@ganglion/xacpx 0.23.0-beta.0 → 0.23.0-beta.2

package/dist/cli.js

@@ -50322,6 +50322,7 @@ class AgentEndpointRegistry {
           }),
           node: ep.displayName ?? ep.nodeId,
           displayName: ep.displayName,
+          sessionAlias: ep.sessionAlias,
           agent: ep.agent,
           workspace: ep.workspace,
           state: ep.state,
@@ -50352,6 +50353,7 @@ class AgentEndpointRegistry {
       activity: candidate.endpoint.activity,
       capabilities: candidate.endpoint.capabilities,
       ...candidate.endpoint.displayName ? { displayName: candidate.endpoint.displayName } : {},
+      ...candidate.endpoint.sessionAlias ? { sessionAlias: candidate.endpoint.sessionAlias } : {},
       updatedAt: Date.now()
     }));
   }
@@ -50502,7 +50504,7 @@ class AgentEndpointRegistry {
     const matches = candidates.filter((candidate) => {
       if (displayNameFilter) {
         const candDisplayName = candidate.endpoint.displayName?.trim().toLowerCase();
-        const candAlias = candidate.runtime.kind === "logical" ? candidate.runtime.alias?.trim().toLowerCase() : undefined;
+        const candAlias = candidate.endpoint.sessionAlias?.trim().toLowerCase() ?? (candidate.runtime.kind === "logical" ? candidate.runtime.alias?.trim().toLowerCase() : undefined);
         if (candDisplayName !== displayNameFilter && candAlias !== displayNameFilter) {
           return false;
         }
@@ -50593,7 +50595,8 @@ class AgentEndpointRegistry {
       nodeId: this.deps.nodeId,
       endpointId: session3.logical_session_id
     };
-    const displayName = session3.display_name || toDisplaySessionAlias(session3.alias);
+    const sessionAlias = toDisplaySessionAlias(session3.alias);
+    const displayName = session3.display_name || sessionAlias;
     const isRunning = this.deps.isSessionActive?.(session3.alias) ?? false;
     return {
       address,
@@ -50602,6 +50605,7 @@ class AgentEndpointRegistry {
       agent: session3.agent,
       workspace: session3.workspace,
       displayName,
+      sessionAlias,
       state: isRunning ? "running" : "idle",
       activity: {
         status: isRunning ? "working" : "idle"
@@ -57747,7 +57751,7 @@ import { execFile as execFile2, spawn as spawn17 } from "node:child_process";
 import { promisify as promisify2 } from "node:util";
 import { homedir as homedir14 } from "node:os";
 import { readdir as readdir9, realpath as realpath6, stat as stat7, open as open10, readFile as readFile23, writeFile as writeFile9, mkdir as mkdir14, rename as fsRename, cp, rm as rm13 } from "node:fs/promises";
-import { basename as basename7, dirname as dirname22, isAbsolute as isAbsolute7, relative as relative3, resolve as resolve7, sep as sep4 } from "node:path";
+import { basename as basename7, dirname as dirname22, isAbsolute as isAbsolute7, join as join33, relative as relative3, resolve as resolve7, sep as sep4 } from "node:path";
 import writeFileAtomic3 from "write-file-atomic";
 function expandHome2(p) {
   if (p === "~")
@@ -57756,6 +57760,44 @@ function expandHome2(p) {
     return resolve7(homedir14(), p.slice(2));
   return p;
 }
+async function browseDirectories(input) {
+  const raw = (input ?? "").trim();
+  const dir = resolve7(homedir14(), expandHome2(raw));
+  const dirents = await readdir9(dir, { withFileTypes: true });
+  const out = [];
+  for (const d of dirents) {
+    if (d.isDirectory()) {
+      out.push({ name: d.name, path: join33(dir, d.name) });
+      continue;
+    }
+    if (d.isSymbolicLink()) {
+      try {
+        if ((await stat7(join33(dir, d.name))).isDirectory()) {
+          out.push({ name: d.name, path: join33(dir, d.name) });
+        }
+      } catch {}
+    }
+  }
+  out.sort((a, b) => {
+    const la = a.name.toLowerCase(), lb = b.name.toLowerCase();
+    return la < lb ? -1 : la > lb ? 1 : a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+  });
+  const truncated = out.length > MAX_BROWSE_ENTRIES;
+  if (truncated)
+    out.length = MAX_BROWSE_ENTRIES;
+  const parent = dirname22(dir);
+  return {
+    path: dir,
+    sep: sepChar(),
+    parent: parent === dir ? null : parent,
+    home: homedir14(),
+    dirs: out,
+    truncated
+  };
+}
+function sepChar() {
+  return sep4 === "\\" ? "\\" : "/";
+}
 
 class WorkspaceFs {
   listWorkspaces;
@@ -58354,7 +58396,7 @@ function globToRegExp(glob) {
     return /$^/;
   }
 }
-var execFileAsync2, MAX_ENTRIES = 2000, FILE_READ_CAP, DIFF_CAP, GIT_MAX_BUFFER, SEARCH_MAX_RESULTS = 200, SEARCH_MAX_SCAN = 20000, SEARCH_SKIP_DIRS, SEARCH_CONTENT_MAX_HITS = 500, SEARCH_CONTENT_MAX_FILE, LINE_MATCH_CAP = 2000, DOWNLOAD_MAX, GIT_TIMEOUT_MS = 1e4, SEARCH_DEADLINE_MS = 4000, MIME_BY_EXT;
+var execFileAsync2, MAX_ENTRIES = 2000, FILE_READ_CAP, DIFF_CAP, GIT_MAX_BUFFER, SEARCH_MAX_RESULTS = 200, SEARCH_MAX_SCAN = 20000, SEARCH_SKIP_DIRS, SEARCH_CONTENT_MAX_HITS = 500, SEARCH_CONTENT_MAX_FILE, LINE_MATCH_CAP = 2000, DOWNLOAD_MAX, GIT_TIMEOUT_MS = 1e4, SEARCH_DEADLINE_MS = 4000, MAX_BROWSE_ENTRIES = 1000, MIME_BY_EXT;
 var init_workspace_fs = __esm(() => {
   execFileAsync2 = promisify2(execFile2);
   FILE_READ_CAP = 256 * 1024;
@@ -58389,7 +58431,7 @@ import { execFile as execFile3 } from "node:child_process";
 import { createHash as createHash11 } from "node:crypto";
 import { lstat, mkdir as mkdir15, realpath as realpath7 } from "node:fs/promises";
 import { homedir as homedir15 } from "node:os";
-import { basename as basename8, isAbsolute as isAbsolute8, join as join33, resolve as resolve8, sep as sep5, win32 as win324 } from "node:path";
+import { basename as basename8, isAbsolute as isAbsolute8, join as join34, resolve as resolve8, sep as sep5, win32 as win324 } from "node:path";
 import { promisify as promisify3 } from "node:util";
 function expandHome3(path14) {
   if (path14 === "~")
@@ -58437,7 +58479,7 @@ class WorkspaceGit {
   writeTails = new Map;
   constructor(listWorkspaces, options = {}) {
     this.listWorkspaces = listWorkspaces;
-    this.managedWorktreesRoot = options.managedWorktreesRoot ?? join33(homedir15(), ".xacpx", "worktrees");
+    this.managedWorktreesRoot = options.managedWorktreesRoot ?? join34(homedir15(), ".xacpx", "worktrees");
     this.platform = options.platform ?? process.platform;
     this.runGitOverride = options.runGit;
   }
@@ -58669,7 +58711,7 @@ class WorkspaceGit {
       const repoKey = `${basename8(top)}-${createHash11("sha256").update(commonDir).digest("hex").slice(0, 8)}`;
       const branchSlug = branch.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "branch";
       const branchKey = `${branchSlug}-${createHash11("sha256").update(branch).digest("hex").slice(0, 6)}`;
-      const repoDir = join33(managedRoot, repoKey);
+      const repoDir = join34(managedRoot, repoKey);
       try {
         const existing = await lstat(repoDir);
         if (!existing.isDirectory() || existing.isSymbolicLink())
@@ -58682,7 +58724,7 @@ class WorkspaceGit {
       const realRepoDir = await realpath7(repoDir);
       if (!worktreePathIsWithin(managedRoot, realRepoDir, this.platform))
         throw new Error("worktree-path-unsafe");
-      const target = join33(realRepoDir, branchKey);
+      const target = join34(realRepoDir, branchKey);
       try {
         await lstat(target);
         throw new Error("worktree-path-exists");
@@ -59531,6 +59573,9 @@ class ControlService {
   listDirectory(workspace3, path15) {
     return this.workspaceFs.listDirectory(workspace3, path15);
   }
+  browseDirectories(path15) {
+    return browseDirectories(path15);
+  }
   readWorkspaceFile(workspace3, path15) {
     return this.workspaceFs.readFile(workspace3, path15);
   }
@@ -60906,9 +60951,9 @@ __export(exports_acpx_agent_overlay, {
   ACPX_MANAGED_ALIAS_PREFIX: () => ACPX_MANAGED_ALIAS_PREFIX
 });
 import { chmod as chmod5, readFile as readFile24, stat as stat9 } from "node:fs/promises";
-import { join as join34 } from "node:path";
+import { join as join35 } from "node:path";
 function acpxConfigPath(home) {
-  return join34(home, ".acpx", "config.json");
+  return join35(home, ".acpx", "config.json");
 }
 function computeAgentOverlayEntries(config4) {
   const entries = [];
@@ -61100,7 +61145,7 @@ __export(exports_main, {
 });
 import { randomUUID as randomUUID15 } from "node:crypto";
 import { homedir as homedir17 } from "node:os";
-import { dirname as dirname24, join as join35 } from "node:path";
+import { dirname as dirname24, join as join36 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 async function defaultProvisionAgentOverlays(config4, logger) {
   const entries = computeAgentOverlayEntries(config4);
@@ -61239,7 +61284,7 @@ async function buildApp(paths, deps = {}) {
     }
   });
   const runtimeRoot = dirname24(paths.configPath);
-  const messagingNodeIdentity = await new MessagingNodeIdentityStore(join35(runtimeRoot, "agent-messaging", "node.json")).loadOrCreate();
+  const messagingNodeIdentity = await new MessagingNodeIdentityStore(join36(runtimeRoot, "agent-messaging", "node.json")).loadOrCreate();
   const sessions = new SessionService(config4, debouncedStateStore, state, {
     stateMutex,
     runtimeRoot
@@ -61306,7 +61351,7 @@ async function buildApp(paths, deps = {}) {
       sessionInitTimeoutMs: config4.transport.sessionInitTimeoutMs
     } : {},
     ...deps.orphanRegistry ? {
-      generationFilePath: join35(deps.orphanRegistry.root, "generation.json")
+      generationFilePath: join36(deps.orphanRegistry.root, "generation.json")
     } : {},
     onMalformedLine: (line) => {
       logger.error("bridge.protocol.malformed_line", "dropped undecodable bridge output line", {
@@ -62087,8 +62132,8 @@ async function main() {
   }
 }
 async function prepareChannelMedia(configPath, config4) {
-  const runtimeDir = join35(dirname24(configPath), "runtime");
-  const mediaRootDir = join35(runtimeDir, "media");
+  const runtimeDir = join36(dirname24(configPath), "runtime");
+  const mediaRootDir = join36(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));
@@ -62101,12 +62146,12 @@ function resolveRuntimePaths() {
   if (!home) {
     throw new Error("Unable to resolve the current user home directory");
   }
-  const configPath = coreEnv("CONFIG") ?? join35(coreHomeDir(home), "config.json");
-  const runtimeDir = join35(dirname24(configPath), "runtime");
+  const configPath = coreEnv("CONFIG") ?? join36(coreHomeDir(home), "config.json");
+  const runtimeDir = join36(dirname24(configPath), "runtime");
   return {
     configPath,
-    statePath: coreEnv("STATE") ?? join35(coreHomeDir(home), "state.json"),
-    perfLogPath: join35(runtimeDir, "perf.log"),
+    statePath: coreEnv("STATE") ?? join36(coreHomeDir(home), "state.json"),
+    perfLogPath: join36(runtimeDir, "perf.log"),
     orchestrationSocketPath: coreEnv("ORCHESTRATION_SOCKET") ?? resolveDaemonOrchestrationSocketPath(runtimeDir)
   };
 }
@@ -62118,13 +62163,13 @@ function resolveBridgeEntryPath() {
 }
 function resolveAppLogPath(configPath) {
   const rootDir = dirname24(configPath);
-  const runtimeDir = join35(rootDir, "runtime");
-  return join35(runtimeDir, "app.log");
+  const runtimeDir = join36(rootDir, "runtime");
+  return join36(runtimeDir, "app.log");
 }
 function resolvePerfLogPath(configPath) {
   const rootDir = dirname24(configPath);
-  const runtimeDir = join35(rootDir, "runtime");
-  return join35(runtimeDir, "perf.log");
+  const runtimeDir = join36(rootDir, "runtime");
+  return join36(runtimeDir, "perf.log");
 }
 function resolveOrchestrationSocketPathFromConfigPath(configPath) {
   const runtimeDir = resolveRuntimeDirFromConfigPath(configPath);
@@ -62806,7 +62851,7 @@ var init_config_check = __esm(() => {
 import { readdir as readdir11, readFile as readFile25, rm as rm15 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 import { homedir as homedir18 } from "node:os";
-import { join as join36 } from "node:path";
+import { join as join37 } from "node:path";
 async function checkDaemon(options = {}) {
   const home = options.home ?? process.env.HOME ?? homedir18();
   const runtimeDir = options.configPath ? resolveRuntimeDirFromConfigPath(options.configPath) : undefined;
@@ -62908,7 +62953,7 @@ async function detectStaleConsumerLockFix(runtimeDir, deps) {
     if (fileName === RUNTIME_CONSUMER_LOCK_FILE || !fileName.endsWith(CONSUMER_LOCK_SUFFIX2)) {
       continue;
     }
-    const lockPath = join36(runtimeDir, fileName);
+    const lockPath = join37(runtimeDir, fileName);
     const lock2 = await deps.readConsumerLock(lockPath);
     if (lock2 && !deps.isProcessRunning(lock2.pid)) {
       stalePaths.push(lockPath);
@@ -62973,7 +63018,7 @@ var init_daemon_check = __esm(() => {
 
 // src/doctor/checks/logs-check.ts
 import { stat as stat10, readdir as readdir12 } from "node:fs/promises";
-import { basename as basename10, join as join37 } from "node:path";
+import { basename as basename10, join as join38 } from "node:path";
 import { homedir as homedir19 } from "node:os";
 async function checkLogs(options = {}) {
   const home = options.home ?? process.env.HOME ?? homedir19();
@@ -63008,7 +63053,7 @@ async function checkLogs(options = {}) {
   const matched = entries.filter((entry) => isTrackedLogName(entry, tracked));
   const files = [];
   for (const name of matched) {
-    const path16 = join37(paths.runtimeDir, name);
+    const path16 = join38(paths.runtimeDir, name);
     try {
       const fileStat = await probe.stat(path16);
       if (fileStat.isDirectory()) {
@@ -64039,7 +64084,7 @@ var init_render_doctor = __esm(() => {
 
 // src/doctor/doctor.ts
 import { homedir as homedir22 } from "node:os";
-import { join as join38 } from "node:path";
+import { join as join39 } from "node:path";
 async function runDoctor(options = {}, deps = {}) {
   const home = deps.home ?? process.env.HOME ?? homedir22();
   const runtimePaths = resolveDoctorRuntimePaths(home, deps.resolveRuntimePaths);
@@ -64200,8 +64245,8 @@ function resolveDoctorRuntimePaths(home, resolver) {
     return resolveRuntimePaths();
   }
   return {
-    configPath: join38(coreHomeDir(home), "config.json"),
-    statePath: join38(coreHomeDir(home), "state.json")
+    configPath: join39(coreHomeDir(home), "config.json"),
+    statePath: join39(coreHomeDir(home), "state.json")
   };
 }
 function depsUseExplicitRuntimeOverrides() {
@@ -64404,7 +64449,7 @@ __export(exports_cli, {
 });
 import { randomUUID as randomUUID16 } from "node:crypto";
 import { homedir as homedir23 } from "node:os";
-import { dirname as dirname26, join as join39, sep as sep6 } from "node:path";
+import { dirname as dirname26, join as join40, sep as sep6 } from "node:path";
 import { fileURLToPath as fileURLToPath9 } from "node:url";
 async function prepareMcpCoordinatorStartup(input) {
   const coordinatorSession = input.coordinatorSession.trim();
@@ -65090,14 +65135,14 @@ function createAdapterCliDeps(input) {
       const runtimeRoot = dirname26(resolveConfigPathForCurrentEnv());
       let orphanRegistry;
       if (process.platform === "win32") {
-        orphanRegistry = new OrphanRegistry(join39(runtimeRoot, "runtime"));
+        orphanRegistry = new OrphanRegistry(join40(runtimeRoot, "runtime"));
         await orphanRegistry.initialize();
       }
       const [result] = await garbageCollectAdapterReleases({
         runtimeRoot,
         id,
         releaseId,
-        statePath: coreEnv("STATE") ?? join39(runtimeRoot, "state.json"),
+        statePath: coreEnv("STATE") ?? join40(runtimeRoot, "state.json"),
         ...orphanRegistry ? { orphanRegistry } : {}
       });
       return result.disposition;
@@ -65516,7 +65561,7 @@ function safeDaemonLogPaths() {
     const configPath = resolveConfigPathForCurrentEnv();
     const paths = resolveDaemonPathsForCurrentConfig();
     return {
-      appLog: join39(dirname26(configPath), "runtime", "app.log"),
+      appLog: join40(dirname26(configPath), "runtime", "app.log"),
       stderrLog: paths.stderrLog
     };
   } catch {

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

@@ -8,7 +8,7 @@ import type { CancelTaskInput, OrchestrationService, OrchestrationTaskFilter } f
 import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types";
 import type { ControlEventBus } from "./control-event-bus";
 import type { AgentCatalogEntry } from "../config/agent-catalog";
-import { type DirListing, type FileContent, type SearchOptions, type SearchResult, type WorkspaceDiff } from "./workspace-fs";
+import { type BrowseDirsResult, type DirListing, type FileContent, type SearchOptions, type SearchResult, type WorkspaceDiff } from "./workspace-fs";
 import { type GitCheckoutOptions, type GitCommitResult, type GitPushOptions, type GitStatus, type GitWorktreeCreateOptions, type GitWorktreeCreateResult } from "./workspace-git";
 import type { AgentEndpointView, AgentMessageTraceRecord } from "../orchestration/agent-messaging-types";
 import type { PromptAttachmentRef } from "@ganglion/xacpx-relay-protocol";
@@ -226,6 +226,7 @@ export declare class ControlService {
     constructor(deps: ControlServiceDeps);
     private readonly workspaceFs;
     listDirectory(workspace: string, path?: string): Promise<DirListing>;
+    browseDirectories(path?: string): Promise<BrowseDirsResult>;
     readWorkspaceFile(workspace: string, path: string): Promise<FileContent>;
     workspaceGitDiff(workspace: string, path?: string): Promise<WorkspaceDiff>;
     workspaceGitStatus(workspace: string): Promise<GitStatus>;

package/dist/control/workspace-fs.d.ts

@@ -1,3 +1,6 @@
+/** Expand a leading `~` to the home directory (workspace cwds are often configured
+ *  as `~` or `~/path`). */
+export declare function expandHome(p: string): string;
 export interface FsEntry {
     name: string;
     type: "dir" | "file";
@@ -67,6 +70,18 @@ export interface WorkspaceDiff {
         linked: boolean;
     };
 }
+export interface BrowseDirsResult {
+    path: string;
+    sep: "/" | "\\";
+    parent: string | null;
+    home: string;
+    dirs: Array<{
+        name: string;
+        path: string;
+    }>;
+    truncated: boolean;
+}
+export declare function browseDirectories(input?: string): Promise<BrowseDirsResult>;
 export interface WorkspaceRef {
     name: string;
     cwd: string;

package/dist/orchestration/agent-messaging-types.d.ts

@@ -25,6 +25,7 @@ export interface AgentEndpointView {
     agent: string;
     workspace?: string;
     displayName?: string;
+    sessionAlias?: string;
     state: "idle" | "running" | "unreachable";
     activity: AgentActivityView;
     capabilities: AgentCapabilities;

package/package.json

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