@openclaw/codex 2026.7.2-beta.7 → 2026.8.1-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/README.md +2 -0
  2. package/dist/api.js +147 -0
  3. package/dist/app-server-policy-bg5QPSVP.js +25 -0
  4. package/dist/attempt-client-cleanup-URjUlCHg.js +735 -0
  5. package/dist/binding-connection-DAvZwp96.js +45 -0
  6. package/dist/{bounded-turn-D2ZAgZVz.js → bounded-turn-4BjrZEwW.js} +63 -56
  7. package/dist/{capabilities-BFDTVYr4.js → capabilities-CH3K57v4.js} +8 -2
  8. package/dist/cli-metadata.js +1 -1
  9. package/dist/{command-formatters-C336eRVS.js → command-formatters-D0nZ3qtd.js} +18 -18
  10. package/dist/{command-handlers-DAHUSry9.js → command-handlers-DC86lgT4.js} +507 -101
  11. package/dist/command-rpc-xUIIonsO.js +90 -0
  12. package/dist/{compact-D_uvHurS.js → compact-COqgBRny.js} +234 -214
  13. package/dist/{session-binding-BXpo9ymA.js → config-CpNeo5AE.js} +284 -1163
  14. package/dist/context-compaction-activity-BOeJf7yo.js +58 -0
  15. package/dist/{conversation-binding-data-BHRpYbX3.js → conversation-binding-data-CW2GuupV.js} +6 -10
  16. package/dist/doctor-contract-api.js +48 -50
  17. package/dist/{dynamic-tools-D2gYkSBO.js → dynamic-tools-fJZhl4CE.js} +3442 -1433
  18. package/dist/{effective-mcp-catalog-Bbd98Inw.js → effective-mcp-catalog-4YKn51aG.js} +20 -15
  19. package/dist/elicitation-input-DMkeki8d.js +71 -0
  20. package/dist/{event-projector-assistant-message-DTgnPPVF.js → event-projector-assistant-message-BwxV4d6N.js} +11 -23
  21. package/dist/{attempt-notifications-AP-a-Q5k.js → event-projector-usage-CLwNEJqW.js} +113 -29
  22. package/dist/harness-DoKQcF8n.js +258 -0
  23. package/dist/harness.js +2 -160
  24. package/dist/image-payload-sanitizer-CnfoUPCE.js +65 -0
  25. package/dist/index.js +730 -256
  26. package/dist/isolated-completion-DPMtlH9r.js +75 -0
  27. package/dist/local-runtime-attribution-B_2mnqhb.js +19 -0
  28. package/dist/managed-binary-By4FZC6i.js +212 -0
  29. package/dist/media-understanding-provider.js +5 -5
  30. package/dist/model-catalog-CmGoqVKB.js +48 -0
  31. package/dist/{models-BBMKU4jA.js → models-CZw1wClT.js} +12 -17
  32. package/dist/native-subagent-monitor-GGq3RnOo.js +3225 -0
  33. package/dist/node-exec-server.runtime-Bsu1LdFZ.js +192 -0
  34. package/dist/{plugin-app-cache-key-DztPafOA.js → plugin-app-cache-key-DMNQ8Zi8.js} +18 -6
  35. package/dist/plugin-approval-roundtrip-C75Yiiwc.js +95 -0
  36. package/dist/plugin-marketplace-discovery-CSWDkMrP.js +399 -0
  37. package/dist/{computer-use-CYEc8U3w.js → plugin-metadata-cache-BXH5NF-4.js} +109 -6
  38. package/dist/protocol-validators-VAVyEnDp.js +2399 -0
  39. package/dist/{rate-limits-CU-gVCCS.js → rate-limits-BI1dMHDG.js} +17 -35
  40. package/dist/{request-qKh331yu.js → request-DSK0W6YI.js} +3 -3
  41. package/dist/{run-attempt-CY9WlDLc.js → run-attempt-BV3HzuCf.js} +3416 -7194
  42. package/dist/{runtime-artifact-CmtG_t1L.js → runtime-artifact-BvyT1uyd.js} +11 -29
  43. package/dist/{sandbox-guard-NuhpXmPB.js → sandbox-guard-C1qEeZ5C.js} +29 -30
  44. package/dist/session-binding-BTrLf9Qm.js +874 -0
  45. package/dist/{session-catalog-DyOgR4WH.js → session-catalog-ezP_UcRM.js} +1584 -1289
  46. package/dist/session-catalog-home-id-BNwAJ9D7.js +18 -0
  47. package/dist/{session-cli-2PZaFLRh.js → session-cli-B1hKvfkI.js} +20 -7
  48. package/dist/session-retirement-CE4iMiLh.js +36 -0
  49. package/dist/{session-upstream-marker-B6U7tLw5.js → session-upstream-marker-D_2npHlA.js} +1 -1
  50. package/dist/{settled-turn-finalizer-CXY2Z9dT.js → settled-turn-finalizer-Dx1onIqg.js} +40 -28
  51. package/dist/{shared-client-DTbvH-XV.js → shared-client-Dw-rzii0.js} +1315 -469
  52. package/dist/{side-question-_ulBk1AL.js → side-question-DbXkJZzg.js} +140 -69
  53. package/dist/{thread-lifecycle-DF53ogiA.js → thread-lifecycle-DKdrnTMX.js} +927 -768
  54. package/dist/thread-ownership-i2NBwDUL.js +92 -0
  55. package/dist/thread-resume-CdJk2Ehf.js +30 -0
  56. package/dist/transcript-mirror-BU0_LKAL.js +588 -0
  57. package/dist/{transport-stdio-DXgGZ7Ib.js → transport-stdio-DhoGy33Z.js} +13 -2
  58. package/dist/upstream-prompt-provenance-CFmsKwr9.js +39 -0
  59. package/dist/{upstream-session-fork-Dy4Xvuoj.js → upstream-session-fork-BDVJCLAD.js} +14 -8
  60. package/dist/{usage-CQ6GhD5-.js → usage-9dKJCgcy.js} +3 -3
  61. package/dist/{web-search-provider.runtime-CCFhg2z5.js → web-search-provider.runtime-DCdx4DGu.js} +8 -9
  62. package/openclaw.plugin.json +49 -4
  63. package/package.json +6 -5
  64. package/dist/app-server-policy-BSaO2JIT.js +0 -49
  65. package/dist/conversation-control-xsIeXbo4.js +0 -287
  66. package/dist/event-projector-usage-Xp4AlR2k.js +0 -86
  67. package/dist/notification-correlation-CU6_AnOb.js +0 -67
  68. package/dist/transcript-mirror-DzsdNCf5.js +0 -6924
@@ -0,0 +1,588 @@
1
+ import { i as readUpstreamUserText, n as attachUpstreamUserText, r as readMirrorIdentity, t as attachCodexMirrorIdentity } from "./upstream-prompt-provenance-CFmsKwr9.js";
2
+ import { asOptionalRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
3
+ import { embeddedAgentLog, formatErrorMessage, projectAgentHarnessTranscriptMessageForDisplay, runAgentHarnessBeforeMessageWriteHook } from "openclaw/plugin-sdk/agent-harness-runtime";
4
+ import { createHash } from "node:crypto";
5
+ import { truncateUtf8Prefix } from "openclaw/plugin-sdk/text-utility-runtime";
6
+ import { withCodexSessionTranscriptMirrorWriteLock } from "openclaw/plugin-sdk/codex-session-transcript-runtime";
7
+ import { publishSessionTranscriptUpdateByIdentity } from "openclaw/plugin-sdk/session-transcript-runtime";
8
+ import { Buffer } from "node:buffer";
9
+ //#region extensions/codex/src/app-server/transcript-history-projection.ts
10
+ const CODEX_HISTORY_IMPORT_MAX_MESSAGES = 200;
11
+ const CODEX_HISTORY_IMPORT_MAX_BYTES = 512 * 1024;
12
+ const CODEX_HISTORY_IMPORT_MAX_MESSAGE_BYTES = 64 * 1024;
13
+ const CODEX_HISTORY_TRUNCATION_SUFFIX = "\n\n[Message truncated during Codex history import.]";
14
+ const CODEX_HISTORY_ASSISTANT_API = "openai-chatgpt-responses";
15
+ const CODEX_HISTORY_ASSISTANT_PROVIDER = "openai";
16
+ const CODEX_HISTORY_ASSISTANT_MODEL = "native-history";
17
+ const CODEX_HISTORY_ZERO_USAGE = {
18
+ input: 0,
19
+ output: 0,
20
+ cacheRead: 0,
21
+ cacheWrite: 0,
22
+ totalTokens: 0,
23
+ cost: {
24
+ input: 0,
25
+ output: 0,
26
+ cacheRead: 0,
27
+ cacheWrite: 0,
28
+ total: 0
29
+ }
30
+ };
31
+ function normalizeImportedHistoryText(value) {
32
+ if (typeof value !== "string") return;
33
+ const text = value.trim();
34
+ if (!text) return;
35
+ if (Buffer.byteLength(text, "utf8") <= CODEX_HISTORY_IMPORT_MAX_MESSAGE_BYTES) return text;
36
+ const suffixBytes = Buffer.byteLength(CODEX_HISTORY_TRUNCATION_SUFFIX, "utf8");
37
+ return `${truncateUtf8Prefix(text, Math.max(0, CODEX_HISTORY_IMPORT_MAX_MESSAGE_BYTES - suffixBytes))}${CODEX_HISTORY_TRUNCATION_SUFFIX}`;
38
+ }
39
+ function projectCodexUserItemText(item) {
40
+ if (!Array.isArray(item.content)) return;
41
+ const parts = [];
42
+ for (const value of item.content) {
43
+ if (!value || typeof value !== "object" || Array.isArray(value)) continue;
44
+ const input = value;
45
+ if (input.type === "text") {
46
+ const text = normalizeImportedHistoryText(input.text);
47
+ if (text) parts.push(text);
48
+ continue;
49
+ }
50
+ if (input.type === "image" || input.type === "localImage") {
51
+ parts.push("[Image attachment]");
52
+ continue;
53
+ }
54
+ if (input.type === "audio" || input.type === "localAudio" || input.type === "local_audio") parts.push("[Audio attachment]");
55
+ if (input.type === "skill" || input.type === "mention") {
56
+ const name = normalizeOptionalString(input.name);
57
+ if (name) parts.push(`${input.type === "skill" ? "$" : "@"}${name}`);
58
+ }
59
+ }
60
+ return normalizeImportedHistoryText(parts.join("\n"));
61
+ }
62
+ function selectTurnsThroughBoundary(thread, throughTurnId) {
63
+ if (throughTurnId === null) return [];
64
+ const turns = thread.turns ?? [];
65
+ const boundaryIndex = turns.findIndex((turn) => turn.id === throughTurnId);
66
+ if (boundaryIndex < 0) throw new Error(`Codex history boundary turn not found: ${throughTurnId}`);
67
+ const boundary = turns[boundaryIndex];
68
+ if (boundary?.status !== "completed" && boundary?.status !== "interrupted" && boundary?.status !== "failed") throw new Error(`Codex history boundary turn is not terminal: ${throughTurnId}`);
69
+ return turns.slice(0, boundaryIndex + 1);
70
+ }
71
+ function projectCodexThreadHistory(params) {
72
+ const projected = [];
73
+ const threadTimestamp = typeof params.thread.createdAt === "number" && Number.isFinite(params.thread.createdAt) ? params.thread.createdAt * 1e3 : params.importedAt;
74
+ let itemOffset = 0;
75
+ for (const turn of selectTurnsThroughBoundary(params.thread, params.throughTurnId)) for (const value of turn.items) {
76
+ const item = value;
77
+ const itemId = normalizeOptionalString(item.id);
78
+ const identity = `${turn.id}:${itemId ?? itemOffset}`;
79
+ const timestampSeconds = item.type === "agentMessage" ? turn.completedAt ?? turn.startedAt : turn.startedAt ?? turn.completedAt;
80
+ const timestamp = typeof timestampSeconds === "number" && Number.isFinite(timestampSeconds) ? timestampSeconds * 1e3 + itemOffset : threadTimestamp + itemOffset;
81
+ const text = item.type === "userMessage" ? projectCodexUserItemText(item) : item.type === "agentMessage" ? normalizeImportedHistoryText(item.text) : void 0;
82
+ const role = item.type === "userMessage" ? "user" : item.type === "agentMessage" ? "assistant" : void 0;
83
+ itemOffset += 1;
84
+ if (!text || !role) continue;
85
+ const message = role === "assistant" ? attachCodexMirrorIdentity({
86
+ role,
87
+ content: [{
88
+ type: "text",
89
+ text
90
+ }],
91
+ api: CODEX_HISTORY_ASSISTANT_API,
92
+ provider: normalizeOptionalString(params.modelProvider) ?? normalizeOptionalString(params.thread.modelProvider) ?? CODEX_HISTORY_ASSISTANT_PROVIDER,
93
+ model: CODEX_HISTORY_ASSISTANT_MODEL,
94
+ usage: CODEX_HISTORY_ZERO_USAGE,
95
+ stopReason: turn.status === "interrupted" ? "aborted" : turn.status === "failed" ? "error" : "stop",
96
+ ...turn.status === "failed" && turn.error?.message ? { errorMessage: turn.error.message } : {},
97
+ timestamp
98
+ }, identity) : attachCodexMirrorIdentity({
99
+ role,
100
+ content: text,
101
+ timestamp
102
+ }, identity);
103
+ const phase = item.phase === "commentary" || item.phase === "final_answer" ? item.phase : void 0;
104
+ projected.push({
105
+ message,
106
+ responseItem: {
107
+ type: "message",
108
+ role,
109
+ content: [{
110
+ type: role === "assistant" ? "output_text" : "input_text",
111
+ text
112
+ }],
113
+ ...role === "assistant" && phase ? { phase } : {}
114
+ },
115
+ textBytes: Buffer.byteLength(text, "utf8")
116
+ });
117
+ }
118
+ return projected;
119
+ }
120
+ function selectBoundedCodexHistoryTail(projected) {
121
+ const selected = [];
122
+ let selectedBytes = 0;
123
+ for (let index = projected.length - 1; index >= 0; index -= 1) {
124
+ const candidate = projected[index];
125
+ if (!candidate) continue;
126
+ if (selected.length >= CODEX_HISTORY_IMPORT_MAX_MESSAGES || selectedBytes + candidate.textBytes > CODEX_HISTORY_IMPORT_MAX_BYTES) break;
127
+ selected.push(candidate);
128
+ selectedBytes += candidate.textBytes;
129
+ }
130
+ return selected.toReversed();
131
+ }
132
+ /** Projects one terminal Codex history prefix into transcript and Responses API items. */
133
+ function projectBoundedCodexThreadHistory(params) {
134
+ const projected = projectCodexThreadHistory({
135
+ thread: params.thread,
136
+ throughTurnId: params.throughTurnId,
137
+ importedAt: params.importedAt,
138
+ ...params.modelProvider ? { modelProvider: params.modelProvider } : {}
139
+ });
140
+ const selected = selectBoundedCodexHistoryTail(projected);
141
+ return {
142
+ importedMessages: selected.length,
143
+ omittedMessages: projected.length - selected.length,
144
+ responseItems: selected.filter(({ message }) => message.role !== "assistant" || message.stopReason !== "aborted" && message.stopReason !== "error").map(({ responseItem }) => responseItem),
145
+ transcriptMessages: selected.map(({ message }) => message)
146
+ };
147
+ }
148
+ /** Projects only visible local user/assistant messages through the same bounded history policy. */
149
+ function projectBoundedCodexVisibleSessionHistory(entries) {
150
+ const projected = [];
151
+ for (const entry of entries) {
152
+ if (entry.role !== "user" && entry.role !== "assistant" || !("content" in entry.message)) continue;
153
+ if (entry.role === "assistant" && "stopReason" in entry.message && (entry.message.stopReason === "aborted" || entry.message.stopReason === "error")) continue;
154
+ const content = entry.message.content;
155
+ const text = normalizeImportedHistoryText(typeof content === "string" ? content : Array.isArray(content) ? content.flatMap((part) => part && typeof part === "object" && "text" in part && typeof part.text === "string" ? [part.text] : []).join("\n") : void 0);
156
+ if (!text) continue;
157
+ projected.push({
158
+ message: entry.message,
159
+ responseItem: {
160
+ type: "message",
161
+ role: entry.role,
162
+ content: [{
163
+ type: entry.role === "assistant" ? "output_text" : "input_text",
164
+ text
165
+ }]
166
+ },
167
+ textBytes: Buffer.byteLength(text, "utf8")
168
+ });
169
+ }
170
+ return selectBoundedCodexHistoryTail(projected).map(({ responseItem }) => responseItem);
171
+ }
172
+ //#endregion
173
+ //#region extensions/codex/src/app-server/transcript-mirror-attestation.ts
174
+ const MIRROR_ORIGIN_META_KEY = "mirrorOrigin";
175
+ const MIRROR_SOURCE_FINGERPRINT_META_KEY = "mirrorSourceFingerprint";
176
+ const CODEX_APP_SERVER_MIRROR_ORIGIN = "codex-app-server";
177
+ const CODEX_META_KEY = "__openclaw";
178
+ function attachCodexMirrorAttestation(message, sourceFingerprint) {
179
+ const existing = CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0;
180
+ const baseMeta = existing && typeof existing === "object" && !Array.isArray(existing) ? existing : {};
181
+ return {
182
+ ...message,
183
+ [CODEX_META_KEY]: {
184
+ ...baseMeta,
185
+ [MIRROR_ORIGIN_META_KEY]: CODEX_APP_SERVER_MIRROR_ORIGIN,
186
+ ...sourceFingerprint ? { [MIRROR_SOURCE_FINGERPRINT_META_KEY]: sourceFingerprint } : {}
187
+ }
188
+ };
189
+ }
190
+ function attachCodexMirrorRunId(message, runId, terminal = false) {
191
+ const { runTerminal: _staleTerminal, ...current } = asOptionalRecord(CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0) ?? {};
192
+ return {
193
+ ...message,
194
+ [CODEX_META_KEY]: {
195
+ ...current,
196
+ runId,
197
+ ...terminal ? { runTerminal: true } : {}
198
+ }
199
+ };
200
+ }
201
+ function readCodexMirrorSourceFingerprint(message) {
202
+ const meta = CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0;
203
+ if (!meta || typeof meta !== "object" || Array.isArray(meta)) return;
204
+ const value = meta[MIRROR_SOURCE_FINGERPRINT_META_KEY];
205
+ return typeof value === "string" && value ? value : void 0;
206
+ }
207
+ function serializeCodexMirrorSourceEvidence(message) {
208
+ const content = "content" in message ? message.content : void 0;
209
+ return JSON.stringify({
210
+ role: message.role,
211
+ content,
212
+ ...message.role === "user" ? { upstreamUserText: readUpstreamUserText(message) } : {},
213
+ ...message.role === "toolResult" ? {
214
+ toolCallId: message.toolCallId,
215
+ toolName: message.toolName,
216
+ isError: message.isError
217
+ } : {}
218
+ });
219
+ }
220
+ function fingerprintCodexMirrorSourceMessage(message) {
221
+ return createHash("sha256").update(serializeCodexMirrorSourceEvidence(message)).digest("hex").slice(0, 32);
222
+ }
223
+ //#endregion
224
+ //#region extensions/codex/src/app-server/user-prompt-message.ts
225
+ function buildSenderLabel(params) {
226
+ const label = params.senderName ?? params.senderUsername ?? params.senderE164 ?? params.senderId;
227
+ if (!label) return;
228
+ return !params.senderId || label.includes(params.senderId) ? label : `${label} (${params.senderId})`;
229
+ }
230
+ function buildFromPrepared(params, preparedUserMessage) {
231
+ const senderId = normalizeOptionalString(params.senderId);
232
+ const senderName = normalizeOptionalString(params.senderName);
233
+ const senderUsername = normalizeOptionalString(params.senderUsername);
234
+ const senderE164 = normalizeOptionalString(params.senderE164);
235
+ const senderLabel = buildSenderLabel({
236
+ senderId,
237
+ senderName,
238
+ senderUsername,
239
+ senderE164
240
+ });
241
+ const sourceChannel = normalizeOptionalString(params.inputProvenance?.sourceChannel ?? params.messageChannel ?? params.messageProvider);
242
+ return {
243
+ role: "user",
244
+ timestamp: Date.now(),
245
+ ...params.inputProvenance ? { provenance: params.inputProvenance } : {},
246
+ ...sourceChannel ? { sourceChannel } : {},
247
+ ...senderId ? { senderId } : {},
248
+ ...senderName ? { senderName } : {},
249
+ ...senderUsername ? { senderUsername } : {},
250
+ ...senderE164 ? { senderE164 } : {},
251
+ ...senderLabel ? { senderLabel } : {},
252
+ ...preparedUserMessage ?? { content: params.transcriptPrompt ?? params.prompt }
253
+ };
254
+ }
255
+ function buildCodexUserPromptMessage(params) {
256
+ return buildFromPrepared(params, params.userTurnTranscriptRecorder?.message);
257
+ }
258
+ function buildCodexUpstreamPromptMessage(params, identity, upstreamUserText) {
259
+ const message = attachCodexMirrorIdentity(buildCodexUserPromptMessage(params), identity);
260
+ return upstreamUserText ? attachUpstreamUserText(message, upstreamUserText) : message;
261
+ }
262
+ function promptSnapshot(params, turnId, upstreamUserText) {
263
+ return params.suppressNextUserMessagePersistence ? [] : [buildCodexUpstreamPromptMessage(params, `${turnId}:prompt`, upstreamUserText)];
264
+ }
265
+ async function buildResolvedCodexUserPromptMessage(params) {
266
+ return buildFromPrepared(params, await params.userTurnTranscriptRecorder?.resolveMessage() ?? params.userTurnTranscriptRecorder?.message);
267
+ }
268
+ //#endregion
269
+ //#region extensions/codex/src/app-server/transcript-mirror.ts
270
+ function isMirroredAgentMessage(message) {
271
+ return message.role === "user" || message.role === "assistant" || message.role === "toolResult";
272
+ }
273
+ /** Imports a bounded, user-visible Codex history tail into a new OpenClaw transcript. */
274
+ async function importCodexThreadHistoryToTranscript(params) {
275
+ const projection = projectBoundedCodexThreadHistory({
276
+ thread: params.thread,
277
+ throughTurnId: params.throughTurnId,
278
+ importedAt: Date.now(),
279
+ ...params.modelProvider ? { modelProvider: params.modelProvider } : {}
280
+ });
281
+ if (projection.transcriptMessages.length > 0) await mirror({
282
+ storePath: params.storePath,
283
+ sessionId: params.sessionId,
284
+ sessionKey: params.sessionKey,
285
+ ...params.agentId ? { agentId: params.agentId } : {},
286
+ ...params.cwd ? { cwd: params.cwd } : {},
287
+ ...params.config ? { config: params.config } : {},
288
+ messages: projection.transcriptMessages,
289
+ idempotencyScope: `codex-app-server:${params.thread.id}:history`
290
+ });
291
+ return {
292
+ importedMessages: projection.importedMessages,
293
+ omittedMessages: projection.omittedMessages
294
+ };
295
+ }
296
+ async function mirrorBestEffort(params) {
297
+ if (!params.params.sessionTarget) return {
298
+ assistantTranscriptOwned: false,
299
+ mirroredMessages: []
300
+ };
301
+ try {
302
+ const messages = await resolveFinalCodexMirrorMessages({
303
+ params: params.params,
304
+ messagesSnapshot: params.result.messagesSnapshot,
305
+ turnId: params.turnId
306
+ });
307
+ const mirrorResult = await mirror({
308
+ agentId: params.agentId,
309
+ sessionKey: params.sessionKey,
310
+ sessionId: params.params.sessionId,
311
+ storePath: params.params.sessionTarget?.storePath,
312
+ cwd: params.cwd,
313
+ messages,
314
+ idempotencyScope: `codex-app-server:${params.threadId}`,
315
+ runId: params.params.runId,
316
+ runMirrorIdentityPrefix: `${params.turnId}:`,
317
+ terminalAssistantOwner: {
318
+ mirrorIdentity: `${params.turnId}:assistant`,
319
+ runId: params.params.runId
320
+ },
321
+ config: params.params.config
322
+ });
323
+ for (const receipt of mirrorResult.userMessageReceipts) try {
324
+ params.notifyUserMessagePersisted(receipt.message, receipt.anchor);
325
+ } catch (error) {
326
+ embeddedAgentLog.warn("failed to notify codex app-server user-message persistence", { error: formatErrorMessage(error) });
327
+ }
328
+ const expectedFingerprints = new Map(messages.flatMap((message) => {
329
+ if (!isMirroredAgentMessage(message)) return [];
330
+ const identity = readMirrorIdentity(message);
331
+ return identity ? [[identity, fingerprintCodexMirrorSourceMessage(message)]] : [];
332
+ }));
333
+ const mirroredMessages = mirrorResult.messagesPresent.filter((message) => {
334
+ const identity = readMirrorIdentity(message);
335
+ return identity !== void 0 && readCodexMirrorSourceFingerprint(message) === expectedFingerprints.get(identity);
336
+ });
337
+ const assistantMirrorIdentity = `${params.turnId}:assistant`;
338
+ const assistantTranscriptMessage = mirroredMessages.find((message) => readMirrorIdentity(message) === assistantMirrorIdentity);
339
+ const assistantTranscriptOwned = Boolean(assistantTranscriptMessage && mirrorResult.assistantMirrorIdentitiesOwned.includes(assistantMirrorIdentity));
340
+ const assistantTranscriptIdempotencyKey = normalizeOptionalString(assistantTranscriptMessage?.idempotencyKey);
341
+ const terminalMessage = mirroredMessages.at(-1);
342
+ const terminalMirrorIdentity = terminalMessage ? readMirrorIdentity(terminalMessage) : void 0;
343
+ const terminalAnchor = (terminalMirrorIdentity ? mirrorResult.anchorsByMirrorIdentity.get(terminalMirrorIdentity) : void 0) ?? params.params.userTurnTranscriptRecorder?.getAdmissionReceipt();
344
+ return {
345
+ assistantTranscriptOwned,
346
+ ...assistantTranscriptIdempotencyKey ? { assistantTranscriptIdempotencyKey } : {},
347
+ ...terminalAnchor ? { terminalAnchor } : {},
348
+ mirroredMessages
349
+ };
350
+ } catch (error) {
351
+ embeddedAgentLog.warn("failed to mirror codex app-server transcript", {
352
+ error: formatErrorMessage(error),
353
+ runId: params.params.runId,
354
+ sessionId: params.params.sessionId
355
+ });
356
+ return {
357
+ assistantTranscriptOwned: false,
358
+ mirroredMessages: []
359
+ };
360
+ }
361
+ }
362
+ async function resolveFinalCodexMirrorMessages(params) {
363
+ if (params.params.suppressNextUserMessagePersistence || !params.params.userTurnTranscriptRecorder) return params.messagesSnapshot;
364
+ const promptSnapshot = params.messagesSnapshot.find((message) => message.role === "user");
365
+ const resolvedBase = attachCodexMirrorIdentity(await buildResolvedCodexUserPromptMessage(params.params), `${params.turnId}:prompt`);
366
+ const upstreamUserText = readUpstreamUserText(promptSnapshot);
367
+ const resolvedPrompt = upstreamUserText ? attachUpstreamUserText(resolvedBase, upstreamUserText) : resolvedBase;
368
+ const firstUserIndex = params.messagesSnapshot.findIndex((message) => message.role === "user");
369
+ if (firstUserIndex === -1) return [resolvedPrompt, ...params.messagesSnapshot];
370
+ const messages = params.messagesSnapshot.slice();
371
+ messages[firstUserIndex] = resolvedPrompt;
372
+ return messages;
373
+ }
374
+ function createCodexAppServerUserMessagePersistenceNotifier(runParams) {
375
+ let notified = false;
376
+ return (message, anchor) => {
377
+ if (notified) return;
378
+ notified = true;
379
+ runParams.userTurnTranscriptRecorder?.markRuntimePersisted(message, anchor);
380
+ try {
381
+ runParams.onUserMessagePersisted?.(message);
382
+ } catch (error) {
383
+ embeddedAgentLog.warn("codex app-server user persistence notification failed", { error: formatErrorMessage(error) });
384
+ }
385
+ };
386
+ }
387
+ async function mirrorPromptAtTurnStartBestEffort(params) {
388
+ if (params.params.suppressNextUserMessagePersistence || !params.params.sessionTarget) return;
389
+ try {
390
+ const mirrorPromise = (async () => {
391
+ const userPromptMessage = projectAgentHarnessTranscriptMessageForDisplay({
392
+ hidden: params.params.trigger === "memory",
393
+ message: attachUpstreamUserText(attachCodexMirrorIdentity(await buildResolvedCodexUserPromptMessage(params.params), `${params.turnId}:prompt`), params.upstreamUserText)
394
+ });
395
+ const mirrorResult = await mirror({
396
+ agentId: params.agentId,
397
+ sessionKey: params.sessionKey,
398
+ sessionId: params.params.sessionId,
399
+ storePath: params.params.sessionTarget?.storePath,
400
+ cwd: params.cwd,
401
+ messages: [userPromptMessage],
402
+ idempotencyScope: `codex-app-server:${params.threadId}`,
403
+ runId: params.params.runId,
404
+ runMirrorIdentityPrefix: `${params.turnId}:`,
405
+ config: params.params.config
406
+ });
407
+ for (const receipt of mirrorResult.userMessageReceipts) params.notifyUserMessagePersisted(receipt.message, receipt.anchor);
408
+ })();
409
+ params.params.userTurnTranscriptRecorder?.markRuntimePersistencePending(mirrorPromise);
410
+ await mirrorPromise;
411
+ } catch (error) {
412
+ embeddedAgentLog.warn("failed to mirror codex app-server prompt at turn start", {
413
+ error: formatErrorMessage(error),
414
+ runId: params.params.runId,
415
+ sessionId: params.params.sessionId
416
+ });
417
+ }
418
+ }
419
+ function fingerprintMirrorMessageContent(message) {
420
+ const payload = JSON.stringify({
421
+ role: message.role,
422
+ content: message.content
423
+ });
424
+ return createHash("sha256").update(payload).digest("hex").slice(0, 16);
425
+ }
426
+ function buildMirrorDedupeIdentity(message) {
427
+ const explicit = readMirrorIdentity(message);
428
+ if (explicit) return explicit;
429
+ return `${message.role}:${fingerprintMirrorMessageContent(message)}`;
430
+ }
431
+ async function mirror(params) {
432
+ const messages = params.messages.filter(isMirroredAgentMessage);
433
+ if (messages.length === 0) return {
434
+ assistantMirrorIdentitiesOwned: [],
435
+ anchorsByMirrorIdentity: /* @__PURE__ */ new Map(),
436
+ messagesPresent: [],
437
+ userMessageReceipts: [],
438
+ userMessagesPresent: []
439
+ };
440
+ const candidates = messages.map((message) => {
441
+ const dedupeIdentity = buildMirrorDedupeIdentity(message);
442
+ const sourceFingerprint = fingerprintCodexMirrorSourceMessage(message);
443
+ return {
444
+ dedupeIdentity,
445
+ idempotencyKey: (message.role === "user" ? normalizeOptionalString("idempotencyKey" in message ? message.idempotencyKey : void 0) : void 0) ?? (params.idempotencyScope ? `${params.idempotencyScope}:${dedupeIdentity}` : void 0),
446
+ message,
447
+ sourceFingerprint
448
+ };
449
+ });
450
+ const candidateIdempotencyKeys = candidates.flatMap(({ idempotencyKey }) => idempotencyKey ? [idempotencyKey] : []);
451
+ const transcriptTarget = resolveCodexMirrorTranscriptTarget(params);
452
+ const { appendedUpdates, assistantMirrorIdentitiesOwned, anchorsByMirrorIdentity, messagesPresent, userMessageReceipts, userMessagesPresent } = await withCodexSessionTranscriptMirrorWriteLock({
453
+ ...transcriptTarget,
454
+ config: params.config
455
+ }, async (transcript) => {
456
+ const nextAppendedUpdates = [];
457
+ const nextAssistantMirrorIdentitiesOwned = /* @__PURE__ */ new Set();
458
+ const nextAnchorsByMirrorIdentity = /* @__PURE__ */ new Map();
459
+ const nextMessagesPresent = [];
460
+ const nextUserMessageReceipts = [];
461
+ const nextUserMessagesPresent = [];
462
+ const mirrorFacts = await transcript.readMessageFacts({ idempotencyKeys: candidateIdempotencyKeys });
463
+ for (const { dedupeIdentity, idempotencyKey, message, sourceFingerprint } of candidates) {
464
+ const mirrorIdentity = readMirrorIdentity(message);
465
+ const ownsRun = Boolean(params.runId && (!params.runMirrorIdentityPrefix || mirrorIdentity?.startsWith(params.runMirrorIdentityPrefix)));
466
+ const terminalOwner = params.terminalAssistantOwner;
467
+ const ownsTerminal = Boolean(ownsRun && terminalOwner && mirrorIdentity === terminalOwner.mirrorIdentity);
468
+ const transcriptMessage = {
469
+ ...attachCodexMirrorAttestation(ownsRun && params.runId ? attachCodexMirrorRunId(message, params.runId, ownsTerminal) : message, sourceFingerprint),
470
+ ...idempotencyKey ? { idempotencyKey } : {}
471
+ };
472
+ if (idempotencyKey && mirrorFacts.existingIdempotencyKeys.has(idempotencyKey)) {
473
+ const persistedMessage = mirrorFacts.messagesByIdempotencyKey.get(idempotencyKey);
474
+ const persistedAnchor = mirrorFacts.anchorsByIdempotencyKey.get(idempotencyKey);
475
+ if (persistedMessage && isMirroredAgentMessage(persistedMessage)) {
476
+ nextMessagesPresent.push(persistedMessage);
477
+ if (persistedMessage.role === "user") {
478
+ nextUserMessagesPresent.push(persistedMessage);
479
+ if (persistedAnchor) nextUserMessageReceipts.push({
480
+ anchor: persistedAnchor,
481
+ message: persistedMessage
482
+ });
483
+ }
484
+ }
485
+ if (persistedAnchor) nextAnchorsByMirrorIdentity.set(dedupeIdentity, persistedAnchor);
486
+ if (message.role === "assistant") nextAssistantMirrorIdentitiesOwned.add(dedupeIdentity);
487
+ continue;
488
+ }
489
+ const nextMessage = params.skipBeforeMessageWriteHooks ? transcriptMessage : runAgentHarnessBeforeMessageWriteHook({
490
+ message: transcriptMessage,
491
+ agentId: params.agentId,
492
+ sessionKey: params.sessionKey
493
+ });
494
+ if (!nextMessage) {
495
+ if (message.role === "assistant") nextAssistantMirrorIdentitiesOwned.add(dedupeIdentity);
496
+ continue;
497
+ }
498
+ let messageToAppend = idempotencyKey ? {
499
+ ...attachCodexMirrorAttestation(nextMessage, sourceFingerprint),
500
+ idempotencyKey
501
+ } : attachCodexMirrorAttestation(nextMessage, sourceFingerprint);
502
+ if (mirrorIdentity) messageToAppend = attachCodexMirrorIdentity(messageToAppend, mirrorIdentity);
503
+ if (ownsRun && params.runId) messageToAppend = attachCodexMirrorRunId(messageToAppend, params.runId, ownsTerminal);
504
+ messageToAppend = projectAgentHarnessTranscriptMessageForDisplay({
505
+ hidden: message.display === false,
506
+ message: messageToAppend
507
+ });
508
+ const { messageSeq, result: appended } = await transcript.appendMessageWithMessageSequence({
509
+ message: messageToAppend,
510
+ idempotencyLookup: "scan",
511
+ cwd: params.cwd
512
+ });
513
+ if (!appended) continue;
514
+ const { messageId, message: appendedMessage } = appended;
515
+ if (isMirroredAgentMessage(appendedMessage)) {
516
+ nextMessagesPresent.push(appendedMessage);
517
+ if (idempotencyKey) mirrorFacts.messagesByIdempotencyKey.set(idempotencyKey, appendedMessage);
518
+ }
519
+ if (message.role === "assistant") nextAssistantMirrorIdentitiesOwned.add(dedupeIdentity);
520
+ if (appended.anchor) nextAnchorsByMirrorIdentity.set(dedupeIdentity, appended.anchor);
521
+ if (appendedMessage.role === "user" && appended.anchor) {
522
+ nextUserMessagesPresent.push(appendedMessage);
523
+ nextUserMessageReceipts.push({
524
+ anchor: appended.anchor,
525
+ message: appendedMessage
526
+ });
527
+ }
528
+ if (appended.appended) nextAppendedUpdates.push({
529
+ messageId,
530
+ message: appendedMessage,
531
+ ...messageSeq !== void 0 ? { messageSeq } : {}
532
+ });
533
+ if (idempotencyKey) {
534
+ mirrorFacts.existingIdempotencyKeys.add(idempotencyKey);
535
+ if (appended.anchor) mirrorFacts.anchorsByIdempotencyKey.set(idempotencyKey, appended.anchor);
536
+ }
537
+ }
538
+ return {
539
+ appendedUpdates: nextAppendedUpdates,
540
+ assistantMirrorIdentitiesOwned: [...nextAssistantMirrorIdentitiesOwned],
541
+ anchorsByMirrorIdentity: nextAnchorsByMirrorIdentity,
542
+ messagesPresent: nextMessagesPresent,
543
+ userMessageReceipts: nextUserMessageReceipts,
544
+ userMessagesPresent: nextUserMessagesPresent
545
+ };
546
+ });
547
+ for (const update of appendedUpdates) try {
548
+ const terminalOwner = params.terminalAssistantOwner;
549
+ const terminalRunId = update.message.role === "assistant" && terminalOwner && readMirrorIdentity(update.message) === terminalOwner.mirrorIdentity ? terminalOwner.runId : void 0;
550
+ await publishSessionTranscriptUpdateByIdentity({
551
+ ...transcriptTarget,
552
+ update: {
553
+ ...params.agentId ? { agentId: params.agentId } : {},
554
+ message: update.message,
555
+ messageId: update.messageId,
556
+ ...update.messageSeq !== void 0 ? { messageSeq: update.messageSeq } : {},
557
+ ...terminalRunId ? { runId: terminalRunId } : {},
558
+ sessionKey: transcriptTarget.sessionKey
559
+ }
560
+ });
561
+ } catch (error) {
562
+ embeddedAgentLog.warn("failed to publish codex app-server transcript update", { error: formatErrorMessage(error) });
563
+ }
564
+ return {
565
+ assistantMirrorIdentitiesOwned,
566
+ anchorsByMirrorIdentity,
567
+ messagesPresent,
568
+ userMessageReceipts,
569
+ userMessagesPresent
570
+ };
571
+ }
572
+ const codexTranscriptMirrorRuntime = {
573
+ mirror,
574
+ mirrorBestEffort
575
+ };
576
+ function resolveCodexMirrorTranscriptTarget(params) {
577
+ const sessionKey = params.sessionKey?.trim();
578
+ const storePath = params.storePath?.trim();
579
+ if (!sessionKey || !storePath) throw new Error("Codex transcript mirror requires a runtime session identity");
580
+ return {
581
+ ...params.agentId ? { agentId: params.agentId } : {},
582
+ sessionId: params.sessionId,
583
+ sessionKey,
584
+ storePath
585
+ };
586
+ }
587
+ //#endregion
588
+ export { buildCodexUserPromptMessage as a, readCodexMirrorSourceFingerprint as c, projectBoundedCodexVisibleSessionHistory as d, mirrorPromptAtTurnStartBestEffort as i, serializeCodexMirrorSourceEvidence as l, createCodexAppServerUserMessagePersistenceNotifier as n, promptSnapshot as o, importCodexThreadHistoryToTranscript as r, fingerprintCodexMirrorSourceMessage as s, codexTranscriptMirrorRuntime as t, projectBoundedCodexThreadHistory as u };
@@ -10,6 +10,12 @@ const UNSAFE_ENVIRONMENT_KEYS = /* @__PURE__ */ new Set([
10
10
  "constructor",
11
11
  "prototype"
12
12
  ]);
13
+ const RUNTIME_INJECTION_ENVIRONMENT_KEYS = /* @__PURE__ */ new Set([
14
+ "NODE_PATH",
15
+ "LD_AUDIT",
16
+ "LD_LIBRARY_PATH",
17
+ "LD_PRELOAD"
18
+ ]);
13
19
  const QA_PARENT_PID_ENV = "OPENCLAW_QA_PARENT_PID";
14
20
  const DEFAULT_SPAWN_RUNTIME = {
15
21
  platform: process.platform,
@@ -43,8 +49,13 @@ function resolveCodexAppServerSpawnEnv(options, baseEnv = process.env, platform
43
49
  const lowerCaseKeysToClear = new Set(keysToClear.map((key) => key.toLowerCase()));
44
50
  for (const candidate of Object.keys(env)) if (lowerCaseKeysToClear.has(candidate.toLowerCase())) delete env[candidate];
45
51
  } else for (const key of keysToClear) delete env[key];
52
+ for (const key of Object.keys(env)) if (isCodexRuntimeInjectionEnvironmentKey(key)) delete env[key];
46
53
  return env;
47
54
  }
55
+ function isCodexRuntimeInjectionEnvironmentKey(rawKey) {
56
+ const key = rawKey.toUpperCase();
57
+ return RUNTIME_INJECTION_ENVIRONMENT_KEYS.has(key) || key.startsWith("DYLD_");
58
+ }
48
59
  /** Keeps QA-owned app-server processes inside the gateway process-group cleanup boundary. */
49
60
  function resolveCodexAppServerDetachedMode(env, platform = process.platform) {
50
61
  return platform !== "win32" && !env[QA_PARENT_PID_ENV]?.trim();
@@ -64,8 +75,8 @@ function copySafeEnvironmentEntries(target, source) {
64
75
  }
65
76
  }
66
77
  /** Spawns the Codex app-server process and returns the shared transport interface. */
67
- function createStdioTransport(options) {
68
- const env = resolveCodexAppServerSpawnEnv(options);
78
+ function createStdioTransport(options, baseEnv = process.env) {
79
+ const env = resolveCodexAppServerSpawnEnv(options, baseEnv);
69
80
  const invocation = resolveCodexAppServerSpawnInvocation(options, {
70
81
  platform: process.platform,
71
82
  env,
@@ -0,0 +1,39 @@
1
+ import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
2
+ //#region extensions/codex/src/app-server/upstream-prompt-provenance.ts
3
+ const UPSTREAM_USER_TEXT_META_KEY = "upstreamUserText";
4
+ const MIRROR_IDENTITY_META_KEY = "mirrorIdentity";
5
+ const CODEX_META_KEY = "__openclaw";
6
+ function attachCodexMirrorIdentity(message, identity) {
7
+ const baseMeta = asOptionalRecord(CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0) ?? {};
8
+ return {
9
+ ...message,
10
+ __openclaw: {
11
+ ...baseMeta,
12
+ [MIRROR_IDENTITY_META_KEY]: identity
13
+ }
14
+ };
15
+ }
16
+ function readMirrorIdentity(message) {
17
+ const record = asOptionalRecord(CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0);
18
+ if (!record) return;
19
+ const id = record[MIRROR_IDENTITY_META_KEY];
20
+ return typeof id === "string" && id ? id : void 0;
21
+ }
22
+ function attachUpstreamUserText(message, text) {
23
+ const baseMeta = asOptionalRecord(CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0) ?? {};
24
+ return {
25
+ ...message,
26
+ __openclaw: {
27
+ ...baseMeta,
28
+ [UPSTREAM_USER_TEXT_META_KEY]: text
29
+ }
30
+ };
31
+ }
32
+ function readUpstreamUserText(message) {
33
+ const record = asOptionalRecord(message && CODEX_META_KEY in message ? message[CODEX_META_KEY] : void 0);
34
+ if (!record) return;
35
+ const text = record[UPSTREAM_USER_TEXT_META_KEY];
36
+ return typeof text === "string" && text ? text : void 0;
37
+ }
38
+ //#endregion
39
+ export { readUpstreamUserText as i, attachUpstreamUserText as n, readMirrorIdentity as r, attachCodexMirrorIdentity as t };