codex-relay 1.0.3 → 1.0.5

package/README.md

@@ -16,7 +16,7 @@ Run the server from the workspace you want Codex to use:
 npx codex-relay@latest
 ```
 
-The CLI prints a QR code, a mobile URL, and a `codex-relay://pair...` pairing payload. Scan the QR code from the mobile app. If scanning is not available, paste the full pairing payload into the app.
+The CLI prints a QR code, a mobile URL, and a `codex-relay://pair...` pairing payload. Scan the QR code from the mobile app. If the relay detects multiple possible network addresses, the QR includes them and the app automatically uses the first address it can reach. If scanning is not available, paste the full pairing payload into the app.
 
 When the app shows an approval code, approve it on the computer:
 
@@ -117,10 +117,11 @@ CODEX_RELAY_WORKSPACE_PATH=/path/to/project npx codex-relay@latest
 
 ## Network Notes
 
-The phone must be able to reach the URL printed as `Mobile:` by the relay.
+The phone must be able to reach one of the URLs printed by the relay.
 
 - On the same Wi-Fi network, the relay usually prints a local network address.
 - On Tailscale, the relay prefers your Tailscale address when it can detect one.
+- If several Wi-Fi, VPN, or virtual network addresses are available, the QR includes all detected candidates and the app tries them automatically.
 - If the printed URL is not reachable from the phone, set `CODEX_RELAY_PUBLIC_URL` to a reachable HTTP URL.
 
 ## Troubleshooting

package/dist/api-schema.js

@@ -1,2 +1,2 @@
-import { $ as SandboxModeSchema, A as PairResponseSchema, At as stripPromptSkillMentions, B as QueuedThreadInputSchema, C as ListQueuedThreadInputsResponseSchema, Ct as isPromptSkillMarkdownMention, D as ListWorkspaceFilesResponseSchema, Dt as promptSkillMentionLabel, E as ListWorkspaceDirectoriesResponseSchema, Et as promptSkillDisplayName, F as PromptAttachmentSummarySchema, G as ResolveApprovalRequestSchema, H as RateLimitWindowSchema, I as PromptContextInputSchema, J as RunThreadResponseSchema, K as ResolveApprovalResponseSchema, L as PromptContextSchema, M as PendingInputRequestQuestionSchema, N as PendingInputRequestSchema, O as PairEncryptedPayloadSchema, Ot as promptSkillMentionMarkdown, P as PromptAttachmentSchema, Q as RuntimePreferencesSchema, R as PromptSkillSchema, S as ListModelsResponseSchema, St as createOpenApiDocument, T as ListThreadsResponseSchema, Tt as promptMarkdownWithSkills, U as RateLimitsResponseSchema, V as RateLimitBucketSchema, W as ReasoningEffortSchema, X as RuntimePreferencesByWorkspacePathSchema, Y as RuntimeModeSchema, Z as RuntimePreferencesResponseSchema, _ as EncryptedPayloadSchema, _t as WorkspaceFileMentionSchema, a as ArchiveThreadResponseSchema, at as ThreadContextWindowResponseSchema, b as InterruptThreadRunResponseSchema, bt as apiPaths, c as ChatMessageRoleSchema, ct as ThreadMessageDetailResponseSchema, d as CheckoutWorkspaceBranchRequestSchema, dt as ThreadSummarySchema, et as StatusResponseSchema, f as CodexModelSchema, ft as UpdateRuntimePreferencesRequestSchema, g as CreateThreadResponseSchema, gt as WorkspaceDirectoryEntrySchema, h as CreateThreadRequestSchema, ht as WorkspaceChangesResponseSchema, i as ApprovalModeSchema, it as ThreadCollaborationModeSchema, j as PendingInputRequestOptionSchema, k as PairRequestSchema, kt as promptSkillMentionTextCandidates, l as ChatMessageSchema, lt as ThreadRunOptionsSchema, m as ContextWindowUsageSchema, mt as WebPreviewTargetSchema, n as AgentSkillSourceSchema, nt as StreamThreadRunRequestSchema, o as ChatMessageKindSchema, ot as ThreadDetailResponseSchema, p as CommitPushWorkspaceRequestSchema, pt as VersionResponseSchema, q as RunThreadRequestSchema, r as ApprovalDecisionSchema, rt as SubmitThreadInputResponseSchema, s as ChatMessagePromptDetailsSchema, st as ThreadMessageDetailFieldSchema, t as AgentSkillSchema, tt as StreamThreadRunEventSchema, u as ChatMessageStateSchema, ut as ThreadStateSchema, v as ErrorResponseSchema, vt as WorkspaceGitActionResponseSchema, w as ListSkillsResponseSchema, wt as normalizePromptContext, x as IsoDateTimeSchema, xt as chatMessageDetailsFromPromptContext, y as ImageAttachmentUploadResponseSchema, yt as WorkspaceSelectionRequestSchema, z as QueuedThreadInputActionResponseSchema } from "./api-schema2.js";
-export { AgentSkillSchema, AgentSkillSourceSchema, ApprovalDecisionSchema, ApprovalModeSchema, ArchiveThreadResponseSchema, ChatMessageKindSchema, ChatMessagePromptDetailsSchema, ChatMessageRoleSchema, ChatMessageSchema, ChatMessageStateSchema, CheckoutWorkspaceBranchRequestSchema, CodexModelSchema, CommitPushWorkspaceRequestSchema, ContextWindowUsageSchema, CreateThreadRequestSchema, CreateThreadResponseSchema, EncryptedPayloadSchema, ErrorResponseSchema, ImageAttachmentUploadResponseSchema, InterruptThreadRunResponseSchema, IsoDateTimeSchema, ListModelsResponseSchema, ListQueuedThreadInputsResponseSchema, ListSkillsResponseSchema, ListThreadsResponseSchema, ListWorkspaceDirectoriesResponseSchema, ListWorkspaceFilesResponseSchema, PairEncryptedPayloadSchema, PairRequestSchema, PairResponseSchema, PendingInputRequestOptionSchema, PendingInputRequestQuestionSchema, PendingInputRequestSchema, PromptAttachmentSchema, PromptAttachmentSummarySchema, PromptContextInputSchema, PromptContextSchema, PromptSkillSchema, QueuedThreadInputActionResponseSchema, QueuedThreadInputSchema, RateLimitBucketSchema, RateLimitWindowSchema, RateLimitsResponseSchema, ReasoningEffortSchema, ResolveApprovalRequestSchema, ResolveApprovalResponseSchema, RunThreadRequestSchema, RunThreadResponseSchema, RuntimeModeSchema, RuntimePreferencesByWorkspacePathSchema, RuntimePreferencesResponseSchema, RuntimePreferencesSchema, SandboxModeSchema, StatusResponseSchema, StreamThreadRunEventSchema, StreamThreadRunRequestSchema, SubmitThreadInputResponseSchema, ThreadCollaborationModeSchema, ThreadContextWindowResponseSchema, ThreadDetailResponseSchema, ThreadMessageDetailFieldSchema, ThreadMessageDetailResponseSchema, ThreadRunOptionsSchema, ThreadStateSchema, ThreadSummarySchema, UpdateRuntimePreferencesRequestSchema, VersionResponseSchema, WebPreviewTargetSchema, WorkspaceChangesResponseSchema, WorkspaceDirectoryEntrySchema, WorkspaceFileMentionSchema, WorkspaceGitActionResponseSchema, WorkspaceSelectionRequestSchema, apiPaths, chatMessageDetailsFromPromptContext, createOpenApiDocument, isPromptSkillMarkdownMention, normalizePromptContext, promptMarkdownWithSkills, promptSkillDisplayName, promptSkillMentionLabel, promptSkillMentionMarkdown, promptSkillMentionTextCandidates, stripPromptSkillMentions };
+import { $ as SandboxModeSchema, A as PairResponseSchema, At as isPromptSkillMarkdownMention, B as QueuedThreadInputSchema, C as ListQueuedThreadInputsResponseSchema, Ct as WorkspaceMarkdownPreviewTargetSchema, D as ListWorkspaceFilesResponseSchema, Dt as apiPaths, E as ListWorkspaceDirectoriesResponseSchema, Et as WorkspaceSelectionRequestSchema, F as PromptAttachmentSummarySchema, Ft as promptSkillMentionMarkdown, G as ResolveApprovalRequestSchema, H as RateLimitWindowSchema, I as PromptContextInputSchema, It as promptSkillMentionTextCandidates, J as RunThreadResponseSchema, K as ResolveApprovalResponseSchema, L as PromptContextSchema, Lt as stripPromptSkillMentions, M as PendingInputRequestQuestionSchema, Mt as promptMarkdownWithSkills, N as PendingInputRequestSchema, Nt as promptSkillDisplayName, O as PairEncryptedPayloadSchema, Ot as chatMessageDetailsFromPromptContext, P as PromptAttachmentSchema, Pt as promptSkillMentionLabel, Q as RuntimePreferencesSchema, R as PromptSkillSchema, S as ListModelsResponseSchema, St as WorkspaceGitActionResponseSchema, T as ListThreadsResponseSchema, Tt as WorkspacePreviewTabSchema, U as RateLimitsResponseSchema, V as RateLimitBucketSchema, W as ReasoningEffortSchema, X as RuntimePreferencesByWorkspacePathSchema, Y as RuntimeModeSchema, Z as RuntimePreferencesResponseSchema, _ as EncryptedPayloadSchema, _t as WebPreviewTargetSchema, a as ArchiveThreadResponseSchema, at as ThreadContextWindowResponseSchema, b as InterruptThreadRunResponseSchema, bt as WorkspaceFileContentResponseSchema, c as ChatMessageRoleSchema, ct as ThreadMessageDetailResponseSchema, d as CheckoutWorkspaceBranchRequestSchema, dt as ThreadSummarySchema, et as StatusResponseSchema, f as CodexModelSchema, ft as UpdateRuntimePreferencesRequestSchema, g as CreateThreadResponseSchema, gt as WORKSPACE_PREVIEW_TAB_VALUES, h as CreateThreadRequestSchema, ht as WORKSPACE_PREVIEW_OPEN_PROTOCOL, i as ApprovalModeSchema, it as ThreadCollaborationModeSchema, j as PendingInputRequestOptionSchema, jt as normalizePromptContext, k as PairRequestSchema, kt as createOpenApiDocument, l as ChatMessageSchema, lt as ThreadRunOptionsSchema, m as ContextWindowUsageSchema, mt as VersionResponseSchema, n as AgentSkillSourceSchema, nt as StreamThreadRunRequestSchema, o as ChatMessageKindSchema, ot as ThreadDetailResponseSchema, p as CommitPushWorkspaceRequestSchema, pt as UpdateWorkspaceFileContentRequestSchema, q as RunThreadRequestSchema, r as ApprovalDecisionSchema, rt as SubmitThreadInputResponseSchema, s as ChatMessagePromptDetailsSchema, st as ThreadMessageDetailFieldSchema, t as AgentSkillSchema, tt as StreamThreadRunEventSchema, u as ChatMessageStateSchema, ut as ThreadStateSchema, v as ErrorResponseSchema, vt as WorkspaceChangesResponseSchema, w as ListSkillsResponseSchema, wt as WorkspacePreviewNavigationRequestSchema, x as IsoDateTimeSchema, xt as WorkspaceFileMentionSchema, y as ImageAttachmentUploadResponseSchema, yt as WorkspaceDirectoryEntrySchema, z as QueuedThreadInputActionResponseSchema } from "./api-schema2.js";
+export { AgentSkillSchema, AgentSkillSourceSchema, ApprovalDecisionSchema, ApprovalModeSchema, ArchiveThreadResponseSchema, ChatMessageKindSchema, ChatMessagePromptDetailsSchema, ChatMessageRoleSchema, ChatMessageSchema, ChatMessageStateSchema, CheckoutWorkspaceBranchRequestSchema, CodexModelSchema, CommitPushWorkspaceRequestSchema, ContextWindowUsageSchema, CreateThreadRequestSchema, CreateThreadResponseSchema, EncryptedPayloadSchema, ErrorResponseSchema, ImageAttachmentUploadResponseSchema, InterruptThreadRunResponseSchema, IsoDateTimeSchema, ListModelsResponseSchema, ListQueuedThreadInputsResponseSchema, ListSkillsResponseSchema, ListThreadsResponseSchema, ListWorkspaceDirectoriesResponseSchema, ListWorkspaceFilesResponseSchema, PairEncryptedPayloadSchema, PairRequestSchema, PairResponseSchema, PendingInputRequestOptionSchema, PendingInputRequestQuestionSchema, PendingInputRequestSchema, PromptAttachmentSchema, PromptAttachmentSummarySchema, PromptContextInputSchema, PromptContextSchema, PromptSkillSchema, QueuedThreadInputActionResponseSchema, QueuedThreadInputSchema, RateLimitBucketSchema, RateLimitWindowSchema, RateLimitsResponseSchema, ReasoningEffortSchema, ResolveApprovalRequestSchema, ResolveApprovalResponseSchema, RunThreadRequestSchema, RunThreadResponseSchema, RuntimeModeSchema, RuntimePreferencesByWorkspacePathSchema, RuntimePreferencesResponseSchema, RuntimePreferencesSchema, SandboxModeSchema, StatusResponseSchema, StreamThreadRunEventSchema, StreamThreadRunRequestSchema, SubmitThreadInputResponseSchema, ThreadCollaborationModeSchema, ThreadContextWindowResponseSchema, ThreadDetailResponseSchema, ThreadMessageDetailFieldSchema, ThreadMessageDetailResponseSchema, ThreadRunOptionsSchema, ThreadStateSchema, ThreadSummarySchema, UpdateRuntimePreferencesRequestSchema, UpdateWorkspaceFileContentRequestSchema, VersionResponseSchema, WORKSPACE_PREVIEW_OPEN_PROTOCOL, WORKSPACE_PREVIEW_TAB_VALUES, WebPreviewTargetSchema, WorkspaceChangesResponseSchema, WorkspaceDirectoryEntrySchema, WorkspaceFileContentResponseSchema, WorkspaceFileMentionSchema, WorkspaceGitActionResponseSchema, WorkspaceMarkdownPreviewTargetSchema, WorkspacePreviewNavigationRequestSchema, WorkspacePreviewTabSchema, WorkspaceSelectionRequestSchema, apiPaths, chatMessageDetailsFromPromptContext, createOpenApiDocument, isPromptSkillMarkdownMention, normalizePromptContext, promptMarkdownWithSkills, promptSkillDisplayName, promptSkillMentionLabel, promptSkillMentionMarkdown, promptSkillMentionTextCandidates, stripPromptSkillMentions };

package/dist/api-schema2.js

@@ -65,6 +65,7 @@ const VersionResponseSchema = z.object({
 });
 const ThreadRunOptionsSchema = z.object({
 	model: z.string().trim().min(1).optional(),
+	serviceTier: z.string().trim().min(1).optional(),
 	runtimeMode: RuntimeModeSchema.optional(),
 	approvalPolicy: ApprovalModeSchema.optional(),
 	sandboxMode: SandboxModeSchema.optional(),
@@ -73,12 +74,14 @@ const ThreadRunOptionsSchema = z.object({
 });
 const RuntimePreferencesSchema = z.object({
 	model: z.string().trim().min(1).optional(),
+	serviceTier: z.string().trim().min(1).optional(),
 	runtimeMode: RuntimeModeSchema.default("default"),
 	reasoningEffort: ReasoningEffortSchema.optional()
 });
 const RuntimePreferencesByWorkspacePathSchema = z.record(z.string().trim().min(1), RuntimePreferencesSchema);
 const UpdateRuntimePreferencesRequestSchema = z.object({
 	model: z.string().trim().min(1).nullable().optional(),
+	serviceTier: z.string().trim().min(1).nullable().optional(),
 	runtimeMode: RuntimeModeSchema.optional(),
 	reasoningEffort: ReasoningEffortSchema.nullable().optional(),
 	threadId: z.string().trim().min(1).optional(),
@@ -97,7 +100,12 @@ const CodexModelSchema = z.object({
 	description: z.string().optional(),
 	isDefault: z.boolean().default(false),
 	defaultReasoningEffort: ReasoningEffortSchema.optional(),
-	supportedReasoningEfforts: z.array(ReasoningEffortSchema).default([])
+	supportedReasoningEfforts: z.array(ReasoningEffortSchema).default([]),
+	serviceTiers: z.array(z.object({
+		id: z.string().min(1),
+		name: z.string().min(1),
+		description: z.string().optional()
+	})).default([])
 });
 const AgentSkillSourceSchema = z.enum([
 	"workspace",
@@ -169,10 +177,28 @@ const WorkspaceFileMentionSchema = z.object({
 	path: z.string().min(1)
 });
 const ListWorkspaceFilesResponseSchema = z.object({
+	directory: z.string(),
 	files: z.array(WorkspaceFileMentionSchema),
+	parentDirectory: z.string().nullable(),
 	query: z.string(),
 	workspacePath: z.string().min(1)
 });
+const WorkspaceFileContentResponseSchema = z.object({
+	binary: z.boolean(),
+	content: z.string(),
+	directory: z.string(),
+	language: z.string(),
+	name: z.string().min(1),
+	path: z.string().min(1),
+	size: z.number().int().nonnegative(),
+	truncated: z.boolean(),
+	workspacePath: z.string().min(1)
+});
+const UpdateWorkspaceFileContentRequestSchema = z.object({
+	content: z.string().max(1024 * 1024),
+	path: z.string().trim().min(1),
+	workspacePath: z.string().trim().min(1).optional()
+});
 const PendingInputRequestOptionSchema = z.object({
 	label: z.string().min(1),
 	description: z.string().optional()
@@ -208,6 +234,7 @@ const ThreadSummarySchema = z.object({
 	updatedAt: IsoDateTimeSchema,
 	state: ThreadStateSchema,
 	model: z.string().optional(),
+	serviceTier: z.string().optional(),
 	runtimeMode: RuntimeModeSchema.optional(),
 	approvalPolicy: ApprovalModeSchema.optional(),
 	sandboxMode: SandboxModeSchema.optional(),
@@ -282,6 +309,19 @@ const WorkspaceGitActionResponseSchema = z.object({
 	message: z.string().min(1),
 	output: z.string().default("")
 });
+const WORKSPACE_PREVIEW_TAB_VALUES = [
+	"git",
+	"files",
+	"markdown",
+	"web"
+];
+const WorkspacePreviewTabSchema = z.enum(WORKSPACE_PREVIEW_TAB_VALUES);
+const WorkspaceMarkdownPreviewTargetSchema = z.object({
+	name: z.string().trim().min(1).optional(),
+	path: z.string().trim().min(1),
+	workspacePath: z.string().trim().min(1).optional()
+});
+const WORKSPACE_PREVIEW_OPEN_PROTOCOL = "workspace-preview.open";
 const WebPreviewTargetSchema = z.object({
 	kind: z.literal("web"),
 	url: z.string().url(),
@@ -299,6 +339,25 @@ const WebPreviewTargetSchema = z.object({
 	]),
 	detectedAt: IsoDateTimeSchema
 });
+const WorkspacePreviewOpenBaseSchema = z.object({
+	protocol: z.literal(WORKSPACE_PREVIEW_OPEN_PROTOCOL),
+	workspacePath: z.string().trim().min(1).optional()
+});
+const WorkspacePreviewNavigationRequestSchema = z.discriminatedUnion("tab", [
+	WorkspacePreviewOpenBaseSchema.extend({ tab: z.literal("git") }),
+	WorkspacePreviewOpenBaseSchema.extend({
+		tab: z.literal("files"),
+		target: z.object({ path: z.string().trim().min(1).optional() }).optional()
+	}),
+	WorkspacePreviewOpenBaseSchema.extend({
+		tab: z.literal("markdown"),
+		target: WorkspaceMarkdownPreviewTargetSchema
+	}),
+	WorkspacePreviewOpenBaseSchema.extend({
+		tab: z.literal("web"),
+		target: WebPreviewTargetSchema.optional()
+	})
+]);
 const PairRequestSchema = z.object({
 	clientSessionId: z.string().trim().min(1).max(120).optional(),
 	clientName: z.string().trim().min(1).max(80).optional(),
@@ -581,6 +640,7 @@ const apiPaths = {
 	pair: "/v1/pair",
 	pairApproval: (approvalCode) => `/v1/pair/${encodeURIComponent(approvalCode)}`,
 	pairApprove: "/v1/pair/approve",
+	sessionsClear: "/v1/sessions/clear",
 	sessionRefresh: "/v1/session/refresh",
 	status: "/v1/status",
 	preferences: "/v1/preferences",
@@ -588,6 +648,7 @@ const apiPaths = {
 	models: "/v1/models",
 	skills: "/v1/skills",
 	workspaceFiles: "/v1/workspace/files",
+	workspaceFileContent: "/v1/workspace/file",
 	workspaceDirectories: "/v1/workspace-directories",
 	workspaceChanges: "/v1/workspace/changes",
 	workspaceCheckout: "/v1/workspace/checkout",
@@ -681,6 +742,35 @@ function createOpenApiDocument() {
 					"400": jsonResponse("ErrorResponse")
 				}
 			} },
+			"/v1/workspace/files": { get: {
+				summary: "List files under the configured workspace",
+				responses: {
+					"200": jsonResponse("ListWorkspaceFilesResponse"),
+					"400": jsonResponse("ErrorResponse"),
+					"502": jsonResponse("ErrorResponse")
+				}
+			} },
+			"/v1/workspace/file": {
+				get: {
+					summary: "Read a workspace file preview",
+					responses: {
+						"200": jsonResponse("WorkspaceFileContentResponse"),
+						"400": jsonResponse("ErrorResponse"),
+						"404": jsonResponse("ErrorResponse"),
+						"502": jsonResponse("ErrorResponse")
+					}
+				},
+				put: {
+					summary: "Update a workspace text file",
+					requestBody: jsonRequest("UpdateWorkspaceFileContentRequest"),
+					responses: {
+						"200": jsonResponse("WorkspaceFileContentResponse"),
+						"400": jsonResponse("ErrorResponse"),
+						"404": jsonResponse("ErrorResponse"),
+						"502": jsonResponse("ErrorResponse")
+					}
+				}
+			},
 			"/v1/threads/{threadId}/runs": { post: {
 				summary: "Run a prompt on a Codex thread",
 				parameters: [{
@@ -814,6 +904,7 @@ function createOpenApiDocument() {
 						minimum: 0
 					},
 					model: { type: "string" },
+					serviceTier: { type: "string" },
 					runtimeMode: { $ref: "#/components/schemas/RuntimeMode" },
 					approvalPolicy: {
 						type: "string",
@@ -901,6 +992,7 @@ function createOpenApiDocument() {
 				required: ["runtimeMode"],
 				properties: {
 					model: { type: "string" },
+					serviceTier: { type: "string" },
 					runtimeMode: {
 						type: "string",
 						enum: [
@@ -932,6 +1024,10 @@ function createOpenApiDocument() {
 						type: "string",
 						nullable: true
 					},
+					serviceTier: {
+						type: "string",
+						nullable: true
+					},
 					runtimeMode: {
 						type: "string",
 						enum: [
@@ -996,6 +1092,87 @@ function createOpenApiDocument() {
 					}
 				}
 			},
+			WorkspaceFileMention: {
+				type: "object",
+				required: [
+					"directory",
+					"kind",
+					"name",
+					"path"
+				],
+				properties: {
+					directory: { type: "string" },
+					kind: {
+						type: "string",
+						enum: ["directory", "file"]
+					},
+					name: { type: "string" },
+					path: { type: "string" }
+				}
+			},
+			ListWorkspaceFilesResponse: {
+				type: "object",
+				required: [
+					"directory",
+					"files",
+					"parentDirectory",
+					"query",
+					"workspacePath"
+				],
+				properties: {
+					directory: { type: "string" },
+					files: {
+						type: "array",
+						items: { $ref: "#/components/schemas/WorkspaceFileMention" }
+					},
+					parentDirectory: {
+						type: "string",
+						nullable: true
+					},
+					query: { type: "string" },
+					workspacePath: { type: "string" }
+				}
+			},
+			WorkspaceFileContentResponse: {
+				type: "object",
+				required: [
+					"binary",
+					"content",
+					"directory",
+					"language",
+					"name",
+					"path",
+					"size",
+					"truncated",
+					"workspacePath"
+				],
+				properties: {
+					binary: { type: "boolean" },
+					content: { type: "string" },
+					directory: { type: "string" },
+					language: { type: "string" },
+					name: { type: "string" },
+					path: { type: "string" },
+					size: {
+						type: "integer",
+						minimum: 0
+					},
+					truncated: { type: "boolean" },
+					workspacePath: { type: "string" }
+				}
+			},
+			UpdateWorkspaceFileContentRequest: {
+				type: "object",
+				required: ["content", "path"],
+				properties: {
+					content: {
+						type: "string",
+						maxLength: 1048576
+					},
+					path: { type: "string" },
+					workspacePath: { type: "string" }
+				}
+			},
 			CreateThreadRequest: {
 				type: "object",
 				properties: {
@@ -1346,4 +1523,4 @@ function jsonResponse(schemaName) {
 	};
 }
 //#endregion
-export { SandboxModeSchema as $, PairResponseSchema as A, stripPromptSkillMentions as At, QueuedThreadInputSchema as B, ListQueuedThreadInputsResponseSchema as C, isPromptSkillMarkdownMention as Ct, ListWorkspaceFilesResponseSchema as D, promptSkillMentionLabel as Dt, ListWorkspaceDirectoriesResponseSchema as E, promptSkillDisplayName as Et, PromptAttachmentSummarySchema as F, ResolveApprovalRequestSchema as G, RateLimitWindowSchema as H, PromptContextInputSchema as I, RunThreadResponseSchema as J, ResolveApprovalResponseSchema as K, PromptContextSchema as L, PendingInputRequestQuestionSchema as M, PendingInputRequestSchema as N, PairEncryptedPayloadSchema as O, promptSkillMentionMarkdown as Ot, PromptAttachmentSchema as P, RuntimePreferencesSchema as Q, PromptSkillSchema as R, ListModelsResponseSchema as S, createOpenApiDocument as St, ListThreadsResponseSchema as T, promptMarkdownWithSkills as Tt, RateLimitsResponseSchema as U, RateLimitBucketSchema as V, ReasoningEffortSchema as W, RuntimePreferencesByWorkspacePathSchema as X, RuntimeModeSchema as Y, RuntimePreferencesResponseSchema as Z, EncryptedPayloadSchema as _, WorkspaceFileMentionSchema as _t, ArchiveThreadResponseSchema as a, ThreadContextWindowResponseSchema as at, InterruptThreadRunResponseSchema as b, apiPaths as bt, ChatMessageRoleSchema as c, ThreadMessageDetailResponseSchema as ct, CheckoutWorkspaceBranchRequestSchema as d, ThreadSummarySchema as dt, StatusResponseSchema as et, CodexModelSchema as f, UpdateRuntimePreferencesRequestSchema as ft, CreateThreadResponseSchema as g, WorkspaceDirectoryEntrySchema as gt, CreateThreadRequestSchema as h, WorkspaceChangesResponseSchema as ht, ApprovalModeSchema as i, ThreadCollaborationModeSchema as it, PendingInputRequestOptionSchema as j, PairRequestSchema as k, promptSkillMentionTextCandidates as kt, ChatMessageSchema as l, ThreadRunOptionsSchema as lt, ContextWindowUsageSchema as m, WebPreviewTargetSchema as mt, AgentSkillSourceSchema as n, StreamThreadRunRequestSchema as nt, ChatMessageKindSchema as o, ThreadDetailResponseSchema as ot, CommitPushWorkspaceRequestSchema as p, VersionResponseSchema as pt, RunThreadRequestSchema as q, ApprovalDecisionSchema as r, SubmitThreadInputResponseSchema as rt, ChatMessagePromptDetailsSchema as s, ThreadMessageDetailFieldSchema as st, AgentSkillSchema as t, StreamThreadRunEventSchema as tt, ChatMessageStateSchema as u, ThreadStateSchema as ut, ErrorResponseSchema as v, WorkspaceGitActionResponseSchema as vt, ListSkillsResponseSchema as w, normalizePromptContext as wt, IsoDateTimeSchema as x, chatMessageDetailsFromPromptContext as xt, ImageAttachmentUploadResponseSchema as y, WorkspaceSelectionRequestSchema as yt, QueuedThreadInputActionResponseSchema as z };
+export { SandboxModeSchema as $, PairResponseSchema as A, isPromptSkillMarkdownMention as At, QueuedThreadInputSchema as B, ListQueuedThreadInputsResponseSchema as C, WorkspaceMarkdownPreviewTargetSchema as Ct, ListWorkspaceFilesResponseSchema as D, apiPaths as Dt, ListWorkspaceDirectoriesResponseSchema as E, WorkspaceSelectionRequestSchema as Et, PromptAttachmentSummarySchema as F, promptSkillMentionMarkdown as Ft, ResolveApprovalRequestSchema as G, RateLimitWindowSchema as H, PromptContextInputSchema as I, promptSkillMentionTextCandidates as It, RunThreadResponseSchema as J, ResolveApprovalResponseSchema as K, PromptContextSchema as L, stripPromptSkillMentions as Lt, PendingInputRequestQuestionSchema as M, promptMarkdownWithSkills as Mt, PendingInputRequestSchema as N, promptSkillDisplayName as Nt, PairEncryptedPayloadSchema as O, chatMessageDetailsFromPromptContext as Ot, PromptAttachmentSchema as P, promptSkillMentionLabel as Pt, RuntimePreferencesSchema as Q, PromptSkillSchema as R, ListModelsResponseSchema as S, WorkspaceGitActionResponseSchema as St, ListThreadsResponseSchema as T, WorkspacePreviewTabSchema as Tt, RateLimitsResponseSchema as U, RateLimitBucketSchema as V, ReasoningEffortSchema as W, RuntimePreferencesByWorkspacePathSchema as X, RuntimeModeSchema as Y, RuntimePreferencesResponseSchema as Z, EncryptedPayloadSchema as _, WebPreviewTargetSchema as _t, ArchiveThreadResponseSchema as a, ThreadContextWindowResponseSchema as at, InterruptThreadRunResponseSchema as b, WorkspaceFileContentResponseSchema as bt, ChatMessageRoleSchema as c, ThreadMessageDetailResponseSchema as ct, CheckoutWorkspaceBranchRequestSchema as d, ThreadSummarySchema as dt, StatusResponseSchema as et, CodexModelSchema as f, UpdateRuntimePreferencesRequestSchema as ft, CreateThreadResponseSchema as g, WORKSPACE_PREVIEW_TAB_VALUES as gt, CreateThreadRequestSchema as h, WORKSPACE_PREVIEW_OPEN_PROTOCOL as ht, ApprovalModeSchema as i, ThreadCollaborationModeSchema as it, PendingInputRequestOptionSchema as j, normalizePromptContext as jt, PairRequestSchema as k, createOpenApiDocument as kt, ChatMessageSchema as l, ThreadRunOptionsSchema as lt, ContextWindowUsageSchema as m, VersionResponseSchema as mt, AgentSkillSourceSchema as n, StreamThreadRunRequestSchema as nt, ChatMessageKindSchema as o, ThreadDetailResponseSchema as ot, CommitPushWorkspaceRequestSchema as p, UpdateWorkspaceFileContentRequestSchema as pt, RunThreadRequestSchema as q, ApprovalDecisionSchema as r, SubmitThreadInputResponseSchema as rt, ChatMessagePromptDetailsSchema as s, ThreadMessageDetailFieldSchema as st, AgentSkillSchema as t, StreamThreadRunEventSchema as tt, ChatMessageStateSchema as u, ThreadStateSchema as ut, ErrorResponseSchema as v, WorkspaceChangesResponseSchema as vt, ListSkillsResponseSchema as w, WorkspacePreviewNavigationRequestSchema as wt, IsoDateTimeSchema as x, WorkspaceFileMentionSchema as xt, ImageAttachmentUploadResponseSchema as y, WorkspaceDirectoryEntrySchema as yt, QueuedThreadInputActionResponseSchema as z };

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { bt as apiPaths } from "./api-schema2.js";
-import { n as codexRelayHome, r as legacyCodexRelayDataPath, t as codexRelayDataPath } from "./paths.js";
+import { Dt as apiPaths } from "./api-schema2.js";
+import { n as codexRelayHome, o as getConnectUrlGuidance, r as legacyCodexRelayDataPath, s as createTursoPairingSessionStore, t as codexRelayDataPath } from "./paths.js";
 import { Command } from "@commander-js/extra-typings";
 import qrcode from "qrcode-terminal";
 import { spawn } from "node:child_process";
 import { closeSync, openSync } from "node:fs";
-import { mkdir, readFile, unlink } from "node:fs/promises";
+import { access, mkdir, readFile, rm, unlink } from "node:fs/promises";
 import { dirname } from "node:path";
 import { setTimeout } from "node:timers/promises";
 import { fileURLToPath } from "node:url";
@@ -17,6 +17,7 @@ Examples:
   ${npxCommand}              Start the relay and print a pairing QR
   ${npxCommand} --bg         Start the relay in the background
   ${npxCommand} qr           Print the current pairing QR
+  ${npxCommand} clear        Sign out every paired mobile app
   ${npxCommand} approve CODE Approve a pending mobile pairing request`).action(async (options) => {
 	if (options.debug) process.env.CODEX_RELAY_DEBUG = "1";
 	if (options.dangerouslyAutoApprove) process.env.CODEX_RELAY_DANGEROUSLY_AUTO_APPROVE = "1";
@@ -32,6 +33,9 @@ program.command("qr").description("Print the current pairing QR for an already r
 program.command("approve").description("Approve a pending mobile pairing request.").argument("<approval-code>", "approval code shown in the mobile app").action(async (approvalCode) => {
 	await approvePairing(approvalCode);
 });
+program.command("clear").description("Sign out every paired mobile app.").option("--debug", "also delete debug.log").action(async (options, command) => {
+	await clearPairings({ clearDebugLog: Boolean(options.debug || command.optsWithGlobals().debug) });
+});
 await program.parseAsync();
 async function startBackgroundServer() {
 	const logPath = codexRelayDataPath("server.log");
@@ -135,6 +139,74 @@ async function approvePairing(rawCode) {
 	}
 	console.log("Approved Codex Relay pairing request.");
 }
+async function clearPairings(options) {
+	const result = await clearPairingsViaServer().catch(async (error) => {
+		if (await hasRunningBackgroundServer()) throw error;
+		return clearPairingsFromLocalStore();
+	});
+	const removedDebugLogs = options.clearDebugLog ? await clearDebugLogs() : [];
+	console.log(`Signed out ${result.sessionsCleared} paired mobile app${result.sessionsCleared === 1 ? "" : "s"}.`);
+	if (result.pendingPairingsCleared > 0) console.log(`Removed ${result.pendingPairingsCleared} pending pairing request${result.pendingPairingsCleared === 1 ? "" : "s"}.`);
+	if (options.clearDebugLog) console.log(removedDebugLogs.length > 0 ? `Deleted debug logs: ${removedDebugLogs.join(", ")}` : "No debug logs found.");
+}
+async function clearPairingsViaServer() {
+	const endpoint = await getApprovalEndpoint();
+	const secret = await readApprovalSecret();
+	const response = await fetch(`${endpoint}${apiPaths.sessionsClear}`, {
+		method: "POST",
+		headers: {
+			accept: "application/json",
+			"x-codex-relay-approve-secret": secret
+		}
+	});
+	const payload = await response.json().catch(() => void 0);
+	if (!response.ok) {
+		const message = payload && typeof payload === "object" && "error" in payload && payload.error && typeof payload.error === "object" && "message" in payload.error ? String(payload.error.message) : `Codex Relay server returned ${response.status}`;
+		throw new Error(message);
+	}
+	return parseClearPairingResult(payload);
+}
+async function clearPairingsFromLocalStore() {
+	const dbPath = await resolveAuthDbPath();
+	if (!dbPath) return {
+		pendingPairingsCleared: 0,
+		sessionsCleared: 0
+	};
+	return (await createTursoPairingSessionStore(dbPath)).clearAll();
+}
+async function resolveAuthDbPath() {
+	if (process.env.CODEX_RELAY_AUTH_DB_PATH) return process.env.CODEX_RELAY_AUTH_DB_PATH;
+	const primary = codexRelayDataPath("auth.db");
+	if (await pathExists(primary)) return primary;
+	const legacy = legacyCodexRelayDataPath("auth.db");
+	if (await pathExists(legacy)) return legacy;
+}
+async function clearDebugLogs() {
+	const paths = [...new Set([codexRelayDataPath("debug.log"), legacyCodexRelayDataPath("debug.log")])];
+	const removed = [];
+	for (const path of paths) {
+		if (!await pathExists(path)) continue;
+		await rm(path, { force: true });
+		removed.push(path);
+	}
+	return removed;
+}
+async function hasRunningBackgroundServer() {
+	return Boolean(await readRunningPid(codexRelayDataPath("server.pid")));
+}
+async function pathExists(path) {
+	return access(path).then(() => true, () => false);
+}
+function parseClearPairingResult(payload) {
+	if (!payload || typeof payload !== "object") return {
+		pendingPairingsCleared: 0,
+		sessionsCleared: 0
+	};
+	return {
+		pendingPairingsCleared: "pendingPairingsCleared" in payload ? Number(payload.pendingPairingsCleared) || 0 : 0,
+		sessionsCleared: "sessionsCleared" in payload ? Number(payload.sessionsCleared) || 0 : 0
+	};
+}
 async function printPairingQr() {
 	const storedState = await readServerState();
 	const state = storedState?.pairingPayload ? storedState : await readServerLogState();
@@ -148,7 +220,15 @@ async function printPairingQr() {
 	console.log("");
 	qrcode.generate(state.pairingPayload, { small: true });
 	console.log("");
-	if (state.connectUrl) console.log(`Mobile: ${state.connectUrl}`);
+	if (state.connectUrl) {
+		console.log(`Mobile: ${state.connectUrl}`);
+		const guidance = getConnectUrlGuidance(state.connectUrl);
+		if (guidance) console.log(`Network: ${guidance}`);
+	}
+	if (state.connectUrlCandidates && state.connectUrlCandidates.length > 1) {
+		console.log(`Candidate addresses: ${state.connectUrlCandidates.length}`);
+		for (const candidate of state.connectUrlCandidates.slice(1)) console.log(`  ${candidate.label}: ${candidate.url}`);
+	}
 	if (state.listenUrl) console.log(`Server: ${state.listenUrl}`);
 	console.log("");
 	console.log(`Pairing: ${state.pairingPayload}`);
@@ -206,6 +286,7 @@ async function readServerState() {
 	if (!state) return;
 	return {
 		connectUrl: typeof state.connectUrl === "string" ? state.connectUrl : void 0,
+		connectUrlCandidates: parseConnectUrlCandidates(state.connectUrlCandidates),
 		host: typeof state.host === "string" ? state.host : void 0,
 		listenUrl: typeof state.listenUrl === "string" ? state.listenUrl : void 0,
 		pairingPayload: typeof state.pairingPayload === "string" ? state.pairingPayload : void 0,
@@ -235,6 +316,18 @@ function lastLogValue(log, label) {
 	for (const match of log.matchAll(pattern)) value = match[1];
 	return value;
 }
+function parseConnectUrlCandidates(value) {
+	if (!Array.isArray(value)) return;
+	return value.map((candidate) => {
+		if (!candidate || typeof candidate !== "object") return;
+		const label = "label" in candidate ? candidate.label : void 0;
+		const url = "url" in candidate ? candidate.url : void 0;
+		return typeof label === "string" && typeof url === "string" ? {
+			label,
+			url
+		} : void 0;
+	}).filter((candidate) => Boolean(candidate));
+}
 function isDatabaseLockError(error) {
 	const message = error instanceof Error ? error.message : String(error);
 	return message.includes("failed to open database") && message.includes("Locking error");