docs(api): update annotations parameter examples in agents

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 193
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-81e6dd362ed000dd15cc51a77545a0772d791241380906229b5ba6f2ba265bcb.yml
-openapi_spec_hash: 9adc025d621dcefde671682cdd711ec0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-eb2a06fb4bcfb9dc85e08216cdaad259453be5d03dd6cdd0562e147d33a8ff31.yml
+openapi_spec_hash: 0d278e84539c7e554d6218666aa3bf41
 config_hash: 1e3edbeecb529f712bfaac1b561d91d5

src/gitpod/resources/agents.py

@@ -581,9 +581,9 @@ def start_execution(
           ```
 
         Args:
-          annotations: annotations are key-value pairs for tracking external context (e.g., Linear
+          annotations: annotations are key-value pairs for tracking external context (e.g., integration
               session IDs, GitHub issue references). Keys should follow domain/name convention
-              (e.g., "linear.app/session-id").
+              (e.g., "agent-client-session/id").
 
           mode: mode specifies the operational mode for this agent execution If not specified,
               defaults to AGENT_MODE_EXECUTION
@@ -1262,9 +1262,9 @@ async def start_execution(
           ```
 
         Args:
-          annotations: annotations are key-value pairs for tracking external context (e.g., Linear
+          annotations: annotations are key-value pairs for tracking external context (e.g., integration
               session IDs, GitHub issue references). Keys should follow domain/name convention
-              (e.g., "linear.app/session-id").
+              (e.g., "agent-client-session/id").
 
           mode: mode specifies the operational mode for this agent execution If not specified,
               defaults to AGENT_MODE_EXECUTION

src/gitpod/types/agent_start_execution_params.py

@@ -17,9 +17,9 @@ class AgentStartExecutionParams(TypedDict, total=False):
 
     annotations: Dict[str, str]
     """
-    annotations are key-value pairs for tracking external context (e.g., Linear
+    annotations are key-value pairs for tracking external context (e.g., integration
     session IDs, GitHub issue references). Keys should follow domain/name convention
-    (e.g., "linear.app/session-id").
+    (e.g., "agent-client-session/id").
     """
 
     code_context: Annotated[AgentCodeContextParam, PropertyInfo(alias="codeContext")]