@linkedclaw/cli 0.1.6 → 0.1.7

package/dist/bin.js

@@ -5741,11 +5741,15 @@ var RequesterFlows = class {
     return this.client.discover({ capability, ...extra });
   }
   /**
-   * Open a session. HTTP create → WS handshake (SESSION_CREATE/ACCEPT) → done.
+   * Open a session.
    *
-   * Default transport is /ws — native providers register there
-   * (`SkillConfig.try_acp=False` upstream default). Set `tryAcp: true` to try
-   * /acp first; on opt-in, falls back to /ws when the recipient isn't on /acp.
+   * Default: pure HTTP — `POST /sessions` then `POST /activate`. Cloud
+   * drives the SESSION_CREATE handshake to the provider server-side. No
+   * WebSocket opens on the requester side; no `agentId` registration
+   * required.
+   *
+   * `tryAcp: true` opts into the legacy WS handshake path for OpenClaw
+   * sub-agent / ACP-routed scenarios — see {@link HireParams.tryAcp}.
    */
   async hire(params) {
     const session = await this.client.createSession({
@@ -5755,9 +5759,9 @@ var RequesterFlows = class {
       ...params.referredBy !== void 0 ? { referred_by: params.referredBy } : {}
     });
     if (params.autoActivate === false) return { session, activated: false };
-    const relayUrl = params.relayUrl ?? DEFAULT_RELAY_URL;
     try {
       if (params.tryAcp) {
+        const relayUrl = params.relayUrl ?? DEFAULT_RELAY_URL;
         const acpUrl = relayUrl.replace(/\/ws$/, "/acp");
         try {
           await this.attemptHandshake(acpUrl, session.session_id, params, ACP_CONNECT_TIMEOUT_MS);
@@ -5765,8 +5769,6 @@ var RequesterFlows = class {
           if (!(err instanceof TransportMissError)) throw err;
           await this.attemptHandshake(relayUrl, session.session_id, params, SESSION_ACCEPT_TIMEOUT_MS);
         }
-      } else {
-        await this.attemptHandshake(relayUrl, session.session_id, params, SESSION_ACCEPT_TIMEOUT_MS);
       }
       await this.client.activateSession(session.session_id);
     } catch (err) {
@@ -5779,7 +5781,14 @@ var RequesterFlows = class {
     }
     return { session, activated: true };
   }
+  // tryAcp:true path only. Default `hire()` no longer calls this — see the
+  // method comment on `hire`. Kept for OpenClaw sub-agent integration.
   async attemptHandshake(url, sessionId, params, connectTimeoutMs) {
+    if (!params.agentId) {
+      throw new Error(
+        "attemptHandshake (tryAcp:true) requires `agentId` in HireParams \u2014 the WS IDENTIFY frame validates listing ownership. Use the default HTTP path (omit tryAcp) if you don't have a registered agent listing."
+      );
+    }
     const ws = new WebSocket2(url);
     try {
       await new Promise((resolve3, reject) => {