@rightbrain/brain-api-client 0.0.1-dev.148.1322688 → 0.0.1-dev.150.56bd32f

package/api.ts

@@ -9606,6 +9606,12 @@ export interface ScheduleTriggerCreate {
      * @memberof ScheduleTriggerCreate
      */
     'target_id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof ScheduleTriggerCreate
+     */
+    'task_agent_revision_id'?: string | null;
 }
 
 
@@ -9785,6 +9791,12 @@ export interface ScheduleTriggerListItem {
      * @memberof ScheduleTriggerListItem
      */
     'target_id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof ScheduleTriggerListItem
+     */
+    'task_agent_revision_id'?: string | null;
     /**
      * 
      * @type {string}
@@ -9854,6 +9866,12 @@ export interface ScheduleTriggerResponse {
      * @memberof ScheduleTriggerResponse
      */
     'target_id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof ScheduleTriggerResponse
+     */
+    'task_agent_revision_id'?: string | null;
     /**
      * 
      * @type {string}
@@ -9983,6 +10001,12 @@ export interface ScheduleTriggerUpdate {
      * @memberof ScheduleTriggerUpdate
      */
     'expires_at'?: string | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof ScheduleTriggerUpdate
+     */
+    'task_agent_revision_id'?: string | null;
 }
 
 
@@ -10775,7 +10799,7 @@ export interface Tag {
      */
     'parent_id'?: string | null;
     /**
-     * The type of entity this tag applies to (task, task_revision, task_share, or skill)
+     * The type of entity this tag applies to (task, task_revision, task_share, skill, or task_agent_revision)
      * @type {string}
      * @memberof Tag
      */
@@ -10828,7 +10852,8 @@ export const TagEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 
 export type TagEntityTypeEnum = typeof TagEntityTypeEnum[keyof typeof TagEntityTypeEnum];
@@ -11679,94 +11704,16 @@ export interface TaskAgentRead {
     'name': string;
     /**
      * 
-     * @type {string}
-     * @memberof TaskAgentRead
-     */
-    'description': string | null;
-    /**
-     * 
-     * @type {string}
-     * @memberof TaskAgentRead
-     */
-    'instruction': string;
-    /**
-     * 
-     * @type {TaskAgentMode}
+     * @type {TaskAgentRevisionSummary}
      * @memberof TaskAgentRead
      */
-    'mode': TaskAgentMode;
+    'active_revision'?: TaskAgentRevisionSummary;
     /**
      * 
-     * @type {string}
+     * @type {Array<TaskAgentRevisionRead>}
      * @memberof TaskAgentRead
      */
-    'llm_model_id': string | null;
-    /**
-     * 
-     * @type {LLMModel}
-     * @memberof TaskAgentRead
-     */
-    'llm_model': LLMModel;
-    /**
-     * 
-     * @type {string}
-     * @memberof TaskAgentRead
-     */
-    'fallback_llm_model_id': string | null;
-    /**
-     * 
-     * @type {LLMModel}
-     * @memberof TaskAgentRead
-     */
-    'fallback_llm_model': LLMModel;
-    /**
-     * 
-     * @type {Array<TaskAgentTaskToolRead>}
-     * @memberof TaskAgentRead
-     */
-    'task_tools'?: Array<TaskAgentTaskToolRead>;
-    /**
-     * 
-     * @type {Array<TaskAgentIntegrationRead>}
-     * @memberof TaskAgentRead
-     */
-    'integrations'?: Array<TaskAgentIntegrationRead>;
-    /**
-     * 
-     * @type {Array<TaskAgentSkillRead>}
-     * @memberof TaskAgentRead
-     */
-    'skills'?: Array<TaskAgentSkillRead>;
-    /**
-     * 
-     * @type {Array<TaskAgentMcpServerRead>}
-     * @memberof TaskAgentRead
-     */
-    'mcp_servers'?: Array<TaskAgentMcpServerRead>;
-    /**
-     * 
-     * @type {Array<TaskAgentRegisteredToolRead>}
-     * @memberof TaskAgentRead
-     */
-    'registered_tools'?: Array<TaskAgentRegisteredToolRead>;
-    /**
-     * 
-     * @type {string}
-     * @memberof TaskAgentRead
-     */
-    'memory_strategy'?: string | null;
-    /**
-     * 
-     * @type {{ [key: string]: any; }}
-     * @memberof TaskAgentRead
-     */
-    'memory_config'?: { [key: string]: any; } | null;
-    /**
-     * 
-     * @type {number}
-     * @memberof TaskAgentRead
-     */
-    'max_turns'?: number | null;
+    'revisions'?: Array<TaskAgentRevisionRead>;
     /**
      * 
      * @type {string}
@@ -11888,6 +11835,172 @@ export const TaskAgentRegisteredToolReadProvisionSourceEnum = {
 
 export type TaskAgentRegisteredToolReadProvisionSourceEnum = typeof TaskAgentRegisteredToolReadProvisionSourceEnum[keyof typeof TaskAgentRegisteredToolReadProvisionSourceEnum];
 
+/**
+ * Full TaskAgent revision read schema.
+ * @export
+ * @interface TaskAgentRevisionRead
+ */
+export interface TaskAgentRevisionRead {
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'task_agent_id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'description': string | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'instruction': string;
+    /**
+     * 
+     * @type {TaskAgentMode}
+     * @memberof TaskAgentRevisionRead
+     */
+    'mode': TaskAgentMode;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'llm_model_id': string | null;
+    /**
+     * 
+     * @type {LLMModel}
+     * @memberof TaskAgentRevisionRead
+     */
+    'llm_model'?: LLMModel;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'fallback_llm_model_id': string | null;
+    /**
+     * 
+     * @type {LLMModel}
+     * @memberof TaskAgentRevisionRead
+     */
+    'fallback_llm_model'?: LLMModel;
+    /**
+     * 
+     * @type {Array<TaskAgentTaskToolRead>}
+     * @memberof TaskAgentRevisionRead
+     */
+    'task_tools'?: Array<TaskAgentTaskToolRead>;
+    /**
+     * 
+     * @type {Array<TaskAgentIntegrationRead>}
+     * @memberof TaskAgentRevisionRead
+     */
+    'integrations'?: Array<TaskAgentIntegrationRead>;
+    /**
+     * 
+     * @type {Array<TaskAgentSkillRead>}
+     * @memberof TaskAgentRevisionRead
+     */
+    'skills'?: Array<TaskAgentSkillRead>;
+    /**
+     * 
+     * @type {Array<TaskAgentMcpServerRead>}
+     * @memberof TaskAgentRevisionRead
+     */
+    'mcp_servers'?: Array<TaskAgentMcpServerRead>;
+    /**
+     * 
+     * @type {Array<TaskAgentRegisteredToolRead>}
+     * @memberof TaskAgentRevisionRead
+     */
+    'registered_tools'?: Array<TaskAgentRegisteredToolRead>;
+    /**
+     * 
+     * @type {Array<Tag>}
+     * @memberof TaskAgentRevisionRead
+     */
+    'tags'?: Array<Tag>;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'memory_strategy'?: string | null;
+    /**
+     * 
+     * @type {{ [key: string]: any; }}
+     * @memberof TaskAgentRevisionRead
+     */
+    'memory_config'?: { [key: string]: any; } | null;
+    /**
+     * 
+     * @type {number}
+     * @memberof TaskAgentRevisionRead
+     */
+    'max_turns'?: number | null;
+    /**
+     * 
+     * @type {boolean}
+     * @memberof TaskAgentRevisionRead
+     */
+    'active'?: boolean;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'created': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionRead
+     */
+    'modified'?: string | null;
+}
+
+
+/**
+ * Summary of the active TaskAgent revision.
+ * @export
+ * @interface TaskAgentRevisionSummary
+ */
+export interface TaskAgentRevisionSummary {
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionSummary
+     */
+    'id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionSummary
+     */
+    'task_agent_id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionSummary
+     */
+    'created': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRevisionSummary
+     */
+    'modified'?: string | null;
+}
 /**
  * Response containing events for a TaskAgentRun.
  * @export
@@ -12012,6 +12125,12 @@ export interface TaskAgentRunRead {
      * @memberof TaskAgentRunRead
      */
     'task_agent_id': string;
+    /**
+     * 
+     * @type {string}
+     * @memberof TaskAgentRunRead
+     */
+    'task_agent_revision_id'?: string | null;
     /**
      * ADK session ID (string format).
      * @type {string}
@@ -12394,6 +12513,12 @@ export interface TaskAgentTaskToolInput {
      * @memberof TaskAgentTaskToolInput
      */
     'task_id': string;
+    /**
+     * Optional pinned TaskRevision. When omitted, the current active TaskRevision is resolved and pinned at write time.
+     * @type {string}
+     * @memberof TaskAgentTaskToolInput
+     */
+    'task_revision_id'?: string | null;
     /**
      * Mark this task tool as the output formatter. Only one task tool per agent can be marked.
      * @type {boolean}
@@ -12419,6 +12544,12 @@ export interface TaskAgentTaskToolRead {
      * @memberof TaskAgentTaskToolRead
      */
     'task_id': string;
+    /**
+     * Pinned TaskRevision used when executing this task tool.
+     * @type {string}
+     * @memberof TaskAgentTaskToolRead
+     */
+    'task_revision_id'?: string | null;
     /**
      * Name of the Task linked as a task tool.
      * @type {string}
@@ -12635,6 +12766,12 @@ export interface TaskAgentUpdate {
      * @memberof TaskAgentUpdate
      */
     'task_agent_run_visibility'?: TaskAgentUpdateTaskAgentRunVisibilityEnum | null;
+    /**
+     * Existing TaskAgent revision to activate. Omit to leave the active revision unchanged.
+     * @type {string}
+     * @memberof TaskAgentUpdate
+     */
+    'active_revision_id'?: string | null;
 }
 
 export const TaskAgentUpdateMemoryStrategyEnum = {
@@ -14700,6 +14837,12 @@ export interface TaskToolInvocationRead {
      * @memberof TaskToolInvocationRead
      */
     'task_id': string;
+    /**
+     * TaskRevision ID used for this invocation.
+     * @type {string}
+     * @memberof TaskToolInvocationRead
+     */
+    'task_revision_id'?: string | null;
     /**
      * 
      * @type {string}
@@ -15548,6 +15691,12 @@ export interface WebhookTriggerCreate {
      * @memberof WebhookTriggerCreate
      */
     'target_id': string;
+    /**
+     * Optional pinned TaskAgent revision for TaskAgent triggers.
+     * @type {string}
+     * @memberof WebhookTriggerCreate
+     */
+    'task_agent_revision_id'?: string | null;
 }
 
 export const WebhookTriggerCreateAuthMethodEnum = {
@@ -15812,6 +15961,12 @@ export interface WebhookTriggerListItem {
      * @memberof WebhookTriggerListItem
      */
     'target_id': string;
+    /**
+     * Optional pinned TaskAgent revision for TaskAgent triggers.
+     * @type {string}
+     * @memberof WebhookTriggerListItem
+     */
+    'task_agent_revision_id'?: string | null;
     /**
      * The type of trigger (webhook for this endpoint).
      * @type {string}
@@ -15875,6 +16030,12 @@ export interface WebhookTriggerResponse {
      * @memberof WebhookTriggerResponse
      */
     'target_id': string;
+    /**
+     * Optional pinned TaskAgent revision for TaskAgent triggers.
+     * @type {string}
+     * @memberof WebhookTriggerResponse
+     */
+    'task_agent_revision_id'?: string | null;
     /**
      * The type of trigger (webhook for this endpoint).
      * @type {string}
@@ -16022,6 +16183,12 @@ export interface WebhookTriggerUpdate {
      * @memberof WebhookTriggerUpdate
      */
     'idempotency_ttl_seconds'?: number | null;
+    /**
+     * Optional pinned TaskAgent revision for TaskAgent triggers.
+     * @type {string}
+     * @memberof WebhookTriggerUpdate
+     */
+    'task_agent_revision_id'?: string | null;
 }
 
 
@@ -16049,6 +16216,12 @@ export interface WebhookTriggerWithSecret {
      * @memberof WebhookTriggerWithSecret
      */
     'target_id': string;
+    /**
+     * Optional pinned TaskAgent revision for TaskAgent triggers.
+     * @type {string}
+     * @memberof WebhookTriggerWithSecret
+     */
+    'task_agent_revision_id'?: string | null;
     /**
      * The type of trigger (webhook for this endpoint).
      * @type {string}
@@ -37043,11 +37216,11 @@ export class SystemApi extends BaseAPI {
 export const TagsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Add a tag to multiple entities at once
+         * Add a tag to multiple supported entities at once.
          * @summary Add Tag to Entities
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagEntityAdd} tagEntityAdd 
          * @param {*} [options] Override http request option.
@@ -37099,11 +37272,11 @@ export const TagsApiAxiosParamCreator = function (configuration?: Configuration)
             };
         },
         /**
-         * Create a new tag for organizing resources.  Tags can be applied to: - Tasks and task revisions - Collections - Documents - Other resources  Tags support hierarchical organization using prefixes.
+         * Create a new tag for organizing resources.  Tags can be applied to supported entity types: - Tasks - Task revisions - Task shares - Skills - TaskAgent revisions  Tags support hierarchical organization using prefixes.
          * @summary Create Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {TagCreate} tagCreate 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -37197,11 +37370,11 @@ export const TagsApiAxiosParamCreator = function (configuration?: Configuration)
             };
         },
         /**
-         * Get tag details
+         * Get tag details for the requested entity type.
          * @summary Get Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -37247,11 +37420,11 @@ export const TagsApiAxiosParamCreator = function (configuration?: Configuration)
             };
         },
         /**
-         * List all tags in the project
+         * List all tags in the project for the requested entity type.
          * @summary List Tags
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {number | null} [pageLimit] The maximum number of items to return per page. Defaults to &#x60;100&#x60; if not specified.
          * @param {string | null} [cursor] A cursor for pagination. Use the &#x60;next_cursor&#x60; value from the previous response to get the next page of results.
          * @param {*} [options] Override http request option.
@@ -37303,11 +37476,11 @@ export const TagsApiAxiosParamCreator = function (configuration?: Configuration)
             };
         },
         /**
-         * Remove a tag from multiple entities at once
+         * Remove a tag from multiple supported entities at once.
          * @summary Remove Tag from Entities
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagEntityRemove} tagEntityRemove 
          * @param {*} [options] Override http request option.
@@ -37363,7 +37536,7 @@ export const TagsApiAxiosParamCreator = function (configuration?: Configuration)
          * @summary Update Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagUpdate} tagUpdate 
          * @param {*} [options] Override http request option.
@@ -37425,11 +37598,11 @@ export const TagsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = TagsApiAxiosParamCreator(configuration)
     return {
         /**
-         * Add a tag to multiple entities at once
+         * Add a tag to multiple supported entities at once.
          * @summary Add Tag to Entities
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagEntityAdd} tagEntityAdd 
          * @param {*} [options] Override http request option.
@@ -37442,11 +37615,11 @@ export const TagsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Create a new tag for organizing resources.  Tags can be applied to: - Tasks and task revisions - Collections - Documents - Other resources  Tags support hierarchical organization using prefixes.
+         * Create a new tag for organizing resources.  Tags can be applied to supported entity types: - Tasks - Task revisions - Task shares - Skills - TaskAgent revisions  Tags support hierarchical organization using prefixes.
          * @summary Create Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {TagCreate} tagCreate 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -37473,11 +37646,11 @@ export const TagsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Get tag details
+         * Get tag details for the requested entity type.
          * @summary Get Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -37489,11 +37662,11 @@ export const TagsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * List all tags in the project
+         * List all tags in the project for the requested entity type.
          * @summary List Tags
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {number | null} [pageLimit] The maximum number of items to return per page. Defaults to &#x60;100&#x60; if not specified.
          * @param {string | null} [cursor] A cursor for pagination. Use the &#x60;next_cursor&#x60; value from the previous response to get the next page of results.
          * @param {*} [options] Override http request option.
@@ -37506,11 +37679,11 @@ export const TagsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Remove a tag from multiple entities at once
+         * Remove a tag from multiple supported entities at once.
          * @summary Remove Tag from Entities
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagEntityRemove} tagEntityRemove 
          * @param {*} [options] Override http request option.
@@ -37527,7 +37700,7 @@ export const TagsApiFp = function(configuration?: Configuration) {
          * @summary Update Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagUpdate} tagUpdate 
          * @param {*} [options] Override http request option.
@@ -37550,11 +37723,11 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
     const localVarFp = TagsApiFp(configuration)
     return {
         /**
-         * Add a tag to multiple entities at once
+         * Add a tag to multiple supported entities at once.
          * @summary Add Tag to Entities
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagEntityAdd} tagEntityAdd 
          * @param {*} [options] Override http request option.
@@ -37564,11 +37737,11 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
             return localVarFp.addTagToEntities(orgId, projectId, entityType, tagId, tagEntityAdd, options).then((request) => request(axios, basePath));
         },
         /**
-         * Create a new tag for organizing resources.  Tags can be applied to: - Tasks and task revisions - Collections - Documents - Other resources  Tags support hierarchical organization using prefixes.
+         * Create a new tag for organizing resources.  Tags can be applied to supported entity types: - Tasks - Task revisions - Task shares - Skills - TaskAgent revisions  Tags support hierarchical organization using prefixes.
          * @summary Create Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {TagCreate} tagCreate 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -37589,11 +37762,11 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
             return localVarFp.deleteTag(orgId, projectId, tagId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Get tag details
+         * Get tag details for the requested entity type.
          * @summary Get Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -37602,11 +37775,11 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
             return localVarFp.getTag(orgId, projectId, entityType, tagId, options).then((request) => request(axios, basePath));
         },
         /**
-         * List all tags in the project
+         * List all tags in the project for the requested entity type.
          * @summary List Tags
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {number | null} [pageLimit] The maximum number of items to return per page. Defaults to &#x60;100&#x60; if not specified.
          * @param {string | null} [cursor] A cursor for pagination. Use the &#x60;next_cursor&#x60; value from the previous response to get the next page of results.
          * @param {*} [options] Override http request option.
@@ -37616,11 +37789,11 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
             return localVarFp.listTags(orgId, projectId, entityType, pageLimit, cursor, options).then((request) => request(axios, basePath));
         },
         /**
-         * Remove a tag from multiple entities at once
+         * Remove a tag from multiple supported entities at once.
          * @summary Remove Tag from Entities
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagEntityRemove} tagEntityRemove 
          * @param {*} [options] Override http request option.
@@ -37634,7 +37807,7 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
          * @summary Update Tag
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
-         * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+         * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
          * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
          * @param {TagUpdate} tagUpdate 
          * @param {*} [options] Override http request option.
@@ -37654,11 +37827,11 @@ export const TagsApiFactory = function (configuration?: Configuration, basePath?
  */
 export class TagsApi extends BaseAPI {
     /**
-     * Add a tag to multiple entities at once
+     * Add a tag to multiple supported entities at once.
      * @summary Add Tag to Entities
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
-     * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+     * @param {AddTagToEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
      * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
      * @param {TagEntityAdd} tagEntityAdd 
      * @param {*} [options] Override http request option.
@@ -37670,11 +37843,11 @@ export class TagsApi extends BaseAPI {
     }
 
     /**
-     * Create a new tag for organizing resources.  Tags can be applied to: - Tasks and task revisions - Collections - Documents - Other resources  Tags support hierarchical organization using prefixes.
+     * Create a new tag for organizing resources.  Tags can be applied to supported entity types: - Tasks - Task revisions - Task shares - Skills - TaskAgent revisions  Tags support hierarchical organization using prefixes.
      * @summary Create Tag
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
-     * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+     * @param {CreateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
      * @param {TagCreate} tagCreate 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -37699,11 +37872,11 @@ export class TagsApi extends BaseAPI {
     }
 
     /**
-     * Get tag details
+     * Get tag details for the requested entity type.
      * @summary Get Tag
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
-     * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+     * @param {GetTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
      * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -37714,11 +37887,11 @@ export class TagsApi extends BaseAPI {
     }
 
     /**
-     * List all tags in the project
+     * List all tags in the project for the requested entity type.
      * @summary List Tags
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
-     * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+     * @param {ListTagsEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
      * @param {number | null} [pageLimit] The maximum number of items to return per page. Defaults to &#x60;100&#x60; if not specified.
      * @param {string | null} [cursor] A cursor for pagination. Use the &#x60;next_cursor&#x60; value from the previous response to get the next page of results.
      * @param {*} [options] Override http request option.
@@ -37730,11 +37903,11 @@ export class TagsApi extends BaseAPI {
     }
 
     /**
-     * Remove a tag from multiple entities at once
+     * Remove a tag from multiple supported entities at once.
      * @summary Remove Tag from Entities
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
-     * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+     * @param {RemoveTagFromEntitiesEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
      * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
      * @param {TagEntityRemove} tagEntityRemove 
      * @param {*} [options] Override http request option.
@@ -37750,7 +37923,7 @@ export class TagsApi extends BaseAPI {
      * @summary Update Tag
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
-     * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, or &#x60;skill&#x60;).
+     * @param {UpdateTagEntityTypeEnum} entityType The type of entity this tag applies to (&#x60;task&#x60;, &#x60;task_revision&#x60;, &#x60;task_share&#x60;, &#x60;skill&#x60;, or &#x60;task_agent_revision&#x60;).
      * @param {string} tagId The unique identifier (UUID) of the tag to operate on.
      * @param {TagUpdate} tagUpdate 
      * @param {*} [options] Override http request option.
@@ -37769,7 +37942,8 @@ export const AddTagToEntitiesEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 export type AddTagToEntitiesEntityTypeEnum = typeof AddTagToEntitiesEntityTypeEnum[keyof typeof AddTagToEntitiesEntityTypeEnum];
 /**
@@ -37779,7 +37953,8 @@ export const CreateTagEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 export type CreateTagEntityTypeEnum = typeof CreateTagEntityTypeEnum[keyof typeof CreateTagEntityTypeEnum];
 /**
@@ -37789,7 +37964,8 @@ export const GetTagEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 export type GetTagEntityTypeEnum = typeof GetTagEntityTypeEnum[keyof typeof GetTagEntityTypeEnum];
 /**
@@ -37799,7 +37975,8 @@ export const ListTagsEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 export type ListTagsEntityTypeEnum = typeof ListTagsEntityTypeEnum[keyof typeof ListTagsEntityTypeEnum];
 /**
@@ -37809,7 +37986,8 @@ export const RemoveTagFromEntitiesEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 export type RemoveTagFromEntitiesEntityTypeEnum = typeof RemoveTagFromEntitiesEntityTypeEnum[keyof typeof RemoveTagFromEntitiesEntityTypeEnum];
 /**
@@ -37819,7 +37997,8 @@ export const UpdateTagEntityTypeEnum = {
     Task: 'task',
     TaskRevision: 'task_revision',
     TaskShare: 'task_share',
-    Skill: 'skill'
+    Skill: 'skill',
+    TaskAgentRevision: 'task_agent_revision'
 } as const;
 export type UpdateTagEntityTypeEnum = typeof UpdateTagEntityTypeEnum[keyof typeof UpdateTagEntityTypeEnum];
 
@@ -37831,7 +38010,7 @@ export type UpdateTagEntityTypeEnum = typeof UpdateTagEntityTypeEnum[keyof typeo
 export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  Configure: - System instruction (prompt) - LLM model for reasoning - Initial task tools (Tasks to add) - Optional MCP server bindings - Execution mode (agentic/sequential)
+         * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  The request creates the root Task Agent and its initial active revision. Runtime configuration such as instructions, models, and tools is stored on revisions.
          * @summary Create Task Agent
          * @param {string} orgId The organization ID
          * @param {string} projectId The project ID
@@ -37879,7 +38058,7 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Remove a Task Agent from the project.  This will: - Remove agent configuration - Delete associated task tools - Preserve run history for auditing  This action cannot be undone.
+         * Remove a Task Agent from the project.  This will: - Remove the agent and its revision configuration - Preserve run history for auditing  This action cannot be undone.
          * @summary Delete Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -38098,7 +38277,7 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Retrieve detailed information about a specific Task Agent.  Returns: - Agent configuration - Available task tools (Tasks) - LLM model details - Execution statistics
+         * Retrieve detailed information about a specific Task Agent.  Returns root Task Agent metadata with embedded immutable revisions. Runtime configuration such as instructions, models, and tools is stored on each revision.
          * @summary Get Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -38190,6 +38369,56 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
 
 
     
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Retrieve an immutable executable revision for a Task Agent.  The response includes the runtime configuration and concrete pinned attachments stored on that revision.
+         * @summary Get Task Agent Revision
+         * @param {string} orgId The organization ID
+         * @param {string} projectId The project ID
+         * @param {string} taskAgentId The task agent ID
+         * @param {string} revisionId 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getTaskAgentRevision: async (orgId: string, projectId: string, taskAgentId: string, revisionId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'orgId' is not null or undefined
+            assertParamExists('getTaskAgentRevision', 'orgId', orgId)
+            // verify required parameter 'projectId' is not null or undefined
+            assertParamExists('getTaskAgentRevision', 'projectId', projectId)
+            // verify required parameter 'taskAgentId' is not null or undefined
+            assertParamExists('getTaskAgentRevision', 'taskAgentId', taskAgentId)
+            // verify required parameter 'revisionId' is not null or undefined
+            assertParamExists('getTaskAgentRevision', 'revisionId', revisionId)
+            const localVarPath = `/org/{org_id}/project/{project_id}/task-agent/{task_agent_id}/revision/{revision_id}`
+                .replace(`{${"org_id"}}`, encodeURIComponent(String(orgId)))
+                .replace(`{${"project_id"}}`, encodeURIComponent(String(projectId)))
+                .replace(`{${"task_agent_id"}}`, encodeURIComponent(String(taskAgentId)))
+                .replace(`{${"revision_id"}}`, encodeURIComponent(String(revisionId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication HTTPBearer required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+    
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -38473,6 +38702,52 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
 
 
     
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * List immutable executable revisions for a Task Agent.  Each revision contains the runtime configuration and pinned attachments that can be executed by new runs, long-lived sessions, or pinned triggers. The active revision is marked with `active`.
+         * @summary List Task Agent Revisions
+         * @param {string} orgId The organization ID
+         * @param {string} projectId The project ID
+         * @param {string} taskAgentId The task agent ID
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        listTaskAgentRevisions: async (orgId: string, projectId: string, taskAgentId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'orgId' is not null or undefined
+            assertParamExists('listTaskAgentRevisions', 'orgId', orgId)
+            // verify required parameter 'projectId' is not null or undefined
+            assertParamExists('listTaskAgentRevisions', 'projectId', projectId)
+            // verify required parameter 'taskAgentId' is not null or undefined
+            assertParamExists('listTaskAgentRevisions', 'taskAgentId', taskAgentId)
+            const localVarPath = `/org/{org_id}/project/{project_id}/task-agent/{task_agent_id}/revision`
+                .replace(`{${"org_id"}}`, encodeURIComponent(String(orgId)))
+                .replace(`{${"project_id"}}`, encodeURIComponent(String(projectId)))
+                .replace(`{${"task_agent_id"}}`, encodeURIComponent(String(taskAgentId)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication HTTPBearer required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+
+    
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -38496,12 +38771,13 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
          * @param {string | null} [createdAfter] Filter runs created at/after this timestamp.
          * @param {string | null} [createdBefore] Filter runs created at/before this timestamp.
          * @param {number | null} [minDurationMs] Filter runs with duration greater than or equal to this value.
+         * @param {string | null} [taskAgentRevisionId] Filter by TaskAgent revision ID.
          * @param {number} [skip] 
          * @param {number} [limit] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        listTaskAgentRuns: async (orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, skip?: number, limit?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        listTaskAgentRuns: async (orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, taskAgentRevisionId?: string | null, skip?: number, limit?: number, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'orgId' is not null or undefined
             assertParamExists('listTaskAgentRuns', 'orgId', orgId)
             // verify required parameter 'projectId' is not null or undefined
@@ -38563,6 +38839,10 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
                 localVarQueryParameter['min_duration_ms'] = minDurationMs;
             }
 
+            if (taskAgentRevisionId !== undefined) {
+                localVarQueryParameter['task_agent_revision_id'] = taskAgentRevisionId;
+            }
+
             if (skip !== undefined) {
                 localVarQueryParameter['skip'] = skip;
             }
@@ -38629,7 +38909,7 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their: - Configuration details - Available task tools (Tasks) - LLM model settings - Execution mode
+         * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their root metadata and embedded revision history. Runtime configuration such as instructions, models, and tools is stored on each revision.
          * @summary List Task Agents
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -38681,15 +38961,16 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
+         * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Use `revision_id` to execute a specific TaskAgent revision. New sessions can run any revision belonging to the TaskAgent. Existing sessions remain pinned to their original revision; passing a conflicting `revision_id` is rejected.  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
          * @summary Run Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
          * @param {string} taskAgentId The specific Task Agent to reference.
+         * @param {string | null} [revisionId] Optional TaskAgent revision ID to use for execution. If omitted, new sessions use the active revision and continuations use the session\&#39;s pinned revision.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        runTaskAgent: async (orgId: string, projectId: string, taskAgentId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        runTaskAgent: async (orgId: string, projectId: string, taskAgentId: string, revisionId?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'orgId' is not null or undefined
             assertParamExists('runTaskAgent', 'orgId', orgId)
             // verify required parameter 'projectId' is not null or undefined
@@ -38715,6 +38996,10 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            if (revisionId !== undefined) {
+                localVarQueryParameter['revision_id'] = revisionId;
+            }
+
 
     
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -38936,7 +39221,7 @@ export const TaskAgentsApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Update Task Agent configuration.  Modifiable fields: - Name and description - System instruction - LLM model - Execution mode - Task tools (full replacement) - MCP servers (full replacement)  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
+         * Update Task Agent metadata, create a new revision, or activate an existing revision.  Modifiable fields: - Root metadata: name and run visibility - Revision configuration: description, instruction, LLM models, execution mode,   memory settings, task tools, MCP servers, integrations, and skills - Activation: `active_revision_id`  Updating revision configuration creates a new inactive revision. Activate it with a separate request that only includes `active_revision_id`.  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
          * @summary Update Task Agent
          * @param {string} orgId The organization ID
          * @param {string} projectId The project ID
@@ -38998,7 +39283,7 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = TaskAgentsApiAxiosParamCreator(configuration)
     return {
         /**
-         * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  Configure: - System instruction (prompt) - LLM model for reasoning - Initial task tools (Tasks to add) - Optional MCP server bindings - Execution mode (agentic/sequential)
+         * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  The request creates the root Task Agent and its initial active revision. Runtime configuration such as instructions, models, and tools is stored on revisions.
          * @summary Create Task Agent
          * @param {string} orgId The organization ID
          * @param {string} projectId The project ID
@@ -39013,7 +39298,7 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Remove a Task Agent from the project.  This will: - Remove agent configuration - Delete associated task tools - Preserve run history for auditing  This action cannot be undone.
+         * Remove a Task Agent from the project.  This will: - Remove the agent and its revision configuration - Preserve run history for auditing  This action cannot be undone.
          * @summary Delete Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -39079,7 +39364,7 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Retrieve detailed information about a specific Task Agent.  Returns: - Agent configuration - Available task tools (Tasks) - LLM model details - Execution statistics
+         * Retrieve detailed information about a specific Task Agent.  Returns root Task Agent metadata with embedded immutable revisions. Runtime configuration such as instructions, models, and tools is stored on each revision.
          * @summary Get Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -39110,6 +39395,22 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['TaskAgentsApi.getTaskAgentCreditReport']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Retrieve an immutable executable revision for a Task Agent.  The response includes the runtime configuration and concrete pinned attachments stored on that revision.
+         * @summary Get Task Agent Revision
+         * @param {string} orgId The organization ID
+         * @param {string} projectId The project ID
+         * @param {string} taskAgentId The task agent ID
+         * @param {string} revisionId 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getTaskAgentRevision(orgId: string, projectId: string, taskAgentId: string, revisionId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<TaskAgentRevisionRead>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getTaskAgentRevision(orgId, projectId, taskAgentId, revisionId, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['TaskAgentsApi.getTaskAgentRevision']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Get conversation events for a specific TaskAgentRun.  Returns the full conversation history from the ADK session including: - User messages - Agent responses - Tool calls and results - Error messages (if any)  Events are returned in chronological order.
          * @summary Get Run Events
@@ -39196,6 +39497,21 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['TaskAgentsApi.getTaskAgentUsageReport']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * List immutable executable revisions for a Task Agent.  Each revision contains the runtime configuration and pinned attachments that can be executed by new runs, long-lived sessions, or pinned triggers. The active revision is marked with `active`.
+         * @summary List Task Agent Revisions
+         * @param {string} orgId The organization ID
+         * @param {string} projectId The project ID
+         * @param {string} taskAgentId The task agent ID
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async listTaskAgentRevisions(orgId: string, projectId: string, taskAgentId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<TaskAgentRevisionRead>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listTaskAgentRevisions(orgId, projectId, taskAgentId, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['TaskAgentsApi.listTaskAgentRevisions']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * List execution runs for a Task Agent.  Returns run history with: - Input message - Token usage - Status and duration - Task tools invoked - MCP tools invoked - Phase timings for LLM and tool execution
          * @summary List Task Agent Runs
@@ -39210,13 +39526,14 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
          * @param {string | null} [createdAfter] Filter runs created at/after this timestamp.
          * @param {string | null} [createdBefore] Filter runs created at/before this timestamp.
          * @param {number | null} [minDurationMs] Filter runs with duration greater than or equal to this value.
+         * @param {string | null} [taskAgentRevisionId] Filter by TaskAgent revision ID.
          * @param {number} [skip] 
          * @param {number} [limit] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async listTaskAgentRuns(orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, skip?: number, limit?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<TaskAgentRunRead>>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.listTaskAgentRuns(orgId, projectId, taskAgentId, sessionId, isError, hadTaskToolFail, hadMcpToolFail, status, createdAfter, createdBefore, minDurationMs, skip, limit, options);
+        async listTaskAgentRuns(orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, taskAgentRevisionId?: string | null, skip?: number, limit?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<TaskAgentRunRead>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listTaskAgentRuns(orgId, projectId, taskAgentId, sessionId, isError, hadTaskToolFail, hadMcpToolFail, status, createdAfter, createdBefore, minDurationMs, taskAgentRevisionId, skip, limit, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['TaskAgentsApi.listTaskAgentRuns']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -39237,7 +39554,7 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their: - Configuration details - Available task tools (Tasks) - LLM model settings - Execution mode
+         * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their root metadata and embedded revision history. Runtime configuration such as instructions, models, and tools is stored on each revision.
          * @summary List Task Agents
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -39253,16 +39570,17 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
+         * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Use `revision_id` to execute a specific TaskAgent revision. New sessions can run any revision belonging to the TaskAgent. Existing sessions remain pinned to their original revision; passing a conflicting `revision_id` is rejected.  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
          * @summary Run Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
          * @param {string} taskAgentId The specific Task Agent to reference.
+         * @param {string | null} [revisionId] Optional TaskAgent revision ID to use for execution. If omitted, new sessions use the active revision and continuations use the session\&#39;s pinned revision.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async runTaskAgent(orgId: string, projectId: string, taskAgentId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.runTaskAgent(orgId, projectId, taskAgentId, options);
+        async runTaskAgent(orgId: string, projectId: string, taskAgentId: string, revisionId?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<any>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.runTaskAgent(orgId, projectId, taskAgentId, revisionId, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['TaskAgentsApi.runTaskAgent']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -39333,7 +39651,7 @@ export const TaskAgentsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Update Task Agent configuration.  Modifiable fields: - Name and description - System instruction - LLM model - Execution mode - Task tools (full replacement) - MCP servers (full replacement)  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
+         * Update Task Agent metadata, create a new revision, or activate an existing revision.  Modifiable fields: - Root metadata: name and run visibility - Revision configuration: description, instruction, LLM models, execution mode,   memory settings, task tools, MCP servers, integrations, and skills - Activation: `active_revision_id`  Updating revision configuration creates a new inactive revision. Activate it with a separate request that only includes `active_revision_id`.  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
          * @summary Update Task Agent
          * @param {string} orgId The organization ID
          * @param {string} projectId The project ID
@@ -39359,7 +39677,7 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
     const localVarFp = TaskAgentsApiFp(configuration)
     return {
         /**
-         * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  Configure: - System instruction (prompt) - LLM model for reasoning - Initial task tools (Tasks to add) - Optional MCP server bindings - Execution mode (agentic/sequential)
+         * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  The request creates the root Task Agent and its initial active revision. Runtime configuration such as instructions, models, and tools is stored on revisions.
          * @summary Create Task Agent
          * @param {string} orgId The organization ID
          * @param {string} projectId The project ID
@@ -39371,7 +39689,7 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
             return localVarFp.createTaskAgent(orgId, projectId, taskAgentCreate, options).then((request) => request(axios, basePath));
         },
         /**
-         * Remove a Task Agent from the project.  This will: - Remove agent configuration - Delete associated task tools - Preserve run history for auditing  This action cannot be undone.
+         * Remove a Task Agent from the project.  This will: - Remove the agent and its revision configuration - Preserve run history for auditing  This action cannot be undone.
          * @summary Delete Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -39425,7 +39743,7 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
             return localVarFp.getProjectTaskAgentUsageReport(orgId, projectId, taskAgentId, aggregation, status, options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieve detailed information about a specific Task Agent.  Returns: - Agent configuration - Available task tools (Tasks) - LLM model details - Execution statistics
+         * Retrieve detailed information about a specific Task Agent.  Returns root Task Agent metadata with embedded immutable revisions. Runtime configuration such as instructions, models, and tools is stored on each revision.
          * @summary Get Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -39450,6 +39768,19 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
         getTaskAgentCreditReport(orgId: string, projectId: string, taskAgentId: string, startDate?: string | null, endDate?: string | null, options?: any): AxiosPromise<TaskAgentCreditReport> {
             return localVarFp.getTaskAgentCreditReport(orgId, projectId, taskAgentId, startDate, endDate, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Retrieve an immutable executable revision for a Task Agent.  The response includes the runtime configuration and concrete pinned attachments stored on that revision.
+         * @summary Get Task Agent Revision
+         * @param {string} orgId The organization ID
+         * @param {string} projectId The project ID
+         * @param {string} taskAgentId The task agent ID
+         * @param {string} revisionId 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getTaskAgentRevision(orgId: string, projectId: string, taskAgentId: string, revisionId: string, options?: any): AxiosPromise<TaskAgentRevisionRead> {
+            return localVarFp.getTaskAgentRevision(orgId, projectId, taskAgentId, revisionId, options).then((request) => request(axios, basePath));
+        },
         /**
          * Get conversation events for a specific TaskAgentRun.  Returns the full conversation history from the ADK session including: - User messages - Agent responses - Tool calls and results - Error messages (if any)  Events are returned in chronological order.
          * @summary Get Run Events
@@ -39521,6 +39852,18 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
         getTaskAgentUsageReport(orgId: string, projectId: string, taskAgentId: string, aggregation?: GetTaskAgentUsageReportAggregationEnum, status?: UsageReportStatus, errorsOnly?: boolean, options?: any): AxiosPromise<TaskAgentUsageReport> {
             return localVarFp.getTaskAgentUsageReport(orgId, projectId, taskAgentId, aggregation, status, errorsOnly, options).then((request) => request(axios, basePath));
         },
+        /**
+         * List immutable executable revisions for a Task Agent.  Each revision contains the runtime configuration and pinned attachments that can be executed by new runs, long-lived sessions, or pinned triggers. The active revision is marked with `active`.
+         * @summary List Task Agent Revisions
+         * @param {string} orgId The organization ID
+         * @param {string} projectId The project ID
+         * @param {string} taskAgentId The task agent ID
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        listTaskAgentRevisions(orgId: string, projectId: string, taskAgentId: string, options?: any): AxiosPromise<Array<TaskAgentRevisionRead>> {
+            return localVarFp.listTaskAgentRevisions(orgId, projectId, taskAgentId, options).then((request) => request(axios, basePath));
+        },
         /**
          * List execution runs for a Task Agent.  Returns run history with: - Input message - Token usage - Status and duration - Task tools invoked - MCP tools invoked - Phase timings for LLM and tool execution
          * @summary List Task Agent Runs
@@ -39535,13 +39878,14 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
          * @param {string | null} [createdAfter] Filter runs created at/after this timestamp.
          * @param {string | null} [createdBefore] Filter runs created at/before this timestamp.
          * @param {number | null} [minDurationMs] Filter runs with duration greater than or equal to this value.
+         * @param {string | null} [taskAgentRevisionId] Filter by TaskAgent revision ID.
          * @param {number} [skip] 
          * @param {number} [limit] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        listTaskAgentRuns(orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, skip?: number, limit?: number, options?: any): AxiosPromise<Array<TaskAgentRunRead>> {
-            return localVarFp.listTaskAgentRuns(orgId, projectId, taskAgentId, sessionId, isError, hadTaskToolFail, hadMcpToolFail, status, createdAfter, createdBefore, minDurationMs, skip, limit, options).then((request) => request(axios, basePath));
+        listTaskAgentRuns(orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, taskAgentRevisionId?: string | null, skip?: number, limit?: number, options?: any): AxiosPromise<Array<TaskAgentRunRead>> {
+            return localVarFp.listTaskAgentRuns(orgId, projectId, taskAgentId, sessionId, isError, hadTaskToolFail, hadMcpToolFail, status, createdAfter, createdBefore, minDurationMs, taskAgentRevisionId, skip, limit, options).then((request) => request(axios, basePath));
         },
         /**
          * List conversation sessions for a Task Agent.  Sessions group related runs together for multi-turn conversations.
@@ -39556,7 +39900,7 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
             return localVarFp.listTaskAgentSessions(orgId, projectId, taskAgentId, options).then((request) => request(axios, basePath));
         },
         /**
-         * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their: - Configuration details - Available task tools (Tasks) - LLM model settings - Execution mode
+         * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their root metadata and embedded revision history. Runtime configuration such as instructions, models, and tools is stored on each revision.
          * @summary List Task Agents
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
@@ -39569,16 +39913,17 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
             return localVarFp.listTaskAgents(orgId, projectId, cursor, pageLimit, options).then((request) => request(axios, basePath));
         },
         /**
-         * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
+         * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Use `revision_id` to execute a specific TaskAgent revision. New sessions can run any revision belonging to the TaskAgent. Existing sessions remain pinned to their original revision; passing a conflicting `revision_id` is rejected.  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
          * @summary Run Task Agent
          * @param {string} orgId The unique identifier of the organization.
          * @param {string} projectId The unique identifier of the project.
          * @param {string} taskAgentId The specific Task Agent to reference.
+         * @param {string | null} [revisionId] Optional TaskAgent revision ID to use for execution. If omitted, new sessions use the active revision and continuations use the session\&#39;s pinned revision.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        runTaskAgent(orgId: string, projectId: string, taskAgentId: string, options?: any): AxiosPromise<any> {
-            return localVarFp.runTaskAgent(orgId, projectId, taskAgentId, options).then((request) => request(axios, basePath));
+        runTaskAgent(orgId: string, projectId: string, taskAgentId: string, revisionId?: string | null, options?: any): AxiosPromise<any> {
+            return localVarFp.runTaskAgent(orgId, projectId, taskAgentId, revisionId, options).then((request) => request(axios, basePath));
         },
         /**
          * Retrieve a specific member that has been granted direct access to the task_agent.
@@ -39634,7 +39979,7 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
             return localVarFp.taskAgentIamOrgOrgIdProjectProjectIdTaskAgentTaskAgentIdIamUpdateMemberRoles(taskAgentId, member, orgId, projectId, taskAgentIAMMemberRoleUpdate, options).then((request) => request(axios, basePath));
         },
         /**
-         * Update Task Agent configuration.  Modifiable fields: - Name and description - System instruction - LLM model - Execution mode - Task tools (full replacement) - MCP servers (full replacement)  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
+         * Update Task Agent metadata, create a new revision, or activate an existing revision.  Modifiable fields: - Root metadata: name and run visibility - Revision configuration: description, instruction, LLM models, execution mode,   memory settings, task tools, MCP servers, integrations, and skills - Activation: `active_revision_id`  Updating revision configuration creates a new inactive revision. Activate it with a separate request that only includes `active_revision_id`.  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
          * @summary Update Task Agent
          * @param {string} orgId The organization ID
          * @param {string} projectId The project ID
@@ -39657,7 +40002,7 @@ export const TaskAgentsApiFactory = function (configuration?: Configuration, bas
  */
 export class TaskAgentsApi extends BaseAPI {
     /**
-     * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  Configure: - System instruction (prompt) - LLM model for reasoning - Initial task tools (Tasks to add) - Optional MCP server bindings - Execution mode (agentic/sequential)
+     * Create a new Task Agent for the project.  Task Agents orchestrate multiple Tasks as task tools using LLM-powered reasoning.  The request creates the root Task Agent and its initial active revision. Runtime configuration such as instructions, models, and tools is stored on revisions.
      * @summary Create Task Agent
      * @param {string} orgId The organization ID
      * @param {string} projectId The project ID
@@ -39671,7 +40016,7 @@ export class TaskAgentsApi extends BaseAPI {
     }
 
     /**
-     * Remove a Task Agent from the project.  This will: - Remove agent configuration - Delete associated task tools - Preserve run history for auditing  This action cannot be undone.
+     * Remove a Task Agent from the project.  This will: - Remove the agent and its revision configuration - Preserve run history for auditing  This action cannot be undone.
      * @summary Delete Task Agent
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
@@ -39733,7 +40078,7 @@ export class TaskAgentsApi extends BaseAPI {
     }
 
     /**
-     * Retrieve detailed information about a specific Task Agent.  Returns: - Agent configuration - Available task tools (Tasks) - LLM model details - Execution statistics
+     * Retrieve detailed information about a specific Task Agent.  Returns root Task Agent metadata with embedded immutable revisions. Runtime configuration such as instructions, models, and tools is stored on each revision.
      * @summary Get Task Agent
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
@@ -39762,6 +40107,21 @@ export class TaskAgentsApi extends BaseAPI {
         return TaskAgentsApiFp(this.configuration).getTaskAgentCreditReport(orgId, projectId, taskAgentId, startDate, endDate, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Retrieve an immutable executable revision for a Task Agent.  The response includes the runtime configuration and concrete pinned attachments stored on that revision.
+     * @summary Get Task Agent Revision
+     * @param {string} orgId The organization ID
+     * @param {string} projectId The project ID
+     * @param {string} taskAgentId The task agent ID
+     * @param {string} revisionId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TaskAgentsApi
+     */
+    public getTaskAgentRevision(orgId: string, projectId: string, taskAgentId: string, revisionId: string, options?: RawAxiosRequestConfig) {
+        return TaskAgentsApiFp(this.configuration).getTaskAgentRevision(orgId, projectId, taskAgentId, revisionId, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Get conversation events for a specific TaskAgentRun.  Returns the full conversation history from the ADK session including: - User messages - Agent responses - Tool calls and results - Error messages (if any)  Events are returned in chronological order.
      * @summary Get Run Events
@@ -39843,6 +40203,20 @@ export class TaskAgentsApi extends BaseAPI {
         return TaskAgentsApiFp(this.configuration).getTaskAgentUsageReport(orgId, projectId, taskAgentId, aggregation, status, errorsOnly, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * List immutable executable revisions for a Task Agent.  Each revision contains the runtime configuration and pinned attachments that can be executed by new runs, long-lived sessions, or pinned triggers. The active revision is marked with `active`.
+     * @summary List Task Agent Revisions
+     * @param {string} orgId The organization ID
+     * @param {string} projectId The project ID
+     * @param {string} taskAgentId The task agent ID
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TaskAgentsApi
+     */
+    public listTaskAgentRevisions(orgId: string, projectId: string, taskAgentId: string, options?: RawAxiosRequestConfig) {
+        return TaskAgentsApiFp(this.configuration).listTaskAgentRevisions(orgId, projectId, taskAgentId, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * List execution runs for a Task Agent.  Returns run history with: - Input message - Token usage - Status and duration - Task tools invoked - MCP tools invoked - Phase timings for LLM and tool execution
      * @summary List Task Agent Runs
@@ -39857,14 +40231,15 @@ export class TaskAgentsApi extends BaseAPI {
      * @param {string | null} [createdAfter] Filter runs created at/after this timestamp.
      * @param {string | null} [createdBefore] Filter runs created at/before this timestamp.
      * @param {number | null} [minDurationMs] Filter runs with duration greater than or equal to this value.
+     * @param {string | null} [taskAgentRevisionId] Filter by TaskAgent revision ID.
      * @param {number} [skip] 
      * @param {number} [limit] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof TaskAgentsApi
      */
-    public listTaskAgentRuns(orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, skip?: number, limit?: number, options?: RawAxiosRequestConfig) {
-        return TaskAgentsApiFp(this.configuration).listTaskAgentRuns(orgId, projectId, taskAgentId, sessionId, isError, hadTaskToolFail, hadMcpToolFail, status, createdAfter, createdBefore, minDurationMs, skip, limit, options).then((request) => request(this.axios, this.basePath));
+    public listTaskAgentRuns(orgId: string, projectId: string, taskAgentId: string, sessionId?: string | null, isError?: boolean | null, hadTaskToolFail?: boolean | null, hadMcpToolFail?: boolean | null, status?: TaskAgentRunStatus, createdAfter?: string | null, createdBefore?: string | null, minDurationMs?: number | null, taskAgentRevisionId?: string | null, skip?: number, limit?: number, options?: RawAxiosRequestConfig) {
+        return TaskAgentsApiFp(this.configuration).listTaskAgentRuns(orgId, projectId, taskAgentId, sessionId, isError, hadTaskToolFail, hadMcpToolFail, status, createdAfter, createdBefore, minDurationMs, taskAgentRevisionId, skip, limit, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -39882,7 +40257,7 @@ export class TaskAgentsApi extends BaseAPI {
     }
 
     /**
-     * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their: - Configuration details - Available task tools (Tasks) - LLM model settings - Execution mode
+     * List all Task Agents configured for the project.  Returns a paginated list of Task Agents with their root metadata and embedded revision history. Runtime configuration such as instructions, models, and tools is stored on each revision.
      * @summary List Task Agents
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
@@ -39897,17 +40272,18 @@ export class TaskAgentsApi extends BaseAPI {
     }
 
     /**
-     * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
+     * Execute the Task Agent with a user message.  The agent will: 1. Process the message using the configured LLM 2. Reason about which task tools to invoke 3. Execute relevant Tasks as needed 4. Return a streaming response  Responses are streamed using Server-Sent Events (SSE).  The first SSE event emitted after successful stream setup is: - `event_type: \"session_id\"` with the resolved `session_id` in `metadata`  Use `revision_id` to execute a specific TaskAgent revision. New sessions can run any revision belonging to the TaskAgent. Existing sessions remain pinned to their original revision; passing a conflicting `revision_id` is rejected.  Subsequent events include tool calls/results, text responses, and the terminal `done` or `error` event.
      * @summary Run Task Agent
      * @param {string} orgId The unique identifier of the organization.
      * @param {string} projectId The unique identifier of the project.
      * @param {string} taskAgentId The specific Task Agent to reference.
+     * @param {string | null} [revisionId] Optional TaskAgent revision ID to use for execution. If omitted, new sessions use the active revision and continuations use the session\&#39;s pinned revision.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof TaskAgentsApi
      */
-    public runTaskAgent(orgId: string, projectId: string, taskAgentId: string, options?: RawAxiosRequestConfig) {
-        return TaskAgentsApiFp(this.configuration).runTaskAgent(orgId, projectId, taskAgentId, options).then((request) => request(this.axios, this.basePath));
+    public runTaskAgent(orgId: string, projectId: string, taskAgentId: string, revisionId?: string | null, options?: RawAxiosRequestConfig) {
+        return TaskAgentsApiFp(this.configuration).runTaskAgent(orgId, projectId, taskAgentId, revisionId, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -39972,7 +40348,7 @@ export class TaskAgentsApi extends BaseAPI {
     }
 
     /**
-     * Update Task Agent configuration.  Modifiable fields: - Name and description - System instruction - LLM model - Execution mode - Task tools (full replacement) - MCP servers (full replacement)  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
+     * Update Task Agent metadata, create a new revision, or activate an existing revision.  Modifiable fields: - Root metadata: name and run visibility - Revision configuration: description, instruction, LLM models, execution mode,   memory settings, task tools, MCP servers, integrations, and skills - Activation: `active_revision_id`  Updating revision configuration creates a new inactive revision. Activate it with a separate request that only includes `active_revision_id`.  To update task tools, pass a `task_tools` array. This performs a full replacement: - Omit the field to leave task tools unchanged - Pass an empty array to remove all task tools - Pass a new array to replace all task tools (array order = execution order)
      * @summary Update Task Agent
      * @param {string} orgId The organization ID
      * @param {string} projectId The project ID