feat: support creating worktrees from GitHub pull requests

packages/server/src/shared/messages.attachments.test.ts

@@ -115,4 +115,71 @@ describe("shared messages attachments", () => {
       },
     ]);
   });
+
+  it("parses old-shape create-worktree payloads without the new intent fields", () => {
+    const parsed = CreatePaseoWorktreeRequestSchema.parse({
+      type: "create_paseo_worktree_request",
+      requestId: "req-4",
+      cwd: "/tmp/repo",
+      attachments: [],
+    });
+
+    expect(parsed).toEqual({
+      type: "create_paseo_worktree_request",
+      requestId: "req-4",
+      cwd: "/tmp/repo",
+      attachments: [],
+    });
+  });
+
+  it("accepts and strips create-worktree intent fields compatibly", () => {
+    const parsed = CreatePaseoWorktreeRequestSchema.parse({
+      type: "create_paseo_worktree_request",
+      requestId: "req-5",
+      cwd: "/tmp/repo",
+      attachments: [],
+      action: "checkout",
+      refName: "feature/ref-picker",
+      githubPrNumber: 42,
+      futureField: "ignored",
+    });
+
+    expect(parsed).toEqual({
+      type: "create_paseo_worktree_request",
+      requestId: "req-5",
+      cwd: "/tmp/repo",
+      attachments: [],
+      action: "checkout",
+      refName: "feature/ref-picker",
+      githubPrNumber: 42,
+    });
+  });
+
+  it("accepts optional create-agent git intent fields and strips unknown git fields", () => {
+    const parsed = CreateAgentRequestMessageSchema.parse({
+      type: "create_agent_request",
+      requestId: "req-6",
+      config: {
+        provider: "codex",
+        cwd: "/tmp/repo",
+      },
+      attachments: [],
+      git: {
+        createWorktree: true,
+        worktreeSlug: "review-42",
+        action: "checkout",
+        refName: "head-ref",
+        githubPrNumber: 42,
+        futureGitField: "ignored",
+      },
+    });
+
+    expect(parsed.git).toEqual({
+      createWorktree: true,
+      worktreeSlug: "review-42",
+      action: "checkout",
+      refName: "head-ref",
+      githubPrNumber: 42,
+    });
+  });
 });

packages/server/src/shared/messages.ts

@@ -837,6 +837,9 @@ const GitSetupOptionsSchema = z.object({
   newBranchName: z.string().optional(),
   createWorktree: z.boolean().optional(),
   worktreeSlug: z.string().optional(),
+  refName: z.string().min(1).optional(),
+  action: z.enum(["branch-off", "checkout"]).optional(),
+  githubPrNumber: z.number().int().positive().optional(),
 });
 
 export type GitSetupOptions = z.infer<typeof GitSetupOptionsSchema>;
@@ -1188,11 +1191,14 @@ export const GitHubSearchItemSchema = z.object({
   headRefName: z.string().nullable().optional(),
 });
 
+export const GitHubSearchKindSchema = z.enum(["github-issue", "github-pr"]);
+
 export const GitHubSearchRequestSchema = z.object({
   type: z.literal("github_search_request"),
   cwd: z.string(),
   query: z.string(),
   limit: z.number().int().min(1).max(50).optional(),
+  kinds: z.array(GitHubSearchKindSchema).optional(),
   requestId: z.string(),
 });
 
@@ -1226,6 +1232,9 @@ export const CreatePaseoWorktreeRequestSchema = z.object({
   cwd: z.string(),
   worktreeSlug: z.string().optional(),
   attachments: AgentAttachmentsSchema,
+  refName: z.string().min(1).optional(),
+  action: z.enum(["branch-off", "checkout"]).optional(),
+  githubPrNumber: z.number().int().positive().optional(),
   requestId: z.string(),
 });
 
@@ -1821,6 +1830,7 @@ export const AgentCreateFailedStatusPayloadSchema = z.object({
   status: z.literal("agent_create_failed"),
   requestId: z.string(),
   error: z.string(),
+  errorCode: z.string().optional(),
 });
 
 export const AgentResumedStatusPayloadSchema = z
@@ -2652,6 +2662,7 @@ export const CreatePaseoWorktreeResponseSchema = z.object({
   payload: z.object({
     workspace: WorkspaceDescriptorPayloadSchema.nullable(),
     error: z.string().nullable(),
+    errorCode: z.string().optional(),
     setupTerminalId: z.string().nullable(),
     requestId: z.string(),
   }),
@@ -3228,6 +3239,7 @@ export type ValidateBranchResponse = z.infer<typeof ValidateBranchResponseSchema
 export type BranchSuggestionsRequest = z.infer<typeof BranchSuggestionsRequestSchema>;
 export type BranchSuggestionsResponse = z.infer<typeof BranchSuggestionsResponseSchema>;
 export type GitHubSearchItem = z.infer<typeof GitHubSearchItemSchema>;
+export type GitHubSearchKind = z.infer<typeof GitHubSearchKindSchema>;
 export type GitHubSearchRequest = z.infer<typeof GitHubSearchRequestSchema>;
 export type GitHubSearchResponse = z.infer<typeof GitHubSearchResponseSchema>;
 export type CreatePaseoWorktreeRequest = z.infer<typeof CreatePaseoWorktreeRequestSchema>;