fix(server): rename worktree branches from prompt + attachments

Replace top-level `attachments` and `nameContext` on `create_paseo_worktree_request` with `firstAgentContext: { prompt?, attachments? }`, the single signal driving auto-rename. Drop the `worktreeSlug || …` short-circuits so a random placeholder slug no longer blocks renaming, drop the attachment-as-PR fallback in favor of explicit `githubPrNumber`, and reshape the MCP `create_worktree` tool around a `target` discriminated union (`branch-off` / `checkout-branch` / `checkout-pr`) with concise field descriptions so callers stop misreading `prompt` as a name field.

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

@@ -226,28 +226,31 @@ describe("shared messages attachments", () => {
     ]);
   });
 
-  it("keeps known attachments and drops unknown worktree-create attachments", () => {
+  it("keeps known firstAgentContext attachments and drops unknown ones", () => {
     const parsed = CreatePaseoWorktreeRequestSchema.parse({
       type: "create_paseo_worktree_request",
       requestId: "req-3",
       cwd: "/tmp/repo",
-      attachments: [
-        {
-          type: "github_pr",
-          mimeType: "application/github-pr",
-          number: 99,
-          title: "Fork-safe PR checkout",
-          url: "https://github.com/getpaseo/paseo/pull/99",
-        },
-        {
-          type: "future_attachment",
-          mimeType: "application/future",
-          foo: "bar",
-        },
-      ],
+      firstAgentContext: {
+        prompt: "Investigate flaky test",
+        attachments: [
+          {
+            type: "github_pr",
+            mimeType: "application/github-pr",
+            number: 99,
+            title: "Fork-safe PR checkout",
+            url: "https://github.com/getpaseo/paseo/pull/99",
+          },
+          {
+            type: "future_attachment",
+            mimeType: "application/future",
+            foo: "bar",
+          },
+        ],
+      },
     });
 
-    expect(parsed.attachments).toEqual([
+    expect(parsed.firstAgentContext?.attachments).toEqual([
       {
         type: "github_pr",
         mimeType: "application/github-pr",
@@ -256,21 +259,20 @@ describe("shared messages attachments", () => {
         url: "https://github.com/getpaseo/paseo/pull/99",
       },
     ]);
+    expect(parsed.firstAgentContext?.prompt).toBe("Investigate flaky test");
   });
 
-  it("parses old-shape create-worktree payloads without the new intent fields", () => {
+  it("parses worktree-create payloads without a firstAgentContext", () => {
     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: [],
     });
   });
 
@@ -279,7 +281,6 @@ describe("shared messages attachments", () => {
       type: "create_paseo_worktree_request",
       requestId: "req-5",
       cwd: "/tmp/repo",
-      attachments: [],
       action: "checkout",
       refName: "feature/ref-picker",
       githubPrNumber: 42,
@@ -290,7 +291,6 @@ describe("shared messages attachments", () => {
       type: "create_paseo_worktree_request",
       requestId: "req-5",
       cwd: "/tmp/repo",
-      attachments: [],
       action: "checkout",
       refName: "feature/ref-picker",
       githubPrNumber: 42,

packages/server/src/shared/messages.ts

@@ -1363,12 +1363,16 @@ export const PaseoWorktreeArchiveRequestSchema = z.object({
   requestId: z.string(),
 });
 
+export const FirstAgentContextSchema = z.object({
+  prompt: z.string().optional(),
+  attachments: AgentAttachmentsSchema,
+});
+
 export const CreatePaseoWorktreeRequestSchema = z.object({
   type: z.literal("create_paseo_worktree_request"),
   cwd: z.string(),
   worktreeSlug: z.string().optional(),
-  nameContext: z.string().optional(),
-  attachments: AgentAttachmentsSchema,
+  firstAgentContext: FirstAgentContextSchema.optional(),
   refName: z.string().min(1).optional(),
   action: z.enum(["branch-off", "checkout"]).optional(),
   githubPrNumber: z.number().int().positive().optional(),
@@ -3484,6 +3488,7 @@ export type DictationStreamFinishMessage = z.infer<typeof DictationStreamFinishM
 export type DictationStreamCancelMessage = z.infer<typeof DictationStreamCancelMessageSchema>;
 export type CreateAgentRequestMessage = z.infer<typeof CreateAgentRequestMessageSchema>;
 export type AgentAttachment = z.infer<typeof AgentAttachmentSchema>;
+export type FirstAgentContext = z.infer<typeof FirstAgentContextSchema>;
 export type ReviewAttachment = z.infer<typeof ReviewAttachmentSchema>;
 export type ListProviderModelsRequestMessage = z.infer<
   typeof ListProviderModelsRequestMessageSchema