@armadra/agent 0.7.5 → 0.8.0

package/dist/i18n/messages/auth.d.ts

@@ -52,6 +52,7 @@ export declare const en: {
     };
     request: {
         notEligible: string;
+        modelUnavailable: (model: string) => string;
         flavorMismatch: (current: string, ref: string, pinned: string) => string;
     };
     errors: {
@@ -150,6 +151,7 @@ export declare const zh: {
     };
     request: {
         notEligible: string;
+        modelUnavailable: (model: string) => string;
         flavorMismatch: (current: string, ref: string, pinned: string) => string;
     };
     errors: {

package/dist/i18n/messages/auth.js

@@ -57,6 +57,7 @@ export const en = {
             "  2. Workspace account: Team / Enterprise / Edu workspaces may not offer it\n" +
             "  3. Region restriction, or not yet rolled out during the preview (most likely when a Pro account still gets this error)\n" +
             "You can sign in the other way instead: ama auth login chatgpt --flavor codex",
+        modelUnavailable: (model) => `${model} is not available to this ChatGPT account (400 from the codex backend). The backend's model list changes over time: run ama models discover chatgpt to refresh it, then pick a listed model with /model or --model`,
         flavorMismatch: (current, ref, pinned) => `signed in with ${current}, but ${ref} pins the @${pinned} channel. Drop @${pinned} so the channel follows the sign-in, or run ama auth login chatgpt --flavor ${pinned}`,
     },
     errors: {
@@ -166,6 +167,7 @@ export const zh = {
             "  2. 工作空间账户：Team / Enterprise / Edu 工作空间可能未开放\n" +
             "  3. 地区受限，或预览期尚未开放（Pro 账户仍报此错时最可能是这一条）\n" +
             "可以改用另一种登录方式：ama auth login chatgpt --flavor codex",
+        modelUnavailable: (model) => `${model} 在这个 ChatGPT 账户下不可用（codex 后端回 400）。后端的模型表会变化：运行 ama models discover chatgpt 刷新，再用 /model 或 --model 选表里的模型`,
         flavorMismatch: (current, ref, pinned) => `当前以 ${current} 方式登录，但 ${ref} 显式指定了 @${pinned} 渠道。去掉 @${pinned} 让渠道跟随登录方式，或运行 ama auth login chatgpt --flavor ${pinned}`,
     },
     errors: {

package/dist/i18n/messages/config-keys.d.ts

@@ -115,6 +115,7 @@ export declare const en: {
         "subagents.maxPending": string;
         "subagents.retainSessions": string;
         "subagents.defaultModel": string;
+        "subagents.forkMaxContextRatio": string;
         "subagents.background": string;
         "subagents.autoBackgroundAfterMs": string;
         models: string;
@@ -269,6 +270,7 @@ export declare const zh: {
         "subagents.maxPending": string;
         "subagents.retainSessions": string;
         "subagents.defaultModel": string;
+        "subagents.forkMaxContextRatio": string;
         "subagents.background": string;
         "subagents.autoBackgroundAfterMs": string;
         models: string;

package/dist/i18n/messages/config-keys.js

@@ -164,6 +164,7 @@ const keysEn = {
     "subagents.maxPending": "Queue limit; task fails beyond it",
     "subagents.retainSessions": "Finished sub-sessions kept in memory (least recently used first out); others reopen from their session file when continued",
     "subagents.defaultModel": "Default sub-session model provider/model[@channel]",
+    "subagents.forkMaxContextRatio": "Fork sub-agents fall back to fresh when the parent's last request used more than this share of (window − compaction.reserveTokens); 0.05–0.95, default 0.5",
     "subagents.background": "Whether task runs in the background by default: auto = background in the TUI / RPC / ACP and foreground with -p; always / never are fixed. The call argument and the agent type's background: override it; user, project and host level",
     "subagents.autoBackgroundAfterMs": "Move a foreground task to the background after it has run this many milliseconds; 0 disables; user and project level",
     models: "Model aliases and the model picker list; user level only (effective from wave 5 W5-G)",
@@ -292,6 +293,7 @@ const keysZh = {
     "subagents.maxPending": "排队上限，超出时 task 报错",
     "subagents.retainSessions": "内存中保留的已结束子会话数（最久未用的先释放），其余续聊时从会话文件重开",
     "subagents.defaultModel": "子会话缺省模型 provider/model[@channel]",
+    "subagents.forkMaxContextRatio": "fork 子 Agent 的回落比例：父上一次请求超过（窗口 − compaction.reserveTokens）的这一比例时改为 fresh；0.05–0.95，缺省 0.5",
     "subagents.background": "task 缺省是否后台：auto = TUI / RPC / ACP 下后台、-p 下前台；always / never 固定。调用参数与类型定义的 background: 优先；用户、项目、宿主级都认",
     "subagents.autoBackgroundAfterMs": "前台任务运行超过该毫秒数自动转后台；0 关闭；用户、项目级都认",
     models: "模型别名与模型选择器清单；只认用户级（第五波 W5-G 起生效）",

package/dist/i18n/messages/config.d.ts

@@ -115,6 +115,7 @@ export declare const en: {
         "subagents.maxPending": string;
         "subagents.retainSessions": string;
         "subagents.defaultModel": string;
+        "subagents.forkMaxContextRatio": string;
         "subagents.background": string;
         "subagents.autoBackgroundAfterMs": string;
         models: string;
@@ -383,6 +384,7 @@ export declare const zh: {
         "subagents.maxPending": string;
         "subagents.retainSessions": string;
         "subagents.defaultModel": string;
+        "subagents.forkMaxContextRatio": string;
         "subagents.background": string;
         "subagents.autoBackgroundAfterMs": string;
         models: string;

package/dist/i18n/messages/drivers.d.ts

@@ -18,6 +18,7 @@ export declare const en: {
         resumeUnsupported: (agent: string) => string;
         resumeNotFound: (agent: string, id: string) => string;
         noMatchingMode: (agent: string, mode: string) => string;
+        noMatchingModel: (agent: string, model: string) => string;
         noImages: (agent: string) => string;
         noImagesDriver: (agent: string) => string;
         noImagesOneshot: (agent: string) => string;
@@ -28,6 +29,7 @@ export declare const en: {
         error: (agent: string, message: string, retrying: boolean) => string;
         askedQuestion: (agent: string, tool: string) => string;
         askedQuestionCodex: (agent: string) => string;
+        extensionDialog: (agent: string, title: string) => string;
         mcpElicitation: (agent: string) => string;
     };
     /** Hook 配置与输出的警告（给人看；回给模型的阻止理由固定英文）。 */
@@ -76,6 +78,7 @@ export declare const zh: {
         resumeUnsupported: (agent: string) => string;
         resumeNotFound: (agent: string, id: string) => string;
         noMatchingMode: (agent: string, mode: string) => string;
+        noMatchingModel: (agent: string, model: string) => string;
         noImages: (agent: string) => string;
         noImagesDriver: (agent: string) => string;
         noImagesOneshot: (agent: string) => string;
@@ -86,6 +89,7 @@ export declare const zh: {
         error: (agent: string, message: string, retrying: boolean) => string;
         askedQuestion: (agent: string, tool: string) => string;
         askedQuestionCodex: (agent: string) => string;
+        extensionDialog: (agent: string, title: string) => string;
         mcpElicitation: (agent: string) => string;
     };
     hooks: {

package/dist/i18n/messages/drivers.js

@@ -19,6 +19,7 @@ export const en = {
         resumeUnsupported: (agent) => `${agent} cannot resume sessions; started a new one`,
         resumeNotFound: (agent, id) => `${agent} cannot find session ${id}; started a new one`,
         noMatchingMode: (agent, mode) => `${agent} has no "${mode}" mode; running in its own default mode (actions that need approval still come to you)`,
+        noMatchingModel: (agent, model) => `${agent} does not offer model "${model}"; using its own default model`,
         noImages: (agent) => `${agent} does not accept images; omitted`,
         noImagesDriver: (agent) => `the ${agent} driver does not pass images yet; omitted`,
         noImagesOneshot: (agent) => `${agent} one-shot mode does not pass images; omitted`,
@@ -29,6 +30,7 @@ export const en = {
         error: (agent, message, retrying) => `${agent}: ${message}${retrying ? " (retrying)" : ""}`,
         askedQuestion: (agent, tool) => `${agent} wants to ask you a question (${tool}); ama does not answer for you and asked it to put the question in its final reply`,
         askedQuestionCodex: (agent) => `${agent} wants to ask you a question; ama does not answer for you — have it put the question in its final reply`,
+        extensionDialog: (agent, title) => `${agent}: an extension asked for input (${title}); ama does not answer for you, cancelled`,
         mcpElicitation: (agent) => `${agent}'s MCP server asked for input; ama does not answer for you, cancelled`,
     },
     /** Hook 配置与输出的警告（给人看；回给模型的阻止理由固定英文）。 */
@@ -77,6 +79,7 @@ export const zh = {
         resumeUnsupported: (agent) => `${agent} 不支持续接会话，已新开`,
         resumeNotFound: (agent, id) => `${agent} 找不到会话 ${id}，已新开`,
         noMatchingMode: (agent, mode) => `${agent} 没有「${mode}」模式，按它自己的缺省模式运行（需要授权的操作仍交给你）`,
+        noMatchingModel: (agent, model) => `${agent} 没有模型「${model}」，按它自己的缺省模型运行`,
         noImages: (agent) => `${agent} 不接受图片，已省略`,
         noImagesDriver: (agent) => `${agent} 驱动暂不传图片，已省略`,
         noImagesOneshot: (agent) => `${agent} 一次性模式不传图片，已省略`,
@@ -87,6 +90,7 @@ export const zh = {
         error: (agent, message, retrying) => `${agent}：${message}${retrying ? "（重试中）" : ""}`,
         askedQuestion: (agent, tool) => `${agent} 想向你提问（${tool}）；ama 不代答，已请它把问题写进最终回复`,
         askedQuestionCodex: (agent) => `${agent} 想向你提问；ama 不代答，请让它把问题写进最终回复`,
+        extensionDialog: (agent, title) => `${agent}：扩展请求输入（${title}）；ama 不代答，已取消`,
         mcpElicitation: (agent) => `${agent} 的 MCP 服务器请求输入；ama 不代答，已取消`,
     },
     hooks: {

package/dist/i18n/messages/interactive.d.ts

@@ -85,6 +85,7 @@ export declare const en: {
         backgroundStopped: (jobId: string, command: string) => string;
         compactionFailed: (error: string) => string;
         compactionCancelled: string;
+        imageReadBackFailed: (id: string) => string;
     };
     statusLine: {
         usage: string;
@@ -335,6 +336,7 @@ export declare const zh: {
         backgroundStopped: (jobId: string, command: string) => string;
         compactionFailed: (error: string) => string;
         compactionCancelled: string;
+        imageReadBackFailed: (id: string) => string;
     };
     statusLine: {
         usage: string;

package/dist/i18n/messages/interactive.js

@@ -99,6 +99,7 @@ export const en = {
         backgroundStopped: (jobId, command) => `Background command ${jobId} stopped: ${command}`,
         compactionFailed: (error) => `Compaction failed: ${error}`,
         compactionCancelled: "Compaction cancelled",
+        imageReadBackFailed: (id) => `Session image for entry ${id} could not be read back (file changed); it stays empty`,
     },
     statusLine: {
         usage: "Usage: /statusline [full|compact]",
@@ -234,6 +235,7 @@ export const zh = {
         backgroundStopped: (jobId, command) => `后台命令 ${jobId} 已停止：${command}`,
         compactionFailed: (error) => `压缩失败：${error}`,
         compactionCancelled: "压缩已取消",
+        imageReadBackFailed: (id) => `会话文件已改变，条目 ${id} 的图片读不回，保留为空`,
     },
     statusLine: {
         usage: "用法：/statusline [full|compact]",

package/dist/i18n/messages/session.js

@@ -88,7 +88,7 @@ export const en = {
         cwdIsHome: "the working directory is the home directory",
         gitNotFound: "git not found",
         tooManyFiles: (files, max) => `the working directory has ${plural(files, "file")} (limit ${max})`,
-        tooSlow: (seconds, max) => `the snapshot took ${seconds} s (limit ${max} s)`,
+        tooSlow: (seconds, max) => `snapshots took longer than ${max} s twice in a row (latest ${seconds} s)`,
         gitFailed: (command, code, detail) => `git ${command} failed (${code})${detail === "" ? "" : `: ${detail}`}`,
         noShadowCommit: "the checkpoint has no shadow commit",
         shadowCommitMissing: (commit) => `shadow commit ${commit} does not exist`,
@@ -211,7 +211,7 @@ export const zh = {
         cwdIsHome: "工作目录是家目录",
         gitNotFound: "找不到 git",
         tooManyFiles: (files, max) => `工作目录有 ${files} 个文件（上限 ${max}）`,
-        tooSlow: (seconds, max) => `快照用了 ${seconds} 秒（上限 ${max} 秒）`,
+        tooSlow: (seconds, max) => `连续两次快照超过 ${max} 秒（最近一次 ${seconds} 秒）`,
         gitFailed: (command, code, detail) => `git ${command} 失败（${code}）${detail === "" ? "" : `：${detail}`}`,
         noShadowCommit: "检查点没有影子提交",
         shadowCommitMissing: (commit) => `影子提交 ${commit} 不存在`,

package/dist/modes/interactive/agent-ui.js

@@ -45,6 +45,8 @@ export function agentCommandHooks(get) {
     };
 }
 const TASK_NOTICE = /^\[task (t\d+)\] ([\s\S]*)$/;
+/** #183：会话图片读不回（`ImageOffload` 的告警）转通知区。 */
+const SESSION_NOTICE = /^cannot read session entry (\S+) back from /;
 export class AgentUi {
     deps;
     plan;
@@ -164,6 +166,11 @@ export class AgentUi {
                 this.deps.notice(level === "warn" ? "warn" : "info", `[${agent} · ${taskId}] ${match[2]}`);
                 return;
             }
+            const image = level === "warn" ? SESSION_NOTICE.exec(message) : null;
+            if (image !== null) {
+                this.deps.notice("warn", msg().interactive.events.imageReadBackFailed(image[1]));
+                return;
+            }
             original?.call(holder, level, message);
         };
         holder.log = routed;

package/dist/session/manager.d.ts

@@ -37,7 +37,7 @@ export declare class SessionManager implements SessionManagerApi {
     private closed;
     private readonly now;
     private readonly images;
-    private readonly warn;
+    private warn;
     /** 已知的会话文件字节数（新行的行首偏移）。 */
     private fileBytes;
     private constructor();
@@ -65,6 +65,8 @@ export declare class SessionManager implements SessionManagerApi {
     private syncImages;
     /** 原文条目（已卸载的从文件回读一份副本）。 */
     private original;
+    /** 接上（或换掉）告警出口（图片读不回等）；`open()` 期间缓冲的告警随即按序冲出（#183）。 */
+    setWarn(warn: (message: string) => void): void;
     /** 已卸载图片的条目数（测试与诊断用）。 */
     offloadedCount(): number;
     private leafLine;

package/dist/session/manager.js

@@ -182,6 +182,11 @@ export class SessionManager {
             return entry;
         return this.images.original(this.storage.file, entry);
     }
+    /** 接上（或换掉）告警出口（图片读不回等）；`open()` 期间缓冲的告警随即按序冲出（#183）。 */
+    setWarn(warn) {
+        this.warn = warn;
+        this.images.setWarn(warn);
+    }
     /** 已卸载图片的条目数（测试与诊断用）。 */
     offloadedCount() {
         return this.images.size;

package/dist/session/offload.d.ts

@@ -10,7 +10,8 @@
  *   `content` 换新数组，image 块换成 `data: ""` 的占位；
  * - 回读：按行位置 `readSync` 一行、`JSON.parse`，校验 id 与内容块数，图片经 `internImage` 驻留后
  *   **就地**放回占位所在的数组（之前拿到同一消息对象的调用方随之看到原图）；读不回（文件被外部改写）时
- *   保留 `""` 并告警，不再重试；
+ *   保留 `""` 并告警，不再重试；告警通道可后接（`setWarn`）：接上之前的告警先缓冲（最多
+ *   `PENDING_WARNINGS` 条，其余折叠成一条计数），接上时按序冲出（#183）；
  * - `original(entry)`：给 `getEntries` / `fork` 的原文副本，不改内存状态。
  */
 import type { SessionEntry } from "./types.js";
@@ -25,12 +26,18 @@ export declare function hasImages(entry: SessionEntry): boolean;
 export declare function readLineAt(file: string, locator: LineLocator): unknown;
 /** 文件里全部 `context_edit` 的目标 id（只解析 context_edit 行；读不了时为空集）。 */
 export declare function editTargets(file: string): Set<string>;
+/** 告警通道接上之前最多缓冲的条数；超出的只计数，冲出时折叠成一条。 */
+export declare const PENDING_WARNINGS = 16;
 export declare class ImageOffload {
-    private readonly warn;
     /** 含图 message 条目的行位置（只有已落盘的条目才有）。 */
     private readonly locators;
     private readonly offloaded;
+    private warn;
+    private readonly pending;
+    private dropped;
     constructor(warn?: (message: string) => void);
+    /** 接上（或换掉）告警通道；之前缓冲的告警按序冲出。 */
+    setWarn(warn: (message: string) => void): void;
     /** 记下条目的行位置；不含图片的条目忽略。 */
     track(entry: SessionEntry, locator: LineLocator): void;
     /** 读文件时逐行调用：记下行位置；`strip` 时就地换成占位（刚解析的对象，别处没有引用）。 */
@@ -48,4 +55,5 @@ export declare class ImageOffload {
     sync(file: string, branch: readonly SessionEntry[], index: ReadonlyMap<string, SessionEntry>): void;
     /** 从文件读回条目（新对象）；不成功时告警、忘掉行位置并返回 undefined。 */
     private read;
+    private report;
 }

package/dist/session/offload.js

@@ -10,7 +10,8 @@
  *   `content` 换新数组，image 块换成 `data: ""` 的占位；
  * - 回读：按行位置 `readSync` 一行、`JSON.parse`，校验 id 与内容块数，图片经 `internImage` 驻留后
  *   **就地**放回占位所在的数组（之前拿到同一消息对象的调用方随之看到原图）；读不回（文件被外部改写）时
- *   保留 `""` 并告警，不再重试；
+ *   保留 `""` 并告警，不再重试；告警通道可后接（`setWarn`）：接上之前的告警先缓冲（最多
+ *   `PENDING_WARNINGS` 条，其余折叠成一条计数），接上时按序冲出（#183）；
  * - `original(entry)`：给 `getEntries` / `fork` 的原文副本，不改内存状态。
  */
 import { closeSync, openSync, readSync } from "node:fs";
@@ -74,14 +75,28 @@ export function editTargets(file) {
     return targets;
 }
 const placeholder = (block) => ({ ...block, data: "" });
+/** 告警通道接上之前最多缓冲的条数；超出的只计数，冲出时折叠成一条。 */
+export const PENDING_WARNINGS = 16;
 export class ImageOffload {
-    warn;
     /** 含图 message 条目的行位置（只有已落盘的条目才有）。 */
     locators = new Map();
     offloaded = new Set();
-    constructor(warn = () => { }) {
+    warn;
+    pending = [];
+    dropped = 0;
+    constructor(warn) {
         this.warn = warn;
     }
+    /** 接上（或换掉）告警通道；之前缓冲的告警按序冲出。 */
+    setWarn(warn) {
+        this.warn = warn;
+        const pending = this.pending.splice(0);
+        if (this.dropped > 0)
+            pending.push(`and ${this.dropped} more session entries could not be read back`);
+        this.dropped = 0;
+        for (const message of pending)
+            warn(message);
+    }
     /** 记下条目的行位置；不含图片的条目忽略。 */
     track(entry, locator) {
         if (hasImages(entry))
@@ -188,8 +203,16 @@ export class ImageOffload {
         catch (error) {
             this.locators.delete(entry.id);
             this.offloaded.delete(entry.id);
-            this.warn(`cannot read session entry ${entry.id} back from ${file}: ${String(error)}`);
+            this.report(`cannot read session entry ${entry.id} back from ${file}: ${String(error)}`);
             return undefined;
         }
     }
+    report(message) {
+        if (this.warn !== undefined)
+            this.warn(message);
+        else if (this.pending.length < PENDING_WARNINGS)
+            this.pending.push(message);
+        else
+            this.dropped++;
+    }
 }

package/dist/tools/background-jobs.d.ts

@@ -5,14 +5,14 @@
  *   这里只拿到 ChildProcess；stdout / stderr 直接写进 `outputPath`（文件描述符交给子进程，ama 退出也不
  *   会因管道断开而 SIGPIPE）。POSIX 自成进程组并登记（进程退出时同步 SIGKILL 残留组）。
  * - `wait(id, timeoutMs)`：等到退出或超时；`stop(id)`：杀整棵树（SIGTERM → 宽限 → SIGKILL）；
- *   `output(id)`：读输出文件尾部（2000 行 / 50 KB）。
+ *   `output(id, options?)`：读输出文件尾部（缺省 2000 行 / 50 KB，调用方可传字节上限）。
  * - 生命周期事件经 `onChange` 发出（started / exited / stopped）；`takeExited()` 取走尚未通知的已退出
  *   任务（提醒通道 reminders.ts 据此告诉模型「后台命令 jobId 已退出（码 N）」）。
  * - 按会话 id 登记（`jobsForSession`）；`disposeSessionJobs` 在会话 dispose 时回收进程树。
  */
 import type { ChildProcess } from "node:child_process";
 import { type ProcessDeps } from "./process-tree.js";
-import { type TruncateResult } from "./truncate.js";
+import { type TruncateOptions, type TruncateResult } from "./truncate.js";
 export type JobStatus = "running" | "exited" | "stopped";
 export interface Job {
     id: string;
@@ -49,8 +49,8 @@ export declare class BackgroundJobs {
     /** 等到退出或超时（`signal` 可提前结束等待，不杀进程）。 */
     wait(id: string, timeoutMs: number, signal?: AbortSignal): Promise<Job | undefined>;
     stop(id: string): Promise<Job | undefined>;
-    /** 输出文件尾部（2000 行 / 50 KB）。 */
-    output(id: string): (TruncateResult & {
+    /** 输出文件尾部（缺省 2000 行 / 50 KB；调用方可传字节上限，#155）。 */
+    output(id: string, options?: TruncateOptions): (TruncateResult & {
         job: Job;
     }) | undefined;
     /** 取走已退出、尚未通知的任务（提醒通道用；wait 已看到退出的也算已知）。 */

package/dist/tools/background-jobs.js

@@ -5,7 +5,7 @@
  *   这里只拿到 ChildProcess；stdout / stderr 直接写进 `outputPath`（文件描述符交给子进程，ama 退出也不
  *   会因管道断开而 SIGPIPE）。POSIX 自成进程组并登记（进程退出时同步 SIGKILL 残留组）。
  * - `wait(id, timeoutMs)`：等到退出或超时；`stop(id)`：杀整棵树（SIGTERM → 宽限 → SIGKILL）；
- *   `output(id)`：读输出文件尾部（2000 行 / 50 KB）。
+ *   `output(id, options?)`：读输出文件尾部（缺省 2000 行 / 50 KB，调用方可传字节上限）。
  * - 生命周期事件经 `onChange` 发出（started / exited / stopped）；`takeExited()` 取走尚未通知的已退出
  *   任务（提醒通道 reminders.ts 据此告诉模型「后台命令 jobId 已退出（码 N）」）。
  * - 按会话 id 登记（`jobsForSession`）；`disposeSessionJobs` 在会话 dispose 时回收进程树。
@@ -119,8 +119,8 @@ export class BackgroundJobs {
         await entry.done;
         return entry.job;
     }
-    /** 输出文件尾部（2000 行 / 50 KB）。 */
-    output(id) {
+    /** 输出文件尾部（缺省 2000 行 / 50 KB；调用方可传字节上限，#155）。 */
+    output(id, options = {}) {
         const entry = this.entries.get(id);
         if (entry === undefined)
             return undefined;
@@ -132,7 +132,7 @@ export class BackgroundJobs {
         catch {
             // 输出文件被删：按空输出
         }
-        return { ...truncateTail(text), job: entry.job };
+        return { ...truncateTail(text, options), job: entry.job };
     }
     /** 取走已退出、尚未通知的任务（提醒通道用；wait 已看到退出的也算已知）。 */
     takeExited() {

package/dist/tools/bash.d.ts

@@ -9,7 +9,8 @@
  * - 注入 `AMA_*` 环境变量（shell.ts）。shell 退出后不等仍占着管道的后台进程。
  * - [W5-H2] 后台命令（§8.3 H6，不加新工具）：`{ command, background: true }` 立即返回
  *   `{ jobId, outputPath, pid }`；`{ job, action: "wait" | "output" | "stop" }` 查询 / 结束
- *   （background-jobs.ts，按会话登记，会话 dispose 时回收进程树；退出经提醒通道通知）。
+ *   （background-jobs.ts，按会话登记，会话 dispose 时回收进程树；退出经提醒通道通知）。查询输出同样按
+ *   会话结果上限尾截断（#155）。
  * - **进程只在 `spawnShell` 里创建**（前台与后台共用）。[S2] `sandbox.bash: auto` 且有能限制写入的
  *   OS 沙箱时在这一处包一层（src/sandbox/bash.ts）；`sandbox: false` 不包装（权限管线照常审批）。
  *   失败输出像是被沙箱拒绝时末尾追加一行说明。

package/dist/tools/bash.js

@@ -9,7 +9,8 @@
  * - 注入 `AMA_*` 环境变量（shell.ts）。shell 退出后不等仍占着管道的后台进程。
  * - [W5-H2] 后台命令（§8.3 H6，不加新工具）：`{ command, background: true }` 立即返回
  *   `{ jobId, outputPath, pid }`；`{ job, action: "wait" | "output" | "stop" }` 查询 / 结束
- *   （background-jobs.ts，按会话登记，会话 dispose 时回收进程树；退出经提醒通道通知）。
+ *   （background-jobs.ts，按会话登记，会话 dispose 时回收进程树；退出经提醒通道通知）。查询输出同样按
+ *   会话结果上限尾截断（#155）。
  * - **进程只在 `spawnShell` 里创建**（前台与后台共用）。[S2] `sandbox.bash: auto` 且有能限制写入的
  *   OS 沙箱时在这一处包一层（src/sandbox/bash.ts）；`sandbox: false` 不包装（权限管线照常审批）。
  *   失败输出像是被沙箱拒绝时末尾追加一行说明。
@@ -304,7 +305,7 @@ async function jobAction(input, ctx, options) {
     }
     if (action === "stop") {
         const job = (await jobs.stop(id));
-        const out = jobs.output(id);
+        const out = jobs.output(id, { maxBytes: toolOutputBytes(ctx.maxResultChars) });
         const text = out?.content ?? "";
         return {
             content: `${text === "" ? "(no output)" : text}\n\n${jobStatusLine(job)}`,
@@ -317,7 +318,7 @@ async function jobAction(input, ctx, options) {
             return fail(`timeoutMs must be between 1 and ${MAX_BASH_TIMEOUT_MS}`);
         await jobs.wait(id, waitMs, ctx.signal);
     }
-    const out = jobs.output(id);
+    const out = jobs.output(id, { maxBytes: toolOutputBytes(ctx.maxResultChars) });
     if (out === undefined)
         return fail(`Unknown background job ${id}`);
     const job = out.job;

package/dist/tools/task-ctl.js

@@ -12,6 +12,7 @@
  */
 import { capTaskText, formatTokens, waitDetachedText } from "../agents/result.js";
 import { taskControl } from "../agents/task-control.js";
+import { nestedTaskRejection } from "./task.js";
 export const TASK_CTL_TOOL = "task_ctl";
 export const DEFAULT_WAIT_MS = 30_000;
 export const MAX_WAIT_MS = 600_000;
@@ -66,7 +67,7 @@ export function createTaskCtlTool() {
         annotations: { pollable: true },
         async execute(input, ctx) {
             if (ctx.depth >= 1)
-                return fail("task_ctl is not available inside a sub-agent.");
+                return fail(nestedTaskRejection(ctx, "task_ctl", "task_ctl is not available inside a sub-agent."));
             const control = taskControl(ctx.sessionId);
             if (input.action === "list") {
                 const tasks = control?.list() ?? ctx.tasks?.list() ?? [];

package/dist/tools/task.d.ts

@@ -20,6 +20,15 @@ import type { ModelThinkingLevel } from "../ai/types.js";
 import { AgentCatalog } from "../agents/catalog.js";
 import type { SubagentRequest, ToolContext, ToolDefinition } from "./types.js";
 export declare const MAX_TASK_DEPTH = 1;
+/** <task> 指令首个非空行，超长截断（#191：fork 子会话被拒时提醒模型回到子任务）。 */
+export declare function taskLine(prompt: string): string;
+/** fork 子会话的标记条目（custom，不进上下文）：`{ taskLine }`。 */
+export declare const FORK_CUSTOM_TYPE = "ama.fork";
+/**
+ * 子会话里 task / task_ctl 的拒绝文案（固定英文）。#191：fork 子会话（有 `ama.fork` 条目）说明身份并
+ * 附 <task> 首行；其它情况用 `fallback`（fresh 按深度拒绝的原文案）。
+ */
+export declare function nestedTaskRejection(ctx: ToolContext, tool: string, fallback: string): string;
 export declare const DEFAULT_TASK_MAX_TURNS = 30;
 export interface TaskInput {
     prompt: string;

package/dist/tools/task.js

@@ -19,6 +19,32 @@
 import { AgentCatalog } from "../agents/catalog.js";
 import { TASK_NOTIFICATION_RULE } from "../agents/result.js";
 export const MAX_TASK_DEPTH = 1;
+/** fork 子会话首条 custom 条目里 <task> 指令首行摘要的上限（字符）。 */
+const TASK_LINE_MAX = 120;
+/** <task> 指令首个非空行，超长截断（#191：fork 子会话被拒时提醒模型回到子任务）。 */
+export function taskLine(prompt) {
+    const line = prompt
+        .split("\n")
+        .find((text) => text.trim() !== "")
+        ?.trim() ?? "";
+    return line.length > TASK_LINE_MAX ? `${line.slice(0, TASK_LINE_MAX - 1)}…` : line;
+}
+/** fork 子会话的标记条目（custom，不进上下文）：`{ taskLine }`。 */
+export const FORK_CUSTOM_TYPE = "ama.fork";
+/**
+ * 子会话里 task / task_ctl 的拒绝文案（固定英文）。#191：fork 子会话（有 `ama.fork` 条目）说明身份并
+ * 附 <task> 首行；其它情况用 `fallback`（fresh 按深度拒绝的原文案）。
+ */
+export function nestedTaskRejection(ctx, tool, fallback) {
+    const mark = ctx.session.lastCustom(FORK_CUSTOM_TYPE);
+    if (mark === undefined || mark === null)
+        return fallback;
+    const line = typeof mark.taskLine === "string" ? mark.taskLine : "";
+    return (`${tool} rejected: you are a sub-agent forked from the main conversation and cannot start ` +
+        "or manage sub-agents. Do not call task or task_ctl again; complete the sub-task in your " +
+        "<task> block yourself with your other tools, then end with your report." +
+        (line !== "" ? ` Your task begins: "${line}"` : ""));
+}
 export const DEFAULT_TASK_MAX_TURNS = 30;
 const THINKING = [
     "off",
@@ -143,7 +169,7 @@ export function createTaskTool(_options = {}) {
         promptGuidelines: [TASK_NOTIFICATION_RULE],
         async execute(input, ctx) {
             if (ctx.depth >= MAX_TASK_DEPTH || ctx.spawnSubagent === undefined) {
-                return fail("Sub-agents are not available here (nested tasks are not allowed).");
+                return fail(nestedTaskRejection(ctx, "task", "Sub-agents are not available here (nested tasks are not allowed)."));
             }
             const request = buildSubagentRequest(input, ctx);
             if (typeof request === "string")