@ganglion/xacpx 0.20.3-beta.1 → 0.20.3

package/dist/bridge/bridge-main.js

@@ -7227,8 +7227,28 @@ function deriveAgentAlias(driver, argv) {
   const hash = createHash5("sha256").update(identity).digest("hex").slice(0, 12);
   return `xacpx-managed-${driver}-${hash}`;
 }
+function isDerivedAgentArgv(driver, argv, runtimeRoot, platform) {
+  if (!argv || argv.length === 0) {
+    return false;
+  }
+  if (isManagedAdapterId(driver)) {
+    const spec = MANAGED_ADAPTERS[driver];
+    return argv[0] === "npx" && argv[1] === "-y" && argv.some((entry) => entry.startsWith(`${spec.packageName}@`)) || classifyRecordedPreinstalledAdapterCommand(renderAgentArgvIdentity(argv), {
+      runtimeRoot,
+      platform
+    }) === driver;
+  }
+  if (driver === "hermes") {
+    return argv[1]?.includes("hermes-acp-shim.") === true;
+  }
+  if (driver === "opencode" || driver === "kilocode") {
+    return argv.length === 2 && argv[0] === driver && argv[1] === "acp";
+  }
+  return false;
+}
 var IDENTITY_SAFE_ARG_RE;
 var init_agent_launch = __esm(() => {
+  init_adapter_catalog();
   IDENTITY_SAFE_ARG_RE = /^[A-Za-z0-9_@%+=:,./^~-]+$/u;
 });
 

package/dist/cli.js

@@ -4622,8 +4622,28 @@ function deriveAgentAlias(driver, argv) {
   const hash = createHash3("sha256").update(identity).digest("hex").slice(0, 12);
   return `xacpx-managed-${driver}-${hash}`;
 }
+function isDerivedAgentArgv(driver, argv, runtimeRoot, platform) {
+  if (!argv || argv.length === 0) {
+    return false;
+  }
+  if (isManagedAdapterId(driver)) {
+    const spec = MANAGED_ADAPTERS[driver];
+    return argv[0] === "npx" && argv[1] === "-y" && argv.some((entry) => entry.startsWith(`${spec.packageName}@`)) || classifyRecordedPreinstalledAdapterCommand(renderAgentArgvIdentity(argv), {
+      runtimeRoot,
+      platform
+    }) === driver;
+  }
+  if (driver === "hermes") {
+    return argv[1]?.includes("hermes-acp-shim.") === true;
+  }
+  if (driver === "opencode" || driver === "kilocode") {
+    return argv.length === 2 && argv[0] === driver && argv[1] === "acp";
+  }
+  return false;
+}
 var IDENTITY_SAFE_ARG_RE;
 var init_agent_launch = __esm(() => {
+  init_adapter_catalog();
   IDENTITY_SAFE_ARG_RE = /^[A-Za-z0-9_@%+=:,./^~-]+$/u;
 });
 
@@ -6304,6 +6324,7 @@ class ConfigStore {
       agents[name] = {
         driver: agent3.driver,
         ...agent3.command ? { command: agent3.command } : {},
+        ...agent3.argv ? { argv: [...agent3.argv] } : {},
         ...agent3.model ? { model: agent3.model } : {},
         ...agent3.settingsPolicy ? { settingsPolicy: agent3.settingsPolicy } : {}
       };
@@ -50131,7 +50152,7 @@ class SessionService {
       platform,
       runtimeRoot: this.runtimeRoot
     });
-    if (current.rawCommand) {
+    if (current.rawCommand || resolveAgentCommand(agentConfig.driver, agentConfig.command)) {
       return current;
     }
     const recordedArgv = isDerivedAgentArgv(agentConfig.driver, session3.transport_agent_argv, this.runtimeRoot, platform) ? undefined : session3.transport_agent_argv;
@@ -50151,9 +50172,6 @@ class SessionService {
     }) === agentConfig.driver);
     const recordedCommand = recordedIsDerived ? undefined : session3.transport_agent_command;
     if (recordedCommand) {
-      if (platform === "win32") {
-        throw new Error(`session "${session3.alias}" was created with a raw command that cannot be launched ` + "on Windows. Migrate the agent to an argv array in config: " + 'agents.<name>.argv = ["agent.exe", "--acp", ...]');
-      }
       return { acpxAgent: agentConfig.driver, rawCommand: recordedCommand, agentCommand: recordedCommand };
     }
     return current;
@@ -50330,25 +50348,6 @@ class SessionService {
     }
   }
 }
-function isDerivedAgentArgv(driver, argv, runtimeRoot, platform) {
-  if (!argv || argv.length === 0) {
-    return false;
-  }
-  if (isManagedAdapterId(driver)) {
-    const spec = MANAGED_ADAPTERS[driver];
-    return argv[0] === "npx" && argv[1] === "-y" && argv.some((entry) => entry.startsWith(`${spec.packageName}@`)) || classifyRecordedPreinstalledAdapterCommand(renderAgentArgvIdentity(argv), {
-      runtimeRoot,
-      platform
-    }) === driver;
-  }
-  if (driver === "hermes") {
-    return argv[1]?.includes("hermes-acp-shim.") === true;
-  }
-  if (driver === "opencode" || driver === "kilocode") {
-    return argv.length === 2 && argv[0] === driver && argv[1] === "acp";
-  }
-  return false;
-}
 var init_session_service = __esm(() => {
   init_resolve_agent_command();
   init_adapter_catalog();

package/dist/config/agent-launch.d.ts

@@ -8,16 +8,16 @@
  * - Structured launches carry `agentArgv` (exact boundaries, Windows-safe) and
  *   `agentCommand` (the stable canonical identity acpx persists and keys its
  *   session records by).
- * - `rawCommand` is the Unix-only legacy escape hatch passed as acpx `--agent`.
+ * - `rawCommand` is the legacy escape hatch / historical selector for acpx `--agent`.
  */
 export interface AgentLaunchSpec {
     /** acpx positional agent: bare driver or xacpx-managed alias. */
     acpxAgent: string;
     /** Stable acpx session identity for explicit launches. */
     agentCommand?: string;
-    /** Exact executable and argument boundaries for overlay/migration. */
+    /** Exact executable and argument boundaries for structured / overlay launches. */
     agentArgv?: string[];
-    /** Unix-only legacy raw override. */
+    /** Legacy raw override / historical session selector. */
     rawCommand?: string;
 }
 export declare function renderAgentArgvIdentity(argv: readonly string[]): string;
@@ -26,3 +26,9 @@ export declare function isValidAgentArgv(value: unknown): value is string[];
 /** Content-addressed overlay alias: stable per canonical argv across processes
  * and platforms; only acpx-safe name characters. */
 export declare function deriveAgentAlias(driver: string, argv: readonly string[]): string;
+/** Detects an argv shape that `resolveLaunchSpec` treats as derived state
+ * (managed adapter pin, hermes shim, or local fallback for opencode /
+ * kilocode). A session with such argv has `recordedArgv` reset to undefined
+ * before step 2 in `resolveLaunchSpec`, so the sticky bypass does NOT
+ * apply — the session follows the current config / derived launch instead. */
+export declare function isDerivedAgentArgv(driver: string, argv: string[] | undefined, runtimeRoot: string, platform: NodeJS.Platform): boolean;

package/dist/transport/types.d.ts

@@ -64,7 +64,7 @@ export interface ResolvedSession {
      * alias provisioned in ~/.acpx/config.json; bare drivers pass through.
      */
     acpxAgent?: string;
-    /** Unix-only legacy raw override passed as acpx `--agent`. */
+    /** Legacy raw override / historical session selector passed as acpx `--agent`. */
     rawCommand?: string;
     /** Exact executable + argument boundaries for overlay/migration. */
     agentArgv?: string[];
@@ -124,7 +124,7 @@ export interface AgentSessionListQuery {
     agentCommand?: string;
     /** Positional acpx agent for list/show queries (overlay alias or bare driver). */
     acpxAgent?: string;
-    /** Unix-only legacy raw override; the shared builder prefers it over acpxAgent. */
+    /** Legacy raw override / historical selector; the shared builder prefers it over acpxAgent. */
     rawCommand?: string;
     /** Resolved acpx driver for `agent` (e.g. a custom `my-codex` agent has driver `codex`). Used to gate driver-specific list filtering. */
     driver?: string;

package/package.json

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