@ganglion/xacpx 0.12.1 → 0.13.0

package/dist/bridge/bridge-main.js

@@ -940,6 +940,7 @@ ${detail}`,
     sessionBlockedByTasks: (alias, count) => `Session "${alias}" has ${count} unfinished task(s). Cancel or wait for them to complete first.`,
     sessionBlockedByTasksHint: "Use /tasks to list tasks, or /task cancel <id> to cancel one.",
     sessionRemoved: (alias) => `Session "${alias}" removed.`,
+    sessionArchived: (alias) => `Archived session "${alias}". Send a message to restore it.`,
     sessionRemovedWasActive: "This was the active session. Its chat context has been cleared.",
     sessionRemovedWasActivePromoted: (alias) => `This was the active session. Switched back to the previous session "${alias}".`,
     sessionTransportShared: (transportSession, count) => `Note: backend session "${transportSession}" is still referenced by ${count} other session(s) and was not closed.`,
@@ -2035,6 +2036,7 @@ ${detail}`,
     sessionBlockedByTasks: (alias, count) => `会话「${alias}」下还有 ${count} 个未结束的任务，请先取消或等待完成。`,
     sessionBlockedByTasksHint: "使用 /tasks 查看任务列表，或 /task cancel <id> 取消任务。",
     sessionRemoved: (alias) => `已删除会话「${alias}」。`,
+    sessionArchived: (alias) => `已归档会话「${alias}」。发送消息即可恢复。`,
     sessionRemovedWasActive: "该会话是当前活跃会话，已自动清除相关聊天上下文。",
     sessionRemovedWasActivePromoted: (alias) => `该会话是当前活跃会话，已切换回上一个会话「${alias}」。`,
     sessionTransportShared: (transportSession, count) => `提示：后端会话「${transportSession}」仍被其他 ${count} 个会话引用，未关闭。`,
@@ -3424,6 +3426,31 @@ var init_agent_session_list = __esm(() => {
   init_path();
 });
 
+// src/transport/acpx-session-files.ts
+import { readdir, unlink as unlink2 } from "node:fs/promises";
+import { homedir as homedir4 } from "node:os";
+import { join as join3 } from "node:path";
+async function deleteAcpxSessionFiles(options) {
+  const dir = options.sessionsDir ?? join3(homedir4(), ".acpx", "sessions");
+  const safeId = encodeURIComponent(options.acpxRecordId);
+  await unlink2(join3(dir, `${safeId}.json`)).catch(() => {
+    return;
+  });
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return;
+  }
+  const streamFiles = entries.filter((name) => name.startsWith(`${safeId}.stream.`));
+  for (const name of streamFiles) {
+    await unlink2(join3(dir, name)).catch(() => {
+      return;
+    });
+  }
+}
+var init_acpx_session_files = () => {};
+
 // src/bridge/bridge-main.ts
 import { createInterface } from "node:readline";
 
@@ -3496,9 +3523,9 @@ init_terminate_process_tree();
 init_prompt_output();
 init_prompt_media();
 init_streaming_prompt();
-import { copyFile, readdir } from "node:fs/promises";
-import { homedir as homedir4 } from "node:os";
-import { dirname as dirname2, join as join3, win32 } from "node:path";
+import { copyFile, readdir as readdir2 } from "node:fs/promises";
+import { homedir as homedir5 } from "node:os";
+import { dirname as dirname2, join as join4, win32 } from "node:path";
 import { spawn as spawn4 } from "node:child_process";
 
 // src/bridge/parse-missing-optional-dep.ts
@@ -3518,6 +3545,7 @@ function parseMissingOptionalDep(text) {
 init_discover_parent_package_paths();
 init_acpx_queue_owner_launcher();
 init_agent_session_list();
+init_acpx_session_files();
 class EnsureSessionFailedError extends Error {
   kind;
   data;
@@ -3798,7 +3826,7 @@ class BridgeRuntime {
         acpxRecordId = parsed.id;
       }
       const agentSessionId = typeof parsed.agentSessionId === "string" ? parsed.agentSessionId : undefined;
-      if (acpxRecordId) {
+      if (acpxRecordId && /^[\w.:-]+$/.test(acpxRecordId) && acpxRecordId.length >= 8) {
         return { acpxRecordId, agentSessionId };
       }
     } catch {
@@ -3890,6 +3918,17 @@ class BridgeRuntime {
     }
     throw new Error(result.stderr || result.stdout || "sessions close failed");
   }
+  async deleteSession(input) {
+    let acpxRecordId;
+    try {
+      ({ acpxRecordId } = await this.readSessionRecord(input));
+    } catch {
+      return {};
+    }
+    await this.removeSession(input);
+    await deleteAcpxSessionFiles({ acpxRecordId });
+    return {};
+  }
   async shutdown() {
     return {};
   }
@@ -4080,14 +4119,14 @@ async function tryRepairAcpxSessionIndex(deps = {}) {
   if (platform !== "win32") {
     return false;
   }
-  const home = deps.home ?? process.env.HOME ?? process.env.USERPROFILE ?? homedir4();
+  const home = deps.home ?? process.env.HOME ?? process.env.USERPROFILE ?? homedir5();
   if (!home) {
     return false;
   }
-  const pathJoin = platform === "win32" ? win32.join : join3;
+  const pathJoin = platform === "win32" ? win32.join : join4;
   const sessionsDir = pathJoin(home, ".acpx", "sessions");
   const indexPath = pathJoin(sessionsDir, "index.json");
-  const readdirFn = deps.readdirFn ?? readdir;
+  const readdirFn = deps.readdirFn ?? readdir2;
   const copyFileFn = deps.copyFileFn ?? copyFile;
   let files;
   try {
@@ -4135,6 +4174,7 @@ var BRIDGE_METHODS = new Set([
   "getSessionModel",
   "cancel",
   "removeSession",
+  "deleteSession",
   "getAgentSessionId"
 ]);
 var SESSION_SCOPED_METHODS = new Set([
@@ -4148,6 +4188,7 @@ var SESSION_SCOPED_METHODS = new Set([
   "getSessionModel",
   "cancel",
   "removeSession",
+  "deleteSession",
   "getAgentSessionId"
 ]);
 
@@ -4355,6 +4396,13 @@ class BridgeServer {
           cwd: requireString(params, "cwd"),
           name: requireString(params, "name")
         });
+      case "deleteSession":
+        return await this.runtime.deleteSession({
+          agent: requireString(params, "agent"),
+          agentCommand: asOptionalString(params.agentCommand),
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name")
+        });
       case "getAgentSessionId":
         return await this.runtime.getAgentSessionId({
           agent: requireString(params, "agent"),

package/dist/cli.js

@@ -141,6 +141,7 @@ ${detail}`,
     sessionBlockedByTasks: (alias, count) => `Session "${alias}" has ${count} unfinished task(s). Cancel or wait for them to complete first.`,
     sessionBlockedByTasksHint: "Use /tasks to list tasks, or /task cancel <id> to cancel one.",
     sessionRemoved: (alias) => `Session "${alias}" removed.`,
+    sessionArchived: (alias) => `Archived session "${alias}". Send a message to restore it.`,
     sessionRemovedWasActive: "This was the active session. Its chat context has been cleared.",
     sessionRemovedWasActivePromoted: (alias) => `This was the active session. Switched back to the previous session "${alias}".`,
     sessionTransportShared: (transportSession, count) => `Note: backend session "${transportSession}" is still referenced by ${count} other session(s) and was not closed.`,
@@ -1236,6 +1237,7 @@ ${detail}`,
     sessionBlockedByTasks: (alias, count) => `会话「${alias}」下还有 ${count} 个未结束的任务，请先取消或等待完成。`,
     sessionBlockedByTasksHint: "使用 /tasks 查看任务列表，或 /task cancel <id> 取消任务。",
     sessionRemoved: (alias) => `已删除会话「${alias}」。`,
+    sessionArchived: (alias) => `已归档会话「${alias}」。发送消息即可恢复。`,
     sessionRemovedWasActive: "该会话是当前活跃会话，已自动清除相关聊天上下文。",
     sessionRemovedWasActivePromoted: (alias) => `该会话是当前活跃会话，已切换回上一个会话「${alias}」。`,
     sessionTransportShared: (transportSession, count) => `提示：后端会话「${transportSession}」仍被其他 ${count} 个会话引用，未关闭。`,
@@ -4695,6 +4697,7 @@ function parseConfig(raw, options = {}) {
       ...typeof transport.command === "string" ? { command: transport.command } : {},
       ...typeof transport.sessionInitTimeoutMs === "number" ? { sessionInitTimeoutMs: transport.sessionInitTimeoutMs } : {},
       ...typeof transport.permissionPolicy === "string" ? { permissionPolicy: transport.permissionPolicy } : {},
+      ...typeof transport.preferLocalAgents === "boolean" ? { preferLocalAgents: transport.preferLocalAgents } : {},
       type: transportType,
       permissionMode,
       nonInteractivePermissions,
@@ -20399,6 +20402,9 @@ function parseCommand(input) {
   if (command === "/session" && parts[1] === "rm" && parts[2] && parts.length === 3) {
     return { kind: "session.rm", alias: parts[2] };
   }
+  if (command === "/session" && parts[1] === "archive" && parts[2] && parts.length === 3) {
+    return { kind: "session.archive", alias: parts[2] };
+  }
   if (command === "/ssn") {
     if (parts.length === 1) {
       return { kind: "session.native.list" };
@@ -20645,7 +20651,7 @@ function parseCommand(input) {
       return { kind: "session.shortcut.new", agent: parts[2], ...shortcutTarget };
     }
   }
-  if (command === "/session" && parts[1] && parts[1] !== "new" && parts[1] !== "attach" && parts[1] !== "reset" && parts[1] !== "rm") {
+  if (command === "/session" && parts[1] && parts[1] !== "new" && parts[1] !== "attach" && parts[1] !== "reset" && parts[1] !== "rm" && parts[1] !== "archive") {
     const shortcutTarget = readSessionShortcutTarget(parts, 2);
     if (shortcutTarget) {
       return { kind: "session.shortcut", agent: parts[1], ...shortcutTarget };
@@ -21109,6 +21115,7 @@ var init_command_policy = __esm(() => {
   COMMAND_KIND_TO_LABEL = {
     "session.reset": "/clear",
     "session.rm": "/session rm",
+    "session.archive": "/session archive",
     "session.tail": "/session tail",
     "replymode.set": "/replymode",
     "replymode.reset": "/replymode reset",
@@ -22326,9 +22333,9 @@ async function handleSessionRemove(context, chatKey, alias) {
   }
   let transportTeardownWarning;
   const shouldTeardownTransport = sharedAliasCount === 0;
-  if (shouldTeardownTransport && context.transport.removeSession) {
+  if (shouldTeardownTransport && context.transport.deleteSession) {
     try {
-      await context.transport.removeSession(session3);
+      await context.transport.deleteSession(session3);
     } catch (error2) {
       const message = error2 instanceof Error ? error2.message : String(error2);
       transportTeardownWarning = message;
@@ -22361,7 +22368,19 @@ async function handleSessionRemove(context, chatKey, alias) {
   return { text: lines.join(`
 `) };
 }
+async function handleSessionArchive(context, chatKey, alias, archive) {
+  const internalAlias = await context.sessions.resolveAliasForChat(chatKey, alias);
+  const session3 = await context.sessions.getSession(internalAlias);
+  if (!session3) {
+    return { text: t().session.sessionNotFound(alias) };
+  }
+  await archive(internalAlias);
+  return { text: t().session.sessionArchived(alias) };
+}
 async function promptWithSession(context, session3, chatKey, text, reply, replyContextToken, accountId, media, abortSignal, onToolEvent, onThought, perfSpan, metadata, onPlan, onUsage) {
+  if (session3.archived) {
+    await context.sessions.setArchived(session3.alias, false);
+  }
   const effectiveReplyMode = resolveEffectiveReplyMode(context.config, chatKey, session3.replyMode);
   if (!session3.replyMode)
     session3.replyMode = effectiveReplyMode;
@@ -24795,6 +24814,8 @@ class CommandRouter {
           return await handleSessionTail(this.createSessionHandlerContext(undefined, perfSpan), chatKey, command.lines);
         case "session.rm":
           return await handleSessionRemove(this.createSessionHandlerContext(undefined, perfSpan), chatKey, command.alias);
+        case "session.archive":
+          return await handleSessionArchive(this.createSessionHandlerContext(undefined, perfSpan), chatKey, command.alias, (internalAlias) => this.archiveSessionWithTransport(internalAlias));
         case "groups":
           return await handleGroupList(this.createHandlerContext(), chatKey, command.filter);
         case "group.new":
@@ -24943,6 +24964,82 @@ class CommandRouter {
       await release();
     }
   }
+  async removeSessionWithTransport(internalAlias) {
+    const session3 = await this.sessions.getSession(internalAlias);
+    if (!session3) {
+      throw new Error(`session "${internalAlias}" does not exist`);
+    }
+    if (this.orchestration) {
+      const blocking = await this.orchestration.listSessionBlockingTasks(session3.transportSession);
+      if (blocking.length > 0) {
+        throw new Error(`session "${internalAlias}" has ${blocking.length} blocking task(s); cancel them before deleting`);
+      }
+    }
+    const sharedAliasCount = this.sessions.countAliasesSharingTransport(session3.transportSession, internalAlias);
+    const { wasActive } = await this.sessions.removeSession(internalAlias);
+    if (this.orchestration) {
+      try {
+        await this.orchestration.purgeSessionReferences(session3.transportSession);
+      } catch (error2) {
+        await this.logger.error("session.orchestration_purge_failed", "failed to purge orchestration references after web remove", {
+          alias: internalAlias,
+          transportSession: session3.transportSession,
+          message: error2 instanceof Error ? error2.message : String(error2)
+        });
+      }
+    }
+    let transportTornDown = false;
+    let transportTeardownWarning;
+    if (sharedAliasCount === 0 && this.transport.deleteSession) {
+      try {
+        await this.transport.deleteSession(session3);
+        transportTornDown = true;
+      } catch (error2) {
+        transportTeardownWarning = error2 instanceof Error ? error2.message : String(error2);
+        await this.logger.error("session.transport_delete_failed", "failed to delete acpx session after logical remove", {
+          alias: internalAlias,
+          transportSession: session3.transportSession,
+          message: transportTeardownWarning
+        });
+      }
+    }
+    return {
+      wasActive,
+      sharedAliasCount,
+      transportTornDown,
+      ...transportTeardownWarning ? { transportTeardownWarning } : {}
+    };
+  }
+  async archiveSessionWithTransport(internalAlias) {
+    const session3 = await this.sessions.getSession(internalAlias);
+    if (!session3) {
+      throw new Error(`session "${internalAlias}" does not exist`);
+    }
+    if (this.activeTurns?.isActiveAnywhere(internalAlias)) {
+      throw new Error(`session "${internalAlias}" has a running turn; stop it before archiving`);
+    }
+    const shared = this.sessions.countAliasesSharingTransport(session3.transportSession, internalAlias) > 0;
+    if (!shared) {
+      try {
+        await this.transport.cancel(session3);
+      } catch {}
+      if (this.transport.removeSession) {
+        try {
+          await this.transport.removeSession(session3);
+        } catch (error2) {
+          await this.logger.error("session.archive_close_failed", "failed to close acpx session on archive", {
+            alias: internalAlias,
+            transportSession: session3.transportSession,
+            message: error2 instanceof Error ? error2.message : String(error2)
+          });
+        }
+      }
+    }
+    await this.sessions.setArchived(internalAlias, true);
+  }
+  async unarchiveSession(internalAlias) {
+    await this.sessions.setArchived(internalAlias, false);
+  }
   async listNativeSessionsForControl(agent3, workspace3) {
     const listAgentSessions = this.transport.listAgentSessions?.bind(this.transport);
     if (!listAgentSessions)
@@ -29659,6 +29756,10 @@ class SessionService {
       const previousCurrent = prevCtx?.current_session;
       const carriedPrevious = previousCurrent && previousCurrent !== internalAlias ? previousCurrent : prevCtx?.previous_session;
       session3.last_used_at = new Date().toISOString();
+      if (session3.archived) {
+        delete session3.archived;
+        delete session3.archived_at;
+      }
       const nextCtx = { ...prevCtx, current_session: internalAlias };
       if (carriedPrevious) {
         nextCtx.previous_session = carriedPrevious;
@@ -29860,6 +29961,22 @@ class SessionService {
     }
     return count;
   }
+  async setArchived(alias, archived) {
+    await this.mutate(async () => {
+      const session3 = this.state.sessions[alias];
+      if (!session3) {
+        throw new Error(`session "${alias}" does not exist`);
+      }
+      if (archived) {
+        session3.archived = true;
+        session3.archived_at = new Date(this.now()).toISOString();
+      } else {
+        delete session3.archived;
+        delete session3.archived_at;
+      }
+      await this.persist();
+    });
+  }
   async removeSession(alias) {
     return await this.mutate(async () => {
       const session3 = this.state.sessions[alias];
@@ -29974,7 +30091,8 @@ class SessionService {
       modeId: session3.mode_id,
       replyMode: session3.reply_mode,
       effectiveReplyMode,
-      cwd: workspaceConfig.cwd
+      cwd: workspaceConfig.cwd,
+      archived: session3.archived === true
     };
   }
   async setSessionModel(alias, modelId) {
@@ -31391,6 +31509,9 @@ ${result.text}` : "" };
   async removeSession(session3) {
     await this.client.request("removeSession", this.toParams(session3));
   }
+  async deleteSession(session3) {
+    await this.client.request("deleteSession", this.toParams(session3));
+  }
   async getAgentSessionId(session3) {
     const result = await this.client.request("getAgentSessionId", this.toParams(session3));
     return result.agentSessionId;
@@ -31959,6 +32080,31 @@ var init_agent_session_list = __esm(() => {
   init_path();
 });
 
+// src/transport/acpx-session-files.ts
+import { readdir as readdir3, unlink as unlink2 } from "node:fs/promises";
+import { homedir as homedir9 } from "node:os";
+import { join as join19 } from "node:path";
+async function deleteAcpxSessionFiles(options) {
+  const dir = options.sessionsDir ?? join19(homedir9(), ".acpx", "sessions");
+  const safeId = encodeURIComponent(options.acpxRecordId);
+  await unlink2(join19(dir, `${safeId}.json`)).catch(() => {
+    return;
+  });
+  let entries;
+  try {
+    entries = await readdir3(dir);
+  } catch {
+    return;
+  }
+  const streamFiles = entries.filter((name) => name.startsWith(`${safeId}.stream.`));
+  for (const name of streamFiles) {
+    await unlink2(join19(dir, name)).catch(() => {
+      return;
+    });
+  }
+}
+var init_acpx_session_files = () => {};
+
 // src/transport/acpx-cli/acpx-cli-transport.ts
 import { createRequire as createRequire5 } from "node:module";
 import { spawn as spawn9 } from "node:child_process";
@@ -32217,6 +32363,16 @@ ${baseText}` : "" };
     const detail = normalizeCommandError(result) ?? `command failed with exit code ${result.code}`;
     throw new Error(detail);
   }
+  async deleteSession(session3) {
+    let acpxRecordId;
+    try {
+      ({ acpxRecordId } = await this.readSessionRecord(session3));
+    } catch {
+      return;
+    }
+    await this.removeSession(session3);
+    await deleteAcpxSessionFiles({ acpxRecordId });
+  }
   async hasSession(session3) {
     const result = await this.runCommand(this.command, this.buildArgs(session3, [
       "sessions",
@@ -32253,7 +32409,7 @@ ${baseText}` : "" };
       const parsed = JSON.parse(result.stdout);
       const acpxRecordId = typeof parsed.acpxRecordId === "string" ? parsed.acpxRecordId : typeof parsed.id === "string" ? parsed.id : undefined;
       const agentSessionId = typeof parsed.agentSessionId === "string" ? parsed.agentSessionId : undefined;
-      if (acpxRecordId) {
+      if (acpxRecordId && /^[\w.:-]+$/.test(acpxRecordId) && acpxRecordId.length >= 8) {
         return { acpxRecordId, agentSessionId };
       }
     } catch {
@@ -32532,6 +32688,7 @@ var init_acpx_cli_transport = __esm(() => {
   init_terminate_process_tree();
   init_acpx_queue_owner_launcher();
   init_agent_session_list();
+  init_acpx_session_files();
   require4 = createRequire5(import.meta.url);
 });
 
@@ -33003,8 +33160,8 @@ function createControlEventBus(logger2) {
 
 // src/transport/native-session-history.ts
 import { readFile as readFile14 } from "node:fs/promises";
-import { homedir as homedir9 } from "node:os";
-import { join as join19 } from "node:path";
+import { homedir as homedir10 } from "node:os";
+import { join as join20 } from "node:path";
 function classifyToolKind(name) {
   const n = name.toLowerCase();
   if (/(^|[^a-z])(read|cat|view|open)([^a-z]|$)/.test(n))
@@ -33116,8 +33273,8 @@ function mapAcpxMessagesToHistory(raw) {
 }
 async function readNativeSessionHistory(opts) {
   try {
-    const dir = opts.sessionsDir ?? join19(opts.homeDir ?? homedir9(), ".acpx", "sessions");
-    const indexRaw = await readFile14(join19(dir, "index.json"), "utf8").catch(() => null);
+    const dir = opts.sessionsDir ?? join20(opts.homeDir ?? homedir10(), ".acpx", "sessions");
+    const indexRaw = await readFile14(join20(dir, "index.json"), "utf8").catch(() => null);
     if (!indexRaw)
       return [];
     const index = JSON.parse(indexRaw);
@@ -33126,7 +33283,7 @@ async function readNativeSessionHistory(opts) {
     for (const entry of candidates) {
       if (!entry.file)
         continue;
-      const recRaw = await readFile14(join19(dir, entry.file), "utf8").catch(() => null);
+      const recRaw = await readFile14(join20(dir, entry.file), "utf8").catch(() => null);
       if (!recRaw)
         continue;
       const record3 = JSON.parse(recRaw);
@@ -33144,14 +33301,14 @@ var init_native_session_history = () => {};
 // src/control/workspace-fs.ts
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { homedir as homedir10 } from "node:os";
-import { readdir as readdir3, realpath, stat as stat3, open as open5 } from "node:fs/promises";
+import { homedir as homedir11 } from "node:os";
+import { readdir as readdir4, realpath, stat as stat3, open as open5 } from "node:fs/promises";
 import { isAbsolute as isAbsolute3, relative, resolve as resolve3, sep } from "node:path";
 function expandHome2(p) {
   if (p === "~")
-    return homedir10();
+    return homedir11();
   if (p.startsWith("~/") || p.startsWith("~" + sep))
-    return resolve3(homedir10(), p.slice(2));
+    return resolve3(homedir11(), p.slice(2));
   return p;
 }
 
@@ -33186,7 +33343,7 @@ class WorkspaceFs {
   }
   async listDirectory(workspace3, relPath) {
     const { abs, rel } = await this.resolve(workspace3, relPath);
-    const dirents = await readdir3(abs, { withFileTypes: true });
+    const dirents = await readdir4(abs, { withFileTypes: true });
     const entries = [];
     for (const d of dirents.slice(0, MAX_ENTRIES)) {
       if (d.isDirectory()) {
@@ -33240,7 +33397,7 @@ class WorkspaceFs {
       const dir = queue.shift();
       let dirents;
       try {
-        dirents = await readdir3(dir, { withFileTypes: true });
+        dirents = await readdir4(dir, { withFileTypes: true });
       } catch {
         continue;
       }
@@ -33389,7 +33546,8 @@ class ControlService {
       agent: session3.agent,
       workspace: session3.workspace,
       transportSession: session3.transportSession,
-      running: this.deps.activeTurns.isActiveAnywhere(session3.alias)
+      running: this.deps.activeTurns.isActiveAnywhere(session3.alias),
+      archived: session3.archived === true
     }));
   }
   async listNativeSessions(_chatKey, agent3, workspace3) {
@@ -33419,15 +33577,26 @@ class ControlService {
       agent: session3.agent,
       workspace: session3.workspace,
       transportSession: session3.transportSession,
-      running: false
+      running: false,
+      archived: false
     };
   }
   async removeSession(chatKey, alias) {
     const internalAlias = await this.deps.sessions.resolveAliasForChat(chatKey, alias);
-    const result = await this.deps.sessions.removeSession(internalAlias);
+    const result = await this.deps.removeSessionWithTransport(internalAlias);
     this.deps.events.emit({ type: "sessions-changed" });
     return result;
   }
+  async archiveSession(chatKey, alias) {
+    const internalAlias = await this.deps.sessions.resolveAliasForChat(chatKey, alias);
+    await this.deps.archiveSessionWithTransport(internalAlias);
+    this.deps.events.emit({ type: "sessions-changed" });
+  }
+  async unarchiveSession(chatKey, alias) {
+    const internalAlias = await this.deps.sessions.resolveAliasForChat(chatKey, alias);
+    await this.deps.unarchiveSession(internalAlias);
+    this.deps.events.emit({ type: "sessions-changed" });
+  }
   listAgents() {
     return this.deps.agents.list();
   }
@@ -33692,7 +33861,7 @@ var init_control_service = __esm(() => {
 
 // src/config/agent-catalog.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { delimiter as delimiter2, join as join20 } from "node:path";
+import { delimiter as delimiter2, join as join21 } from "node:path";
 function isBinaryOnPath(binary) {
   const path15 = process.env.PATH ?? "";
   const exts = process.platform === "win32" ? ["", ".exe", ".cmd", ".bat"] : [""];
@@ -33701,7 +33870,7 @@ function isBinaryOnPath(binary) {
       continue;
     for (const ext of exts) {
       try {
-        if (existsSync3(join20(dir, binary + ext)))
+        if (existsSync3(join21(dir, binary + ext)))
           return true;
       } catch {}
     }
@@ -33741,8 +33910,8 @@ __export(exports_main, {
   buildApp: () => buildApp
 });
 import { randomUUID as randomUUID3 } from "node:crypto";
-import { homedir as homedir11 } from "node:os";
-import { dirname as dirname12, join as join21 } from "node:path";
+import { homedir as homedir12 } from "node:os";
+import { dirname as dirname12, join as join22 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 function startProgressHeartbeat(orchestration3, config4, logger2, channel) {
   const thresholdSeconds = config4.orchestration.progressHeartbeatSeconds;
@@ -34240,6 +34409,9 @@ async function buildApp(paths, deps = {}) {
     createSessionWithTransport: (internalAlias, agent4, workspace3, model) => router3.createSessionWithTransport(internalAlias, agent4, workspace3, model),
     listNativeSessions: (agent4, workspace3) => router3.listNativeSessionsForControl(agent4, workspace3),
     attachNativeSessionWithTransport: (internalAlias, agent4, workspace3, agentSessionId, nativeMeta) => router3.attachNativeSessionWithTransport(internalAlias, agent4, workspace3, agentSessionId, nativeMeta),
+    removeSessionWithTransport: (internalAlias) => router3.removeSessionWithTransport(internalAlias),
+    archiveSessionWithTransport: (internalAlias) => router3.archiveSessionWithTransport(internalAlias),
+    unarchiveSession: (internalAlias) => router3.unarchiveSession(internalAlias),
     activeTurns,
     scheduled: scheduledService,
     orchestration: orchestration3,
@@ -34402,8 +34574,8 @@ async function main() {
   }
 }
 async function prepareChannelMedia(configPath, config4) {
-  const runtimeDir = join21(dirname12(configPath), "runtime");
-  const mediaRootDir = join21(runtimeDir, "media");
+  const runtimeDir = join22(dirname12(configPath), "runtime");
+  const mediaRootDir = join22(runtimeDir, "media");
   const mediaStore = new RuntimeMediaStore({ rootDir: mediaRootDir });
   await mediaStore.cleanupExpired().catch((error2) => {
     console.error("[xacpx] media cleanup failed:", error2 instanceof Error ? error2.message : String(error2));
@@ -34412,16 +34584,16 @@ async function prepareChannelMedia(configPath, config4) {
   return { mediaStore, channelDeps: { mediaStore, allowedMediaRoots } };
 }
 function resolveRuntimePaths() {
-  const home = process.env.HOME ?? homedir11();
+  const home = process.env.HOME ?? homedir12();
   if (!home) {
     throw new Error("Unable to resolve the current user home directory");
   }
-  const configPath = coreEnv("CONFIG") ?? join21(coreHomeDir(home), "config.json");
-  const runtimeDir = join21(dirname12(configPath), "runtime");
+  const configPath = coreEnv("CONFIG") ?? join22(coreHomeDir(home), "config.json");
+  const runtimeDir = join22(dirname12(configPath), "runtime");
   return {
     configPath,
-    statePath: coreEnv("STATE") ?? join21(coreHomeDir(home), "state.json"),
-    perfLogPath: join21(runtimeDir, "perf.log"),
+    statePath: coreEnv("STATE") ?? join22(coreHomeDir(home), "state.json"),
+    perfLogPath: join22(runtimeDir, "perf.log"),
     orchestrationSocketPath: coreEnv("ORCHESTRATION_SOCKET") ?? resolveDaemonOrchestrationSocketPath(runtimeDir)
   };
 }
@@ -34433,13 +34605,13 @@ function resolveBridgeEntryPath() {
 }
 function resolveAppLogPath(configPath) {
   const rootDir = dirname12(configPath);
-  const runtimeDir = join21(rootDir, "runtime");
-  return join21(runtimeDir, "app.log");
+  const runtimeDir = join22(rootDir, "runtime");
+  return join22(runtimeDir, "app.log");
 }
 function resolvePerfLogPath(configPath) {
   const rootDir = dirname12(configPath);
-  const runtimeDir = join21(rootDir, "runtime");
-  return join21(runtimeDir, "perf.log");
+  const runtimeDir = join22(rootDir, "runtime");
+  return join22(runtimeDir, "perf.log");
 }
 function resolveOrchestrationSocketPathFromConfigPath(configPath) {
   const runtimeDir = resolveRuntimeDirFromConfigPath(configPath);
@@ -34677,12 +34849,12 @@ var init_config_check = __esm(async () => {
 });
 
 // src/doctor/checks/daemon-check.ts
-import { readdir as readdir4, readFile as readFile15, rm as rm10 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile15, rm as rm10 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
-import { homedir as homedir12 } from "node:os";
-import { join as join22 } from "node:path";
+import { homedir as homedir13 } from "node:os";
+import { join as join23 } from "node:path";
 async function checkDaemon(options = {}) {
-  const home = options.home ?? process.env.HOME ?? homedir12();
+  const home = options.home ?? process.env.HOME ?? homedir13();
   const runtimeDir = options.configPath ? resolveRuntimeDirFromConfigPath(options.configPath) : undefined;
   const paths = (options.resolveDaemonPaths ?? resolveDaemonPaths)({
     home,
@@ -34782,7 +34954,7 @@ async function detectStaleConsumerLockFix(runtimeDir, deps) {
     if (!fileName.endsWith(CONSUMER_LOCK_SUFFIX)) {
       continue;
     }
-    const lockPath = join22(runtimeDir, fileName);
+    const lockPath = join23(runtimeDir, fileName);
     const lock2 = await deps.readConsumerLock(lockPath);
     if (lock2 && !deps.isProcessRunning(lock2.pid)) {
       stalePaths.push(lockPath);
@@ -34816,7 +34988,7 @@ async function detectStaleConsumerLockFix(runtimeDir, deps) {
 }
 async function defaultListConsumerLocks(runtimeDir) {
   try {
-    return await readdir4(runtimeDir);
+    return await readdir5(runtimeDir);
   } catch {
     return [];
   }
@@ -34846,11 +35018,11 @@ var init_daemon_check = __esm(() => {
 });
 
 // src/doctor/checks/logs-check.ts
-import { stat as stat4, readdir as readdir5 } from "node:fs/promises";
-import { basename as basename3, join as join23 } from "node:path";
-import { homedir as homedir13 } from "node:os";
+import { stat as stat4, readdir as readdir6 } from "node:fs/promises";
+import { basename as basename3, join as join24 } from "node:path";
+import { homedir as homedir14 } from "node:os";
 async function checkLogs(options = {}) {
-  const home = options.home ?? process.env.HOME ?? homedir13();
+  const home = options.home ?? process.env.HOME ?? homedir14();
   const runtimeDir = options.configPath ? resolveRuntimeDirFromConfigPath(options.configPath) : undefined;
   const paths = (options.resolveDaemonPaths ?? resolveDaemonPaths)({
     home,
@@ -34882,7 +35054,7 @@ async function checkLogs(options = {}) {
   const matched = entries.filter((entry) => isTrackedLogName(entry, tracked));
   const files = [];
   for (const name of matched) {
-    const path15 = join23(paths.runtimeDir, name);
+    const path15 = join24(paths.runtimeDir, name);
     try {
       const fileStat = await probe.stat(path15);
       if (fileStat.isDirectory()) {
@@ -34963,7 +35135,7 @@ function formatBytes(bytes) {
 function createLogsFsProbe() {
   return {
     stat: async (path15) => await stat4(path15),
-    readdir: async (path15) => await readdir5(path15)
+    readdir: async (path15) => await readdir6(path15)
   };
 }
 function formatError6(error2) {
@@ -35032,9 +35204,9 @@ var init_orchestration_health = __esm(() => {
 });
 
 // src/doctor/checks/orchestration-socket-check.ts
-import { homedir as homedir14 } from "node:os";
+import { homedir as homedir15 } from "node:os";
 async function checkOrchestrationSocket(options = {}) {
-  const home = options.home ?? process.env.HOME ?? homedir14();
+  const home = options.home ?? process.env.HOME ?? homedir15();
   const runtimeDir = options.configPath ? resolveRuntimeDirFromConfigPath(options.configPath) : undefined;
   const paths = (options.resolveDaemonPaths ?? resolveDaemonPaths)({
     home,
@@ -35209,9 +35381,9 @@ var init_plugin_check = __esm(async () => {
 import { constants } from "node:fs";
 import { access as access4, stat as stat5 } from "node:fs/promises";
 import { dirname as dirname13 } from "node:path";
-import { homedir as homedir15 } from "node:os";
+import { homedir as homedir16 } from "node:os";
 async function checkRuntime(options = {}) {
-  const home = options.home ?? process.env.HOME ?? homedir15();
+  const home = options.home ?? process.env.HOME ?? homedir16();
   const runtimeDir = options.configPath ? resolveRuntimeDirFromConfigPath(options.configPath) : undefined;
   const paths = (options.resolveDaemonPaths ?? resolveDaemonPaths)({
     home,
@@ -35844,10 +36016,10 @@ var init_render_doctor = __esm(() => {
 });
 
 // src/doctor/doctor.ts
-import { homedir as homedir16 } from "node:os";
-import { join as join24 } from "node:path";
+import { homedir as homedir17 } from "node:os";
+import { join as join25 } from "node:path";
 async function runDoctor(options = {}, deps = {}) {
-  const home = deps.home ?? process.env.HOME ?? homedir16();
+  const home = deps.home ?? process.env.HOME ?? homedir17();
   const runtimePaths = resolveDoctorRuntimePaths(home, deps.resolveRuntimePaths);
   const sharedLoadConfig = createSharedLoadConfig(runtimePaths, deps.loadConfig ?? loadConfig);
   const runners = [
@@ -36000,8 +36172,8 @@ function resolveDoctorRuntimePaths(home, resolver) {
     return resolveRuntimePaths();
   }
   return {
-    configPath: join24(coreHomeDir(home), "config.json"),
-    statePath: join24(coreHomeDir(home), "state.json")
+    configPath: join25(coreHomeDir(home), "config.json"),
+    statePath: join25(coreHomeDir(home), "state.json")
   };
 }
 function depsUseExplicitRuntimeOverrides() {
@@ -36184,8 +36356,8 @@ var init_doctor2 = __esm(async () => {
 // src/cli.ts
 init_core_home();
 import { randomUUID as randomUUID4 } from "node:crypto";
-import { homedir as homedir17 } from "node:os";
-import { dirname as dirname14, join as join25, sep as sep2 } from "node:path";
+import { homedir as homedir18 } from "node:os";
+import { dirname as dirname14, join as join26, sep as sep2 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 
 // src/runtime/migrate-core-home.ts
@@ -52439,7 +52611,7 @@ async function createCliScheduledTaskService() {
   return new ScheduledTaskService(state, stateStore);
 }
 function resolveConfigPathForCurrentEnv() {
-  return coreEnv("CONFIG") ?? join25(coreHomeDir(requireHome2()), "config.json");
+  return coreEnv("CONFIG") ?? join26(coreHomeDir(requireHome2()), "config.json");
 }
 function resolveDaemonPathsForCurrentConfig() {
   const configPath = resolveConfigPathForCurrentEnv();
@@ -52790,7 +52962,7 @@ function decodeFirstRunOnboarding(raw) {
   return null;
 }
 function requireHome2() {
-  const home = process.env.HOME ?? homedir17();
+  const home = process.env.HOME ?? homedir18();
   if (!home) {
     throw new Error("Unable to resolve the current user home directory");
   }
@@ -52814,7 +52986,7 @@ function safeDaemonLogPaths() {
     const configPath = resolveConfigPathForCurrentEnv();
     const paths = resolveDaemonPathsForCurrentConfig();
     return {
-      appLog: join25(dirname14(configPath), "runtime", "app.log"),
+      appLog: join26(dirname14(configPath), "runtime", "app.log"),
       stderrLog: paths.stderrLog
     };
   } catch {

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

@@ -38,6 +38,7 @@ export declare function handleCancel(context: SessionHandlerContext, chatKey: st
 export declare function handleSessionReset(context: SessionHandlerContext, chatKey: string): Promise<RouterResponse>;
 export declare function handleSessionTail(context: SessionHandlerContext, chatKey: string, lines?: number): Promise<RouterResponse>;
 export declare function handleSessionRemove(context: SessionHandlerContext, chatKey: string, alias: string): Promise<RouterResponse>;
+export declare function handleSessionArchive(context: SessionHandlerContext, chatKey: string, alias: string, archive: (internalAlias: string) => Promise<void>): Promise<RouterResponse>;
 export declare function handlePromptWithSession(context: SessionHandlerContext, session: ResolvedSession, chatKey: string, text: string, reply?: (text: string) => Promise<void>, replyContextToken?: string, accountId?: string, media?: PromptMediaInput, abortSignal?: AbortSignal, onToolEvent?: (event: ToolUseEvent) => void | Promise<void>, onThought?: (chunk: string) => void | Promise<void>, perfSpan?: PerfSpan, metadata?: ChatRequestMetadata, onPlan?: (entries: PlanEntry[]) => void | Promise<void>, onUsage?: (usage: {
     used: number;
     size: number;

package/dist/commands/parse-command.d.ts

@@ -64,6 +64,9 @@ export type ParsedCommand = {
 } | {
     kind: "session.rm";
     alias: string;
+} | {
+    kind: "session.archive";
+    alias: string;
 } | {
     kind: "delegate.request";
     targetAgent: string;

package/dist/control/control-service.d.ts

@@ -15,6 +15,7 @@ export interface ControlSessionInfo {
     workspace: string;
     transportSession: string;
     running: boolean;
+    archived: boolean;
 }
 export interface ControlAgentInfo {
     name: string;
@@ -37,6 +38,11 @@ export interface ControlServiceDeps {
     sessions: Pick<SessionService, "listAllResolvedSessions" | "removeSession" | "useSession" | "resolveAliasForChat" | "getSession" | "setSessionModel">;
     transport: Pick<SessionTransport, "setModel" | "getSessionModel">;
     createSessionWithTransport: (internalAlias: string, agent: string, workspace: string, model?: string) => Promise<ResolvedSession>;
+    removeSessionWithTransport: (internalAlias: string) => Promise<{
+        wasActive: boolean;
+    }>;
+    archiveSessionWithTransport: (internalAlias: string) => Promise<void>;
+    unarchiveSession: (internalAlias: string) => Promise<void>;
     listNativeSessions: (agent: string, workspace: string) => Promise<AgentSession[]>;
     attachNativeSessionWithTransport: (internalAlias: string, agent: string, workspace: string, agentSessionId: string, nativeMeta?: {
         title?: string | null;
@@ -121,6 +127,8 @@ export declare class ControlService {
     removeSession(chatKey: string, alias: string): Promise<{
         wasActive: boolean;
     }>;
+    archiveSession(chatKey: string, alias: string): Promise<void>;
+    unarchiveSession(chatKey: string, alias: string): Promise<void>;
     listAgents(): ControlAgentInfo[];
     listWorkspaces(): ControlWorkspaceInfo[];
     createWorkspace(name: string, cwd: string, description?: string): Promise<ControlWorkspaceInfo>;

package/dist/i18n/types.d.ts

@@ -50,6 +50,7 @@ export interface SessionMessages {
     sessionBlockedByTasks: (alias: string, count: number) => string;
     sessionBlockedByTasksHint: string;
     sessionRemoved: (alias: string) => string;
+    sessionArchived: (alias: string) => string;
     sessionRemovedWasActive: string;
     sessionRemovedWasActivePromoted: (alias: string) => string;
     sessionTransportShared: (transportSession: string, count: number) => string;

package/dist/plugin-api.js

@@ -116,6 +116,7 @@ ${detail}`,
     sessionBlockedByTasks: (alias, count) => `Session "${alias}" has ${count} unfinished task(s). Cancel or wait for them to complete first.`,
     sessionBlockedByTasksHint: "Use /tasks to list tasks, or /task cancel <id> to cancel one.",
     sessionRemoved: (alias) => `Session "${alias}" removed.`,
+    sessionArchived: (alias) => `Archived session "${alias}". Send a message to restore it.`,
     sessionRemovedWasActive: "This was the active session. Its chat context has been cleared.",
     sessionRemovedWasActivePromoted: (alias) => `This was the active session. Switched back to the previous session "${alias}".`,
     sessionTransportShared: (transportSession, count) => `Note: backend session "${transportSession}" is still referenced by ${count} other session(s) and was not closed.`,
@@ -1211,6 +1212,7 @@ ${detail}`,
     sessionBlockedByTasks: (alias, count) => `会话「${alias}」下还有 ${count} 个未结束的任务，请先取消或等待完成。`,
     sessionBlockedByTasksHint: "使用 /tasks 查看任务列表，或 /task cancel <id> 取消任务。",
     sessionRemoved: (alias) => `已删除会话「${alias}」。`,
+    sessionArchived: (alias) => `已归档会话「${alias}」。发送消息即可恢复。`,
     sessionRemovedWasActive: "该会话是当前活跃会话，已自动清除相关聊天上下文。",
     sessionRemovedWasActivePromoted: (alias) => `该会话是当前活跃会话，已切换回上一个会话「${alias}」。`,
     sessionTransportShared: (transportSession, count) => `提示：后端会话「${transportSession}」仍被其他 ${count} 个会话引用，未关闭。`,

package/dist/sessions/session-service.d.ts

@@ -106,6 +106,7 @@ export declare class SessionService {
     getCurrentSession(chatKey: string): Promise<ResolvedSession | null>;
     listSessions(chatKey: string): Promise<SessionListItem[]>;
     countAliasesSharingTransport(transportSession: string, excludeAlias?: string): number;
+    setArchived(alias: string, archived: boolean): Promise<void>;
     removeSession(alias: string): Promise<{
         wasActive: boolean;
     }>;

package/dist/state/types.d.ts

@@ -30,6 +30,10 @@ export interface LogicalSession {
     /** Per-session LLM model override (e.g. `gpt-5.2[high]`); falls back to the agent config default. */
     model?: string;
     reply_mode?: "stream" | "final" | "verbose";
+    /** True when the user archived this session: process closed, row greyed + sunk.
+     *  Cleared on the next useSession (restore-on-message). */
+    archived?: boolean;
+    archived_at?: string;
     created_at: string;
     last_used_at: string;
 }

package/dist/transport/types.d.ts

@@ -55,6 +55,11 @@ export interface ResolvedSession {
      * persisted state by alias) does not apply.
      */
     transient?: boolean;
+    /**
+     * True when the user archived this session (process closed, greyed out in the
+     * web dashboard). Surfaced to the control/web path via ControlSessionInfo.
+     */
+    archived?: boolean;
 }
 export interface AgentSession {
     sessionId: string;
@@ -160,6 +165,13 @@ export interface SessionTransport {
     listAgentSessions?(query: AgentSessionListQuery): Promise<AgentSessionListResult | undefined>;
     resumeAgentSession?(session: ResolvedSession, agentSessionId: string): Promise<void>;
     removeSession?(session: ResolvedSession): Promise<void>;
+    /**
+     * Hard-delete the transport session AND its on-disk history: close the acpx
+     * process, then delete acpx's record files. Distinct from removeSession (=
+     * `acpx sessions close`, which keeps history for resume). Optional: transports
+     * that can't delete omit it. A missing acpx session is a no-op (idempotent).
+     */
+    deleteSession?(session: ResolvedSession): Promise<void>;
     /**
      * Read the underlying agent-native session id for an existing transport
      * session. Used by `/clear` to keep a native session native: the fresh

package/package.json

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