Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

packages/sdk/src/transport.test.ts

@@ -0,0 +1,98 @@
+// OpenClaw SDK tests cover transport behavior.
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { GatewayClientTransport } from "./transport.js";
+
+type MockGatewayClientInstance = {
+  opts: {
+    onConnectError?: (error: Error) => void;
+    onHelloOk?: (hello: unknown) => void;
+  };
+  request: ReturnType<typeof vi.fn>;
+  start: ReturnType<typeof vi.fn>;
+  stopAndWait: ReturnType<typeof vi.fn>;
+};
+
+const gatewayClientMocks = vi.hoisted(() => ({
+  instances: [] as MockGatewayClientInstance[],
+}));
+
+vi.mock("@openclaw/gateway-client", () => ({
+  GatewayClient: class {
+    readonly opts: MockGatewayClientInstance["opts"];
+    readonly request = vi.fn();
+    readonly start = vi.fn();
+    readonly stopAndWait = vi.fn(async () => {});
+
+    constructor(opts: MockGatewayClientInstance["opts"]) {
+      this.opts = opts;
+      gatewayClientMocks.instances.push(this);
+    }
+  },
+}));
+
+describe("GatewayClientTransport", () => {
+  beforeEach(() => {
+    gatewayClientMocks.instances.length = 0;
+  });
+
+  it("rejects a pending connect when the transport closes before hello-ok", async () => {
+    const transport = new GatewayClientTransport();
+
+    const connect = transport.connect();
+    const connectExpectation = expect(connect).rejects.toThrow(
+      "gateway transport closed before connect completed",
+    );
+    const client = gatewayClientMocks.instances[0];
+    expect(client?.start).toHaveBeenCalledTimes(1);
+
+    await transport.close();
+
+    await connectExpectation;
+    expect(client?.stopAndWait).toHaveBeenCalledTimes(1);
+  });
+
+  it("rejects reconnect attempts after close", async () => {
+    const transport = new GatewayClientTransport();
+
+    await transport.close();
+
+    await expect(transport.connect()).rejects.toThrow("gateway transport is closed");
+    expect(gatewayClientMocks.instances).toHaveLength(0);
+  });
+
+  it("resolves connect when a hello observer throws", async () => {
+    const onHelloOk = vi.fn(() => {
+      throw new Error("hello observer failed");
+    });
+    const transport = new GatewayClientTransport({ onHelloOk });
+
+    const connect = transport.connect();
+    const client = gatewayClientMocks.instances[0];
+
+    expect(() => client?.opts.onHelloOk?.({ sessionId: "session-1" })).toThrow(
+      "hello observer failed",
+    );
+
+    await expect(connect).resolves.toBeUndefined();
+    expect(onHelloOk).toHaveBeenCalledWith({ sessionId: "session-1" });
+  });
+
+  it("rejects connect when a connect-error observer throws", async () => {
+    const onConnectError = vi.fn(() => {
+      throw new Error("connect observer failed");
+    });
+    const transport = new GatewayClientTransport({ onConnectError });
+
+    const connect = transport.connect();
+    const connectExpectation = expect(connect).rejects.toThrow("gateway rejected");
+    const client = gatewayClientMocks.instances[0];
+
+    expect(() => client?.opts.onConnectError?.(new Error("gateway rejected"))).toThrow(
+      "connect observer failed",
+    );
+
+    await connectExpectation;
+    expect(onConnectError).toHaveBeenCalledOnce();
+    expect(client?.stopAndWait).toHaveBeenCalledTimes(1);
+  });
+});