@ganglion/xacpx 0.24.0 → 0.24.1-beta.0

package/dist/bridge/bridge-main.js

@@ -4381,9 +4381,9 @@ var init_recovery = __esm(() => {
     sessionInterrupted: (alias) => `Session "${alias}" was interrupted; no final reply received.`,
     sessionInterruptedHint: "Retry directly. If the session remains unresponsive, send /cancel first, then retry.",
     sessionInterruptedError: (summary) => `Error: ${summary}`,
-    queueOverflowWarning: "⚠️ Output too large",
-    queueOverflowHint: "Ask the agent to summarize or send in smaller chunks, then retry. The session is ready for your next message.",
-    queueOverflowUnconfirmedHint: "Automatic cleanup could not be confirmed. Please send /cancel first, then retry; if the issue persists, recreate the session (/session new ...).",
+    queueOverflowWarning: "",
+    queueOverflowHint: "Reply was truncated for size — you can continue.",
+    queueOverflowUnconfirmedHint: "Output was large and cleanup wasn't confirmed — send /cancel, then continue.",
     autoInstallHeadlineFixed: "⚠️ Auto-install ran but could not fix the session startup problem",
     autoInstallHeadlineFailed: "❌ Auto-install failed",
     autoInstallOriginalError: "Original error:",
@@ -5512,9 +5512,9 @@ var init_recovery2 = __esm(() => {
     sessionInterrupted: (alias) => `当前会话「${alias}」执行中断，未收到最终回复。`,
     sessionInterruptedHint: "请直接重试；如果长时间无响应，可先发送 /cancel 后再重试。",
     sessionInterruptedError: (summary) => `错误信息：${summary}`,
-    queueOverflowWarning: "⚠️ 单次输出过大",
-    queueOverflowHint: "请让 agent 分步/摘要输出，或拆成多次发送；会话已就绪，可直接继续。",
-    queueOverflowUnconfirmedHint: "自动清理未能确认完成，请先发送 /cancel 后重试；若仍异常，请重建会话（/session new ...）或稍后重试。",
+    queueOverflowWarning: "",
+    queueOverflowHint: "部分回复因过长已收束，可直接继续。",
+    queueOverflowUnconfirmedHint: "输出过长且清理未确认，请先发 /cancel 再继续。",
     autoInstallHeadlineFixed: "⚠️ 自动安装已执行但未能修复会话启动问题",
     autoInstallHeadlineFailed: "❌ 自动安装失败",
     autoInstallOriginalError: "原始错误：",

package/dist/cli.js

@@ -302,9 +302,9 @@ var init_recovery = __esm(() => {
     sessionInterrupted: (alias) => `Session "${alias}" was interrupted; no final reply received.`,
     sessionInterruptedHint: "Retry directly. If the session remains unresponsive, send /cancel first, then retry.",
     sessionInterruptedError: (summary) => `Error: ${summary}`,
-    queueOverflowWarning: "⚠️ Output too large",
-    queueOverflowHint: "Ask the agent to summarize or send in smaller chunks, then retry. The session is ready for your next message.",
-    queueOverflowUnconfirmedHint: "Automatic cleanup could not be confirmed. Please send /cancel first, then retry; if the issue persists, recreate the session (/session new ...).",
+    queueOverflowWarning: "",
+    queueOverflowHint: "Reply was truncated for size — you can continue.",
+    queueOverflowUnconfirmedHint: "Output was large and cleanup wasn't confirmed — send /cancel, then continue.",
     autoInstallHeadlineFixed: "⚠️ Auto-install ran but could not fix the session startup problem",
     autoInstallHeadlineFailed: "❌ Auto-install failed",
     autoInstallOriginalError: "Original error:",
@@ -1433,9 +1433,9 @@ var init_recovery2 = __esm(() => {
     sessionInterrupted: (alias) => `当前会话「${alias}」执行中断，未收到最终回复。`,
     sessionInterruptedHint: "请直接重试；如果长时间无响应，可先发送 /cancel 后再重试。",
     sessionInterruptedError: (summary) => `错误信息：${summary}`,
-    queueOverflowWarning: "⚠️ 单次输出过大",
-    queueOverflowHint: "请让 agent 分步/摘要输出，或拆成多次发送；会话已就绪，可直接继续。",
-    queueOverflowUnconfirmedHint: "自动清理未能确认完成，请先发送 /cancel 后重试；若仍异常，请重建会话（/session new ...）或稍后重试。",
+    queueOverflowWarning: "",
+    queueOverflowHint: "部分回复因过长已收束，可直接继续。",
+    queueOverflowUnconfirmedHint: "输出过长且清理未确认，请先发 /cancel 再继续。",
     autoInstallHeadlineFixed: "⚠️ 自动安装已执行但未能修复会话启动问题",
     autoInstallHeadlineFailed: "❌ 自动安装失败",
     autoInstallOriginalError: "原始错误：",
@@ -34428,7 +34428,7 @@ async function executeChatTurn(params) {
     }
   });
   return {
-    text: response.text,
+    text: response.silent ? undefined : response.text,
     media: response.media,
     usedReply
   };
@@ -41980,6 +41980,239 @@ var init_acpx_queue_overflow = __esm(() => {
   };
 });
 
+// src/commands/transport-diagnostics.ts
+function summarizeTransportError(message) {
+  return message.replace(/\s+/g, " ").trim().slice(0, 200);
+}
+function summarizeTransportDiagnostic(output) {
+  const trimmed = output.replace(/\s+/g, " ").trim();
+  if (trimmed.length === 0) {
+    return;
+  }
+  return trimmed.slice(0, 200);
+}
+function summarizeTransportDiagnosticTail(output) {
+  const trimmed = output.replace(/\s+/g, " ").trim();
+  if (trimmed.length === 0) {
+    return;
+  }
+  return trimmed.slice(-200);
+}
+function summarizeTransportNdjson(output, prefix) {
+  const lines = output.split(`
+`).map((line) => line.trim()).filter((line) => line.length > 0);
+  if (lines.length === 0) {
+    return {};
+  }
+  const methods = new Set;
+  let agentMessageChunkCount = 0;
+  let stopReason;
+  for (const line of lines) {
+    try {
+      const payload = JSON.parse(line);
+      if (typeof payload.method === "string" && payload.method.length > 0) {
+        methods.add(payload.method);
+      }
+      if (payload.params?.update?.sessionUpdate === "agent_message_chunk") {
+        agentMessageChunkCount += 1;
+      }
+      if (typeof payload.result?.stopReason === "string" && payload.result.stopReason.length > 0) {
+        stopReason = payload.result.stopReason;
+      }
+    } catch {
+      continue;
+    }
+  }
+  const summary = {
+    [`${prefix}LineCount`]: lines.length
+  };
+  if (methods.size > 0) {
+    summary[`${prefix}Methods`] = [...methods].join(",");
+  }
+  if (agentMessageChunkCount > 0) {
+    summary[`${prefix}AgentMessageChunkCount`] = agentMessageChunkCount;
+  }
+  if (stopReason) {
+    summary[`${prefix}StopReason`] = stopReason;
+  }
+  return summary;
+}
+function isPartialPromptOutputError(message) {
+  return message.includes(ACPX_PARTIAL_OUTPUT_SENTINEL);
+}
+var ACPX_PARTIAL_OUTPUT_SENTINEL = "未收到最终回复";
+
+// src/recovery/errors.ts
+var MissingOptionalDepError, AutoInstallFailedError;
+var init_errors4 = __esm(() => {
+  MissingOptionalDepError = class MissingOptionalDepError extends Error {
+    kind = "missing_optional_dep";
+    package;
+    parentPackagePath;
+    rawMessage;
+    constructor(payload) {
+      super(payload.rawMessage);
+      this.name = "MissingOptionalDepError";
+      this.package = payload.package;
+      this.parentPackagePath = payload.parentPackagePath;
+      this.rawMessage = payload.rawMessage;
+    }
+  };
+  AutoInstallFailedError = class AutoInstallFailedError extends Error {
+    kind = "auto_install_failed";
+    original;
+    steps;
+    logPath;
+    constructor(original, steps, logPath) {
+      super(`auto-install failed: ${original.package}`);
+      this.name = "AutoInstallFailedError";
+      this.original = original;
+      this.steps = steps;
+      this.logPath = logPath;
+    }
+  };
+});
+
+// src/commands/handlers/session-recovery-handler.ts
+function queueOverflowTipText(confirmed) {
+  const r = t().recovery;
+  return [r.queueOverflowWarning, confirmed ? r.queueOverflowHint : r.queueOverflowUnconfirmedHint].filter((line) => line.length > 0).join(`
+`);
+}
+function renderTransportError(session3, error2) {
+  if (error2 instanceof AcpxQueueOverflowError) {
+    return { silent: true };
+  }
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  const registryError = renderAdapterRegistryError(session3, message);
+  if (registryError)
+    return registryError;
+  if (message.includes("No acpx session found")) {
+    if (session3.transient) {
+      return {
+        text: [
+          t().recovery.transientSessionFailed,
+          t().recovery.transientSessionHint
+        ].join(`
+`)
+      };
+    }
+    const quotedWs = quoteWorkspaceNameIfNeeded(session3.workspace);
+    return {
+      text: [
+        t().recovery.sessionUnavailable(session3.alias),
+        t().recovery.sessionUnavailableRenewHint(session3.alias, session3.agent, quotedWs),
+        t().recovery.sessionUnavailableAttachHint(session3.alias, session3.agent, quotedWs)
+      ].join(`
+`)
+    };
+  }
+  if (!isPartialPromptOutputError(message)) {
+    throw error2;
+  }
+  return {
+    text: [
+      t().recovery.sessionInterrupted(session3.alias),
+      t().recovery.sessionInterruptedHint,
+      t().recovery.sessionInterruptedError(summarizeTransportError(message))
+    ].join(`
+`)
+  };
+}
+function renderSessionCreationError(session3, error2) {
+  if (error2 instanceof AutoInstallFailedError) {
+    const { original, steps, logPath } = error2;
+    const r = t().recovery;
+    const allVerifyFailed = steps.length > 0 && steps.every((s) => s.reason === "verify-failed");
+    const headline = allVerifyFailed ? r.autoInstallHeadlineFixed : r.autoInstallHeadlineFailed;
+    const stepLines = steps.map((s) => {
+      const perStepPath = s.path ?? (s.scope === "precise" ? original.parentPackagePath : null);
+      const label = s.scope === "precise" ? r.autoInstallScopePrecise(s.manager, perStepPath ?? undefined) : r.autoInstallScopeGlobal;
+      if (s.reason === "verify-failed") {
+        return r.autoInstallStepVerifyFailed(label);
+      }
+      return r.autoInstallStepError(label, s.stderrTail);
+    }).join(`
+
+`);
+    return {
+      text: [
+        headline,
+        ``,
+        r.autoInstallOriginalError,
+        original.rawMessage,
+        ``,
+        stepLines,
+        ``,
+        r.autoInstallManual(original.package),
+        r.autoInstallLog(logPath)
+      ].join(`
+`)
+    };
+  }
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  const registryError = renderAdapterRegistryError(session3, message);
+  if (registryError)
+    return {
+      text: [
+        t().recovery.sessionCreationFailed,
+        registryError.text
+      ].join(`
+`)
+    };
+  if (message.includes("timed out") && message.includes("sessions new")) {
+    return renderSessionCreationFailure(session3, message);
+  }
+  throw error2;
+}
+function renderAdapterRegistryError(session3, message) {
+  const registry2 = managedAdapterRegistryFromCommand(session3.agentCommand);
+  if (!registry2 || !isNpmAdapterRegistryNotFoundOutput(message))
+    return null;
+  return {
+    text: t().recovery.adapterRegistryE404(registry2, DEFAULT_ADAPTER_REGISTRY)
+  };
+}
+function renderSessionCreationVerificationError(session3) {
+  return renderSessionCreationFailure(session3, t().recovery.sessionCreationVerificationDetail);
+}
+function renderSessionCreationFailure(session3, detail) {
+  const r = t().recovery;
+  return {
+    text: [
+      r.sessionCreationFailed,
+      r.sessionCreationError(summarizeTransportError(detail)),
+      r.sessionCreationAttachHint(session3.alias, session3.agent, quoteWorkspaceNameIfNeeded(session3.workspace))
+    ].join(`
+`)
+  };
+}
+async function tryRecoverMissingSession(ops, session3, error2) {
+  if (error2 instanceof AcpxQueueOverflowError)
+    return null;
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  if (!message.includes("No acpx session found")) {
+    return null;
+  }
+  if (session3.transient) {
+    return null;
+  }
+  const transportAgentCommand = await ops.resolveSessionAgentCommand(session3);
+  if (!transportAgentCommand || transportAgentCommand === session3.agentCommand) {
+    return null;
+  }
+  await ops.setSessionTransportAgentCommand(session3.alias, transportAgentCommand);
+  return await ops.getSession(session3.alias);
+}
+var init_session_recovery_handler = __esm(() => {
+  init_errors4();
+  init_workspace_name();
+  init_i18n();
+  init_adapter_registry();
+  init_adapter_catalog();
+  init_acpx_queue_overflow();
+});
+
 // src/commands/handlers/session-handler.ts
 function sessionHelp() {
   const s = t().session;
@@ -42640,7 +42873,13 @@ async function handlePromptWithSession(context, session3, chatKey, text, reply,
         diagnostic: error2.cleanupDiagnostic ?? (error2 instanceof Error ? error2.message.slice(0, 512) : String(error2).slice(0, 512)),
         confirmed
       });
-      return context.recovery.renderTransportError(session3, error2);
+      context.onQueueOverflowTip?.({
+        chatKey,
+        sessionAlias: session3.alias,
+        confirmed,
+        text: queueOverflowTipText(confirmed)
+      });
+      return { silent: true };
     }
     const recovered = await context.recovery.tryRecoverMissingSession(session3, error2);
     if (recovered) {
@@ -42739,6 +42978,7 @@ var init_session_handler = __esm(() => {
   init_workspace_name();
   init_i18n();
   init_acpx_queue_overflow();
+  init_session_recovery_handler();
 });
 
 // src/formatting/render-text.ts
@@ -43756,37 +43996,6 @@ var init_help_handler = __esm(() => {
   init_i18n();
 });
 
-// src/recovery/errors.ts
-var MissingOptionalDepError, AutoInstallFailedError;
-var init_errors4 = __esm(() => {
-  MissingOptionalDepError = class MissingOptionalDepError extends Error {
-    kind = "missing_optional_dep";
-    package;
-    parentPackagePath;
-    rawMessage;
-    constructor(payload) {
-      super(payload.rawMessage);
-      this.name = "MissingOptionalDepError";
-      this.package = payload.package;
-      this.parentPackagePath = payload.parentPackagePath;
-      this.rawMessage = payload.rawMessage;
-    }
-  };
-  AutoInstallFailedError = class AutoInstallFailedError extends Error {
-    kind = "auto_install_failed";
-    original;
-    steps;
-    logPath;
-    constructor(original, steps, logPath) {
-      super(`auto-install failed: ${original.package}`);
-      this.name = "AutoInstallFailedError";
-      this.original = original;
-      this.steps = steps;
-      this.logPath = logPath;
-    }
-  };
-});
-
 // src/commands/handlers/session-shortcut-handler.ts
 async function handleSessionShortcutCommand(context, ops, chatKey, agent3, target, createNew) {
   if (!context.config || !context.configStore) {
@@ -44384,213 +44593,6 @@ var init_native_session_handler = __esm(() => {
   NATIVE_SESSION_CACHE_TTL_MS = 10 * 60 * 1000;
 });
 
-// src/commands/transport-diagnostics.ts
-function summarizeTransportError(message) {
-  return message.replace(/\s+/g, " ").trim().slice(0, 200);
-}
-function summarizeTransportDiagnostic(output) {
-  const trimmed = output.replace(/\s+/g, " ").trim();
-  if (trimmed.length === 0) {
-    return;
-  }
-  return trimmed.slice(0, 200);
-}
-function summarizeTransportDiagnosticTail(output) {
-  const trimmed = output.replace(/\s+/g, " ").trim();
-  if (trimmed.length === 0) {
-    return;
-  }
-  return trimmed.slice(-200);
-}
-function summarizeTransportNdjson(output, prefix) {
-  const lines = output.split(`
-`).map((line) => line.trim()).filter((line) => line.length > 0);
-  if (lines.length === 0) {
-    return {};
-  }
-  const methods = new Set;
-  let agentMessageChunkCount = 0;
-  let stopReason;
-  for (const line of lines) {
-    try {
-      const payload = JSON.parse(line);
-      if (typeof payload.method === "string" && payload.method.length > 0) {
-        methods.add(payload.method);
-      }
-      if (payload.params?.update?.sessionUpdate === "agent_message_chunk") {
-        agentMessageChunkCount += 1;
-      }
-      if (typeof payload.result?.stopReason === "string" && payload.result.stopReason.length > 0) {
-        stopReason = payload.result.stopReason;
-      }
-    } catch {
-      continue;
-    }
-  }
-  const summary = {
-    [`${prefix}LineCount`]: lines.length
-  };
-  if (methods.size > 0) {
-    summary[`${prefix}Methods`] = [...methods].join(",");
-  }
-  if (agentMessageChunkCount > 0) {
-    summary[`${prefix}AgentMessageChunkCount`] = agentMessageChunkCount;
-  }
-  if (stopReason) {
-    summary[`${prefix}StopReason`] = stopReason;
-  }
-  return summary;
-}
-function isPartialPromptOutputError(message) {
-  return message.includes(ACPX_PARTIAL_OUTPUT_SENTINEL);
-}
-var ACPX_PARTIAL_OUTPUT_SENTINEL = "未收到最终回复";
-
-// src/commands/handlers/session-recovery-handler.ts
-function renderTransportError(session3, error2) {
-  if (error2 instanceof AcpxQueueOverflowError) {
-    const confirmed = error2.cleanup?.ownerTerminationSucceeded === true;
-    if (confirmed) {
-      return {
-        text: [t().recovery.queueOverflowWarning, t().recovery.queueOverflowHint].join(`
-`)
-      };
-    }
-    return {
-      text: [t().recovery.queueOverflowWarning, t().recovery.queueOverflowUnconfirmedHint].join(`
-`)
-    };
-  }
-  const message = error2 instanceof Error ? error2.message : String(error2);
-  const registryError = renderAdapterRegistryError(session3, message);
-  if (registryError)
-    return registryError;
-  if (message.includes("No acpx session found")) {
-    if (session3.transient) {
-      return {
-        text: [
-          t().recovery.transientSessionFailed,
-          t().recovery.transientSessionHint
-        ].join(`
-`)
-      };
-    }
-    const quotedWs = quoteWorkspaceNameIfNeeded(session3.workspace);
-    return {
-      text: [
-        t().recovery.sessionUnavailable(session3.alias),
-        t().recovery.sessionUnavailableRenewHint(session3.alias, session3.agent, quotedWs),
-        t().recovery.sessionUnavailableAttachHint(session3.alias, session3.agent, quotedWs)
-      ].join(`
-`)
-    };
-  }
-  if (!isPartialPromptOutputError(message)) {
-    throw error2;
-  }
-  return {
-    text: [
-      t().recovery.sessionInterrupted(session3.alias),
-      t().recovery.sessionInterruptedHint,
-      t().recovery.sessionInterruptedError(summarizeTransportError(message))
-    ].join(`
-`)
-  };
-}
-function renderSessionCreationError(session3, error2) {
-  if (error2 instanceof AutoInstallFailedError) {
-    const { original, steps, logPath } = error2;
-    const r = t().recovery;
-    const allVerifyFailed = steps.length > 0 && steps.every((s) => s.reason === "verify-failed");
-    const headline = allVerifyFailed ? r.autoInstallHeadlineFixed : r.autoInstallHeadlineFailed;
-    const stepLines = steps.map((s) => {
-      const perStepPath = s.path ?? (s.scope === "precise" ? original.parentPackagePath : null);
-      const label = s.scope === "precise" ? r.autoInstallScopePrecise(s.manager, perStepPath ?? undefined) : r.autoInstallScopeGlobal;
-      if (s.reason === "verify-failed") {
-        return r.autoInstallStepVerifyFailed(label);
-      }
-      return r.autoInstallStepError(label, s.stderrTail);
-    }).join(`
-
-`);
-    return {
-      text: [
-        headline,
-        ``,
-        r.autoInstallOriginalError,
-        original.rawMessage,
-        ``,
-        stepLines,
-        ``,
-        r.autoInstallManual(original.package),
-        r.autoInstallLog(logPath)
-      ].join(`
-`)
-    };
-  }
-  const message = error2 instanceof Error ? error2.message : String(error2);
-  const registryError = renderAdapterRegistryError(session3, message);
-  if (registryError)
-    return {
-      text: [
-        t().recovery.sessionCreationFailed,
-        registryError.text
-      ].join(`
-`)
-    };
-  if (message.includes("timed out") && message.includes("sessions new")) {
-    return renderSessionCreationFailure(session3, message);
-  }
-  throw error2;
-}
-function renderAdapterRegistryError(session3, message) {
-  const registry2 = managedAdapterRegistryFromCommand(session3.agentCommand);
-  if (!registry2 || !isNpmAdapterRegistryNotFoundOutput(message))
-    return null;
-  return {
-    text: t().recovery.adapterRegistryE404(registry2, DEFAULT_ADAPTER_REGISTRY)
-  };
-}
-function renderSessionCreationVerificationError(session3) {
-  return renderSessionCreationFailure(session3, t().recovery.sessionCreationVerificationDetail);
-}
-function renderSessionCreationFailure(session3, detail) {
-  const r = t().recovery;
-  return {
-    text: [
-      r.sessionCreationFailed,
-      r.sessionCreationError(summarizeTransportError(detail)),
-      r.sessionCreationAttachHint(session3.alias, session3.agent, quoteWorkspaceNameIfNeeded(session3.workspace))
-    ].join(`
-`)
-  };
-}
-async function tryRecoverMissingSession(ops, session3, error2) {
-  if (error2 instanceof AcpxQueueOverflowError)
-    return null;
-  const message = error2 instanceof Error ? error2.message : String(error2);
-  if (!message.includes("No acpx session found")) {
-    return null;
-  }
-  if (session3.transient) {
-    return null;
-  }
-  const transportAgentCommand = await ops.resolveSessionAgentCommand(session3);
-  if (!transportAgentCommand || transportAgentCommand === session3.agentCommand) {
-    return null;
-  }
-  await ops.setSessionTransportAgentCommand(session3.alias, transportAgentCommand);
-  return await ops.getSession(session3.alias);
-}
-var init_session_recovery_handler = __esm(() => {
-  init_errors4();
-  init_workspace_name();
-  init_i18n();
-  init_adapter_registry();
-  init_adapter_catalog();
-  init_acpx_queue_overflow();
-});
-
 // src/recovery/auto-install-optional-dep.ts
 import { spawn as spawn11 } from "node:child_process";
 import { createWriteStream } from "node:fs";
@@ -45595,6 +45597,7 @@ class CommandRouter {
   scheduled;
   scheduledDelivery;
   resolveNativeSessionListFormat;
+  controlEvents;
   logger;
   autoInstall = autoInstallOptionalDep;
   discoverPaths = discoverParentPackagePaths;
@@ -45607,7 +45610,7 @@ class CommandRouter {
   activeTurns;
   transportInvoker;
   sessionControl;
-  constructor(sessions, transport, config4, configStore, logger, resolveSessionAgentCommand = resolveSessionAgentCommandFromIndex, orchestration3, quota, scheduled, scheduledDelivery, resolveNativeSessionListFormat, activeTurns) {
+  constructor(sessions, transport, config4, configStore, logger, resolveSessionAgentCommand = resolveSessionAgentCommandFromIndex, orchestration3, quota, scheduled, scheduledDelivery, resolveNativeSessionListFormat, activeTurns, controlEvents) {
     this.sessions = sessions;
     this.transport = transport;
     this.config = config4;
@@ -45618,6 +45621,7 @@ class CommandRouter {
     this.scheduled = scheduled;
     this.scheduledDelivery = scheduledDelivery;
     this.resolveNativeSessionListFormat = resolveNativeSessionListFormat;
+    this.controlEvents = controlEvents;
     this.logger = logger ?? createNoopAppLogger();
     this.activeTurns = activeTurns;
     this.transportInvoker = new TransportInvoker({
@@ -45836,7 +45840,18 @@ class CommandRouter {
       lifecycle: this.createSessionLifecycleOps(reply, perfSpan),
       interaction: this.createSessionInteractionOps(perfSpan),
       recovery: this.createSessionRenderRecoveryOps(),
-      ...this.activeTurns ? { activeTurns: this.activeTurns } : {}
+      ...this.activeTurns ? { activeTurns: this.activeTurns } : {},
+      ...this.controlEvents ? {
+        onQueueOverflowTip: (info) => {
+          this.controlEvents.emit({
+            type: "queue-overflow-tip",
+            chatKey: info.chatKey,
+            sessionAlias: info.sessionAlias,
+            confirmed: info.confirmed,
+            text: info.text
+          });
+        }
+      } : {}
     };
   }
   createSessionLifecycleOps(reply, perfSpan) {
@@ -60254,7 +60269,7 @@ ${envelope}` : envelope;
           });
         }
       });
-      if (response.text) {
+      if (response.text && !response.silent) {
         emitChunk(response.text);
       }
       this.deps.events.emit({
@@ -60262,7 +60277,8 @@ ${envelope}` : envelope;
         chatKey: req.chatKey,
         sessionAlias: req.sessionAlias,
         ok: true,
-        text: finalText,
+        ...finalText !== "" || !response.silent ? { text: finalText } : {},
+        ...response.silent ? { silent: true } : {},
         ...req.peerOrigin ? { peerOrigin: req.peerOrigin } : {}
       });
       return {
@@ -63331,7 +63347,7 @@ async function buildApp(paths, deps = {}) {
   });
   const router3 = new CommandRouter(sessions, transport, config4, configStore, logger, undefined, orchestration3, quota, scheduledService, deps.channel?.supportsScheduledMessages ? {
     supportsScheduledMessages: deps.channel.supportsScheduledMessages.bind(deps.channel)
-  } : undefined, deps.channel?.nativeSessionListFormat ? deps.channel.nativeSessionListFormat.bind(deps.channel) : undefined, activeTurns);
+  } : undefined, deps.channel?.nativeSessionListFormat ? deps.channel.nativeSessionListFormat.bind(deps.channel) : undefined, activeTurns, controlEvents);
   const agent3 = new ConsoleAgent(router3, logger);
   const terminalService = createTerminalService({
     events: controlEvents,

package/dist/commands/handlers/session-handler.d.ts

@@ -9,6 +9,12 @@ export interface SessionHandlerContext extends CommandRouterContext {
     interaction: SessionInteractionOps;
     recovery: SessionRenderRecoveryOps;
     readonly activeTurns?: import("../../sessions/active-turn-registry.js").ActiveTurnRegistry;
+    onQueueOverflowTip?: (info: {
+        chatKey: string;
+        sessionAlias: string;
+        confirmed: boolean;
+        text: string;
+    }) => void;
 }
 export declare function sessionHelp(): HelpTopicMetadata;
 export declare function nativeSessionHelp(): HelpTopicMetadata;

package/dist/commands/handlers/session-recovery-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedSession } from "../../transport/types";
+import type { RouterResponse, SessionRecoveryOps } from "../router-types";
+export declare function queueOverflowTipText(confirmed: boolean): string;
+export declare function renderTransportError(session: ResolvedSession, error: unknown): RouterResponse;
+export declare function renderSessionCreationError(session: ResolvedSession, error: unknown): RouterResponse;
+export declare function renderSessionCreationVerificationError(session: ResolvedSession): RouterResponse;
+export declare function tryRecoverMissingSession(ops: SessionRecoveryOps, session: ResolvedSession, error: unknown): Promise<ResolvedSession | null>;

package/dist/commands/router-types.d.ts

@@ -9,6 +9,8 @@ import type { PlanEntry, ToolUseEvent } from "../channels/types.js";
 import type { PerfSpan } from "../perf/perf-tracer";
 export interface RouterResponse {
     text?: string;
+    /** When true, channels must not deliver `text` (including an empty bubble). */
+    silent?: boolean;
 }
 export interface PromptRouteMetadata {
     chatKey: string;

package/dist/commands/transport-diagnostics.d.ts

@@ -0,0 +1,5 @@
+export declare function summarizeTransportError(message: string): string;
+export declare function summarizeTransportDiagnostic(output: string): string | undefined;
+export declare function summarizeTransportDiagnosticTail(output: string): string | undefined;
+export declare function summarizeTransportNdjson(output: string, prefix: "stdout" | "stderr"): Record<string, string | number>;
+export declare function isPartialPromptOutputError(message: string): boolean;

package/dist/control/control-event-bus.d.ts

@@ -73,7 +73,14 @@ export type ControlEvent = {
     errorMessage?: string;
     cancelled?: boolean;
     text?: string;
+    silent?: boolean;
     peerOrigin?: PeerTurnOrigin;
+} | {
+    type: "queue-overflow-tip";
+    chatKey: string;
+    sessionAlias: string;
+    confirmed: boolean;
+    text: string;
 } | {
     type: "sessions-changed";
 } | {

package/dist/plugin-api.js

@@ -317,9 +317,9 @@ var init_recovery = __esm(() => {
     sessionInterrupted: (alias) => `Session "${alias}" was interrupted; no final reply received.`,
     sessionInterruptedHint: "Retry directly. If the session remains unresponsive, send /cancel first, then retry.",
     sessionInterruptedError: (summary) => `Error: ${summary}`,
-    queueOverflowWarning: "⚠️ Output too large",
-    queueOverflowHint: "Ask the agent to summarize or send in smaller chunks, then retry. The session is ready for your next message.",
-    queueOverflowUnconfirmedHint: "Automatic cleanup could not be confirmed. Please send /cancel first, then retry; if the issue persists, recreate the session (/session new ...).",
+    queueOverflowWarning: "",
+    queueOverflowHint: "Reply was truncated for size — you can continue.",
+    queueOverflowUnconfirmedHint: "Output was large and cleanup wasn't confirmed — send /cancel, then continue.",
     autoInstallHeadlineFixed: "⚠️ Auto-install ran but could not fix the session startup problem",
     autoInstallHeadlineFailed: "❌ Auto-install failed",
     autoInstallOriginalError: "Original error:",
@@ -1448,9 +1448,9 @@ var init_recovery2 = __esm(() => {
     sessionInterrupted: (alias) => `当前会话「${alias}」执行中断，未收到最终回复。`,
     sessionInterruptedHint: "请直接重试；如果长时间无响应，可先发送 /cancel 后再重试。",
     sessionInterruptedError: (summary) => `错误信息：${summary}`,
-    queueOverflowWarning: "⚠️ 单次输出过大",
-    queueOverflowHint: "请让 agent 分步/摘要输出，或拆成多次发送；会话已就绪，可直接继续。",
-    queueOverflowUnconfirmedHint: "自动清理未能确认完成，请先发送 /cancel 后重试；若仍异常，请重建会话（/session new ...）或稍后重试。",
+    queueOverflowWarning: "",
+    queueOverflowHint: "部分回复因过长已收束，可直接继续。",
+    queueOverflowUnconfirmedHint: "输出过长且清理未确认，请先发 /cancel 再继续。",
     autoInstallHeadlineFixed: "⚠️ 自动安装已执行但未能修复会话启动问题",
     autoInstallHeadlineFailed: "❌ 自动安装失败",
     autoInstallOriginalError: "原始错误：",

package/dist/recovery/discover-parent-package-paths.d.ts

@@ -0,0 +1,49 @@
+export type PackageManager = "npm" | "bun" | "pnpm" | "yarn";
+export interface DiscoveredParentPath {
+    /** Absolute directory containing the parent package's package.json. */
+    path: string;
+    /** Which package manager owns this directory — determines which CLI to install with. */
+    manager: PackageManager;
+}
+export interface DiscoverDeps {
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+    platform?: NodeJS.Platform;
+    /**
+     * Working directory used as the anchor for `require.resolve` style lookups.
+     * In production this is typically the bridge / acpx cwd, not the daemon's cwd.
+     * Defaults to `process.cwd()` which is usually wrong for daemonized use.
+     */
+    cwd?: string;
+    fsExists?: (path: string) => Promise<boolean>;
+    /**
+     * Resolve `<name>/package.json` via Node.js resolution, anchored on the provided cwd.
+     * Returns the parent package dir (containing package.json) or null.
+     */
+    resolveFromCwd?: (parentName: string, cwd: string) => string | null;
+    /**
+     * Query a package manager root. Short timeout; null if the CLI is unavailable.
+     */
+    queryPackageManagerRoot?: (tool: "npm" | "pnpm" | "yarn") => Promise<string | null>;
+}
+/**
+ * Strip platform / arch / libc suffixes from an npm optional platform package name.
+ * Examples:
+ *   "opencode-windows-x64" → "opencode"
+ *   "@scope/pkg-linux-arm64-musl" → "@scope/pkg"
+ *   "esbuild-darwin-x64" → "esbuild"
+ *   "@next/swc-win32-x64-msvc" → "@next/swc"
+ *   "@rollup/rollup-linux-x64-gnu" → "@rollup/rollup"
+ */
+export declare function deriveParentPackageName(platformPackage: string): string;
+/**
+ * Enumerate directories where the parent package might be installed across
+ * common package managers: npm (global), Bun (global), pnpm (global), Yarn (global),
+ * plus the local Node resolution tree. Each entry is tagged with its owning
+ * package manager so the installer can dispatch to the correct CLI — running
+ * `npm install` inside a Bun or pnpm tree would corrupt the managed store.
+ *
+ * Every returned path is guaranteed to exist and contain a package.json.
+ * Duplicates and non-existent paths are filtered out.
+ */
+export declare function discoverParentPackagePaths(platformPackage: string, seedPath: string | null, deps?: DiscoverDeps): Promise<DiscoveredParentPath[]>;

package/dist/recovery/errors.d.ts

@@ -0,0 +1,30 @@
+export interface MissingOptionalDepPayload {
+    package: string;
+    parentPackagePath: string | null;
+    rawMessage: string;
+}
+export declare class MissingOptionalDepError extends Error {
+    readonly kind: "missing_optional_dep";
+    readonly package: string;
+    readonly parentPackagePath: string | null;
+    readonly rawMessage: string;
+    constructor(payload: MissingOptionalDepPayload);
+}
+import type { PackageManager } from "./discover-parent-package-paths";
+export interface AutoInstallStepError {
+    scope: "precise" | "global";
+    stderrTail: string;
+    code: number | null;
+    reason?: "timeout" | "spawn" | "exit" | "verify-failed";
+    /** The parent package directory this precise install was run in (only set for scope === "precise"). */
+    path?: string;
+    /** The package manager used for this precise install (only set for scope === "precise"). */
+    manager?: PackageManager;
+}
+export declare class AutoInstallFailedError extends Error {
+    readonly kind: "auto_install_failed";
+    readonly original: MissingOptionalDepError;
+    readonly steps: AutoInstallStepError[];
+    readonly logPath: string;
+    constructor(original: MissingOptionalDepError, steps: AutoInstallStepError[], logPath: string);
+}

package/dist/weixin/agent/interface.d.ts

@@ -86,6 +86,12 @@ export interface ChatResponse {
      * the same turn. May contain markdown and will be normalized before send.
      */
     text?: string;
+    /**
+     * When true, the channel must not post `text` as a chat/agent message
+     * (including a blank bubble). Used for queue-overflow tips that only
+     * surface as a relay-web toast.
+     */
+    silent?: boolean;
     /** Reply media file(s). */
     media?: OutboundChannelMedia | OutboundChannelMedia[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganglion/xacpx",
-  "version": "0.24.0",
+  "version": "0.24.1-beta.0",
   "description": "随时随地通过聊天频道（微信 / 飞书 / 元宝等）远程控制 `acpx` 上的 Claude Code、Codex 等 Agents。",
   "keywords": [
     "acpx",