[codex] Add visual draw annotation context (#1547)

* feat(web): add visual draw annotation context

* Fix visual draw annotation staging

* Fix concurrent visual annotation IDs

packages/contracts/src/api/chat.ts

@@ -3,10 +3,12 @@ import type {
   PreviewCommentMember,
   PreviewCommentPosition,
   PreviewCommentSelectionKind,
+  PreviewVisualMarkKind,
 } from './comments';
 import type { ResearchOptions } from './research';
 
 export type ChatRole = 'user' | 'assistant';
+export type ChatCommentSelectionKind = PreviewCommentSelectionKind | 'visual';
 
 export interface ChatRequest {
   agentId: string;
@@ -107,9 +109,12 @@ export interface ChatCommentAttachment {
   currentText: string;
   pagePosition: PreviewCommentPosition;
   htmlHint: string;
-  selectionKind?: PreviewCommentSelectionKind;
+  selectionKind?: ChatCommentSelectionKind;
   memberCount?: number;
   podMembers?: PreviewCommentMember[];
+  screenshotPath?: string;
+  markKind?: PreviewVisualMarkKind;
+  intent?: string;
   source?: 'saved-comment' | 'board-batch';
 }
 

packages/contracts/src/api/comments.ts

@@ -16,6 +16,7 @@ export interface PreviewCommentPosition {
 }
 
 export type PreviewCommentSelectionKind = 'element' | 'pod';
+export type PreviewVisualMarkKind = 'click' | 'stroke' | 'click+stroke';
 
 export interface PreviewCommentMember {
   elementId: string;