@cadenya/cadenya 1.4.0 → 1.6.0

package/dist/types.d.ts

@@ -243,12 +243,25 @@ export interface AccountSpec {
     workspaces: Array<Workspace>;
 }
 /**
- * Attach a single tool, tool set, or sub-agent to a variation. Exactly one
+ * Activate an inactive pool.
+ */
+export interface ActivateAgentPoolRequest {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * AgentPool ID. Accepts the canonical `apool_…` form or the `external_id:<value>` form.
+     */
+    id?: string;
+}
+/**
+ * Attach a single tool, tool set, sub-agent, or agent pool to a variation. Exactly one
  *  of the target fields must be set; the assignment kind is inferred from the
  *  populated field. Adding an existing target returns AlreadyExists.
  *  All targets must be in the variation's workspace and eligible for assignment.
  */
-export type AddAgentVariationAssignmentRequest = AddAgentVariationAssignmentRequest_ToolId | AddAgentVariationAssignmentRequest_ToolSetId | AddAgentVariationAssignmentRequest_SubAgentId;
+export type AddAgentVariationAssignmentRequest = AddAgentVariationAssignmentRequest_ToolId | AddAgentVariationAssignmentRequest_ToolSetId | AddAgentVariationAssignmentRequest_SubAgentId | AddAgentVariationAssignmentRequest_AgentPoolId;
 /**
  * Attach a memory layer to a variation. Use UpdateAgentVariationMemoryLayer or
  *  replace the spec list to reposition an existing layer. Rejected when:
@@ -337,6 +350,97 @@ export interface AgentInfo {
     variationCount: number;
     createdBy?: Profile;
 }
+/**
+ * Output only. Pools are created INACTIVE. Use :activate, :deactivate,
+ *  :archive, and :unarchive to transition states. Unarchive returns INACTIVE.
+ */
+export type AgentPoolState = 'AGENT_POOL_STATE_UNSPECIFIED' | 'AGENT_POOL_STATE_ACTIVE' | 'AGENT_POOL_STATE_INACTIVE' | 'AGENT_POOL_STATE_ARCHIVED';
+/**
+ * A workspace-scoped group of agents. When assigned to a variation, the pool
+ *  exposes one callable target that routes a request to a member agent.
+ *  Pool membership references agents; variation assignments reference the pool.
+ */
+export interface AgentPool {
+    metadata: ResourceMetadata;
+    spec: AgentPoolSpec;
+    info?: AgentPoolInfo;
+    /**
+     * Output only. Pools are created INACTIVE. Use :activate, :deactivate,
+     *  :archive, and :unarchive to transition states. Unarchive returns INACTIVE.
+     */
+    state: AgentPoolState;
+}
+/**
+ * A member of a pool, identified by its agent ID. This is distinct from a
+ *  VariationAssignment, which attaches the entire pool to a variation.
+ */
+export interface AgentPoolAssignment {
+    /**
+     * Canonical ID of an agent in the pool's workspace.
+     */
+    agentId: string;
+}
+/**
+ * AgentPoolInfo represents the information of an agent pool.
+ */
+export interface AgentPoolInfo {
+    /**
+     * Number of member agents in spec.assignments.
+     */
+    assignedAgents: number;
+    createdBy: Profile;
+}
+/**
+ * AgentPoolSpec describes the pool's purpose, membership, input schema, and routing instructions.
+ */
+export interface AgentPoolSpec {
+    /**
+     * Describes when a calling agent should use this pool.
+     */
+    description: string;
+    /**
+     * JSON Schema defining the input arguments for this pool's callable tool.
+     *  When the pool is assigned to an agent variation, this schema tells the LLM
+     *  what arguments to supply. The supplied arguments provide the context used
+     *  to route the request to an agent in the pool.
+     */
+    state?: Record<string, unknown>;
+    /**
+     * Complete set of member agents, all in the pool's workspace. At least one
+     *  member is required. Order has no meaning; duplicate agent IDs are invalid.
+     */
+    assignments: Array<AgentPoolAssignment>;
+    /**
+     * Instructions for routing requests to an agent in the pool.
+     *  If empty, defaults to "Which agent is best suited to handle this request?".
+     */
+    instructions?: string;
+}
+/**
+ * Partial input for UpdateAgentPool. The server applies update_mask, then
+ *  validates the resulting AgentPoolSpec before persisting any changes.
+ */
+export interface AgentPoolUpdateSpec {
+    /**
+     * Omit to leave unchanged, unless the mask selects this field or all of spec.
+     */
+    description?: string;
+    /**
+     * JSON Schema for the pool's callable input arguments. Update through
+     *  spec.state in the update mask.
+     */
+    state?: Record<string, unknown>;
+    /**
+     * Replacement membership. A selected empty list is invalid because a pool
+     *  must retain at least one member. Unselected fields remain unchanged.
+     */
+    assignments?: Array<AgentPoolAssignment>;
+    /**
+     * Routing instructions to update through spec.instructions in the update
+     *  mask. Selecting this field with an empty value restores the default question.
+     */
+    instructions?: string;
+}
 /**
  * The current lifecycle state of the schedule. Output only. Schedules are
  *  created STATE_ACTIVE; use the :pause, :resume, and :archive actions to
@@ -553,23 +657,27 @@ export interface AgentVariationInfo {
     /**
      * Number of distinct callable tools available through this variation's
      *  assignments after normalization. Expands tool sets and deduplicates tools
-     *  also assigned directly. Each sub-agent contributes one callable tool;
-     *  its own assignments are not expanded. Counts the full normalized set,
-     *  regardless of which tools progressive discovery has loaded.
+     *  also assigned directly. Each sub-agent or pool contributes one callable
+     *  tool; sub-agent assignments and pool members are not expanded. Counts the
+     *  full normalized set, regardless of which tools progressive discovery has loaded.
      */
     effectiveToolCount: number;
     /**
      * Current display metadata for targets explicitly referenced by
      *  spec.assignments and spec.memory_layer_assignments, keyed by canonical
-     *  resource ID. Includes tools, tool sets, sub-agents, and memory layers in
-     *  one map; each value's id equals its key. Does not expand tools within
-     *  assigned tool sets or assignments within sub-agents.
+     *  resource ID. Includes tools, tool sets, sub-agents, agent pools,
+     *  and memory layers in one map; each value's id equals its key. Does not expand
+     *  tools within assigned tool sets, assignments within sub-agents, or pool members.
      *  Populated whenever info is returned; empty when there are no assignments.
      *  Missing or inaccessible targets are omitted, and names may be absent.
      *  Clients use spec for assignment type/order and fall back to the ID when
      *  display metadata is unavailable. This map never accepts assignment writes.
      */
     assignmentMetadata: Record<string, BareMetadata>;
+    /**
+     * Number of agent pools assigned to this variation.
+     */
+    agentPoolCount: number;
 }
 /**
  * AgentVariationSpec defines the complete operational configuration for a
@@ -589,7 +697,7 @@ export interface AgentVariationSpec {
      * ProgressiveDiscovery is an optional config that, when set, will load a Cadenya provided tool that
      *  can search for tools in the assigned tool sets or tools.
      *
-     *  Note: Sub-agents are always loaded as a tool regardless of this value.
+     *  Note: Sub-agents and agent pools are always loaded as tools regardless of this value.
      */
     progressiveDiscovery?: AgentVariationSpec_ProgressiveDiscovery;
     /**
@@ -619,7 +727,7 @@ export interface AgentVariationSpec {
      */
     firstUserMessageTemplate?: string;
     /**
-     * Complete set of assigned tools, tool sets, and sub-agents. Order has no
+     * Complete set of assigned tools, tool sets, sub-agents, and agent pools. Order has no
      *  meaning. Duplicate (target kind, canonical target ID) pairs are collapsed.
      *  On create, omitted or empty means no assignments. On update, selecting
      *  spec.assignments in update_mask replaces the entire set; empty clears it.
@@ -764,6 +872,19 @@ export interface ApproveToolCallRequest {
      */
     toolCallId?: string;
 }
+/**
+ * Archive an active or inactive pool, preserving membership and assignments.
+ */
+export interface ArchiveAgentPoolRequest {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * AgentPool ID. Accepts the canonical `apool_…` form or the `external_id:<value>` form.
+     */
+    id?: string;
+}
 /**
  * Archive agent request
  */
@@ -858,7 +979,7 @@ export interface BedrockConfig {
  * CallableTool is a union that represents a tool that can be called by an agent. In Cadenya, a tool that is used within an agent objective
  *  might be a user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context), or a Cadenya Tool (one Cadenya provides).
  */
-export type CallableTool = CallableTool_Tool | CallableTool_Agent | CallableTool_CadenyaProvidedTool;
+export type CallableTool = CallableTool_Tool | CallableTool_Agent | CallableTool_CadenyaProvidedTool | CallableTool_AgentPool;
 export interface CancelObjectiveRequest {
     workspaceId?: string;
     /**
@@ -1129,6 +1250,17 @@ export interface CreateAccountResourceMetadata {
      */
     labels?: Record<string, string>;
 }
+/**
+ * Create a pool in INACTIVE state. Validate and persist membership atomically.
+ */
+export interface CreateAgentPoolRequest {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    metadata: CreateResourceMetadata;
+    spec: AgentPoolSpec;
+}
 /**
  * Create agent request
  */
@@ -1465,6 +1597,19 @@ export interface CredentialGoogleServiceAccount {
 export interface CredentialHeaders {
     headers?: Record<string, string>;
 }
+/**
+ * Deactivate an active pool.
+ */
+export interface DeactivateAgentPoolRequest {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * AgentPool ID. Accepts the canonical `apool_…` form or the `external_id:<value>` form.
+     */
+    id?: string;
+}
 /**
  * Delete tenant widget sessions response.
  */
@@ -1579,6 +1724,13 @@ export interface ListAgentFeedbackResponse {
     items: Array<ObjectiveFeedback>;
     pagination?: Page;
 }
+/**
+ * List agent pools response
+ */
+export interface ListAgentPoolsResponse {
+    items: Array<AgentPool>;
+    pagination?: Page;
+}
 /**
  * List agent schedules response.
  */
@@ -2899,7 +3051,7 @@ export interface Reasoning {
  * Detach a target by its foreign key. Removing an unassigned target returns
  *  NotFound. The parent variation must exist and be accessible.
  */
-export type RemoveAgentVariationAssignmentRequest = RemoveAgentVariationAssignmentRequest_ToolId | RemoveAgentVariationAssignmentRequest_ToolSetId | RemoveAgentVariationAssignmentRequest_SubAgentId;
+export type RemoveAgentVariationAssignmentRequest = RemoveAgentVariationAssignmentRequest_ToolId | RemoveAgentVariationAssignmentRequest_ToolSetId | RemoveAgentVariationAssignmentRequest_SubAgentId | RemoveAgentVariationAssignmentRequest_AgentPoolId;
 /**
  * Remove by memory layer ID. An unassigned layer returns NotFound.
  *  The parent variation must still exist and be accessible.
@@ -3220,6 +3372,7 @@ export interface SetToolCallContentRequest_ImageBlock {
 export interface SetToolCallContentRequest_TextBlock {
     text: string;
 }
+export type StatusDetails = WidgetSessionErrorInfo | GoogleProtobufAny;
 /**
  * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
  */
@@ -3235,7 +3388,7 @@ export interface Status {
     /**
      * A list of messages that carry the error details.  There is a common set of message types for APIs to use.
      */
-    details?: Array<GoogleProtobufAny>;
+    details?: Array<StatusDetails>;
 }
 export interface SubAgentSpawned {
     agent: ResourceMetadata;
@@ -3965,6 +4118,19 @@ export interface ToolSpec {
  *  If the tool is an inline tool, the adapter will be Inline.
  */
 export type ToolSpec_Config = ToolSpec_Config_Http | ToolSpec_Config_Mcp | ToolSpec_Config_Openapi | ToolSpec_Config_Bare;
+/**
+ * Restore an archived pool to INACTIVE; activate it separately to route requests.
+ */
+export interface UnarchiveAgentPoolRequest {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * AgentPool ID. Accepts the canonical `apool_…` form or the `external_id:<value>` form.
+     */
+    id?: string;
+}
 /**
  * Unarchive agent request
  */
@@ -4078,6 +4244,31 @@ export interface UpdateAccountResourceMetadata {
      */
     labels?: Record<string, string>;
 }
+/**
+ * Update agent pool request
+ */
+export interface UpdateAgentPoolRequest {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * AgentPool ID. Accepts the canonical `apool_…` form or the `external_id:<value>` form.
+     */
+    id?: string;
+    metadata?: UpdateResourceMetadata;
+    spec?: AgentPoolUpdateSpec;
+    /**
+     * Fields to update. Only metadata and spec are mutable; top-level state and info
+     *  paths are invalid. spec.assignments replaces the entire membership list.
+     *  A spec mask replaces the full spec; * replaces all mutable fields.
+     *  Without a mask, infer paths from non-empty fields. Empty or omitted
+     *  membership then leaves the existing list unchanged. Element/index paths
+     *  are invalid. Validate the merged pool atomically: an empty description
+     *  or membership (including an explicitly masked empty list) is invalid.
+     */
+    updateMask?: string;
+}
 /**
  * Update agent request
  */
@@ -4417,11 +4608,11 @@ export interface UserMessage {
     content: string;
 }
 /**
- * A tool, tool set, or sub-agent assigned to a variation, identified only by
+ * A tool, tool set, sub-agent, or agent pool assigned to a variation, identified only by
  *  the target resource ID. The same shape is accepted in a spec and returned
  *  on reads. Assignment junction records are an internal implementation detail.
  */
-export type VariationAssignment = VariationAssignment_ToolId | VariationAssignment_ToolSetId | VariationAssignment_SubAgentId;
+export type VariationAssignment = VariationAssignment_ToolId | VariationAssignment_ToolSetId | VariationAssignment_SubAgentId | VariationAssignment_AgentPoolId;
 /**
  * A whole memory layer in a variation's baseline memory cascade. Identified
  *  by the memory layer ID; no assignment junction ID is exposed. Entry pinning
@@ -4550,8 +4741,9 @@ export type WidgetSessionState = 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_E
  *  a widget, minted server-to-server by the customer's backend. The session
  *  carries all customer-asserted context — tenant, subject, labels, secrets —
  *  and every conversation (objective) created through the widget inherits it.
- *  The bearer token returned at mint is short-lived and refreshed at the
- *  widget host; the session row is what makes revocation possible.
+ *  The browser renews short-lived bearer tokens at the widget host with
+ *  RenewWidgetSession, authenticated by its existing token. Renewal preserves
+ *  this bounded grant and does not extend its hard expiry.
  */
 export interface WidgetSession {
     metadata: OperationMetadata;
@@ -4568,6 +4760,44 @@ export interface WidgetSession {
      *  headers server-side — never returned by any API.
      */
     secrets: Array<WidgetSession_Secret>;
+    /**
+     * Present only on creation. The same envelope is returned by
+     *  RenewWidgetSession on the widget host. Omitted on reads, lists, and revocation.
+     *  Existing spec.token/spec.token_expires_at and info.host remain populated
+     *  on creation for v1 compatibility and agree with these credentials.
+     */
+    credentials?: WidgetSessionCredentials;
+}
+/**
+ * WidgetSessionCredentials is the only credential envelope the customer's
+ *  backend forwards to the browser. Never log or persist its token. Responses
+ *  containing credentials use Cache-Control: no-store. Both initial and later
+ *  issuance use the same schema; no refresh token or management key is included.
+ */
+export interface WidgetSessionCredentials {
+    /**
+     * Canonical wsess_ identifier. Ordinary renewal cannot change the session.
+     */
+    sessionId: string;
+    /**
+     * Authoritative hostname, without a scheme or path. Use HTTPS with this
+     *  host; never construct it or accept a host change during renewal.
+     */
+    host: string;
+    /**
+     * Short-lived bearer credential for the widget host only.
+     */
+    token: string;
+    /**
+     * Exact token expiry, at most 15 minutes after issuance and never later
+     *  than session_expires_at. Equals JWT exp without the 60-second validation
+     *  tolerance added. Renew proactively before this timestamp.
+     */
+    tokenExpiresAt: string;
+    /**
+     * Immutable hard session expiry. Issuance never extends this deadline.
+     */
+    sessionExpiresAt: string;
 }
 /**
  * WidgetSessionInfo provides read-only server-derived data about a session.
@@ -4603,7 +4833,7 @@ export interface WidgetSessionInfo {
     messageCount: number;
     /**
      * When the session last created a conversation, sent a message, or
-     *  refreshed a token.
+     *  received a newly issued token.
      */
     lastActiveAt?: string;
 }
@@ -4617,18 +4847,19 @@ export interface WidgetSessionSpec {
      */
     widgetId: string;
     /**
-     * Optional tenant assertion — the customer's org/company identifier for the
-     *  visitor. Upserts the tenant record in the workspace and tags the session
-     *  and every conversation it creates. Conversation listing at the widget
-     *  host is scoped to this tenant.
+     * Required tenant assertion — the customer's organization identifier.
+     *  Upserts the tenant record in the workspace. Every conversation created
+     *  through this session inherits the tenant and subject identity.
      */
-    tenant?: TenantAssertion;
+    tenant: TenantAssertion;
     /**
-     * Optional subject assertion — the visitor within the tenant (e.g. their
-     *  user id in the customer's namespace). Requires `tenant`; a subject
-     *  asserted without a tenant is rejected with InvalidArgument.
+     * Required subject assertion — the visitor's ID within the tenant.
+     *  Sessions with the same tenant and subject share conversation history on
+     *  the same widget and agent, subject to the current session's permissions.
+     *  A static ID deliberately shares that history; use a distinct ID per
+     *  visitor when their conversations should be separate.
      */
-    subject?: SubjectAssertion;
+    subject: SubjectAssertion;
     /**
      * Hard session expiry. Tokens never outlive it; after it passes the session
      *  transitions to STATE_EXPIRED. Defaults to a server-chosen horizon when
@@ -4636,14 +4867,14 @@ export interface WidgetSessionSpec {
      */
     expiresAt?: string;
     /**
-     * The session bearer token. Returned only on creation — subsequent reads
-     *  omit it. The token is short-lived; the widget refreshes it at the widget
-     *  host without involving the customer's backend.
+     * Legacy creation-only alias of credentials.token; omitted on reads.
+     *  Supported throughout v1. New clients should consume credentials.
+     *  The browser obtains replacements with RenewWidgetSession at the widget host.
      */
     token: string;
     /**
-     * Expiry of the token returned in `token`. Distinct from `expires_at`,
-     *  which bounds the session itself.
+     * Legacy creation-only alias of credentials.token_expires_at, supported
+     *  throughout v1. Distinct from expires_at, which bounds the session itself.
      */
     tokenExpiresAt?: string;
     /**
@@ -4805,6 +5036,13 @@ export interface VariationAssignment_SubAgentId {
      */
     subAgentId: string;
 }
+export interface VariationAssignment_AgentPoolId {
+    type: 'agentPoolId';
+    /**
+     * Canonical agent pool ID. Attaches the pool as a single callable target.
+     */
+    agentPoolId: string;
+}
 export interface ObjectiveToolCallResult_ContentBlock_Text {
     type: 'text';
     text: ObjectiveToolCallResult_TextBlock;
@@ -5102,6 +5340,13 @@ export interface CallableTool_CadenyaProvidedTool {
     type: 'cadenyaProvidedTool';
     cadenyaProvidedTool: ResourceMetadata;
 }
+export interface CallableTool_AgentPool {
+    type: 'agentPool';
+    /**
+     * Agent pool responsible for routing this call to a member agent.
+     */
+    agentPool: ResourceMetadata;
+}
 export interface MemoryEntryCreateSpec_Content {
     type: 'content';
     /**
@@ -5189,6 +5434,25 @@ export interface AddAgentVariationAssignmentRequest_SubAgentId {
      */
     variationId?: string;
 }
+export interface AddAgentVariationAssignmentRequest_AgentPoolId {
+    type: 'agentPoolId';
+    /**
+     * Canonical agent pool ID in the variation's workspace.
+     */
+    agentPoolId: string;
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form.
+     */
+    agentId?: string;
+    /**
+     * Variation ID. Accepts the canonical `agentvar_…` form or the `external_id:<value>` form.
+     */
+    variationId?: string;
+}
 export interface RemoveAgentVariationAssignmentRequest_ToolId {
     type: 'toolId';
     toolId: string;
@@ -5237,6 +5501,25 @@ export interface RemoveAgentVariationAssignmentRequest_SubAgentId {
      */
     variationId?: string;
 }
+export interface RemoveAgentVariationAssignmentRequest_AgentPoolId {
+    type: 'agentPoolId';
+    /**
+     * Canonical agent pool ID in the variation's workspace.
+     */
+    agentPoolId: string;
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form.
+     */
+    agentId?: string;
+    /**
+     * Variation ID. Accepts the canonical `agentvar_…` form or the `external_id:<value>` form.
+     */
+    variationId?: string;
+}
 export interface AIProviderCredential_ApiKey {
     type: 'apiKey';
     /**
@@ -5317,6 +5600,23 @@ export interface ModelSpec_Capability_Caching {
     type: 'caching';
     caching: Capability_Caching;
 }
+/**
+ * TOKEN_EXPIRED identifies access-token expiry beyond the 60-second clock-skew tolerance. That token cannot renew; use already-installed newer credentials or require explicit app reauthentication. SESSION_* reasons are terminal. Never infer renewability from HTTP status alone.
+ */
+export type WidgetSessionErrorReason = 'TOKEN_EXPIRED' | 'SESSION_REVOKED' | 'SESSION_EXPIRED' | 'SESSION_EXHAUSTED';
+/**
+ * google.rpc.ErrorInfo detail for widget lifecycle failures. Match both domain and reason; ignore unknown reasons rather than renewing automatically.
+ */
+export interface WidgetSessionErrorInfo {
+    '@type': 'type.googleapis.com/google.rpc.ErrorInfo';
+    domain: 'api.cadenya.com';
+    reason: WidgetSessionErrorReason;
+    /**
+     * Optional non-sensitive context. Never contains tokens or secrets.
+     */
+    metadata?: Record<string, string>;
+}
+export type AgentPoolServiceListAgentPoolsState = 'AGENT_POOL_STATE_UNSPECIFIED' | 'AGENT_POOL_STATE_ACTIVE' | 'AGENT_POOL_STATE_INACTIVE' | 'AGENT_POOL_STATE_ARCHIVED';
 export type AgentServiceListAgentsState = 'STATE_UNSPECIFIED' | 'STATE_DRAFT' | 'STATE_PUBLISHED' | 'STATE_ARCHIVED';
 export type AgentServiceListAgentsVariationSelectionMode = 'VARIATION_SELECTION_MODE_UNSPECIFIED' | 'VARIATION_SELECTION_MODE_RANDOM' | 'VARIATION_SELECTION_MODE_WEIGHTED';
 export type AgentServiceListAgentFeedbackSentiment = 'FEEDBACK_SENTIMENT_UNSPECIFIED' | 'FEEDBACK_SENTIMENT_POSITIVE' | 'FEEDBACK_SENTIMENT_NEGATIVE';
@@ -5350,7 +5650,7 @@ export interface APIKeySpecParam {
      */
     permissions?: Array<string>;
 }
-export type AddAgentVariationAssignmentRequestParam = AddAgentVariationAssignmentRequest_ToolIdParam | AddAgentVariationAssignmentRequest_ToolSetIdParam | AddAgentVariationAssignmentRequest_SubAgentIdParam;
+export type AddAgentVariationAssignmentRequestParam = AddAgentVariationAssignmentRequest_ToolIdParam | AddAgentVariationAssignmentRequest_ToolSetIdParam | AddAgentVariationAssignmentRequest_SubAgentIdParam | AddAgentVariationAssignmentRequest_AgentPoolIdParam;
 export interface CreateAgentVariationRequestParam {
     metadata: CreateResourceMetadata;
     spec: AgentVariationSpec;
@@ -5370,7 +5670,7 @@ export interface ObjectiveEpisodicConfigParam {
      */
     key: string;
 }
-export type RemoveAgentVariationAssignmentRequestParam = RemoveAgentVariationAssignmentRequest_ToolIdParam | RemoveAgentVariationAssignmentRequest_ToolSetIdParam | RemoveAgentVariationAssignmentRequest_SubAgentIdParam;
+export type RemoveAgentVariationAssignmentRequestParam = RemoveAgentVariationAssignmentRequest_ToolIdParam | RemoveAgentVariationAssignmentRequest_ToolSetIdParam | RemoveAgentVariationAssignmentRequest_SubAgentIdParam | RemoveAgentVariationAssignmentRequest_AgentPoolIdParam;
 export interface WidgetSessionSpecParam {
     /**
      * Widget this session is minted against. Accepts the canonical `wgt_…` form
@@ -5378,18 +5678,19 @@ export interface WidgetSessionSpecParam {
      */
     widgetId: string;
     /**
-     * Optional tenant assertion — the customer's org/company identifier for the
-     *  visitor. Upserts the tenant record in the workspace and tags the session
-     *  and every conversation it creates. Conversation listing at the widget
-     *  host is scoped to this tenant.
+     * Required tenant assertion — the customer's organization identifier.
+     *  Upserts the tenant record in the workspace. Every conversation created
+     *  through this session inherits the tenant and subject identity.
      */
-    tenant?: TenantAssertion;
+    tenant: TenantAssertion;
     /**
-     * Optional subject assertion — the visitor within the tenant (e.g. their
-     *  user id in the customer's namespace). Requires `tenant`; a subject
-     *  asserted without a tenant is rejected with InvalidArgument.
+     * Required subject assertion — the visitor's ID within the tenant.
+     *  Sessions with the same tenant and subject share conversation history on
+     *  the same widget and agent, subject to the current session's permissions.
+     *  A static ID deliberately shares that history; use a distinct ID per
+     *  visitor when their conversations should be separate.
      */
-    subject?: SubjectAssertion;
+    subject: SubjectAssertion;
     /**
      * Hard session expiry. Tokens never outlive it; after it passes the session
      *  transitions to STATE_EXPIRED. Defaults to a server-chosen horizon when
@@ -5420,6 +5721,13 @@ export interface AddAgentVariationAssignmentRequest_SubAgentIdParam {
     type: 'subAgentId';
     subAgentId: string;
 }
+export interface AddAgentVariationAssignmentRequest_AgentPoolIdParam {
+    type: 'agentPoolId';
+    /**
+     * Canonical agent pool ID in the variation's workspace.
+     */
+    agentPoolId: string;
+}
 export interface RemoveAgentVariationAssignmentRequest_ToolIdParam {
     type: 'toolId';
     toolId: string;
@@ -5432,6 +5740,13 @@ export interface RemoveAgentVariationAssignmentRequest_SubAgentIdParam {
     type: 'subAgentId';
     subAgentId: string;
 }
+export interface RemoveAgentVariationAssignmentRequest_AgentPoolIdParam {
+    type: 'agentPoolId';
+    /**
+     * Canonical agent pool ID in the variation's workspace.
+     */
+    agentPoolId: string;
+}
 export declare function wireArray<T>(value: Array<T> | null | undefined, fn: (v: T) => unknown): unknown;
 export declare function wireMap<T>(value: Record<string, T> | null | undefined, fn: (v: T) => unknown): unknown;
 export declare function wireAPIKeySpec(value: APIKeySpecParam | null | undefined): unknown;
@@ -5444,7 +5759,9 @@ export declare function wireWidgetSessionSpec(value: WidgetSessionSpecParam | nu
 export declare function wireAddAgentVariationAssignmentRequest_ToolId(value: AddAgentVariationAssignmentRequest_ToolIdParam | null | undefined): unknown;
 export declare function wireAddAgentVariationAssignmentRequest_ToolSetId(value: AddAgentVariationAssignmentRequest_ToolSetIdParam | null | undefined): unknown;
 export declare function wireAddAgentVariationAssignmentRequest_SubAgentId(value: AddAgentVariationAssignmentRequest_SubAgentIdParam | null | undefined): unknown;
+export declare function wireAddAgentVariationAssignmentRequest_AgentPoolId(value: AddAgentVariationAssignmentRequest_AgentPoolIdParam | null | undefined): unknown;
 export declare function wireRemoveAgentVariationAssignmentRequest_ToolId(value: RemoveAgentVariationAssignmentRequest_ToolIdParam | null | undefined): unknown;
 export declare function wireRemoveAgentVariationAssignmentRequest_ToolSetId(value: RemoveAgentVariationAssignmentRequest_ToolSetIdParam | null | undefined): unknown;
 export declare function wireRemoveAgentVariationAssignmentRequest_SubAgentId(value: RemoveAgentVariationAssignmentRequest_SubAgentIdParam | null | undefined): unknown;
+export declare function wireRemoveAgentVariationAssignmentRequest_AgentPoolId(value: RemoveAgentVariationAssignmentRequest_AgentPoolIdParam | null | undefined): unknown;
 //# sourceMappingURL=types.d.ts.map