u1s1-cli 1.14.6 → 1.15.1

package/dist/agent-setup.d.ts

@@ -106,6 +106,13 @@ export declare function writeAttributionExtension(site?: Site): void;
  * 所以启动时要把残留文件删掉(Desktop App 共用同一个 agentDir,同样受益)。
  */
 export declare function removeLegacyCompactUiExtension(outputDir?: string): void;
+/**
+ * 「界面文案」(斜杠命令补全描述、思考中提示)上一版投影成 <agentDir>/extensions/u1s1-ui-text.js,
+ * 用户带 --no-extensions 或在设置里禁用它时就失效;现在改由 pi.ts 的进程内扩展调用
+ * pi-ui-text.ts 的 registerUiText。启动时删掉残留文件,免得和进程内扩展各包一层
+ * (两层同时生效结果也正确,只是多余);Desktop App 共用 agentDir,它那里本来就是空转。
+ */
+export declare function removeLegacyUiTextExtension(outputDir?: string): void;
 /**
  * pi-web-ui 的就绪检测只认 <agentDir>/auth.json 里有没有凭据条目(models.json
  * 的 apiKey 它不看),空 {} 会在网页里弹「未检测到 pi agent 配置」引导装 pi。

package/dist/agent-setup.js

@@ -4,6 +4,7 @@ import { dirname, join } from "node:path";
 import { activeSite, agentDir, CUSTOM_ENDPOINTS, ENDPOINT_ID_RE, effectiveContextWindow, endpointKeyEnvName, MODELS, readCompactionBudgetSetting, PROVIDER_ID, UNKNOWN_MODEL_COST, VERSION, } from "./config.js";
 import { tr } from "./i18n.js";
 import { migrateLegacyMcpConfig } from "./mcp/config.js";
+import { LEGACY_UI_TEXT_EXTENSION_FILE } from "./pi-ui-text.js";
 /**
  * 系统提示里的品牌人设。中国站面向编程新手、兜底语言中文(保持原文一字不差);
  * 国际站面向开发者、兜底语言英文。按站点而不是界面语言判定,用时求值(配置可能晚于 import 才读)。
@@ -518,6 +519,19 @@ export function removeLegacyCompactUiExtension(outputDir) {
     }
     catch { }
 }
+/**
+ * 「界面文案」(斜杠命令补全描述、思考中提示)上一版投影成 <agentDir>/extensions/u1s1-ui-text.js,
+ * 用户带 --no-extensions 或在设置里禁用它时就失效;现在改由 pi.ts 的进程内扩展调用
+ * pi-ui-text.ts 的 registerUiText。启动时删掉残留文件,免得和进程内扩展各包一层
+ * (两层同时生效结果也正确,只是多余);Desktop App 共用 agentDir,它那里本来就是空转。
+ */
+export function removeLegacyUiTextExtension(outputDir) {
+    const dir = outputDir ?? join(agentDir, "extensions");
+    try {
+        rmSync(join(dir, LEGACY_UI_TEXT_EXTENSION_FILE), { force: true });
+    }
+    catch { }
+}
 /**
  * pi-web-ui 的就绪检测只认 <agentDir>/auth.json 里有没有凭据条目(models.json
  * 的 apiKey 它不看),空 {} 会在网页里弹「未检测到 pi agent 配置」引导装 pi。

package/dist/agents/agent-config.d.ts

@@ -0,0 +1,83 @@
+import { type RuntimeBrake } from "./runtime.js";
+export type GatewayAgentName = "claude-code" | "codex" | "pi";
+export interface AgentModel {
+    id: string;
+    name: string;
+    contextWindow?: number;
+}
+export interface AgentConfig {
+    agent: GatewayAgentName;
+    enabled: boolean;
+    disabledReason: string | null;
+    runtime: RuntimeBrake;
+    defaultModel: string | null;
+    smallModel: string | null;
+    models: AgentModel[];
+    settings: Record<string, unknown> | null;
+}
+/** 校验并规范化响应体;形状不对返回 undefined(按网关故障处理,可退回缓存)。 */
+export declare function parseAgentConfig(body: unknown, agent: GatewayAgentName): AgentConfig | undefined;
+export type AgentConfigResult = {
+    status: "ok";
+    config: AgentConfig;
+    fromCache: boolean;
+} | {
+    status: "disabled";
+    reason: string | null;
+    fromCache: boolean;
+} | {
+    status: "unavailable";
+} | {
+    status: "auth";
+    httpStatus: number;
+} | {
+    status: "error";
+    detail: string;
+};
+interface CacheFile {
+    site: string;
+    fetchedAt: number;
+    body: unknown;
+}
+export declare function readConfigCache(file: string, site: string): CacheFile | undefined;
+/**
+ * @param fetchConfig 发出请求(经签名代理);抛错 = 网络失败
+ * @param site 缓存按站点隔离(用 API origin),换站后不会用到另一站的配置
+ */
+export declare function loadAgentConfig(input: {
+    agent: GatewayAgentName;
+    fetchConfig: () => Promise<Response>;
+    cacheFile: string;
+    site: string;
+    now?: () => number;
+}): Promise<AgentConfigResult>;
+/**
+ * 网关 `GET /public/agents/:agent/runtime`(免鉴权):只有开关与版本刹车,没有模型阵容。
+ * 给还没登录、也没有配置缓存的 `u1s1 agents install` 用——那时拿不到 /v1/agents/:agent/config,
+ * 又不能在没有版本上限的情况下下载。不写缓存:缓存里要的是完整配置(离线启动时要用阵容)。
+ */
+export interface PublicAgentRuntime {
+    enabled: boolean;
+    disabledReason: string | null;
+    runtime: RuntimeBrake;
+}
+export declare function parsePublicAgentRuntime(body: unknown, agent: GatewayAgentName): PublicAgentRuntime | undefined;
+export type PublicAgentRuntimeResult = {
+    status: "ok";
+    brakes: PublicAgentRuntime;
+}
+/** 404:线上网关还没有这个接口 */
+ | {
+    status: "unavailable";
+}
+/** 网络失败、5xx、响应不成形 */
+ | {
+    status: "error";
+    detail: string;
+};
+export declare function loadPublicAgentRuntime(input: {
+    agent: GatewayAgentName;
+    /** 发出请求;抛错 = 网络失败 */
+    fetchRuntime: () => Promise<Response>;
+}): Promise<PublicAgentRuntimeResult>;
+export {};

package/dist/agents/agent-config.js

@@ -0,0 +1,154 @@
+/**
+ * 网关按客户端下发的配置:`GET /v1/agents/:agent/config`(经本机签名代理调用)。
+ *
+ * 契约(网关 workers/gateway/src/agent-config.ts):
+ *   { agent, enabled, disabled_reason, runtime: { min_version, max_tested_version, blocked_versions },
+ *     default_model, small_model, models: [...], settings }
+ * default_model / small_model 在没有模型时是 null;settings 只在 claude-code 启用时是对象,其余 null。
+ * 响应里没有任何凭证或端点:地址和本地 token 由启动器自己注入。
+ *
+ * 结果处理:
+ *   200 → 用并写缓存;enabled:false → 不启动,显示 disabled_reason;
+ *   404(老网关没有这个接口)→ 当作「暂未开放」;
+ *   网络失败 / 5xx / 超时 → 用同一站点上次成功拉到的缓存,没有缓存才报错。
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { dirname } from "node:path";
+import { brakeFromApi } from "./runtime.js";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function nonEmptyString(v, max = 200) {
+    return typeof v === "string" && v.length > 0 && v.length <= max ? v : null;
+}
+/** 校验并规范化响应体;形状不对返回 undefined(按网关故障处理,可退回缓存)。 */
+export function parseAgentConfig(body, agent) {
+    if (!isRecord(body) || body["agent"] !== agent || typeof body["enabled"] !== "boolean")
+        return undefined;
+    const models = [];
+    if (Array.isArray(body["models"])) {
+        for (const m of body["models"]) {
+            if (!isRecord(m))
+                continue;
+            const id = nonEmptyString(m["id"]);
+            if (!id)
+                continue;
+            const cw = m["context_window"];
+            models.push({
+                id,
+                name: nonEmptyString(m["name"]) ?? id,
+                contextWindow: typeof cw === "number" && Number.isFinite(cw) && cw > 0 ? cw : undefined,
+            });
+        }
+    }
+    const settings = isRecord(body["settings"]) ? body["settings"] : null;
+    return {
+        agent,
+        enabled: body["enabled"],
+        disabledReason: nonEmptyString(body["disabled_reason"], 2000),
+        runtime: brakeFromApi(body["runtime"]),
+        defaultModel: nonEmptyString(body["default_model"]),
+        smallModel: nonEmptyString(body["small_model"]),
+        models,
+        settings,
+    };
+}
+export function readConfigCache(file, site) {
+    try {
+        const raw = JSON.parse(readFileSync(file, "utf8"));
+        return raw && raw.site === site && typeof raw.fetchedAt === "number" ? raw : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeConfigCache(file, entry) {
+    try {
+        mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
+        const tmp = `${file}.${process.pid}.${randomBytes(4).toString("hex")}.tmp`;
+        writeFileSync(tmp, JSON.stringify(entry) + "\n", { mode: 0o600 });
+        renameSync(tmp, file);
+    }
+    catch {
+        // 缓存写不进去不影响本次启动
+    }
+}
+function fromConfig(config, fromCache) {
+    if (!config.enabled)
+        return { status: "disabled", reason: config.disabledReason, fromCache };
+    return { status: "ok", config, fromCache };
+}
+/**
+ * @param fetchConfig 发出请求(经签名代理);抛错 = 网络失败
+ * @param site 缓存按站点隔离(用 API origin),换站后不会用到另一站的配置
+ */
+export async function loadAgentConfig(input) {
+    const now = input.now ?? Date.now;
+    const fallback = (detail) => {
+        const cached = readConfigCache(input.cacheFile, input.site);
+        const config = cached ? parseAgentConfig(cached.body, input.agent) : undefined;
+        return config ? fromConfig(config, true) : { status: "error", detail };
+    };
+    let res;
+    try {
+        res = await input.fetchConfig();
+    }
+    catch (e) {
+        return fallback(e instanceof Error ? e.message : String(e));
+    }
+    if (res.status === 404)
+        return { status: "unavailable" };
+    if (res.status === 401 || res.status === 403)
+        return { status: "auth", httpStatus: res.status };
+    if (!res.ok)
+        return fallback(`HTTP ${res.status}`);
+    let body;
+    try {
+        const text = await res.text();
+        if (text.length > 1024 * 1024)
+            return fallback("response too large");
+        body = JSON.parse(text);
+    }
+    catch {
+        return fallback("malformed response");
+    }
+    const config = parseAgentConfig(body, input.agent);
+    if (!config)
+        return fallback("malformed response");
+    writeConfigCache(input.cacheFile, { site: input.site, fetchedAt: now(), body });
+    return fromConfig(config, false);
+}
+export function parsePublicAgentRuntime(body, agent) {
+    if (!isRecord(body) || body["agent"] !== agent || typeof body["enabled"] !== "boolean" || !isRecord(body["runtime"])) {
+        return undefined;
+    }
+    return {
+        enabled: body["enabled"],
+        disabledReason: nonEmptyString(body["disabled_reason"], 2000),
+        runtime: brakeFromApi(body["runtime"]),
+    };
+}
+export async function loadPublicAgentRuntime(input) {
+    let res;
+    try {
+        res = await input.fetchRuntime();
+    }
+    catch (e) {
+        return { status: "error", detail: e instanceof Error ? e.message : String(e) };
+    }
+    if (res.status === 404)
+        return { status: "unavailable" };
+    if (!res.ok)
+        return { status: "error", detail: `HTTP ${res.status}` };
+    try {
+        const text = await res.text();
+        if (text.length > 64 * 1024)
+            return { status: "error", detail: "response too large" };
+        const brakes = parsePublicAgentRuntime(JSON.parse(text), input.agent);
+        return brakes ? { status: "ok", brakes } : { status: "error", detail: "malformed response" };
+    }
+    catch {
+        return { status: "error", detail: "malformed response" };
+    }
+}

package/dist/agents/claude.d.ts

@@ -0,0 +1,113 @@
+import { type McpLaunchEnv } from "../mcp-server.js";
+import { type AgentConfig } from "./agent-config.js";
+import { type RuntimePaths } from "./runtime.js";
+export { agentsRoot, CLAUDE_TERMS_URL, cliInstallHooks, consentLines, notOpenText, overMaxTestedText, printRuntimeFailure, runtimeErrorText, spawnAgent, } from "./launch.js";
+export declare const CLAUDE_GATEWAY_AGENT: "claude-code";
+export interface ClaudePaths extends RuntimePaths {
+    /** CLAUDE_CONFIG_DIR */
+    configDir: string;
+    /** --settings 文件 */
+    settingsFile: string;
+    /** 上次成功拉到的 /v1/agents/claude-code/config */
+    configCache: string;
+    /** --mcp-config 文件 */
+    mcpConfigFile: string;
+}
+export declare function claudePaths(root?: string): ClaudePaths;
+/**
+ * 子进程环境里要去掉的变量:会让它绕开本机代理(云厂商开关与地址)、换用别的凭证
+ * (API Key、OAuth token,其中 x-api-key 会被代理拒绝),或盖过网关下发设置的模型变量。
+ * 只影响这一次启动的子进程环境,用户自己的 shell 与配置不动。
+ */
+export declare const CLAUDE_ENV_DROP: readonly string[];
+export interface ClaudeLaunchInput {
+    baseEnv: NodeJS.ProcessEnv;
+    /** 签名代理的 origin,形如 http://127.0.0.1:12345(不带 /v1) */
+    proxyOrigin: string;
+    /** 签名代理的一次性本地 token */
+    localToken: string;
+    configDir: string;
+    /** u1s1 工具服务要的变量(mcpLaunchEnv);不注入时省略 */
+    mcp?: McpLaunchEnv;
+}
+export declare function claudeLaunchEnv(input: ClaudeLaunchInput): NodeJS.ProcessEnv;
+/**
+ * --mcp-config 是可变参数(后面不是选项的参数都会被当成配置文件),所以放在 --settings 前面,
+ * 让 --settings 把它截住;用户自己的参数(包括直接写的提示词)放最后。
+ *
+ * 例外:用户参数恰好只有一个 --version / -v / -V 时原样传,什么都不加。Claude Code 只在参数只有
+ * 版本开关时走快速返回;前面多了 --mcp-config / --settings 就会先跑完整初始化,断网时要等很久。
+ * 只打印版本用不到这两个配置。
+ */
+export declare function claudeLaunchArgs(settingsFile: string, userArgs: readonly string[], mcpConfigFile?: string): string[];
+/** `u1s1 claude --version`(或 -v / -V)且没有别的参数。 */
+export declare function isBareVersionQuery(userArgs: readonly string[]): boolean;
+/**
+ * 写给 --mcp-config 的内容:一个 stdio 服务,env 里只有 `${变量名}` 引用,由 Claude Code 在拉起时
+ * 用它自己的环境展开(值是启动器放进子进程环境的,见 claudeLaunchEnv),文件里没有 token。
+ */
+export declare function claudeMcpConfig(command?: {
+    command: string;
+    args: string[];
+}, env?: NodeJS.ProcessEnv): Record<string, unknown>;
+/**
+ * 搜索与读网页预先允许(与 Pi 一致,不逐次确认;读网页直连不计费,搜索按次计费但单价低,
+ * 工具说明里要求模型别重复搜)。生图单价高:放进 ask,每次都问用户——不放 ask 的话,Claude Code
+ * 默认的 auto mode 会让它自己的安全检查替用户放行(2.1.322 实测),用户不知情就扣费。
+ */
+export declare const CLAUDE_MCP_ALLOWED_TOOLS: readonly string[];
+export declare const CLAUDE_MCP_ASK_TOOLS: readonly string[];
+export declare function withMcpPermissions(settings: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 启动器自己钉在 settings.env 里的值(盖过网关下发的同名项)。CLAUDE_ENV_DROP 只管得到 shell 环境;
+ * 用户仓库里的 .claude/settings.json / settings.local.json 也能用 env 设这两个变量,改掉网关判定要核对的
+ * 请求形状(=0 时 system 里不带计费头;EXTRA_BODY 带 metadata 时盖掉 metadata.user_id),判成中转嫌疑。
+ * --settings 的优先级高于项目设置,在这里写回默认值。
+ */
+export declare const CLAUDE_SETTINGS_ENV_PINNED: Readonly<Record<string, string>>;
+/** 去掉连接/凭证相关项(SETTINGS_FORBIDDEN、env 里的 SETTINGS_ENV_FORBIDDEN),钉上 CLAUDE_SETTINGS_ENV_PINNED。 */
+export declare function sanitizeClaudeSettings(settings: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 网关的 settings → 写给 --settings 的对象:去掉连接/凭证相关项,钉上 CLAUDE_SETTINGS_ENV_PINNED;
+ * model 用调用方选好的(用户在 u1s1 config 里定的、仍在阵容里的模型),没给时保留网关的,
+ * 网关也没有就用 default_model。
+ */
+export declare function claudeSettingsFromConfig(config: AgentConfig, model?: string | null): Record<string, unknown>;
+/** 调用方的 --settings 有问题(缺值、读不了、不是 JSON 对象);runClaude 报出来后以非 0 退出。 */
+export declare class ClaudeSettingsArgError extends Error {
+    name: string;
+}
+/**
+ * Claude Code 的 --settings 只认最后一个(2.1.323 实测),用户参数里再带一个就把启动器的整份设置盖掉。
+ * 所以从用户参数里把它们全抽出来(`--settings <值>` 与 `--settings=<值>`,按出现顺序;`--` 之后不动),
+ * 由启动器合并进自己写的那份。值可以是文件路径,也可以是 JSON 字符串(与 Claude Code 一样)。
+ */
+export declare function extractSettingsArgs(userArgs: readonly string[]): {
+    rest: string[];
+    sources: string[];
+};
+/** 读一个 --settings 的值:以 `{` 开头按 JSON 字符串解析,否则当文件路径(相对 cwd)。必须是 JSON 对象。 */
+export declare function loadCallerSettings(source: string, cwd?: string): Record<string, unknown>;
+/**
+ * 把调用方的设置合并进启动器的:对象逐层合并;hooks 每个事件的数组拼接;其余数组拼接去重;
+ * 标量(含 model、statusLine 这类整项)以调用方为准。合并后调用方还要再过 sanitizeClaudeSettings 与
+ * withMcpPermissions,不能借此换凭证、换地址、改请求形状。
+ */
+export declare function mergeClaudeSettings(base: Record<string, unknown>, caller: Record<string, unknown>): Record<string, unknown>;
+/** 启动器的设置 + 调用方的设置(按顺序)→ 清洗 → MCP 权限:写进 --settings 文件的最终内容。 */
+export declare function finalClaudeSettings(launcher: Record<string, unknown>, callers: readonly Record<string, unknown>[], withMcp: boolean): Record<string, unknown>;
+export declare function writeClaudeSettings(file: string, settings: Record<string, unknown>): void;
+/** 桌面端复用:同一份注入逻辑(embed.ts 导出)。 */
+export declare function agentLaunchEnv(agent: "claude", input: ClaudeLaunchInput): NodeJS.ProcessEnv;
+/**
+ * 带调用方 --settings 时,合并结果写进这个进程自己的文件:Claude Code 会监视 --settings 文件、改了就重读,
+ * 几个进程共用一份的话,后起的会把先起的那个的 hooks(调用方按会话区分的回调)换成自己的。
+ * 没有调用方 --settings 时内容只取决于网关配置,仍用共用的 settingsFile。
+ */
+export declare function processSettingsFile(paths: Pick<ClaudePaths, "root">, pid?: number): string;
+/** 删掉上次没来得及清理(进程被强杀)的每进程设置文件;进程还在的不动。 */
+export declare function cleanStaleSettingsFiles(root: string, alive?: (pid: number) => boolean): void;
+/**
+ * `u1s1 claude [参数…]`。返回子进程的退出码(启动前就失败返回 1)。
+ */
+export declare function runClaude(userArgs: string[]): Promise<number>;