fix: connect URL mismatch and paperclip connector crash on missing context

Found by fresh-agent zero-to-company test:

Bug 1: `af paperclip connect` set adapter URL to /heartbeat but gateway
serves /webhook/paperclip. Fixed default bridge URL.

Bug 2: Paperclip connector crashed when payload.context was undefined
(e.g. from wakeup with no issue assignment). Now handles missing/partial
context gracefully.

Both bugs prevented the primary flow (deploy → connect → wakeup → work)
from working end-to-end. Now verified working.

Author: seanphan

packages/cli/src/cli/gateway/connectors/paperclip.ts

@@ -25,12 +25,12 @@ export class PaperclipConnector implements ChannelConnector {
     body: string,
   ): Promise<InboundTask | null> {
     const payload = JSON.parse(body) as {
-      agentId: string;
-      runId: string;
-      context: Record<string, unknown>;
+      agentId?: string;
+      runId?: string;
+      context?: Record<string, unknown>;
     };
 
-    if (!payload.agentId) throw new Error("Missing agentId");
+    if (!payload.agentId) throw new Error("Missing agentId in payload");
 
     // Look up AF agent ID from Paperclip agent metadata
     const pcAgent = await this.pc.getAgent(payload.agentId);
@@ -42,9 +42,9 @@ export class PaperclipConnector implements ChannelConnector {
       throw new Error(`Agent ${payload.agentId} has no af_agent_id. Deploy via "af paperclip deploy" first.`);
     }
 
-    // Build message from Paperclip context — just pass the task info
-    const ctx = payload.context;
-    const issueId = (ctx.issueId ?? ctx.taskId) as string | undefined;
+    // Build message from Paperclip context — handle missing/partial context
+    const ctx = payload.context ?? {};
+    const issueId = (ctx.issueId ?? ctx.taskId ?? ctx.taskKey) as string | undefined;
     const parts: string[] = [];
 
     if (ctx.wakeReason) parts.push(`Reason: ${ctx.wakeReason}`);

packages/cli/src/cli/main.ts

@@ -4919,7 +4919,7 @@ export function createProgram(): Command {
   pcOpts.both(paperclipCmd
     .command("connect")
     .description("Update all AF-deployed agents to route through the bridge webhook."))
-    .option("--bridge-url <url>", "Bridge URL", "http://localhost:4100/heartbeat")
+    .option("--bridge-url <url>", "Gateway webhook URL", "http://localhost:4100/webhook/paperclip")
     .action(async (opts: Record<string, string>) => {
       const { pc, companyId } = await pcContext(opts);
       const agents = await pc.listAgents(companyId);