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

推荐订阅源

freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
T
Tailwind CSS Blog
J
Java Code Geeks
Microsoft Azure Blog
Microsoft Azure Blog
GbyAI
GbyAI
爱范儿
爱范儿
量子位
Martin Fowler
Martin Fowler
V
V2EX
博客园 - 三生石上(FineUI控件)
I
InfoQ
MongoDB | Blog
MongoDB | Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
N
Netflix TechBlog - Medium
D
DataBreaches.Net
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Last Week in AI
Last Week in AI
U
Unit 42
Apple Machine Learning Research
Apple Machine Learning Research
H
Help Net Security
T
The Blog of Author Tim Ferriss
Hugging Face - Blog
Hugging Face - Blog
美团技术团队
Engineering at Meta
Engineering at Meta

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
feat(plugins): add sanitized model call hooks · openclaw/...
vincentkoc · 2026-04-26 · via Recent Commits to openclaw:main

@@ -1,4 +1,5 @@

11

import type { StreamFn } from "@mariozechner/pi-agent-core";

2+

import { fireAndForgetBoundedHook } from "../../../hooks/fire-and-forget.js";

23

import {

34

diagnosticErrorCategory,

45

diagnosticProviderRequestIdHash,

@@ -12,6 +13,12 @@ import {

1213

freezeDiagnosticTraceContext,

1314

type DiagnosticTraceContext,

1415

} from "../../../infra/diagnostic-trace-context.js";

16+

import { getGlobalHookRunner } from "../../../plugins/hook-runner-global.js";

17+

import type {

18+

PluginHookAgentContext,

19+

PluginHookModelCallEndedEvent,

20+

PluginHookModelCallStartedEvent,

21+

} from "../../../plugins/hook-types.js";

15221623

export { diagnosticErrorCategory };

1724

@@ -35,6 +42,10 @@ type ModelCallErrorFields = Pick<

3542

Extract<DiagnosticEventInput, { type: "model.call.error" }>,

3643

"errorCategory" | "upstreamRequestIdHash"

3744

>;

45+

type ModelCallEndedHookFields = Pick<

46+

PluginHookModelCallEndedEvent,

47+

"durationMs" | "outcome" | "errorCategory" | "upstreamRequestIdHash"

48+

>;

38493950

const MODEL_CALL_STREAM_RETURN_TIMEOUT_MS = 1000;

4051

@@ -90,6 +101,102 @@ function modelCallErrorFields(err: unknown): ModelCallErrorFields {

90101

};

91102

}

92103104+

function modelCallHookEventBase(eventBase: ModelCallEventBase): PluginHookModelCallStartedEvent {

105+

return {

106+

runId: eventBase.runId,

107+

callId: eventBase.callId,

108+

...(eventBase.sessionKey ? { sessionKey: eventBase.sessionKey } : {}),

109+

...(eventBase.sessionId ? { sessionId: eventBase.sessionId } : {}),

110+

provider: eventBase.provider,

111+

model: eventBase.model,

112+

...(eventBase.api ? { api: eventBase.api } : {}),

113+

...(eventBase.transport ? { transport: eventBase.transport } : {}),

114+

};

115+

}

116+117+

function modelCallHookContext(eventBase: ModelCallEventBase): PluginHookAgentContext {

118+

return Object.freeze({

119+

runId: eventBase.runId,

120+

trace: eventBase.trace,

121+

...(eventBase.sessionKey ? { sessionKey: eventBase.sessionKey } : {}),

122+

...(eventBase.sessionId ? { sessionId: eventBase.sessionId } : {}),

123+

modelProviderId: eventBase.provider,

124+

modelId: eventBase.model,

125+

}) as PluginHookAgentContext;

126+

}

127+128+

function dispatchModelCallStartedHook(eventBase: ModelCallEventBase): void {

129+

const hookRunner = getGlobalHookRunner();

130+

if (!hookRunner?.hasHooks("model_call_started")) {

131+

return;

132+

}

133+

const event = Object.freeze(modelCallHookEventBase(eventBase)) as PluginHookModelCallStartedEvent;

134+

const hookCtx = modelCallHookContext(eventBase);

135+

fireAndForgetBoundedHook(

136+

() => hookRunner.runModelCallStarted(event, hookCtx),

137+

"model_call_started plugin hook failed",

138+

);

139+

}

140+141+

function dispatchModelCallEndedHook(

142+

eventBase: ModelCallEventBase,

143+

fields: ModelCallEndedHookFields,

144+

): void {

145+

const hookRunner = getGlobalHookRunner();

146+

if (!hookRunner?.hasHooks("model_call_ended")) {

147+

return;

148+

}

149+

const event = Object.freeze({

150+

...modelCallHookEventBase(eventBase),

151+

...fields,

152+

}) as PluginHookModelCallEndedEvent;

153+

const hookCtx = modelCallHookContext(eventBase);

154+

fireAndForgetBoundedHook(

155+

() => hookRunner.runModelCallEnded(event, hookCtx),

156+

"model_call_ended plugin hook failed",

157+

);

158+

}

159+160+

function emitModelCallStarted(eventBase: ModelCallEventBase): void {

161+

emitTrustedDiagnosticEvent({

162+

type: "model.call.started",

163+

...eventBase,

164+

});

165+

dispatchModelCallStartedHook(eventBase);

166+

}

167+168+

function emitModelCallCompleted(eventBase: ModelCallEventBase, startedAt: number): void {

169+

const durationMs = Date.now() - startedAt;

170+

emitTrustedDiagnosticEvent({

171+

type: "model.call.completed",

172+

...eventBase,

173+

durationMs,

174+

});

175+

dispatchModelCallEndedHook(eventBase, {

176+

durationMs,

177+

outcome: "completed",

178+

});

179+

}

180+181+

function emitModelCallError(

182+

eventBase: ModelCallEventBase,

183+

startedAt: number,

184+

fields: ModelCallErrorFields,

185+

): void {

186+

const durationMs = Date.now() - startedAt;

187+

emitTrustedDiagnosticEvent({

188+

type: "model.call.error",

189+

...eventBase,

190+

durationMs,

191+

...fields,

192+

});

193+

dispatchModelCallEndedHook(eventBase, {

194+

durationMs,

195+

outcome: "error",

196+

...fields,

197+

});

198+

}

199+93200

async function safeReturnIterator(iterator: AsyncIterator<unknown>): Promise<void> {

94201

let returnResult: unknown;

95202

try {

@@ -137,29 +244,15 @@ async function* observeModelCallIterator<T>(

137244

yield next.value;

138245

}

139246

terminalEmitted = true;

140-

emitTrustedDiagnosticEvent({

141-

type: "model.call.completed",

142-

...eventBase,

143-

durationMs: Date.now() - startedAt,

144-

});

247+

emitModelCallCompleted(eventBase, startedAt);

145248

} catch (err) {

146249

terminalEmitted = true;

147-

emitTrustedDiagnosticEvent({

148-

type: "model.call.error",

149-

...eventBase,

150-

durationMs: Date.now() - startedAt,

151-

...modelCallErrorFields(err),

152-

});

250+

emitModelCallError(eventBase, startedAt, modelCallErrorFields(err));

153251

throw err;

154252

} finally {

155253

if (!terminalEmitted) {

156254

await safeReturnIterator(iterator);

157-

emitTrustedDiagnosticEvent({

158-

type: "model.call.error",

159-

...eventBase,

160-

durationMs: Date.now() - startedAt,

161-

errorCategory: "StreamAbandoned",

162-

});

255+

emitModelCallError(eventBase, startedAt, { errorCategory: "StreamAbandoned" });

163256

}

164257

}

165258

}

@@ -209,11 +302,7 @@ function observeModelCallResult(

209302

startedAt,

210303

);

211304

}

212-

emitTrustedDiagnosticEvent({

213-

type: "model.call.completed",

214-

...eventBase,

215-

durationMs: Date.now() - startedAt,

216-

});

305+

emitModelCallCompleted(eventBase, startedAt);

217306

return result;

218307

}

219308

@@ -225,10 +314,7 @@ export function wrapStreamFnWithDiagnosticModelCallEvents(

225314

const callId = ctx.nextCallId();

226315

const trace = freezeDiagnosticTraceContext(createChildDiagnosticTraceContext(ctx.trace));

227316

const eventBase = baseModelCallEvent(ctx, callId, trace);

228-

emitTrustedDiagnosticEvent({

229-

type: "model.call.started",

230-

...eventBase,

231-

});

317+

emitModelCallStarted(eventBase);

232318

const startedAt = Date.now();

233319234320

try {

@@ -237,24 +323,14 @@ export function wrapStreamFnWithDiagnosticModelCallEvents(

237323

return result.then(

238324

(resolved) => observeModelCallResult(resolved, eventBase, startedAt),

239325

(err) => {

240-

emitTrustedDiagnosticEvent({

241-

type: "model.call.error",

242-

...eventBase,

243-

durationMs: Date.now() - startedAt,

244-

...modelCallErrorFields(err),

245-

});

326+

emitModelCallError(eventBase, startedAt, modelCallErrorFields(err));

246327

throw err;

247328

},

248329

);

249330

}

250331

return observeModelCallResult(result, eventBase, startedAt);

251332

} catch (err) {

252-

emitTrustedDiagnosticEvent({

253-

type: "model.call.error",

254-

...eventBase,

255-

durationMs: Date.now() - startedAt,

256-

...modelCallErrorFields(err),

257-

});

333+

emitModelCallError(eventBase, startedAt, modelCallErrorFields(err));

258334

throw err;

259335

}

260336

}) as StreamFn;