weacpx 0.5.2 → 0.6.1

package/README.md

@@ -25,7 +25,7 @@
 
 `weacpx` 适合轻量临时使用多 Agent 办公的用户。你可以用微信、飞书或元宝盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
 
-> `weacpx` 的会话是跟本地隔离的，它目前还不能使用 CLI 已有的会话，你在 weacpx 也无法看到本地的 CLI 会话记录。
+> 日常使用优先记 `/ss`：它负责创建或复用 weacpx 逻辑会话。如果你想接入本地 Codex 等 Agent 已有的原生会话，再用 `/ssn`；进阶说明见 [docs/native-sessions.md](./docs/native-sessions.md)。
 
 ## 5 分钟快速开始
 
@@ -305,6 +305,7 @@ opencode, qoder, qwen, trae
 | `/sessions` / `/session` / `/ss` | 查看会话列表 |
 | `/ss <agent> (-d <path> \| --ws <name>)` | 创建或复用当前最常用的会话 |
 | `/ss new <agent> (-d <path> \| --ws <name>)` | 强制新建会话 |
+| `/ssn <agent> (-d <path> \| --ws <name>)` | 接入本地已有的 Agent 原生会话，详见 [native sessions](./docs/native-sessions.md) |
 | `/use <alias>` | 切换当前会话 |
 | `/status` | 查看当前会话状态 |
 | `/mode` / `/mode <id>` | 查看或设置底层 `acpx` mode |
@@ -325,6 +326,8 @@ opencode, qoder, qwen, trae
 /cancel
 ```
 
+如果要接入本地 Codex 等 Agent 已有的原生会话，用 `/ssn codex -d /absolute/path/to/repo`；完整语义见 [docs/native-sessions.md](./docs/native-sessions.md)。
+
 ### 定时任务（/later）
 
 让 agent 在未来某个时间自动收到一条消息。**默认在一个为该任务新建的临时会话里执行**（沿用创建时当前会话的 agent 与工作区，对话历史全新，跑完即销毁）；加 `--bind` 则发送到创建时绑定的当前会话。到点后把消息作为普通 prompt 投递，结果推回原聊天。
@@ -449,9 +452,9 @@ Windows 上如果 MCP host 不会帮你解析带参数的 `command`，把 `node.
 ```json
 {
   "type": "stdio",
-  "command": "D:\\Users\\you\\.nvmd\\versions\\22.19.0\\node.exe",
+  "command": "C:\\Program Files\\nodejs\\node.exe",
   "args": [
-    "E:\\projects\\weacpx\\dist\\cli.js",
+    "C:\\path\\to\\weacpx\\dist\\cli.js",
     "mcp-stdio"
   ]
 }
@@ -478,6 +481,15 @@ Windows 上如果 MCP host 不会帮你解析带参数的 `command`，把 `node.
 /use frontend:codex
 ```
 
+### 接入本地已有 Codex 原生会话
+
+```text
+/ssn codex -d /absolute/path/to/backend
+/ssn 1
+```
+
+更多筛选、别名和故障排查见 [docs/native-sessions.md](./docs/native-sessions.md)。
+
 ## 配置与运行文件
 
 默认文件位置：

package/dist/bridge/bridge-main.js

@@ -826,6 +826,19 @@ async function defaultRunProcessCommand(command, args) {
 }
 var init_terminate_process_tree = () => {};
 
+// src/util/text.ts
+function truncateText(text, maxLength, ellipsis = "…") {
+  if (text.length <= maxLength)
+    return text;
+  return text.slice(0, maxLength - ellipsis.length) + ellipsis;
+}
+function escapeForDoubleQuotes(input) {
+  return input.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function quoteIfNeeded(input) {
+  return `"${escapeForDoubleQuotes(input)}"`;
+}
+
 // src/transport/acpx-queue-owner-launcher.ts
 import { createHash } from "node:crypto";
 import { spawn as spawn3 } from "node:child_process";
@@ -1013,7 +1026,7 @@ function resolveDefaultWeacpxCommand(env) {
   return "weacpx";
 }
 function quoteCommandPart(value) {
-  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+  return quoteIfNeeded(value);
 }
 var init_acpx_queue_owner_launcher = __esm(() => {
   init_spawn_command();
@@ -1032,6 +1045,99 @@ function permissionModeToFlag(permissionMode) {
   }
 }
 
+// src/util/path.ts
+import path2 from "node:path";
+import { homedir as homedir3 } from "node:os";
+function normalizePath(input) {
+  const expanded = expandHome(input);
+  if (isWindowsLikePath(expanded)) {
+    return path2.win32.normalize(expanded).replace(/\\/g, "/");
+  }
+  return path2.posix.normalize(expanded.replace(/\\/g, "/"));
+}
+function basenameForPath(input) {
+  const normalized = normalizePath(input);
+  if (ROOT_PATH_RE.test(normalized)) {
+    return normalized;
+  }
+  const base = path2.posix.basename(normalized);
+  return base || normalized;
+}
+function isSamePath(left, right) {
+  const normalizedLeft = normalizePath(left);
+  const normalizedRight = normalizePath(right);
+  if (isWindowsLikePath(normalizedLeft) || isWindowsLikePath(normalizedRight)) {
+    return normalizedLeft.toLowerCase() === normalizedRight.toLowerCase();
+  }
+  return normalizedLeft === normalizedRight;
+}
+function isWindowsLikePath(input) {
+  return WINDOWS_DRIVE_PATH_RE.test(input) || WINDOWS_UNC_PATH_RE.test(input);
+}
+function expandHome(input) {
+  return input.startsWith("~") ? homedir3() + input.slice(1) : input;
+}
+var WINDOWS_DRIVE_PATH_RE, WINDOWS_UNC_PATH_RE, ROOT_PATH_RE;
+var init_path = __esm(() => {
+  WINDOWS_DRIVE_PATH_RE = /^[a-zA-Z]:[\\/]/;
+  WINDOWS_UNC_PATH_RE = /^\\\\/;
+  ROOT_PATH_RE = /^(\/|[a-zA-Z]:\/?)$/;
+});
+
+// src/transport/agent-session-list.ts
+function isUnknownFilterCwdOption(output) {
+  return /(?:unknown|unrecognized) option/i.test(output) && output.includes("--filter-cwd");
+}
+async function runAgentSessionList(options) {
+  let result = await options.runList(true);
+  let filterLocally = false;
+  if (result.code !== 0 && options.filterCwd && isUnknownFilterCwdOption(result.stdout + result.stderr)) {
+    result = await options.runList(false);
+    filterLocally = true;
+  }
+  if (result.code !== 0) {
+    if ((result.stdout + result.stderr).includes("sessionCapabilities.list")) {
+      return;
+    }
+    throw new Error(options.formatError(result));
+  }
+  return parseAgentSessionListOutput(result.stdout, filterLocally ? options.filterCwd : undefined);
+}
+function parseAgentSessionListOutput(stdout, filterCwd) {
+  let parsed;
+  try {
+    parsed = JSON.parse(stdout);
+  } catch {
+    throw new Error("failed to parse acpx sessions list output");
+  }
+  if (!isAgentSessionListResult(parsed)) {
+    return;
+  }
+  return filterCwd ? filterAgentSessionListByCwd(parsed, filterCwd) : parsed;
+}
+function isAgentSessionListResult(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return false;
+  const record = value;
+  if (record.source !== "agent" || !Array.isArray(record.sessions))
+    return false;
+  return record.sessions.every((session) => {
+    if (!session || typeof session !== "object" || Array.isArray(session))
+      return false;
+    const item = session;
+    return typeof item.sessionId === "string";
+  });
+}
+function filterAgentSessionListByCwd(result, cwd) {
+  return {
+    ...result,
+    sessions: result.sessions.filter((session) => session.cwd && isSamePath(session.cwd, cwd))
+  };
+}
+var init_agent_session_list = __esm(() => {
+  init_path();
+});
+
 // src/bridge/bridge-main.ts
 import { createInterface } from "node:readline";
 
@@ -1091,7 +1197,7 @@ init_prompt_output();
 init_prompt_media();
 init_streaming_prompt();
 import { copyFile, readdir } from "node:fs/promises";
-import { homedir as homedir3 } from "node:os";
+import { homedir as homedir4 } from "node:os";
 import { dirname as dirname2, join as join3, win32 } from "node:path";
 import { spawn as spawn4 } from "node:child_process";
 
@@ -1111,6 +1217,7 @@ function parseMissingOptionalDep(text) {
 // src/bridge/bridge-runtime.ts
 init_discover_parent_package_paths();
 init_acpx_queue_owner_launcher();
+init_agent_session_list();
 class EnsureSessionFailedError extends Error {
   kind;
   data;
@@ -1149,6 +1256,36 @@ class BridgeRuntime {
     this.options.permissionPolicy = policy.permissionPolicy;
     return {};
   }
+  async listAgentSessions(input) {
+    return await runAgentSessionList({
+      filterCwd: input.filterCwd,
+      runList: async (includeFilterCwd) => {
+        const spec = resolveSpawnCommand(this.command, this.buildSessionArgs(input, [
+          "sessions",
+          "list",
+          ...includeFilterCwd && input.filterCwd ? ["--filter-cwd", input.filterCwd] : [],
+          ...input.cursor ? ["--cursor", input.cursor] : []
+        ], { format: "json" }));
+        return await this.run(spec.command, spec.args);
+      },
+      formatError: (result) => result.stderr || result.stdout || `sessions list failed with exit code ${result.code}`
+    });
+  }
+  async resumeAgentSession(input) {
+    const spawnSpec = resolveSpawnCommand(this.command, this.buildSessionArgs(input, [
+      "sessions",
+      "new",
+      "--name",
+      input.name,
+      "--resume-session",
+      input.agentSessionId
+    ], { format: "quiet" }));
+    const result = await this.runSessionCreate(spawnSpec.command, spawnSpec.args, input.cwd);
+    if (result.code !== 0) {
+      throw new Error(result.stderr || result.stdout || "sessions resume failed");
+    }
+    return {};
+  }
   async hasSession(input) {
     const spawnSpec = resolveSpawnCommand(this.command, this.buildSessionArgs(input, [
       "sessions",
@@ -1369,7 +1506,7 @@ class BridgeRuntime {
   buildSessionArgs(input, tail, options = {}) {
     const prefix = [
       "--format",
-      "quiet",
+      options.format ?? "quiet",
       "--cwd",
       input.cwd,
       ...this.buildPermissionArgs()
@@ -1535,7 +1672,7 @@ async function tryRepairAcpxSessionIndex(deps = {}) {
   if (platform !== "win32") {
     return false;
   }
-  const home = deps.home ?? process.env.HOME ?? process.env.USERPROFILE ?? homedir3();
+  const home = deps.home ?? process.env.HOME ?? process.env.USERPROFILE ?? homedir4();
   if (!home) {
     return false;
   }
@@ -1582,6 +1719,8 @@ var BRIDGE_METHODS = new Set([
   "hasSession",
   "ensureSession",
   "tailSessionHistory",
+  "listAgentSessions",
+  "resumeAgentSession",
   "prompt",
   "setMode",
   "cancel",
@@ -1591,6 +1730,7 @@ var SESSION_SCOPED_METHODS = new Set([
   "hasSession",
   "ensureSession",
   "tailSessionHistory",
+  "resumeAgentSession",
   "prompt",
   "setMode",
   "cancel",
@@ -1673,6 +1813,14 @@ class BridgeServer {
           name: requireString(params, "name"),
           lines: requirePositiveInt(params, "lines")
         });
+      case "listAgentSessions":
+        return await this.runtime.listAgentSessions({
+          agent: requireString(params, "agent"),
+          agentCommand: asOptionalString(params.agentCommand),
+          cwd: requireString(params, "cwd"),
+          cursor: asOptionalString(params.cursor),
+          filterCwd: asOptionalString(params.filterCwd)
+        });
       case "ensureSession":
         return await this.runtime.ensureSession({
           agent: requireString(params, "agent"),
@@ -1732,6 +1880,14 @@ class BridgeServer {
             }));
           }
         });
+      case "resumeAgentSession":
+        return await this.runtime.resumeAgentSession({
+          agent: requireString(params, "agent"),
+          agentCommand: asOptionalString(params.agentCommand),
+          cwd: requireString(params, "cwd"),
+          name: requireString(params, "name"),
+          agentSessionId: requireString(params, "agentSessionId")
+        });
       case "setMode":
         return await this.runtime.setMode({
           agent: requireString(params, "agent"),

package/dist/channels/channel-scope.d.ts

@@ -6,4 +6,12 @@ export declare function toInternalSessionAlias(channelId: string, displayAlias:
 export declare function toDisplaySessionAlias(internalAlias: string): string;
 export declare function isSessionAliasVisibleInChannel(alias: string, channelId: string): boolean;
 export declare function resolveSessionAliasForInput(channelId: string, displayAlias: string, existingAliases: Iterable<string>): string;
+/**
+ * Internal alias for a display alias entered in `channelId`. The default
+ * channel (weixin) stays unprefixed for backwards compatibility; every other
+ * channel is namespaced as `channelId:alias`. Idempotent — an already-scoped
+ * alias is not double-prefixed. This is the single home for the rule that
+ * handlers must not re-implement inline.
+ */
+export declare function scopeDisplayAliasToInternal(channelId: string, displayAlias: string): string;
 export declare function buildDefaultTransportSession(channelId: string, displayAlias: string): string;

package/dist/channels/types.d.ts

@@ -1,4 +1,5 @@
 import type { Agent as ChatAgent } from "../weixin/agent/interface.js";
+import type { CommandHint } from "../commands/command-hints.js";
 import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
 import type { AppLogger } from "../logging/app-logger.js";
 import type { PendingFinalChunk } from "../weixin/messaging/quota-manager.js";
@@ -50,6 +51,10 @@ export interface ChannelStartInput {
     quota: OutboundQuota;
     logger: AppLogger;
     perfTracer?: PerfTracer;
+    /** weacpx 内置命令目录，供支持输入框命令提示的频道使用。 */
+    commandHints?: CommandHint[];
+    /** weacpx 核心版本字符串，供需要它的频道（如命令同步元数据）使用。 */
+    coreVersion?: string;
 }
 export interface OrchestrationDeliveryCallbacks {
     markTaskNoticeDelivered: (taskId: string, accountId: string) => Promise<void>;
@@ -83,6 +88,12 @@ export interface MessageChannelRuntime {
     notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
     sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
     sendScheduledMessage?(input: ScheduledChannelMessageInput): Promise<void>;
+    /**
+     * Preferred render format for `/ssn` native session lists. weixin renders
+     * markdown tables poorly and declares "cards"; channels that omit this are
+     * treated as "table".
+     */
+    nativeSessionListFormat?: "cards" | "table";
 }
 export type ToolUseStatus = "running" | "success" | "error";
 export type ToolUseKind = "read" | "search" | "execute" | "edit" | "think" | "other";

package/dist/channels/weixin-channel.d.ts

@@ -3,6 +3,7 @@ import type { RuntimeMediaStore } from "./media-store.js";
 import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
 export declare class WeixinChannel implements MessageChannelRuntime {
     readonly id = "weixin";
+    readonly nativeSessionListFormat: "cards" | "table";
     private agent;
     private quota;
     private logger;