feat: optimize heartbeat token usage

Co-Authored-By: Paperclip <noreply@paperclip.ing>

packages/shared/src/validators/agent.ts

@@ -78,6 +78,7 @@ export const wakeAgentSchema = z.object({
   reason: z.string().optional().nullable(),
   payload: z.record(z.unknown()).optional().nullable(),
   idempotencyKey: z.string().optional().nullable(),
+  forceFreshSession: z.boolean().optional().default(false),
 });
 
 export type WakeAgent = z.infer<typeof wakeAgentSchema>;