codex-relay 1.0.7 → 1.1.1

package/README.md

@@ -2,6 +2,8 @@
 
 Codex Relay runs a local bridge server for the Codex Relay mobile app. Keep Codex on your computer, then use your phone to pair with that local session, send prompts, watch streamed output, and respond to approval requests.
 
+Codex Relay is an independent project. It is not affiliated with, endorsed by, or sponsored by OpenAI or the OpenAI Codex team.
+
 ## Requirements
 
 - Node.js 22.14 or newer
@@ -145,3 +147,11 @@ kill -TERM <pid>
 ```
 
 If the mobile app cannot connect, confirm that the phone can reach the printed `Mobile:` URL and that the chosen port is not blocked by a firewall.
+
+Connection checklist:
+
+- Are the phone and computer on the same Wi-Fi or LAN?
+- If keeping the same network is difficult, are both devices connected through Tailscale or another reachable private network?
+- Can the phone open the exact `Mobile:` URL printed by the relay?
+- Does the computer firewall allow inbound traffic on the relay port, usually `8787`?
+- If the printed URL is not reachable, did you set `CODEX_RELAY_PUBLIC_URL` to a reachable LAN, Tailscale, or tunnel URL?

package/dist/src.js

@@ -2229,16 +2229,17 @@ async function runPromptStreamed(input) {
 			if (kind === "error") throw new Error(text ?? "Codex run failed.");
 			if (!text) continue;
 			if (kind === "assistant") {
-				assistantMessage = appendMessageDelta(input.messagesByThreadId, activeThreadId, assistantMessage.id, text);
+				const assistantPatch = appendMessageDelta(input.messagesByThreadId, activeThreadId, assistantMessage.id, text);
+				assistantMessage = assistantPatch.message;
 				updateThread(input.threads, input.messagesByThreadId, activeThreadId, {
 					state: "running",
 					lastResult: assistantMessage.content
 				});
-				sendSse(input.controller, input.encoder, input.secureSession, {
+				if (assistantPatch.delta) sendSse(input.controller, input.encoder, input.secureSession, {
 					type: "thread.message.delta",
 					threadId: activeThreadId,
 					messageId: assistantMessage.id,
-					delta: text
+					delta: assistantPatch.delta
 				});
 			} else {
 				const structured = structuredStreamMessage(kind, event, text);
@@ -2494,16 +2495,17 @@ async function streamRunningAppServerThread(input) {
 							turnId: firstString(params, ["turnId"]) ?? activeTurnId
 						});
 						assistantMessageId = itemId;
-						const message = appendMessageDelta(input.messagesByThreadId, input.threadId, itemId, delta);
+						const patch = appendMessageDelta(input.messagesByThreadId, input.threadId, itemId, delta);
+						const message = patch.message;
 						updateThread(input.threads, input.messagesByThreadId, input.threadId, {
 							state: "running",
 							lastResult: message.content
 						});
-						sendSse(input.controller, input.encoder, input.secureSession, {
+						if (patch.delta) sendSse(input.controller, input.encoder, input.secureSession, {
 							type: "thread.message.delta",
 							threadId: input.threadId,
 							messageId: itemId,
-							delta
+							delta: patch.delta
 						});
 						return;
 					}
@@ -2705,7 +2707,7 @@ async function runAppServerPromptStreamed(input) {
 					case "item/completed": {
 						const item = params?.item;
 						if (!item || typeof item !== "object") return;
-						const canonicalUserMessage = replaceDuplicateInitialUserMessage(input.messagesByThreadId, activeThreadId, firstString(params, ["turnId"]) ?? activeTurnId, item, userMessage.id, prompt);
+						const canonicalUserMessage = replaceDuplicateInitialUserMessage(input.messagesByThreadId, activeThreadId, firstString(params, ["turnId"]) ?? activeTurnId, item, userMessage.id, displayPrompt);
 						if (canonicalUserMessage) {
 							userMessage = canonicalUserMessage;
 							return;
@@ -2737,17 +2739,18 @@ async function runAppServerPromptStreamed(input) {
 							turnId: firstString(params, ["turnId"]) ?? activeTurnId
 						});
 						assistantMessageId = itemId;
-						const message = appendMessageDelta(input.messagesByThreadId, activeThreadId, itemId, delta);
+						const patch = appendMessageDelta(input.messagesByThreadId, activeThreadId, itemId, delta);
+						const message = patch.message;
 						producedTurnOutput = true;
 						updateThread(input.threads, input.messagesByThreadId, activeThreadId, {
 							state: "running",
 							lastResult: message.content
 						});
-						sendSse(input.controller, input.encoder, input.secureSession, {
+						if (patch.delta) sendSse(input.controller, input.encoder, input.secureSession, {
 							type: "thread.message.delta",
 							threadId: activeThreadId,
 							messageId: itemId,
-							delta
+							delta: patch.delta
 						});
 						return;
 					}
@@ -3269,8 +3272,9 @@ function isDuplicateInitialUserMessage(messagesByThreadId, threadId, item, local
 	if (item.type !== "userMessage" || !("content" in item) || !Array.isArray(item.content)) return false;
 	const localMessage = messagesByThreadId.get(threadId)?.find((message) => message.id === localMessageId);
 	const skills = appServerUserMessageSkills(item);
-	const normalizedPrompt = stripPromptSkillMentions(prompt, skills);
-	return stripPromptSkillMentions(localMessage?.content ?? "", skills) === normalizedPrompt && stripPromptSkillMentions(appServerUserMessageText(item), skills) === normalizedPrompt;
+	const normalizeContent = (content) => stripPromptSkillMentions(normalizeImageMessageContent(content), skills);
+	const normalizedPrompt = normalizeContent(prompt);
+	return normalizeContent(localMessage?.content ?? "") === normalizedPrompt && normalizeContent(appServerUserMessageText(item)) === normalizedPrompt;
 }
 function messageWithReplacementDetail(message, replacesMessageId) {
 	return ChatMessageSchema.parse({
@@ -3526,10 +3530,18 @@ function isAppServerSkillInput(input) {
 }
 function appendMessageDelta(messagesByThreadId, threadId, messageId, delta) {
 	const existing = messagesByThreadId.get(threadId)?.find((message) => message.id === messageId);
-	return updateMessage(messagesByThreadId, threadId, messageId, {
-		content: `${existing?.content ?? ""}${delta}`,
-		state: "streaming"
-	});
+	const normalizedDelta = normalizeStreamDelta(existing?.content ?? "", delta);
+	return {
+		delta: normalizedDelta,
+		message: updateMessage(messagesByThreadId, threadId, messageId, {
+			content: `${existing?.content ?? ""}${normalizedDelta}`,
+			state: "streaming"
+		})
+	};
+}
+function normalizeStreamDelta(existingContent, incomingDelta) {
+	if (!existingContent || !incomingDelta.startsWith(existingContent)) return incomingDelta;
+	return incomingDelta.slice(existingContent.length);
 }
 function markApprovalMessageResolved(messagesByThreadId, threadId, messageId, decision) {
 	const message = (messagesByThreadId.get(threadId) ?? []).find((candidate) => candidate.id === messageId);
@@ -4092,6 +4104,7 @@ function readRolloutThreadMessages(threadId, workspacePath = defaultWorkspacePat
 	};
 	const collected = [];
 	const applyPatchInputs = /* @__PURE__ */ new Map();
+	const handledApplyPatchCallIds = /* @__PURE__ */ new Set();
 	const pendingApplyPatchChanges = [];
 	const lines = readFileSync(rolloutPath, "utf8").split("\n");
 	for (let index = 0; index < lines.length; index += 1) {
@@ -4102,7 +4115,7 @@ function readRolloutThreadMessages(threadId, workspacePath = defaultWorkspacePat
 		try {
 			const record = JSON.parse(line);
 			rememberRolloutApplyPatchInput(record, applyPatchInputs);
-			collectRolloutApplyPatchOutput(record, workspacePath, applyPatchInputs, pendingApplyPatchChanges);
+			collectRolloutApplyPatchOutput(record, workspacePath, applyPatchInputs, handledApplyPatchCallIds, pendingApplyPatchChanges);
 			if (isRolloutTaskComplete(record) && pendingApplyPatchChanges.length > 0) {
 				collected.push(rolloutApplyPatchSummaryMessage(threadId, record, `rollout:${lineNumber}:apply_patch`, pendingApplyPatchChanges));
 				pendingApplyPatchChanges.length = 0;
@@ -4111,6 +4124,11 @@ function readRolloutThreadMessages(threadId, workspacePath = defaultWorkspacePat
 			const message = rolloutRecordMessage(threadId, record, `rollout:${lineNumber}`, workspacePath);
 			if (!message) continue;
 			collected.push(message);
+			const patchApplyEndCallId = rolloutPatchApplyEndCallId(record);
+			if (patchApplyEndCallId) {
+				handledApplyPatchCallIds.add(patchApplyEndCallId);
+				pendingApplyPatchChanges.splice(0, pendingApplyPatchChanges.length, ...pendingApplyPatchChanges.filter((change) => change.callId !== patchApplyEndCallId));
+			}
 		} catch {}
 	}
 	return {
@@ -4172,7 +4190,7 @@ function rolloutRecordMessage(threadId, record, messageKey, workspacePath = defa
 	if (record.type === "event_msg" && payload.type === "patch_apply_end") {
 		const changes = rolloutPatchApplyChanges(payload.changes, workspacePath);
 		if (changes.length === 0) return;
-		const patchPreview = largeTextPreview(changes.map((change) => change.patch).filter((patch) => Boolean(patch)).join("\n"));
+		const patchPreview = largeTextPreview(rolloutPatchPreview(changes));
 		return ChatMessageSchema.parse({
 			id: `${messageKey}:patch:${firstString(payload, ["call_id"]) ?? ""}`,
 			threadId,
@@ -4182,7 +4200,7 @@ function rolloutRecordMessage(threadId, record, messageKey, workspacePath = defa
 			createdAt: timestamp,
 			state: "completed",
 			details: {
-				changes: changes.map(({ patch: _patch, ...change }) => change),
+				changes: changes.map(publicRolloutPatchChange),
 				patch: patchPreview?.text,
 				patchOriginalLength: patchPreview?.originalLength,
 				patchTruncated: patchPreview?.truncated
@@ -4250,15 +4268,16 @@ function rememberRolloutApplyPatchInput(record, applyPatchInputs) {
 	const input = firstString(payload, ["input"]);
 	if (callId && input) applyPatchInputs.set(callId, input);
 }
-function collectRolloutApplyPatchOutput(record, workspacePath, applyPatchInputs, pendingApplyPatchChanges) {
+function collectRolloutApplyPatchOutput(record, workspacePath, applyPatchInputs, handledApplyPatchCallIds, pendingApplyPatchChanges) {
 	const payload = record.payload;
-	if (record.type !== "response_item" || payload?.type !== "custom_tool_call_output" || !firstString(payload, ["call_id"])) return;
+	const callId = firstString(payload, ["call_id"]);
+	if (record.type !== "response_item" || payload?.type !== "custom_tool_call_output" || !callId || handledApplyPatchCallIds.has(callId)) return;
 	const changes = rolloutApplyPatchOutputChanges(rolloutCustomToolOutputText(payload), workspacePath);
 	if (changes.length === 0) return;
-	const callId = firstString(payload, ["call_id"]);
 	const patch = callId ? applyPatchInputs.get(callId) : void 0;
 	for (const change of changes) pendingApplyPatchChanges.push({
 		...change,
+		callId,
 		patch
 	});
 }
@@ -4274,13 +4293,36 @@ function rolloutApplyPatchSummaryMessage(threadId, record, messageKey, pendingAp
 		createdAt: timestamp,
 		state: "completed",
 		details: {
-			changes: pendingApplyPatchChanges.map(({ patch: _patch, ...change }) => change),
+			changes: pendingApplyPatchChanges.map(publicRolloutPatchChange),
 			patch: patchPreview?.text,
 			patchOriginalLength: patchPreview?.originalLength,
 			patchTruncated: patchPreview?.truncated
 		}
 	});
 }
+function rolloutPatchApplyEndCallId(record) {
+	if (record.type !== "event_msg" || record.payload?.type !== "patch_apply_end") return;
+	return firstString(record.payload, ["call_id"]);
+}
+function publicRolloutPatchChange(change) {
+	const { callId: _callId, patch: _patch, ...publicChange } = change;
+	return publicChange;
+}
+function rolloutPatchPreview(changes) {
+	return changes.flatMap((change) => {
+		if (!change.patch) return [];
+		if (hasPatchFileHeader(change.patch)) return [change.patch];
+		return [`*** ${patchHeaderChangeKind(change.kind)} File: ${change.path}\n${change.patch}`];
+	}).join("\n");
+}
+function hasPatchFileHeader(patch) {
+	return /^(?:diff --git |\*\*\* (?:Add|Update|Delete) File: )/m.test(patch);
+}
+function patchHeaderChangeKind(kind) {
+	if (kind === "added") return "Add";
+	if (kind === "deleted") return "Delete";
+	return "Update";
+}
 function rolloutCustomToolOutputText(payload) {
 	const rawOutput = firstString(payload, ["output"]);
 	if (!rawOutput) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-relay",
-  "version": "1.0.7",
+  "version": "1.1.1",
   "description": "Local Codex Relay CLI bridge for the Codex Relay mobile app.",
   "license": "Apache-2.0",
   "repository": {