惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

大猫的无限游戏
大猫的无限游戏
U
Unit 42
T
Tailwind CSS Blog
罗磊的独立博客
WordPress大学
WordPress大学
小众软件
小众软件
Recent Announcements
Recent Announcements
博客园 - 聂微东
Jina AI
Jina AI
云风的 BLOG
云风的 BLOG
博客园 - 【当耐特】
爱范儿
爱范儿
Microsoft Azure Blog
Microsoft Azure Blog
GbyAI
GbyAI
V
V2EX
博客园 - 三生石上(FineUI控件)
I
InfoQ
雷峰网
雷峰网
G
Google Developers Blog
阮一峰的网络日志
阮一峰的网络日志
B
Blog
腾讯CDC
A
About on SuperTechFans
博客园 - 叶小钗

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
fix(gateway): wait for event loop before client start · o...
steipete · 2026-04-29 · via Recent Commits to openclaw:main

@@ -22,6 +22,24 @@ const deviceIdentityState = vi.hoisted(() => ({

2222

throwOnLoad: false,

2323

}));

242425+

const eventLoopReadyState = vi.hoisted(() => ({

26+

calls: [] as Array<{ maxWaitMs?: number } | undefined>,

27+

promise: null as Promise<{

28+

ready: boolean;

29+

elapsedMs: number;

30+

maxDriftMs: number;

31+

checks: number;

32+

aborted: boolean;

33+

}> | null,

34+

result: {

35+

ready: true,

36+

elapsedMs: 0,

37+

maxDriftMs: 0,

38+

checks: 2,

39+

aborted: false,

40+

},

41+

}));

42+2543

let lastClientOptions: {

2644

url?: string;

2745

token?: string;

@@ -43,6 +61,7 @@ let lastRequestOptions: {

4361

} | null = null;

4462

type StartMode = "hello" | "close" | "silent" | "startup-retry-then-hello";

4563

let startMode: StartMode = "hello";

64+

let startCalls = 0;

4665

let closeCode = 1006;

4766

let closeReason = "";

4867

let helloMethods: string[] | undefined = ["health", "secrets.resolve"];

@@ -81,6 +100,7 @@ vi.mock("./client.js", () => ({

81100

return { ok: true };

82101

}

83102

start() {

103+

startCalls += 1;

84104

if (startMode === "hello") {

85105

void lastClientOptions?.onHelloOk?.({

86106

features: {

@@ -101,6 +121,16 @@ vi.mock("./client.js", () => ({

101121

},

102122

}));

103123124+

vi.mock("./event-loop-ready.js", () => ({

125+

waitForEventLoopReady: vi.fn(async (params?: { maxWaitMs?: number }) => {

126+

eventLoopReadyState.calls.push(params);

127+

if (eventLoopReadyState.promise) {

128+

return await eventLoopReadyState.promise;

129+

}

130+

return eventLoopReadyState.result;

131+

}),

132+

}));

133+104134

const {

105135

__testing,

106136

buildGatewayConnectionDetails,

@@ -134,6 +164,7 @@ class StubGatewayClient {

134164

return { ok: true };

135165

}

136166

start() {

167+

startCalls += 1;

137168

if (startMode === "hello") {

138169

void lastClientOptions?.onHelloOk?.({

139170

features: {

@@ -161,7 +192,17 @@ function resetGatewayCallMocks() {

161192

pickPrimaryLanIPv4.mockClear();

162193

lastClientOptions = null;

163194

lastRequestOptions = null;

195+

eventLoopReadyState.calls = [];

196+

eventLoopReadyState.promise = null;

197+

eventLoopReadyState.result = {

198+

ready: true,

199+

elapsedMs: 0,

200+

maxDriftMs: 0,

201+

checks: 2,

202+

aborted: false,

203+

};

164204

startMode = "hello";

205+

startCalls = 0;

165206

closeCode = 1006;

166207

closeReason = "";

167208

helloMethods = ["health", "secrets.resolve"];

@@ -570,52 +611,37 @@ describe("callGateway url resolution", () => {

570611

expect(lastClientOptions?.clientDisplayName).toBeUndefined();

571612

});

572613573-

it("yields one event-loop turn before starting CLI pairing requests", async () => {

614+

it("waits for event-loop readiness before starting CLI pairing requests", async () => {

574615

setLocalLoopbackGatewayConfig();

575616576-

let preConnectYieldRan = false;

577-

let sawYieldBeforeStart = false;

578-

setImmediate(() => {

579-

preConnectYieldRan = true;

617+

let resolveReady!: (result: {

618+

ready: boolean;

619+

elapsedMs: number;

620+

maxDriftMs: number;

621+

checks: number;

622+

aborted: boolean;

623+

}) => void;

624+

eventLoopReadyState.promise = new Promise((resolve) => {

625+

resolveReady = resolve;

580626

});

581627582-

__testing.setDepsForTests({

583-

createGatewayClient: (opts) =>

584-

({

585-

async request(

586-

method: string,

587-

params: unknown,

588-

requestOpts?: { expectFinal?: boolean; timeoutMs?: number | null },

589-

) {

590-

lastRequestOptions = { method, params, opts: requestOpts };

591-

return { ok: true };

592-

},

593-

start() {

594-

sawYieldBeforeStart = preConnectYieldRan;

595-

opts.onHelloOk?.({

596-

features: {

597-

methods: helloMethods ?? [],

598-

events: [],

599-

},

600-

} as unknown as Parameters<NonNullable<typeof opts.onHelloOk>>[0]);

601-

},

602-

stop() {},

603-

}) as never,

604-

getRuntimeConfig: getRuntimeConfig as unknown as () => OpenClawConfig,

605-

loadOrCreateDeviceIdentity: () => deviceIdentityState.value,

606-

resolveGatewayPort: resolveGatewayPort as unknown as (

607-

cfg?: OpenClawConfig,

608-

env?: NodeJS.ProcessEnv,

609-

) => number,

610-

});

611-612-

await callGateway({

628+

const promise = callGateway({

613629

method: "device.pair.list",

614630

mode: GATEWAY_CLIENT_MODES.CLI,

615631

clientName: GATEWAY_CLIENT_NAMES.CLI,

616632

});

617633618-

expect(sawYieldBeforeStart).toBe(true);

634+

await vi.waitFor(() => {

635+

expect(eventLoopReadyState.calls).toHaveLength(1);

636+

});

637+

expect(eventLoopReadyState.calls[0]?.maxWaitMs).toBe(10_000);

638+

expect(lastClientOptions?.clientName).toBe(GATEWAY_CLIENT_NAMES.CLI);

639+

expect(startCalls).toBe(0);

640+641+

resolveReady({ ready: true, elapsedMs: 0, maxDriftMs: 0, checks: 2, aborted: false });

642+

await promise;

643+644+

expect(startCalls).toBe(1);

619645

});

620646

});

621647

@@ -896,6 +922,51 @@ describe("callGateway error details", () => {

896922

});

897923

});

898924925+

it("charges event-loop readiness against the wrapper timeout", async () => {

926+

startMode = "silent";

927+

setLocalLoopbackGatewayConfig();

928+

eventLoopReadyState.promise = new Promise(() => {});

929+930+

vi.useFakeTimers();

931+

let errMessage = "";

932+

const promise = callGateway({ method: "health", timeoutMs: 5 }).catch((caught) => {

933+

errMessage = caught instanceof Error ? caught.message : String(caught);

934+

});

935+936+

await vi.waitFor(() => {

937+

expect(eventLoopReadyState.calls).toHaveLength(1);

938+

});

939+

expect(eventLoopReadyState.calls[0]?.maxWaitMs).toBe(5);

940+

expect(startCalls).toBe(0);

941+

await vi.advanceTimersByTimeAsync(5);

942+

await promise;

943+944+

expect(startCalls).toBe(0);

945+

expect(errMessage).toContain("gateway timeout after 5ms");

946+

});

947+948+

it("fails before connecting when event-loop readiness consumes the wrapper timeout", async () => {

949+

startMode = "silent";

950+

setLocalLoopbackGatewayConfig();

951+

eventLoopReadyState.result = {

952+

ready: false,

953+

elapsedMs: 5,

954+

maxDriftMs: 400,

955+

checks: 1,

956+

aborted: false,

957+

};

958+959+

await expect(callGateway({ method: "health", timeoutMs: 5 })).rejects.toMatchObject({

960+

name: "GatewayTransportError",

961+

kind: "timeout",

962+

timeoutMs: 5,

963+

});

964+

expect(eventLoopReadyState.calls).toHaveLength(1);

965+

expect(eventLoopReadyState.calls[0]?.maxWaitMs).toBe(5);

966+

expect(lastClientOptions).not.toBeNull();

967+

expect(startCalls).toBe(0);

968+

});

969+899970

it("keeps the default wrapper timeout aligned with configured handshake timeout", async () => {

900971

startMode = "silent";

901972

getRuntimeConfig.mockReturnValue({