@armadra/agent 0.2.1 → 0.4.0

package/dist/cli/compose-store.js

@@ -2,7 +2,7 @@
  * 组装根：会话存储（实施计划 §1.1 `sessions.*`）。[B6]
  *
  * 会话根目录 `sessionDir` 下按 cwd 分子目录（`sessionDirForCwd`）。
- * - `new` → 延迟落盘新建；`continue` → 本目录最近一条（没有则新建）；
+ * - `new` → 延迟落盘新建；`memory`（`--no-session`）→ 内存会话，从不落盘；`continue` → 本目录最近一条（没有则新建）；
  * - `resume{id}` / `fork{id}`：先在本目录、再在全部子目录里按 id 或唯一前缀找文件；找不到 →
  *   `session_not_found`，前缀不唯一 → `invalid_arguments` 并列出候选；
  * - `session-id{id}`：找到则打开，否则以该 id 新建；
@@ -67,6 +67,8 @@ export function openSession(request, context) {
     switch (request.kind) {
         case "new":
             return SessionManager.create(dir, cwd);
+        case "memory":
+            return SessionManager.inMemory(cwd);
         case "continue":
             return SessionManager.continueRecent(dir, cwd);
         case "resume":

package/dist/cli/compose.d.ts

@@ -23,10 +23,11 @@
  * 需要会话时用 `ctx.session()`，嵌套调用其它工具用 `ToolContext.tools.executeTool`（走完整门禁）。
  */
 import type { ApiRegistry } from "../ai/apis/api.js";
-import type { ProviderData } from "../ai/types.js";
+import type { ModelRef, ProviderData } from "../ai/types.js";
 import type { AgentSession } from "../agent/types.js";
 import type { AmaConfig } from "../config/types.js";
 import type { Rule } from "../permissions/types.js";
+import { type SandboxCapability } from "../codemode/capability.js";
 import { PresetToolRegistry } from "../tools/presets.js";
 import type { ToolDefinition, ToolRegistryApi } from "../tools/types.js";
 import { type ComposeState, type LogFn } from "./compose-session.js";
@@ -46,7 +47,7 @@ export interface ToolFactoryContext {
 }
 /** 返回 undefined = 本次不注册（例如配置关闭）。 */
 export type ToolFactory = (ctx: ToolFactoryContext) => ToolDefinition | undefined;
-/** 缺省工具工厂：codemode（`codemode.mode` 生效值为 off 时不注册）。 */
+/** 缺省工具工厂：codemode（生效模式为 off 时不注册；缺省跟随预设，见 tools/presets.ts）。 */
 export declare const DEFAULT_TOOL_FACTORIES: readonly ToolFactory[];
 export interface ComposeOptions {
     /** 追加 / 覆盖供应商（SDK）。 */
@@ -56,6 +57,11 @@ export interface ComposeOptions {
     extraTools?: ToolDefinition[];
     /** 缺省 DEFAULT_TOOL_FACTORIES。 */
     toolFactories?: readonly ToolFactory[];
+    /**
+     * 沙箱能力（缺省按运行时 Node 探测）。决定 default 预设是否开 codemode；给了且没给
+     * `toolFactories` 时 codemode 工厂也用它（测试据此不随 Node 版本变化）。
+     */
+    sandboxCapability?: SandboxCapability;
     /** 覆盖启动期问答；缺省见 `defaultStartupUi`。 */
     ui?: InteractiveUi;
     modes?: Partial<Record<RuntimeMode, ModeRunner>>;
@@ -73,15 +79,21 @@ export declare const DEFAULT_MODES: Readonly<Partial<Record<RuntimeMode, ModeRun
 /**
  * 第 12 步：内置工具 + 工厂 + extraTools，按预设定活动集；warning 留给组装会话时报告。
  *
- * 先跑工厂（产物暂不注册）再解析预设：codemode 是否可用决定预设与模式；`on` 模式下注册时给
- * 其它工具的描述追加 codemode 提示，`only` 模式活动集独占（codemode/modes.ts）。工厂拿到的
- * `registry` 在执行期才读，此时已登记完全部工具。
+ * 先跑工厂（产物暂不注册）再解析预设：codemode 是否可用决定预设与模式；`only` 模式活动集独占
+ * （codemode/modes.ts）。工厂拿到的 `registry` 在执行期才读，此时已登记完全部工具。default 预设
+ * 跟随预设而 codemode 缺省关闭时（非 strict 运行时）提示一次（cli/codemode-notice.ts）。
  */
 export declare function createTools(input: {
     config: AmaConfig;
     cwd: string;
     mode: RuntimeMode;
+    paths?: {
+        configDir: string;
+        dataDir: string;
+    } | undefined;
 }, options: ComposeOptions, state: ComposeState): PresetToolRegistry;
+/** 当前模型是否收图片（read 工具用）；查不到模型时按收（交给协议层过滤）。 */
+export declare function modelAcceptsImages(state: ComposeState, model: ModelRef | undefined): boolean;
 /** 第 14 步前：内置 deny（builtinDeny 过滤）+ 用户规则；非法规则 warning 后跳过。 */
 export declare function buildRules(specs: readonly {
     effect: "allow" | "deny";

package/dist/cli/compose.js

@@ -22,19 +22,22 @@
  * 第 12 步建注册表时调用，产物以 `builtin` 来源注册（受预设管理）；工厂拿不到会话对象本身，执行期
  * 需要会话时用 `ctx.session()`，嵌套调用其它工具用 `ToolContext.tools.executeTool`（走完整门禁）。
  */
+import { formatModelRef } from "../ai/providers/channels.js";
 import { PermissionPipeline } from "../permissions/pipeline.js";
 import { BUILTIN_DENY_RULES, parseRule } from "../permissions/rules.js";
 import { discoverSkills, skillSources } from "../skills/discover.js";
 import { discoverPromptTemplates, promptSources } from "../skills/templates.js";
-import { applyCodemodeMode, decorateForMode } from "../codemode/modes.js";
+import { applyCodemodeMode } from "../codemode/modes.js";
+import { detectSandboxCapability } from "../codemode/capability.js";
 import { codemodeToolFactory } from "../codemode/tool.js";
 import { PresetToolRegistry, resolvePreset } from "../tools/presets.js";
 import { builtinTools } from "../tools/registry.js";
+import { takeCodemodeNotice } from "./codemode-notice.js";
 import { buildProviderRegistry } from "./compose-providers.js";
 import { composeSession, emptyComposeState, } from "./compose-session.js";
 import { createSessionStore } from "./compose-store.js";
 import { defaultSendUser } from "./startup-steps.js";
-/** 缺省工具工厂：codemode（`codemode.mode` 生效值为 off 时不注册）。 */
+/** 缺省工具工厂：codemode（生效模式为 off 时不注册；缺省跟随预设，见 tools/presets.ts）。 */
 export const DEFAULT_TOOL_FACTORIES = [codemodeToolFactory()];
 export function lazyMode(load) {
     return async (runtime, context) => (await load())(runtime, context);
@@ -49,16 +52,24 @@ export const DEFAULT_MODES = {
 /**
  * 第 12 步：内置工具 + 工厂 + extraTools，按预设定活动集；warning 留给组装会话时报告。
  *
- * 先跑工厂（产物暂不注册）再解析预设：codemode 是否可用决定预设与模式；`on` 模式下注册时给
- * 其它工具的描述追加 codemode 提示，`only` 模式活动集独占（codemode/modes.ts）。工厂拿到的
- * `registry` 在执行期才读，此时已登记完全部工具。
+ * 先跑工厂（产物暂不注册）再解析预设：codemode 是否可用决定预设与模式；`only` 模式活动集独占
+ * （codemode/modes.ts）。工厂拿到的 `registry` 在执行期才读，此时已登记完全部工具。default 预设
+ * 跟随预设而 codemode 缺省关闭时（非 strict 运行时）提示一次（cli/codemode-notice.ts）。
  */
 export function createTools(input, options, state) {
     const registry = new PresetToolRegistry();
+    const capability = options.sandboxCapability ?? detectSandboxCapability();
+    const factories = options.toolFactories ??
+        (options.sandboxCapability !== undefined
+            ? [codemodeToolFactory({ capability })]
+            : DEFAULT_TOOL_FACTORIES);
     const bash = input.config.tools?.bashTimeoutMs !== undefined
         ? { defaultTimeoutMs: input.config.tools.bashTimeoutMs }
         : {};
-    const builtins = builtinTools({ bash });
+    const builtins = builtinTools({
+        bash,
+        read: { supportsImages: (ctx) => modelAcceptsImages(state, ctx.model) },
+    });
     const ctx = {
         ...input,
         registry,
@@ -66,7 +77,7 @@ export function createTools(input, options, state) {
         warn: (message) => state.warnings.push(message),
     };
     const produced = [];
-    for (const factory of options.toolFactories ?? DEFAULT_TOOL_FACTORIES) {
+    for (const factory of factories) {
         try {
             const tool = factory(ctx);
             if (tool !== undefined)
@@ -78,22 +89,38 @@ export function createTools(input, options, state) {
     }
     const extra = options.extraTools ?? [];
     const names = new Set([...builtins, ...produced, ...extra].map((tool) => tool.name));
-    const preset = resolvePreset({ config: input.config, available: (name) => names.has(name) });
-    const decorate = decorateForMode(preset.codemode);
+    const preset = resolvePreset({
+        config: input.config,
+        available: (name) => names.has(name),
+        strict: capability.strict,
+    });
     for (const tool of [...builtins, ...produced]) {
         try {
-            registry.register(decorate(tool), "builtin");
+            registry.register(tool, "builtin");
         }
         catch (error) {
             state.warnings.push(`工具 ${tool.name} 注册失败：${error.message}`);
         }
     }
     for (const tool of extra)
-        registry.register(decorate(tool), "sdk");
+        registry.register(tool, "sdk");
     applyCodemodeMode(registry, preset);
     state.warnings.push(...preset.warnings);
+    // 一次性提示只给有人看的界面（交互 / 行式）；-p 与 RPC 的 stderr 常被脚本解析，不打扰。
+    if (input.paths !== undefined && (input.mode === "interactive" || input.mode === "line")) {
+        const notice = takeCodemodeNotice({ config: input.config, capability, ...input.paths });
+        if (notice !== undefined)
+            state.warnings.push(notice);
+    }
     return registry;
 }
+/** 当前模型是否收图片（read 工具用）；查不到模型时按收（交给协议层过滤）。 */
+export function modelAcceptsImages(state, model) {
+    if (model === undefined || state.providers === undefined)
+        return true;
+    const found = state.providers.findModel(formatModelRef(model));
+    return found.ok ? found.model.input.includes("image") : true;
+}
 /** 第 14 步前：内置 deny（builtinDeny 过滤）+ 用户规则；非法规则 warning 后跳过。 */
 export function buildRules(specs, builtinDeny, warn) {
     const rules = [];
@@ -142,14 +169,18 @@ export function createRuntimeDeps(options = {}) {
     const state = emptyComposeState();
     const deps = {
         providers: {
-            create: (input) => buildProviderRegistry(input, {
-                providers: options.providers,
-                apis: options.apis,
-                env: options.env,
-                includeFake: options.includeFake,
-                probeLocal: options.probeLocal,
-                warn: (message) => state.warnings.push(message),
-            }),
+            create: async (input) => {
+                const registry = await buildProviderRegistry(input, {
+                    providers: options.providers,
+                    apis: options.apis,
+                    env: options.env,
+                    includeFake: options.includeFake,
+                    probeLocal: options.probeLocal,
+                    warn: (message) => state.warnings.push(message),
+                });
+                state.providers = registry;
+                return registry;
+            },
         },
         sessions: createSessionStore(),
         tools: { create: (input) => createTools(input, options, state) },
@@ -158,6 +189,9 @@ export function createRuntimeDeps(options = {}) {
                 mode: input.mode,
                 rules: buildRules(input.rules, input.builtinDeny, (m) => state.warnings.push(m)),
                 cwd: input.cwd,
+                ...(input.autoSafeCommands !== undefined
+                    ? { autoSafeCommands: input.autoSafeCommands }
+                    : {}),
             }),
         },
         resources: {

package/dist/cli/default-model.d.ts

@@ -1,16 +1,53 @@
 /**
  * 零配置选模型（设计 §10.0、§11.1 第 11 步）：没有 `--model`、续会话的 model_change 与
- * `config.defaultModel` 时，按内置供应商顺序（§3.3）选第一个**可用**供应商的缺省模型（目录首条）。
+ * `config.defaultModel` 时，按供应商顺序（内置 §3.3 在前，config 里的自定义供应商在后）选第一个
+ * **可用**供应商，再在它的模型里挑一个：
+ *
+ * - 内置供应商：目录首条（目录按推荐顺序整理过）；
+ * - 自定义供应商（中转站，模型表是上游 /v1/models 的顺序）：按 `pickByPrice` 的规则挑——
+ *   models.dev 有价格（输入价 > 0）且支持工具调用、上下文 ≥ 64k 的模型里输入价最低的；同价取上下文
+ *   大的，再同取列表靠前的。没有满足条件的才退回列表首条。`ama providers add` 写 defaultModel 用同一规则。
  *
  * 可用 = 有 key（`requiresApiKey`）或本地服务已探测到模型（ollama / lmstudio，组装根在
  * 无 key 时探测）。跳过 `fake`（测试供应商只能显式 `--model fake/…`）与协议尚未实现的供应商。
  */
 import type { Model, ProviderData, ProviderRegistryApi } from "../ai/types.js";
+/** 缺省模型的最小上下文（token）。 */
+export declare const MIN_DEFAULT_CONTEXT = 64000;
+export interface PriceCandidate {
+    id: string;
+    contextWindow?: number | undefined;
+    /** $/M 输入 token。 */
+    inputCost?: number | undefined;
+    /** models.dev 的 tool_call。 */
+    toolCall?: boolean | undefined;
+}
+export interface PricePick {
+    id: string;
+    /** 为什么选它（一句话）。 */
+    reason: string;
+}
+/** 规则说明（帮助与输出共用）。 */
+export declare const PRICE_RULE = "\u652F\u6301\u5DE5\u5177\u8C03\u7528\u3001\u4E0A\u4E0B\u6587 \u2265 64k \u4E14\u6709\u4EF7\u683C\u7684\u6A21\u578B\u91CC\u8F93\u5165\u4EF7\u6700\u4F4E";
+/** 按价格挑缺省模型；没有满足条件的返回 undefined（规则见文件头）。 */
+export declare function pickByPrice(candidates: readonly PriceCandidate[]): PricePick | undefined;
 export interface DefaultModelChoice {
     model: Model;
     provider: ProviderData;
     /** 选中原因：`key`（有 key，来源见 keySource）或 `local`（本地服务）。 */
     via: "key" | "local";
     keySource?: string;
+    /** 为什么是这个模型（内置目录首条 / 价格规则 / 列表首条）。 */
+    rule: string;
 }
+/** 供应商内挑模型：内置取目录首条；自定义按价格规则，挑不出再取首条。 */
+export declare function pickProviderModel(registry: ProviderRegistryApi, provider: ProviderData): {
+    model: Model;
+    rule: string;
+} | undefined;
 export declare function pickDefaultModel(registry: ProviderRegistryApi): Promise<DefaultModelChoice | undefined>;
+/**
+ * 没有可用模型时的引导（一行，选择器的说明行与报错共用）：列出前几个内置供应商的 key 环境变量，
+ * 以及 `ama auth set` / `ama providers add`。
+ */
+export declare function noModelGuidance(registry: Pick<ProviderRegistryApi, "list">): string;

package/dist/cli/default-model.js

@@ -1,24 +1,111 @@
 /**
  * 零配置选模型（设计 §10.0、§11.1 第 11 步）：没有 `--model`、续会话的 model_change 与
- * `config.defaultModel` 时，按内置供应商顺序（§3.3）选第一个**可用**供应商的缺省模型（目录首条）。
+ * `config.defaultModel` 时，按供应商顺序（内置 §3.3 在前，config 里的自定义供应商在后）选第一个
+ * **可用**供应商，再在它的模型里挑一个：
+ *
+ * - 内置供应商：目录首条（目录按推荐顺序整理过）；
+ * - 自定义供应商（中转站，模型表是上游 /v1/models 的顺序）：按 `pickByPrice` 的规则挑——
+ *   models.dev 有价格（输入价 > 0）且支持工具调用、上下文 ≥ 64k 的模型里输入价最低的；同价取上下文
+ *   大的，再同取列表靠前的。没有满足条件的才退回列表首条。`ama providers add` 写 defaultModel 用同一规则。
  *
  * 可用 = 有 key（`requiresApiKey`）或本地服务已探测到模型（ollama / lmstudio，组装根在
  * 无 key 时探测）。跳过 `fake`（测试供应商只能显式 `--model fake/…`）与协议尚未实现的供应商。
  */
+import { compactTokens, metadataOf } from "./subcommands/model-meta.js";
+/** 缺省模型的最小上下文（token）。 */
+export const MIN_DEFAULT_CONTEXT = 64_000;
+/** 规则说明（帮助与输出共用）。 */
+export const PRICE_RULE = "支持工具调用、上下文 ≥ 64k 且有价格的模型里输入价最低";
+/** 按价格挑缺省模型；没有满足条件的返回 undefined（规则见文件头）。 */
+export function pickByPrice(candidates) {
+    let best;
+    candidates.forEach((c, index) => {
+        if (c.toolCall !== true)
+            return;
+        if (c.inputCost === undefined || !(c.inputCost > 0))
+            return;
+        if ((c.contextWindow ?? 0) < MIN_DEFAULT_CONTEXT)
+            return;
+        if (best === undefined) {
+            best = { c, index };
+            return;
+        }
+        const a = best.c;
+        const cheaper = c.inputCost < a.inputCost;
+        const same = c.inputCost === a.inputCost;
+        if (cheaper || (same && (c.contextWindow ?? 0) > (a.contextWindow ?? 0)))
+            best = { c, index };
+    });
+    if (best === undefined)
+        return undefined;
+    const { c } = best;
+    return {
+        id: c.id,
+        reason: `${PRICE_RULE}（$${c.inputCost}/M 输入，上下文 ${compactTokens(c.contextWindow)}）`,
+    };
+}
+/** 供应商内挑模型：内置取目录首条；自定义按价格规则，挑不出再取首条。 */
+export function pickProviderModel(registry, provider) {
+    const usable = provider.models.filter((m) => registry.getApi(m.api) !== undefined);
+    const first = usable[0];
+    if (first === undefined)
+        return undefined;
+    if (provider.builtin)
+        return { model: first, rule: "内置目录推荐的首个模型" };
+    const picked = pickByPrice(usable.map((m) => ({
+        id: m.id,
+        contextWindow: m.contextWindow,
+        inputCost: m.cost?.input,
+        toolCall: metadataOf(registry, provider.id, m.id)?.toolCall,
+    })));
+    const model = picked === undefined ? undefined : usable.find((m) => m.id === picked.id);
+    if (picked !== undefined && model !== undefined)
+        return { model, rule: picked.reason };
+    return {
+        model: first,
+        rule: "列表首个模型（没有同时支持工具调用、上下文 ≥ 64k 且有价格的模型）",
+    };
+}
 export async function pickDefaultModel(registry) {
     for (const provider of registry.list()) {
         if (provider.id === "fake" && !provider.requiresApiKey)
             continue;
-        const model = provider.models[0];
-        if (model === undefined)
+        const head = provider.models[0];
+        if (head === undefined)
+            continue;
+        if (registry.getApi(head.api) === undefined)
             continue;
-        if (registry.getApi(model.api) === undefined)
+        let via = "local";
+        let keySource;
+        if (provider.requiresApiKey) {
+            const key = await registry.resolveApiKey(provider.id);
+            if (key.apiKey === undefined)
+                continue;
+            via = "key";
+            keySource = key.source;
+        }
+        const picked = pickProviderModel(registry, provider);
+        if (picked === undefined)
             continue;
-        if (!provider.requiresApiKey)
-            return { model, provider, via: "local" };
-        const key = await registry.resolveApiKey(provider.id);
-        if (key.apiKey !== undefined)
-            return { model, provider, via: "key", keySource: key.source };
+        const choice = { model: picked.model, provider, via, rule: picked.rule };
+        if (keySource !== undefined)
+            choice.keySource = keySource;
+        return choice;
     }
     return undefined;
 }
+/**
+ * 没有可用模型时的引导（一行，选择器的说明行与报错共用）：列出前几个内置供应商的 key 环境变量，
+ * 以及 `ama auth set` / `ama providers add`。
+ */
+export function noModelGuidance(registry) {
+    const envs = registry
+        .list()
+        .filter((p) => p.builtin && p.requiresApiKey && p.id !== "fake")
+        .map((p) => p.envKeys[0])
+        .filter((name) => name !== undefined);
+    const shown = envs.slice(0, 3).join(" / ");
+    const more = envs.length > 3 ? " 等" : "";
+    return (`没有可用模型：设置 ${shown}${more}环境变量，或 \`ama auth set <provider>\` 保存 key，` +
+        "或 `ama providers add <id> --base-url <url>` 接入中转站（也可 --model 指定）");
+}

package/dist/cli/deps.d.ts

@@ -37,6 +37,10 @@ export type SessionRequest = {
 } | {
     kind: "fork";
     id: string;
+}
+/** `--no-session`：内存会话，从不落盘。 */
+ | {
+    kind: "memory";
 };
 export interface ProviderBuildInput {
     config: AmaConfig;
@@ -51,6 +55,8 @@ export interface ProviderBuildInput {
         modelRef: string;
         provider?: string;
     };
+    /** 数据目录：读 models.dev 缓存（`<dataDir>/models-dev.json`，只读不联网）；缺省不补元数据。 */
+    dataDir?: string;
 }
 export interface ResourceDiscoveryInput {
     cwd: string;
@@ -105,8 +111,22 @@ export interface SessionAssembly {
     sessionStartContext(): string | undefined;
     /** print：ask → deny。 */
     unattended: boolean;
+    /** 命令行对会话的覆盖（W4-C）：`-p --max-turns`、`--system-prompt`、`--no-session`。 */
+    overrides?: SessionOverrides;
     warn(message: string): void;
 }
+export interface SessionOverrides {
+    /** 一次运行（prompt）的回合上限。 */
+    maxTurns?: number;
+    /** `--system-prompt`：追加进 rules 节，或替换 preamble。 */
+    systemPrompt?: SystemPromptOverride;
+    /** `--no-session`：`/new` 等切换出的新会话也只在内存里。 */
+    noSession?: boolean;
+}
+export interface SystemPromptOverride {
+    text: string;
+    mode: "append" | "replace";
+}
 export interface ModeContext {
     args: ParsedArgs;
     /** 位置参数拼成的首条提示。 */
@@ -164,6 +184,11 @@ export interface RuntimeDeps {
             config: AmaConfig;
             cwd: string;
             mode: RuntimeMode;
+            /** CLI 启动时给出（一次性提示记在数据目录）；SDK 不给。 */
+            paths?: {
+                configDir: string;
+                dataDir: string;
+            };
         }): ToolRegistryApi;
     };
     /** B3：权限管线。 */
@@ -176,6 +201,8 @@ export interface RuntimeDeps {
             cwd: string;
             /** config `permission.builtinDeny`（只来自用户级 / profile）；缺省 = 启用全部内置 deny。 */
             builtinDeny?: boolean | string[];
+            /** config `permission.autoSafeCommands`（auto 模式安全名单追加）。 */
+            autoSafeCommands?: string[];
         }): PermissionPipelineApi;
     };
     /** B3：skills / prompts 发现；缺省为空。 */
@@ -202,4 +229,15 @@ export interface CliIo {
     cwd: string;
     /** 读取 stdin 全部内容（auth set）。 */
     readStdin(): Promise<string>;
+    /**
+     * 等首字节至多 `timeoutMs`：期间没有任何字节 → undefined（停止读取，不再占着 stdin）；收到首字节
+     * 后读到 EOF（不再超时）；期间就 EOF → 已读到的内容。缺省实现见 cli/main.ts。
+     */
+    readStdinFirstByte?(timeoutMs: number): Promise<string | undefined>;
+    /**
+     * stdin 的类型（`-p` 据此决定读不读）：`file` / `null`（/dev/null 等字符设备）读了不会卡；
+     * `fifo` 是 shell 管道；`socket` 多为父进程 spawn 时留的管道。未提供时按 `other` 处理（不读、不提示）。
+     */
+    stdinKind?(): StdinKind;
 }
+export type StdinKind = "tty" | "file" | "null" | "fifo" | "socket" | "other";

package/dist/cli/exit-codes.d.ts

@@ -16,6 +16,8 @@ export declare const ExitCode: {
     readonly Session: 5;
     /** 宿主 / Hook 加载或启动失败。 */
     readonly HostOrHook: 6;
+    /** `-p` 运行中有工具调用被拒（无人审批、deny 规则、plan 等），要求的动作没有完成。 */
+    readonly ToolDenied: 7;
     /** HOST_API_VERSION 不匹配。 */
     readonly HostVersion: 78;
     /** SIGINT 退出（两次 Ctrl+C）。 */

package/dist/cli/exit-codes.js

@@ -16,6 +16,8 @@ export const ExitCode = {
     Session: 5,
     /** 宿主 / Hook 加载或启动失败。 */
     HostOrHook: 6,
+    /** `-p` 运行中有工具调用被拒（无人审批、deny 规则、plan 等），要求的动作没有完成。 */
+    ToolDenied: 7,
     /** HOST_API_VERSION 不匹配。 */
     HostVersion: 78,
     /** SIGINT 退出（两次 Ctrl+C）。 */
@@ -31,6 +33,7 @@ export const EXIT_CODE_DESCRIPTIONS = {
     4: "无可用模型或密钥",
     5: "会话不存在 / 损坏 / cwd 不匹配",
     6: "宿主 / Hook 加载或启动失败",
+    7: "-p 运行中有工具调用被拒（没有人审批）",
     78: "HOST_API_VERSION 不匹配",
     130: "SIGINT 退出（两次 Ctrl+C）",
     143: "SIGTERM",

package/dist/cli/fake-visibility.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 测试供应商 `fake` 的可见性：零配置的模型选择器、`ama doctor`、`ama models list`、`ama providers list`、
+ * `ama config show` 缺省不列出它（实测零配置 TUI 的首项是 `fake › echo`，直接回车就用上了测试供应商）。
+ *
+ * - `AMA_SHOW_FAKE=1` 或设置了 `AMA_FAKE_SCRIPT` 时照常列出；
+ * - 只藏 `list()`：`--model fake/…`、`findModel`、`resolveApiKey` 等显式引用不受影响。
+ */
+import type { ProviderRegistryApi } from "../ai/types.js";
+export declare const SHOW_FAKE_ENV = "AMA_SHOW_FAKE";
+export declare const FAKE_PROVIDER_ID = "fake";
+export declare function fakeVisible(env: Readonly<Record<string, string | undefined>>): boolean;
+/** 列表里藏起 fake 的注册表视图（其余方法原样转给原注册表）；可见时原样返回。 */
+export declare function hideFakeProvider<T extends ProviderRegistryApi>(registry: T, env: Readonly<Record<string, string | undefined>>): T;

package/dist/cli/fake-visibility.js

@@ -0,0 +1,26 @@
+/**
+ * 测试供应商 `fake` 的可见性：零配置的模型选择器、`ama doctor`、`ama models list`、`ama providers list`、
+ * `ama config show` 缺省不列出它（实测零配置 TUI 的首项是 `fake › echo`，直接回车就用上了测试供应商）。
+ *
+ * - `AMA_SHOW_FAKE=1` 或设置了 `AMA_FAKE_SCRIPT` 时照常列出；
+ * - 只藏 `list()`：`--model fake/…`、`findModel`、`resolveApiKey` 等显式引用不受影响。
+ */
+import { FAKE_SCRIPT_ENV } from "../ai/fake/fake-provider.js";
+export const SHOW_FAKE_ENV = "AMA_SHOW_FAKE";
+export const FAKE_PROVIDER_ID = "fake";
+export function fakeVisible(env) {
+    return env[SHOW_FAKE_ENV] === "1" || (env[FAKE_SCRIPT_ENV] ?? "") !== "";
+}
+/** 列表里藏起 fake 的注册表视图（其余方法原样转给原注册表）；可见时原样返回。 */
+export function hideFakeProvider(registry, env) {
+    if (fakeVisible(env))
+        return registry;
+    return new Proxy(registry, {
+        get(target, prop) {
+            if (prop === "list")
+                return () => target.list().filter((provider) => provider.id !== FAKE_PROVIDER_ID);
+            const value = Reflect.get(target, prop, target);
+            return typeof value === "function" ? value.bind(target) : value;
+        },
+    });
+}

package/dist/cli/from-prompt.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `--from <会话 id>[#编号]`：用旧会话里的一条用户消息作为新提示（docs/sessions.md「复用」）。[W4-D]
+ *
+ * - 文本：那条消息的文本；命令行另有位置参数时接在后面（空一行）；
+ * - 图片：`-p` 时把图片块写进临时目录、追加到 `--image`（沿用 print 模式的图片校验：模型不收图片 →
+ *   用法错误），运行结束删掉；交互 / 行式界面只带文本，有图片时在 stderr 提示一行；
+ * - 交互模式经现有的「初始提示」参数传入（启动后直接提交，与 `ama "提示"` 相同）；
+ * - `--mode rpc` 不支持（rpc 的提示来自宿主）。
+ * 会话目录用 bootstrap 解析后的 `paths.sessionDir`（含 `--session-dir` 与 profile），本目录优先找 id。
+ */
+import { type ParsedArgs } from "./args.js";
+import type { CliIo, ModeContext } from "./deps.js";
+import type { Runtime } from "./runtime.js";
+export interface FromContext {
+    context: ModeContext;
+    cleanup(): void;
+}
+export declare function applyFromOption(args: ParsedArgs, runtime: Pick<Runtime, "mode" | "paths">, io: CliIo): FromContext;

package/dist/cli/from-prompt.js

@@ -0,0 +1,49 @@
+/**
+ * `--from <会话 id>[#编号]`：用旧会话里的一条用户消息作为新提示（docs/sessions.md「复用」）。[W4-D]
+ *
+ * - 文本：那条消息的文本；命令行另有位置参数时接在后面（空一行）；
+ * - 图片：`-p` 时把图片块写进临时目录、追加到 `--image`（沿用 print 模式的图片校验：模型不收图片 →
+ *   用法错误），运行结束删掉；交互 / 行式界面只带文本，有图片时在 stderr 提示一行；
+ * - 交互模式经现有的「初始提示」参数传入（启动后直接提交，与 `ama "提示"` 相同）；
+ * - `--mode rpc` 不支持（rpc 的提示来自宿主）。
+ * 会话目录用 bootstrap 解析后的 `paths.sessionDir`（含 `--session-dir` 与 profile），本目录优先找 id。
+ */
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { resolveFromMessage } from "../session/reuse.js";
+import { UsageError } from "./args.js";
+const EXT = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/gif": "gif",
+    "image/webp": "webp",
+};
+export function applyFromOption(args, runtime, io) {
+    const spec = args.from;
+    const plain = { context: { args, prompt: args.prompt, io }, cleanup: () => { } };
+    if (spec === undefined)
+        return plain;
+    if (runtime.mode === "rpc")
+        throw new UsageError("--from 不用于 --mode rpc");
+    const picked = resolveFromMessage(runtime.paths.sessionDir, spec, runtime.paths.cwd);
+    const parts = [picked.text, args.prompt ?? ""].filter((p) => p.trim() !== "");
+    const prompt = parts.length > 0 ? parts.join("\n\n") : undefined;
+    if (picked.images.length === 0) {
+        return { context: { args, prompt, io }, cleanup: () => { } };
+    }
+    if (runtime.mode !== "print") {
+        io.stderr(`ama: --from 的消息带 ${picked.images.length} 张图片，交互界面只带文本（-p 会一并发送）\n`);
+        return { context: { args, prompt, io }, cleanup: () => { } };
+    }
+    const dir = mkdtempSync(join(tmpdir(), "ama-from-"));
+    const files = picked.images.map((image, i) => {
+        const file = join(dir, `${picked.n}-${i + 1}.${EXT[image.mimeType] ?? "png"}`);
+        writeFileSync(file, Buffer.from(image.data, "base64"), { mode: 0o600 });
+        return file;
+    });
+    return {
+        context: { args: { ...args, images: [...args.images, ...files] }, prompt, io },
+        cleanup: () => rmSync(dir, { recursive: true, force: true }),
+    };
+}

package/dist/cli/main.d.ts

@@ -4,14 +4,18 @@
  *
  * - 设 `AMA=1`、`AI_AGENT=ama`；直接执行时装 `uncaughtException` / `unhandledRejection` →
  *   stderr 一行 + 退出码 1；SIGINT / SIGTERM 交给当前模式。
- * - `--version` / `--help` 短路；子命令 `auth / sessions / models / doctor / config` 分派后返回；
+ * - `--version` / `--help` 短路；子命令 `auth / sessions / models / providers / doctor / config /
+ *   init` 分派后返回；进入对话的命令（与 `providers add`）启动前若配置目录不存在则静默初始化
+ *   （`AMA_NO_INIT=1` 关闭），只读子命令（`config show`、`doctor`、`models list` 等）不写配置目录；
  *   其余交给 `runCli()`（bootstrap → 模式）。
+ * - 设了 HTTPS_PROXY / HTTP_PROXY 时启用 Node 内置的环境变量代理（cli/proxy.ts）；不支持的 Node
+ *   版本在会联网的命令里提示一次。
  * - 运行时实现（RuntimeDeps）：`MainOptions.deps` > `registerRuntimeDeps()` > 组装根
  *   `createRuntimeDeps()`（cli/compose.ts，动态 import）。
  * - 签名 `main(argv): Promise<number>` 与「直接执行才自动运行」判定保持不变：
  *   src/bundle.ts 显式调用 `main()`。
  */
-import type { CliIo, RuntimeDeps } from "./deps.js";
+import type { CliIo, RuntimeDeps, StdinKind } from "./deps.js";
 /** 集成批次注入运行时实现（B1 / B2 / B3 / B6 / B7）。 */
 export declare function registerRuntimeDeps(deps: RuntimeDeps | undefined): void;
 export interface MainOptions {
@@ -22,5 +26,9 @@ export interface MainOptions {
 }
 /** 读 stdin 全部内容；TTY 下只读一行且不回显（auth set）。 */
 export declare function readStdinDefault(): Promise<string>;
+/** fd 0 的类型；fstat 失败（已关闭）按 `null` 处理。 */
+export declare function stdinKindDefault(): StdinKind;
+/** 等 stdin 首字节至多 `timeoutMs`；超时则停止读取并返回 undefined，否则读到 EOF。 */
+export declare function readStdinFirstByteDefault(timeoutMs: number): Promise<string | undefined>;
 export declare function defaultIo(): CliIo;
 export declare function main(argv: readonly string[], options?: MainOptions): Promise<number>;