@armadra/agent 0.2.1 → 0.4.0

package/dist/permissions/protected.d.ts

@@ -0,0 +1,19 @@
+/**
+ * auto 模式规则层的受保护路径（§7.4，docs/permissions.md「规则层」）。
+ *
+ * - **机密路径**（读写都询问）：`.env` / `.env.*`（`.example` / `.sample` / `.template` / `.dist` 除外）、
+ *   `*.env`、`.ssh/`、`.gnupg/`、`.aws/`、`.kube/config`、`.docker/config.json`、`.config/gcloud/`、
+ *   `.netrc`、`.pgpass`、`.git-credentials`、私钥（`id_rsa` 等、`*.pem`、`*.key`、`*.p12`、`*.pfx`、
+ *   `*.jks`、`*.keystore`、`*.ppk`）、ama 自己的 `ama/auth.json`。
+ * - **受保护写入**（只对写询问）：机密路径，`.git` 目录内部，项目里的 `.ama/`（Hook 与配置可能借此放宽），
+ *   项目目录外的任何路径（`/dev/null`、`/dev/stdout`、`/dev/stderr`、`/dev/tty` 除外）。
+ *
+ * 判断按词法路径（不跟随符号链接，与规则匹配一致）。返回英文短说明（进审计与 tool_result），
+ * 不受保护返回 undefined。
+ */
+/** 机密文件或目录：读与写都要询问。 */
+export declare function secretPathReason(absPath: string): string | undefined;
+/** 写入受保护的原因：机密、`.git` 内部、项目 `.ama/`、项目外；可以写返回 undefined。 */
+export declare function writeProtectionReason(absPath: string, projectRoot: string): string | undefined;
+/** 是否在项目目录内（含项目根本身）。 */
+export declare function insideProject(absPath: string, projectRoot: string): boolean;

package/dist/permissions/protected.js

@@ -0,0 +1,74 @@
+/**
+ * auto 模式规则层的受保护路径（§7.4，docs/permissions.md「规则层」）。
+ *
+ * - **机密路径**（读写都询问）：`.env` / `.env.*`（`.example` / `.sample` / `.template` / `.dist` 除外）、
+ *   `*.env`、`.ssh/`、`.gnupg/`、`.aws/`、`.kube/config`、`.docker/config.json`、`.config/gcloud/`、
+ *   `.netrc`、`.pgpass`、`.git-credentials`、私钥（`id_rsa` 等、`*.pem`、`*.key`、`*.p12`、`*.pfx`、
+ *   `*.jks`、`*.keystore`、`*.ppk`）、ama 自己的 `ama/auth.json`。
+ * - **受保护写入**（只对写询问）：机密路径，`.git` 目录内部，项目里的 `.ama/`（Hook 与配置可能借此放宽），
+ *   项目目录外的任何路径（`/dev/null`、`/dev/stdout`、`/dev/stderr`、`/dev/tty` 除外）。
+ *
+ * 判断按词法路径（不跟随符号链接，与规则匹配一致）。返回英文短说明（进审计与 tool_result），
+ * 不受保护返回 undefined。
+ */
+import { basename, relative } from "node:path";
+import { isWithin, toPosix } from "../tools/paths.js";
+const ENV_EXEMPT = /\.(example|sample|template|dist)$/i;
+const KEY_FILE = /^id_(rsa|dsa|ecdsa|ed25519)(_sk)?$/;
+const KEY_EXT = /\.(pem|key|p12|pfx|jks|keystore|ppk)$/i;
+const SECRET_DIRS = new Set([".ssh", ".gnupg", ".aws"]);
+const SECRET_FILES = new Set([".netrc", ".pgpass", ".git-credentials"]);
+const DEVICE_SINKS = new Set(["/dev/null", "/dev/stdout", "/dev/stderr", "/dev/tty"]);
+function segments(absPath) {
+    return toPosix(absPath).split("/").filter(Boolean);
+}
+/** 机密文件或目录：读与写都要询问。 */
+export function secretPathReason(absPath) {
+    const parts = segments(absPath);
+    const name = basename(absPath);
+    if ((/^\.env(\..+)?$/.test(name) || /\.env$/.test(name)) && !ENV_EXEMPT.test(name)) {
+        return `secret file ${name}`;
+    }
+    if (KEY_FILE.test(name) || KEY_EXT.test(name))
+        return `private key or certificate ${name}`;
+    if (SECRET_FILES.has(name))
+        return `credentials file ${name}`;
+    const dir = parts.slice(0, -1);
+    const secretDir = parts.find((p) => SECRET_DIRS.has(p));
+    if (secretDir !== undefined)
+        return `credentials directory ${secretDir}/`;
+    for (let i = 0; i < dir.length; i++) {
+        const a = dir[i];
+        const b = parts[i + 1];
+        if (a === ".kube" && b === "config")
+            return "kubeconfig";
+        if (a === ".docker" && b === "config.json")
+            return "docker credentials";
+        if (a === ".config" && b === "gcloud")
+            return "gcloud credentials";
+        if ((a === "ama" || a === ".ama") && b === "auth.json" && i + 2 === parts.length) {
+            return "ama API key file";
+        }
+    }
+    return undefined;
+}
+/** 写入受保护的原因：机密、`.git` 内部、项目 `.ama/`、项目外；可以写返回 undefined。 */
+export function writeProtectionReason(absPath, projectRoot) {
+    if (DEVICE_SINKS.has(toPosix(absPath)))
+        return undefined;
+    const secret = secretPathReason(absPath);
+    if (secret !== undefined)
+        return secret;
+    if (segments(absPath).includes(".git"))
+        return "writes inside .git";
+    if (!isWithin(projectRoot, absPath))
+        return "writes outside the project directory";
+    const rel = toPosix(relative(projectRoot, absPath));
+    if (rel === ".ama" || rel.startsWith(".ama/"))
+        return "writes to the project .ama/ config";
+    return undefined;
+}
+/** 是否在项目目录内（含项目根本身）。 */
+export function insideProject(absPath, projectRoot) {
+    return isWithin(projectRoot, absPath);
+}

package/dist/permissions/rules.js

@@ -229,6 +229,9 @@ export function resolvePermissionLayers(layers, options = {}) {
             if (!PERMISSION_MODES_STRICT_FIRST.includes(layer.mode)) {
                 warnings.push(`${layer.source}: unknown permission mode "${String(layer.mode)}"`);
             }
+            else if (restricted && (layer.mode === "auto" || layer.mode === "full-auto")) {
+                warnings.push(`project config cannot set permission mode "${layer.mode}"; ignored`);
+            }
             else if (restricted && !isAtLeastAsStrict(layer.mode, mode)) {
                 warnings.push(`project config cannot relax permission mode from "${mode}" to "${layer.mode}"; ignored`);
             }

package/dist/permissions/types.d.ts

@@ -11,9 +11,32 @@
  *   「覆盖未读过的文件」。`previewAction()` 实现归 W3-B9a-2。
  */
 import type { ToolPermission } from "../tools/types.js";
-/** 严格程度：plan > default > auto-edit > full-auto（项目级只能往左收紧，§7.2）。 */
-export type PermissionMode = "plan" | "default" | "auto-edit" | "full-auto";
+/**
+ * 六种模式（§7.4）。严格程度从严到宽：plan < allowlist < default < auto-edit < auto < full-auto
+ * （项目级只能往左收紧，且不能设 auto / full-auto，§7.2）。
+ * `allowlist` 放行只读工具与 allow 规则命中的调用，其余拒绝、从不询问：放行集合是 plan 的超集、
+ * default 放行集合的子集，所以排在两者之间。
+ */
+export type PermissionMode = "plan" | "allowlist" | "default" | "auto-edit" | "auto" | "full-auto";
 export declare const PERMISSION_MODES_STRICT_FIRST: readonly PermissionMode[];
+/** auto 判定发生在哪一层（§7.4）：规则层、静态判定、模型分类器。 */
+export type AutoLayer = "rule" | "static" | "classifier";
+/** 一次 auto 判定（审计用；线上形状，可 JSON 序列化）。 */
+export interface AutoDecision {
+    layer: AutoLayer;
+    /** 这一层的结论；ask 在无人值守时最终按 deny 执行。 */
+    decision: Decision;
+    reason: string;
+    /** 分类器结果来自会话内缓存。 */
+    cached?: boolean;
+}
+/** `/permissions` 列出的最近判定。 */
+export interface AutoAuditEntry extends AutoDecision {
+    at: number;
+    toolName: string;
+    /** 命令或路径摘要（单行、截断）。 */
+    summary: string;
+}
 export type Decision = "allow" | "ask" | "deny";
 export type RuleSource = "builtin" | "user" | "profile" | "project" | "cli" | "sdk";
 /** `bash(git push*)`、`write(src/**)`、`read(**)`、`canvas_*` 解析结果。 */
@@ -36,6 +59,8 @@ export interface ApprovalRequest {
     hookReason?: string;
     /** [W3-C0] 执行前预览（只读、有上限）；预览超时或未实现时缺省。 */
     preview?: ActionPreview;
+    /** auto 模式下为什么要询问（规则层或分类器的结论）。 */
+    autoDecision?: AutoDecision;
     /**
      * 发起方上下文：`depth > 0` 表示来自 `task` 子 Agent（对话框标 `[task]`）；codemode 内层
      * 调用带外层调用的 `parentToolCallId`。由子会话包装的 broker 填入，缺省视为主会话。
@@ -80,7 +105,15 @@ export interface PermissionCheckInput {
     unattended: boolean;
 }
 /** 管线哪一步做出了最终决定。 */
-export type PermissionStep = "deny-rule" | "hook-deny" | "dangerous" | "mode" | "allow-rule" | "hook" | "session";
+export type PermissionStep = "deny-rule" | "hook-deny" | "dangerous" | "mode" | "allow-rule" | "hook" | "session"
+/** auto 规则层：受保护路径、网络、删除类、项目外写入。 */
+ | "auto-rule"
+/** auto 静态判定放行。 */
+ | "auto-static"
+/** auto 留给模型分类器（verdict.classify 为真）。 */
+ | "auto-classify"
+/** allowlist 模式下不在允许名单。 */
+ | "allowlist";
 export interface PermissionVerdict {
     decision: Decision;
     step: PermissionStep;
@@ -89,6 +122,13 @@ export interface PermissionVerdict {
     rule?: Rule;
     /** 给模型 / 用户看的说明（deny 时写进 tool_result）。 */
     message?: string;
+    /** auto 模式的判定记录（layer / reason）；其它模式缺省。 */
+    auto?: AutoDecision;
+    /**
+     * auto 模式下规则层与静态判定都没决定：调用方可以问模型分类器，allow → 放行；否则按本 verdict
+     * 的 decision（ask，无人值守时已是 deny）。不认识这个字段的调用方得到的就是保守结论。
+     */
+    classify?: boolean;
 }
 export interface PermissionPipelineApi {
     readonly mode: PermissionMode;
@@ -97,4 +137,11 @@ export interface PermissionPipelineApi {
     check(input: PermissionCheckInput): PermissionVerdict;
     /** allow_session：内存记住 toolName + 归一化输入前缀，不落盘。 */
     rememberForSession(toolName: string, input: unknown): void;
+    /** auto 判定审计：记一条（最多保留最近 {@link AUTO_AUDIT_LIMIT} 条）。 */
+    recordAutoDecision?(toolName: string, input: unknown, decision: AutoDecision): void;
+    /** 最近的 auto 判定，旧的在前。 */
+    autoDecisions?(): readonly AutoAuditEntry[];
+    /** auto：项目根（分类器输入），缺省 = 会话 cwd。 */
+    readonly projectRoot?: string;
 }
+export declare const AUTO_AUDIT_LIMIT = 20;

package/dist/permissions/types.js

@@ -12,7 +12,10 @@
  */
 export const PERMISSION_MODES_STRICT_FIRST = [
     "plan",
+    "allowlist",
     "default",
     "auto-edit",
+    "auto",
     "full-auto",
 ];
+export const AUTO_AUDIT_LIMIT = 20;

package/dist/rpc.d.ts

@@ -45,9 +45,11 @@ export interface RpcCommandMap {
     get_messages: NoParams;
     get_last_assistant_text: NoParams;
     get_session_stats: NoParams;
+    /** `channel`：多渠道供应商的渠道名（缺省走模型的首选渠道）。 */
     set_model: {
         provider: string;
         modelId: string;
+        channel?: string;
     };
     get_available_models: NoParams;
     set_thinking_level: {

package/dist/sdk.d.ts

@@ -16,7 +16,7 @@ import type { AgentSessionImpl } from "./agent/session.js";
 import { type LogFn } from "./cli/compose-session.js";
 import { type ComposeOptions } from "./cli/compose.js";
 import type { Runtime } from "./cli/runtime.js";
-import type { AmaConfig, ToolsPreset } from "./config/types.js";
+import { type AmaConfig, type ToolsPresetInput } from "./config/types.js";
 import type { HookConfig } from "./hooks/types.js";
 import type { InstructionSource } from "./host/types.js";
 import type { ApprovalDecision, ApprovalRequest, PermissionMode } from "./permissions/types.js";
@@ -32,7 +32,8 @@ export interface RuntimeOptions {
     model?: string;
     thinkingLevel?: ModelThinkingLevel;
     permissionMode?: PermissionMode;
-    toolsPreset?: ToolsPreset;
+    /** `codemode` 是 `codemode-only` 的别名。 */
+    toolsPreset?: ToolsPresetInput;
     /** 信任项目（项目级 Hook / Skill / 提示模板）。 */
     trust?: boolean;
     sessionDir?: string;
@@ -73,7 +74,8 @@ export interface CreateSessionOptions {
     sessionManager?: SessionManager;
     /** `default`（缺省，按预设）/ `none` / 指定工具全集。 */
     tools?: "default" | "none" | ToolDefinition[];
-    toolsPreset?: ToolsPreset;
+    /** `codemode` 是 `codemode-only` 的别名。 */
+    toolsPreset?: ToolsPresetInput;
     extraTools?: ToolDefinition[];
     disableTools?: string[];
     /** 进系统提示 host 节。 */
@@ -85,6 +87,10 @@ export interface CreateSessionOptions {
         mode?: PermissionMode;
         allow?: string[];
         deny?: string[];
+        /** auto 模式分类器的模型（`provider/model`）；缺省 config `permission.autoModel`，再缺省当前模型。 */
+        autoModel?: string;
+        /** auto 模式安全名单追加（与 config `permission.autoSafeCommands` 合并）。 */
+        autoSafeCommands?: string[];
         /** 审批回调；缺省无人作答 → deny。 */
         ask?(request: ApprovalRequest, signal: AbortSignal): Promise<ApprovalDecision>;
     };

package/dist/sdk.js

@@ -21,6 +21,7 @@ import { pickDefaultModel } from "./cli/default-model.js";
 import { findContextFiles } from "./config/context-files.js";
 import { DEFAULT_CONFIG, mergeConfig } from "./config/merge.js";
 import { resolveConfigDir, resolveDataDir } from "./config/paths.js";
+import { canonicalPreset } from "./config/types.js";
 import { AmaError } from "./errors.js";
 import { hooksFromConfig } from "./hooks/config.js";
 import { HookDispatcher } from "./hooks/dispatcher.js";
@@ -41,7 +42,7 @@ export async function createRuntime(options = {}) {
     if (options.permissionMode !== undefined)
         args.permissionMode = options.permissionMode;
     if (options.toolsPreset !== undefined)
-        args.toolsPreset = options.toolsPreset;
+        args.toolsPreset = canonicalPreset(options.toolsPreset);
     if (options.trust !== undefined)
         args.trust = options.trust;
     if (options.sessionDir !== undefined)
@@ -131,7 +132,14 @@ export async function createAgentSession(options = {}) {
             source: "sdk",
         })),
     ], config.permission?.builtinDeny, warn);
-    const permission = new PermissionPipeline({ mode, rules, cwd });
+    const autoSafeCommands = [
+        ...(config.permission?.autoSafeCommands ?? []),
+        ...(options.permission?.autoSafeCommands ?? []),
+    ];
+    const permission = new PermissionPipeline({ mode, rules, cwd, autoSafeCommands });
+    const autoModel = options.permission?.autoModel;
+    if (autoModel !== undefined)
+        config.permission = { ...config.permission, autoModel };
     const manager = options.sessionManager ?? SessionManager.inMemory(cwd);
     let session;
     const hooks = new HookDispatcher({

package/dist/session/export.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 会话导出（`ama sessions export`）：md（给人读）/ json（结构化）/ jsonl（原格式子集）。[W4-D]
+ *
+ * - 范围：`leaf` = 根 → 当前叶子的分支（同 `/tree` 当前位置），`all` = 文件里全部条目（文件顺序）。
+ * - 三种格式都先脱敏（redact.ts）：json / jsonl 对每个字符串值做（图片 base64 保留），md 对成文做。
+ * - md：用户 / 助手消息、工具调用（参数 JSON 截到 500 字符）与结果（截到 2000 字符）、压缩与分支摘要、
+ *   末尾用量合计；思考块与 system 消息不写；图片写成占位 `[图片 image/png]`。
+ * - jsonl：头 + 所选条目，形状与会话文件相同（可以再被 ama 读），不带 leaf 行。
+ */
+import type { SessionEntry, SessionHeader } from "./types.js";
+export type ExportFormat = "md" | "json" | "jsonl";
+export type ExportBranch = "leaf" | "all";
+export interface ExportInput {
+    header: SessionHeader;
+    entries: readonly SessionEntry[];
+    leaf: string | null;
+}
+export interface UsageTotals {
+    requests: number;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    /** 有价请求的费用；没有有价请求时缺省。 */
+    cost?: number;
+}
+export declare function selectEntries(input: ExportInput, branch: ExportBranch): SessionEntry[];
+export declare function usageTotals(entries: readonly SessionEntry[]): UsageTotals;
+export declare function renderMarkdown(input: ExportInput, branch: ExportBranch): string;
+export declare function renderJson(input: ExportInput, branch: ExportBranch): string;
+export declare function renderJsonl(input: ExportInput, branch: ExportBranch): string;
+export declare function renderExport(input: ExportInput, format: ExportFormat, branch: ExportBranch): string;

package/dist/session/export.js

@@ -0,0 +1,187 @@
+/**
+ * 会话导出（`ama sessions export`）：md（给人读）/ json（结构化）/ jsonl（原格式子集）。[W4-D]
+ *
+ * - 范围：`leaf` = 根 → 当前叶子的分支（同 `/tree` 当前位置），`all` = 文件里全部条目（文件顺序）。
+ * - 三种格式都先脱敏（redact.ts）：json / jsonl 对每个字符串值做（图片 base64 保留），md 对成文做。
+ * - md：用户 / 助手消息、工具调用（参数 JSON 截到 500 字符）与结果（截到 2000 字符）、压缩与分支摘要、
+ *   末尾用量合计；思考块与 system 消息不写；图片写成占位 `[图片 image/png]`。
+ * - jsonl：头 + 所选条目，形状与会话文件相同（可以再被 ama 读），不带 leaf 行。
+ */
+import { contentImages, contentText, numberUserMessages } from "./reuse.js";
+import { redactSecrets, redactValue } from "./redact.js";
+import { indexEntries, pathToRoot } from "./tree.js";
+export function selectEntries(input, branch) {
+    return branch === "all"
+        ? [...input.entries]
+        : pathToRoot(indexEntries(input.entries), input.leaf);
+}
+export function usageTotals(entries) {
+    const totals = { requests: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+    let cost = 0;
+    let costed = 0;
+    const add = (usage) => {
+        if (usage === undefined)
+            return;
+        totals.requests++;
+        totals.input += usage.input;
+        totals.output += usage.output;
+        totals.cacheRead += usage.cacheRead;
+        totals.cacheWrite += usage.cacheWrite;
+        if (usage.cost !== undefined) {
+            cost += usage.cost.total;
+            costed++;
+        }
+    };
+    for (const entry of entries) {
+        if (entry.type === "message" && entry.message.role === "assistant")
+            add(entry.message.usage);
+        else if (entry.type === "usage")
+            add(entry.usage);
+        else if (entry.type === "compaction" || entry.type === "branch_summary")
+            add(entry.usage);
+    }
+    if (costed > 0)
+        totals.cost = cost;
+    return totals;
+}
+function sessionName(entries) {
+    let name;
+    for (const entry of entries)
+        if (entry.type === "session_info")
+            name = entry.name;
+    return name;
+}
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max)}\n…（截断，原长 ${text.length} 字符）` : text;
+}
+function fence(text, lang = "") {
+    let ticks = "```";
+    while (text.includes(ticks))
+        ticks += "`";
+    return `${ticks}${lang}\n${text}\n${ticks}`;
+}
+function time(iso) {
+    return iso.replace("T", " ").replace(/\.\d+Z$|Z$/, "");
+}
+function imagesNote(content) {
+    return contentImages(content)
+        .map((image) => `[图片 ${image.mimeType}]`)
+        .join(" ");
+}
+export function renderMarkdown(input, branch) {
+    const entries = selectEntries(input, branch);
+    const numbers = new Map(numberUserMessages(input.entries).map((u) => [u.entryId, u.n]));
+    const name = sessionName(input.entries);
+    const out = [
+        `# ${name ?? `会话 ${input.header.id.slice(0, 8)}`}`,
+        "",
+        `- id：${input.header.id}`,
+        `- 目录：${input.header.cwd}`,
+        `- 创建：${time(input.header.timestamp)}`,
+        `- 范围：${branch === "all" ? "全部条目" : "当前分支"}（${entries.length} 条条目）`,
+        ...(input.header.parentSession !== undefined
+            ? [`- 来源会话：${input.header.parentSession}`]
+            : []),
+        "",
+    ];
+    for (const entry of entries) {
+        switch (entry.type) {
+            case "message": {
+                const m = entry.message;
+                if (m.role === "user") {
+                    const n = numbers.get(entry.id);
+                    const origin = m.origin;
+                    out.push(`## 用户${n !== undefined ? ` #${n}` : ""}${origin !== undefined ? `（${origin}）` : ""} · ${time(entry.timestamp)}`, "");
+                    const text = contentText(m.content);
+                    if (text !== "")
+                        out.push(text, "");
+                    const images = imagesNote(m.content);
+                    if (images !== "")
+                        out.push(images, "");
+                }
+                else if (m.role === "assistant") {
+                    out.push(`## 助手 · ${m.provider}/${m.model} · ${time(entry.timestamp)}`, "");
+                    for (const block of m.content) {
+                        if (block.type === "text" && block.text.trim() !== "")
+                            out.push(block.text, "");
+                        if (block.type === "toolCall") {
+                            out.push(`**工具调用** \`${block.name}\``, "", fence(truncate(JSON.stringify(block.arguments, null, 2), 500), "json"), "");
+                        }
+                    }
+                    if (m.stopReason === "error" || m.stopReason === "aborted") {
+                        out.push(`> 停止：${m.stopReason}${m.errorMessage !== undefined ? ` · ${m.errorMessage}` : ""}`, "");
+                    }
+                }
+                else if (m.role === "toolResult") {
+                    out.push(`**结果** \`${m.toolName}\`${m.isError ? "（出错）" : ""}`, "", fence(truncate(contentText(m.content), 2000)), "");
+                    const images = imagesNote(m.content);
+                    if (images !== "")
+                        out.push(images, "");
+                }
+                break;
+            }
+            case "compaction":
+                out.push(`## 压缩摘要 · ${time(entry.timestamp)}`, "", entry.summary, "");
+                break;
+            case "branch_summary":
+                out.push(`## 分支摘要 · ${time(entry.timestamp)}`, "", entry.summary, "");
+                break;
+            case "custom_message":
+                if (entry.display) {
+                    out.push(`## ${entry.customType} · ${time(entry.timestamp)}`, "");
+                    out.push(contentText(entry.content), "");
+                }
+                break;
+            case "model_change":
+                out.push(`_切换模型：${entry.provider}/${entry.modelId}${entry.channel !== undefined ? `@${entry.channel}` : ""}_`, "");
+                break;
+            default:
+                break;
+        }
+    }
+    const usage = usageTotals(entries);
+    out.push("## 用量", "", "| 请求 | 输入 | 输出 | 缓存读 | 缓存写 | 费用 |", "| ---: | ---: | ---: | ---: | ---: | ---: |", `| ${usage.requests} | ${usage.input} | ${usage.output} | ${usage.cacheRead} | ${usage.cacheWrite} | ${usage.cost !== undefined ? `$${usage.cost.toFixed(4)}` : "—"} |`, "");
+    return redactSecrets(out.join("\n"));
+}
+export function renderJson(input, branch) {
+    const entries = selectEntries(input, branch);
+    const selected = new Set(entries.map((e) => e.id));
+    const name = sessionName(input.entries);
+    const session = {
+        id: input.header.id,
+        cwd: input.header.cwd,
+        createdAt: input.header.timestamp,
+        agent: input.header.agent,
+    };
+    if (name !== undefined)
+        session["name"] = name;
+    if (input.header.parentSession !== undefined)
+        session["parentSession"] = input.header.parentSession;
+    const doc = {
+        format: "ama.session-export",
+        version: 1,
+        session,
+        branch,
+        leafId: input.leaf,
+        userMessages: numberUserMessages(input.entries)
+            .filter((u) => selected.has(u.entryId))
+            .map((u) => ({ n: u.n, entryId: u.entryId })),
+        usage: usageTotals(entries),
+        entries,
+    };
+    return JSON.stringify(redactValue(doc), null, 2) + "\n";
+}
+export function renderJsonl(input, branch) {
+    const lines = [input.header, ...selectEntries(input, branch)].map((line) => JSON.stringify(redactValue(line)));
+    return lines.join("\n") + "\n";
+}
+export function renderExport(input, format, branch) {
+    switch (format) {
+        case "md":
+            return renderMarkdown(input, branch);
+        case "json":
+            return renderJson(input, branch);
+        case "jsonl":
+            return renderJsonl(input, branch);
+    }
+}

package/dist/session/projection.js

@@ -172,7 +172,11 @@ export function buildContext(branch) {
     let thinkingLevel;
     for (const entry of branch) {
         if (entry.type === "model_change")
-            model = { provider: entry.provider, id: entry.modelId };
+            model = {
+                provider: entry.provider,
+                id: entry.modelId,
+                ...(entry.channel !== undefined ? { channel: entry.channel } : {}),
+            };
         else if (entry.type === "thinking_level_change")
             thinkingLevel = entry.thinkingLevel;
     }

package/dist/session/redact.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 导出前的机密脱敏（`ama sessions export`）。[W4-D]
+ *
+ * 只认「形态」：常见 key / token 前缀（sk-…、sk-ant-…、ghp_…、github_pat_…、xox?-…、AIza…、
+ * AKIA…、npm_…）、JWT、`Bearer` / `Basic` 凭据、PEM 私钥块，以及 `apiKey` / `secret` / `token` /
+ * `password` / `authorization` 之后紧跟 `:` 或 `=` 的值。命中的部分换成 `[REDACTED]`
+ * （键名与 Bearer 之类的前缀保留，便于读者知道那里原来有什么）。宁可多遮，不做熵判断。
+ */
+export declare const REDACTED = "[REDACTED]";
+export declare function redactSecrets(text: string): string;
+/**
+ * 深拷贝并对全部字符串值脱敏；键名像机密（如 `apiKey`、`authToken`）的字符串值整段遮掉；
+ * 图片块的 base64 `data` 原样保留（不会是机密，替换会弄坏图片）。
+ */
+export declare function redactValue<T>(value: T): T;

package/dist/session/redact.js

@@ -0,0 +1,55 @@
+/**
+ * 导出前的机密脱敏（`ama sessions export`）。[W4-D]
+ *
+ * 只认「形态」：常见 key / token 前缀（sk-…、sk-ant-…、ghp_…、github_pat_…、xox?-…、AIza…、
+ * AKIA…、npm_…）、JWT、`Bearer` / `Basic` 凭据、PEM 私钥块，以及 `apiKey` / `secret` / `token` /
+ * `password` / `authorization` 之后紧跟 `:` 或 `=` 的值。命中的部分换成 `[REDACTED]`
+ * （键名与 Bearer 之类的前缀保留，便于读者知道那里原来有什么）。宁可多遮，不做熵判断。
+ */
+export const REDACTED = "[REDACTED]";
+const TOKEN_PATTERNS = [
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
+    /\bsk-[A-Za-z0-9_-]{16,}/g,
+    /\b(?:gh[pousr]_[A-Za-z0-9]{20,}|github_pat_[A-Za-z0-9_]{20,})/g,
+    /\bxox[abprs]-[A-Za-z0-9-]{10,}/g,
+    /\bAIza[0-9A-Za-z_-]{30,}/g,
+    /\bAKIA[0-9A-Z]{16}\b/g,
+    /\bnpm_[A-Za-z0-9]{30,}/g,
+    /\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}/g,
+];
+const SCHEME = /\b(Bearer|Basic)(\s+)[A-Za-z0-9._~+/=-]{12,}/g;
+const ASSIGNMENT = /\b([A-Za-z0-9_-]*(?:api[_-]?key|apikey|secret|token|password|passwd|authorization))(["']?\s*[:=]\s*["']?)([^\s"',;}{)]{8,})/gi;
+export function redactSecrets(text) {
+    let out = text;
+    for (const pattern of TOKEN_PATTERNS)
+        out = out.replace(pattern, REDACTED);
+    out = out.replace(SCHEME, (_m, scheme, space) => `${scheme}${space}${REDACTED}`);
+    out = out.replace(ASSIGNMENT, (match, key, sep, value) => value === REDACTED || value.startsWith(REDACTED) ? match : `${key}${sep}${REDACTED}`);
+    return out;
+}
+const SECRET_KEY = /(?:api[_-]?key|apikey|secret|token|password|passwd|authorization)$/i;
+/**
+ * 深拷贝并对全部字符串值脱敏；键名像机密（如 `apiKey`、`authToken`）的字符串值整段遮掉；
+ * 图片块的 base64 `data` 原样保留（不会是机密，替换会弄坏图片）。
+ */
+export function redactValue(value) {
+    if (typeof value === "string")
+        return redactSecrets(value);
+    if (Array.isArray(value))
+        return value.map((item) => redactValue(item));
+    if (typeof value === "object" && value !== null) {
+        const record = value;
+        const image = record["type"] === "image";
+        const out = {};
+        for (const [key, item] of Object.entries(record)) {
+            if (image && key === "data")
+                out[key] = item;
+            else if (typeof item === "string" && item.length >= 8 && SECRET_KEY.test(key))
+                out[key] = REDACTED;
+            else
+                out[key] = redactValue(item);
+        }
+        return out;
+    }
+    return value;
+}

package/dist/session/reuse.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 会话复用：用户消息编号与 `--from <id>[#n]`。[W4-D]
+ *
+ * - 编号 = 文件里第几条 `role: "user"` 的消息（1 起，含 steer / followUp / host 注入），与分支无关、
+ *   只追加所以稳定；`ama sessions show` 列出，`ama sessions search` 的命中也给出同样的编号。
+ * - `--from <id>`（不带 `#n`）取文件里最后一条用户消息。
+ * - 取出的是那条消息的文本（多个文本块用空行连接）与图片块。
+ */
+import type { ImageBlock } from "../ai/types.js";
+import type { SessionEntry } from "./types.js";
+export interface NumberedUserMessage {
+    n: number;
+    entryId: string;
+    timestamp: string;
+    text: string;
+    images: ImageBlock[];
+    origin?: string;
+}
+/** 内容 → 纯文本（文本块用空行连接；不含图片）。 */
+export declare function contentText(content: unknown): string;
+export declare function contentImages(content: unknown): ImageBlock[];
+export declare function numberUserMessages(entries: readonly SessionEntry[]): NumberedUserMessage[];
+/** `abc123#4` → `{ id: "abc123", n: 4 }`；`abc123` → `{ id }`。 */
+export declare function parseFromSpec(spec: string): {
+    id: string;
+    n?: number;
+};
+export interface FromMessage extends NumberedUserMessage {
+    sessionId: string;
+    file: string;
+}
+/** 在会话目录里找 `--from` 指向的用户消息；找不到会话 → session_not_found，编号越界 → 用法错误。 */
+export declare function resolveFromMessage(root: string, spec: string, cwd?: string): FromMessage;