codex-relay 1.0.3 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-relay",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Local Codex Relay CLI bridge for the Codex Relay mobile app.",
   "repository": {
     "type": "git",

package/src/api-schema.ts

@@ -42,6 +42,7 @@ export const VersionResponseSchema = z.object({
 
 export 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(),
@@ -51,6 +52,7 @@ export const ThreadRunOptionsSchema = z.object({
 
 export 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(),
 });
@@ -62,6 +64,7 @@ export const RuntimePreferencesByWorkspacePathSchema = z.record(
 
 export 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(),
@@ -83,6 +86,15 @@ export const CodexModelSchema = z.object({
   isDefault: z.boolean().default(false),
   defaultReasoningEffort: ReasoningEffortSchema.optional(),
   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([]),
 });
 
 export const AgentSkillSourceSchema = z.enum(["workspace", "personal", "system", "plugin"]);
@@ -176,11 +188,31 @@ export const WorkspaceFileMentionSchema = z.object({
 });
 
 export const ListWorkspaceFilesResponseSchema = z.object({
+  directory: z.string(),
   files: z.array(WorkspaceFileMentionSchema),
+  parentDirectory: z.string().nullable(),
   query: z.string(),
   workspacePath: z.string().min(1),
 });
 
+export 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),
+});
+
+export const UpdateWorkspaceFileContentRequestSchema = z.object({
+  content: z.string().max(1024 * 1024),
+  path: z.string().trim().min(1),
+  workspacePath: z.string().trim().min(1).optional(),
+});
+
 export const PendingInputRequestOptionSchema = z.object({
   label: z.string().min(1),
   description: z.string().optional(),
@@ -220,6 +252,7 @@ export 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(),
@@ -319,6 +352,18 @@ export const WorkspaceGitActionResponseSchema = z.object({
   output: z.string().default(""),
 });
 
+export const WORKSPACE_PREVIEW_TAB_VALUES = ["git", "files", "markdown", "web"] as const;
+
+export const WorkspacePreviewTabSchema = z.enum(WORKSPACE_PREVIEW_TAB_VALUES);
+
+export const WorkspaceMarkdownPreviewTargetSchema = z.object({
+  name: z.string().trim().min(1).optional(),
+  path: z.string().trim().min(1),
+  workspacePath: z.string().trim().min(1).optional(),
+});
+
+export const WORKSPACE_PREVIEW_OPEN_PROTOCOL = "workspace-preview.open" as const;
+
 export const WebPreviewTargetSchema = z.object({
   kind: z.literal("web"),
   url: z.string().url(),
@@ -329,6 +374,33 @@ export const WebPreviewTargetSchema = z.object({
   detectedAt: IsoDateTimeSchema,
 });
 
+const WorkspacePreviewOpenBaseSchema = z.object({
+  protocol: z.literal(WORKSPACE_PREVIEW_OPEN_PROTOCOL),
+  workspacePath: z.string().trim().min(1).optional(),
+});
+
+export 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(),
+  }),
+]);
+
 export const PairRequestSchema = z.object({
   clientSessionId: z.string().trim().min(1).max(120).optional(),
   clientName: z.string().trim().min(1).max(80).optional(),
@@ -592,6 +664,11 @@ export type WorkspaceSelectionRequest = z.infer<typeof WorkspaceSelectionRequest
 export type CheckoutWorkspaceBranchRequest = z.infer<typeof CheckoutWorkspaceBranchRequestSchema>;
 export type CommitPushWorkspaceRequest = z.infer<typeof CommitPushWorkspaceRequestSchema>;
 export type WorkspaceGitActionResponse = z.infer<typeof WorkspaceGitActionResponseSchema>;
+export type WorkspacePreviewTab = z.infer<typeof WorkspacePreviewTabSchema>;
+export type WorkspaceMarkdownPreviewTarget = z.infer<typeof WorkspaceMarkdownPreviewTargetSchema>;
+export type WorkspacePreviewNavigationRequest = z.infer<
+  typeof WorkspacePreviewNavigationRequestSchema
+>;
 export type WebPreviewTarget = z.infer<typeof WebPreviewTargetSchema>;
 export type PairRequest = z.infer<typeof PairRequestSchema>;
 export type PairResponse = z.infer<typeof PairResponseSchema>;
@@ -619,6 +696,7 @@ export type ArchiveThreadResponse = z.infer<typeof ArchiveThreadResponseSchema>;
 export type ListModelsResponse = z.infer<typeof ListModelsResponseSchema>;
 export type ListSkillsResponse = z.infer<typeof ListSkillsResponseSchema>;
 export type ListWorkspaceFilesResponse = z.infer<typeof ListWorkspaceFilesResponseSchema>;
+export type WorkspaceFileContentResponse = z.infer<typeof WorkspaceFileContentResponseSchema>;
 
 export function normalizePromptContext(input?: {
   attachments?: PromptAttachment[] | null;
@@ -819,6 +897,9 @@ export type ThreadDetailResponse = z.infer<typeof ThreadDetailResponseSchema>;
 export type ThreadMessageDetailField = z.infer<typeof ThreadMessageDetailFieldSchema>;
 export type ThreadMessageDetailResponse = z.infer<typeof ThreadMessageDetailResponseSchema>;
 export type StreamThreadRunEvent = z.infer<typeof StreamThreadRunEventSchema>;
+export type UpdateWorkspaceFileContentRequest = z.infer<
+  typeof UpdateWorkspaceFileContentRequestSchema
+>;
 
 export const apiPaths = {
   version: "/version",
@@ -832,6 +913,7 @@ export 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",
@@ -950,6 +1032,37 @@ export function createOpenApiDocument() {
           },
         },
       },
+      "/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",
@@ -1055,6 +1168,7 @@ export function createOpenApiDocument() {
             state: { $ref: "#/components/schemas/ThreadState" },
             messageCount: { type: "integer", minimum: 0 },
             model: { type: "string" },
+            serviceTier: { type: "string" },
             runtimeMode: { $ref: "#/components/schemas/RuntimeMode" },
             approvalPolicy: { type: "string", enum: ["on-request", "on-failure", "never"] },
             sandboxMode: {
@@ -1111,6 +1225,7 @@ export function createOpenApiDocument() {
           required: ["runtimeMode"],
           properties: {
             model: { type: "string" },
+            serviceTier: { type: "string" },
             runtimeMode: {
               type: "string",
               enum: ["default", "auto", "full-access", "on-request"],
@@ -1128,6 +1243,7 @@ export function createOpenApiDocument() {
             threadId: { type: "string" },
             workspacePath: { type: "string" },
             model: { type: "string", nullable: true },
+            serviceTier: { type: "string", nullable: true },
             runtimeMode: {
               type: "string",
               enum: ["default", "auto", "full-access", "on-request"],
@@ -1173,6 +1289,64 @@ export 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: {