feat(api): add UserInputMetadata type to 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-0e20f536f7f833dd7205eaadd72826bd527a3ed91fcb006323e3232550abb04e.yml
-openapi_spec_hash: 7a96aca1a75735a1664edd091b277940
-config_hash: 25c7c72de891ed240ee62c4fb9a99756
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-ac173b64bb40160fa60a528c250b18b70b60676d8d639d22065a430a40e6406a.yml
+openapi_spec_hash: 10763c4df593dae81fe9729e8a6ff799
+config_hash: d579aac01b686dadf777791467e135dd

api.md

@@ -68,6 +68,7 @@ Types:
 - <code><a href="./src/resources/agents.ts">Role</a></code>
 - <code><a href="./src/resources/agents.ts">Type</a></code>
 - <code><a href="./src/resources/agents.ts">UserInputBlock</a></code>
+- <code><a href="./src/resources/agents.ts">UserInputMetadata</a></code>
 - <code><a href="./src/resources/agents.ts">WakeEvent</a></code>
 - <code><a href="./src/resources/agents.ts">AgentCreateExecutionConversationTokenResponse</a></code>
 - <code><a href="./src/resources/agents.ts">AgentCreatePromptResponse</a></code>

src/client.ts

@@ -154,6 +154,7 @@ import {
   Role,
   Type,
   UserInputBlock,
+  UserInputMetadata,
   WakeEvent,
 } from './resources/agents';
 import {
@@ -1411,6 +1412,7 @@ export declare namespace Gitpod {
     type Role as Role,
     type Type as Type,
     type UserInputBlock as UserInputBlock,
+    type UserInputMetadata as UserInputMetadata,
     type WakeEvent as WakeEvent,
     type AgentCreateExecutionConversationTokenResponse as AgentCreateExecutionConversationTokenResponse,
     type AgentCreatePromptResponse as AgentCreatePromptResponse,

src/resources/agents.ts

@@ -1321,6 +1321,22 @@ export namespace UserInputBlock {
   }
 }
 
+/**
+ * UserInputMetadata carries integration-specific context for a user input.
+ * Internal only — not exposed in public SDKs. External API consumers should not
+ * set these fields; they are populated by integration handlers.
+ */
+export interface UserInputMetadata {
+  /**
+   * Origin of this input — set by integration handlers to their host (e.g.
+   * "github.com", "slack.com"). Empty for non-integration callers. This field drives
+   * emission gating: when set, agent responses are only emitted to the matching
+   * integration. Treated as trusted input from integration handlers; not validated
+   * against registered hosts.
+   */
+  source?: string;
+}
+
 /**
  * WakeEvent is sent by the backend to wake an agent when a registered interest
  * fires. Delivered via SendToAgentExecution as a new oneof variant.
@@ -1697,6 +1713,7 @@ export declare namespace Agents {
     type Role as Role,
     type Type as Type,
     type UserInputBlock as UserInputBlock,
+    type UserInputMetadata as UserInputMetadata,
     type WakeEvent as WakeEvent,
     type AgentCreateExecutionConversationTokenResponse as AgentCreateExecutionConversationTokenResponse,
     type AgentCreatePromptResponse as AgentCreatePromptResponse,

src/resources/index.ts

@@ -33,6 +33,7 @@ export {
   type Role,
   type Type,
   type UserInputBlock,
+  type UserInputMetadata,
   type WakeEvent,
   type AgentCreateExecutionConversationTokenResponse,
   type AgentCreatePromptResponse,