@archastro/sdk 0.20.0 → 0.22.0

package/dist/v1/resources/teams.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient } from "../../runtime/http-client.js";
 import type { CustomObject } from "../../types/common.js";
-import type { Task } from "../../types/tasks.js";
+import type { Task, TaskEnsureResult, TaskEpicEntity, TaskEpicEntityCollection } from "../../types/tasks.js";
 import type { Team, TeamDeleteImpactResponse, TeamInvite, TeamMembership } from "../../types/teams.js";
 import type { Thread } from "../../types/threads.js";
 export declare class TeamCustomObjectResource {
@@ -44,17 +44,34 @@ export declare class TeamCustomObjectResource {
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                add_denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
                 grants?: {
                     actions: string[];
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                preserve_denies?: boolean | undefined;
                 remove?: {
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                remove_denies?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
             } | undefined;
+            agent?: string | undefined;
             created_at?: string | undefined;
+            expires_at?: string | null | undefined;
             fields?: Record<string, unknown> | undefined;
             id: string;
             org?: string | undefined;
@@ -160,15 +177,30 @@ export declare class MemberResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 app?: string | undefined;
                 created_at?: string | undefined;
@@ -417,6 +449,98 @@ export declare class MemberResource {
         role: string;
     }): Promise<TeamMembership>;
 }
+export declare class TeamTaskEpicResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List an owner's epic summaries
+     * Groups tasks by their exact epic label, ordered by label. Closed tasks include cancelled tasks, but cancelled prerequisites still block. Source filters select the tasks summarized; blockers outside that selection still affect readiness. Root ranking is capped per epic and root_blockers_partial is true when that graph is truncated. No epic entity is created.
+     * @param params - Query parameters.
+     * @param params.representation - labels (default) or entities.
+     * @param params.name - Exact entity name; only used for entities.
+     * @param params.sourceScope - Exact source scope; supply all three source fields.
+     * @param params.sourceType - Exact source type.
+     * @param params.sourceId - Exact source ID.
+     * @param params.topPriority - Exact highest open priority, from 0 to 4.
+     * @param params.owner - Keep only epics with at least one non-closed task owned by this user: `me` or a user public ID (`usr_...`).
+     * @param params.includeClosed - Include epics with no non-closed tasks; defaults to false.
+     * @param params.limit - Maximum epics; defaults to 50, capped at 100.
+     * @param params.afterCursor - Opaque forward cursor from the preceding page.
+     * @returns Successful response
+     */
+    list(team: string, params?: {
+        representation?: string;
+        name?: string;
+        user?: string;
+        org?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        topPriority?: number;
+        owner?: string;
+        includeClosed?: boolean;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
+        data: {
+            blocked_count: number;
+            counts: Record<string, unknown>;
+            epic: string;
+            next_ready: {
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            }[];
+            owner?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            primary_task?: {
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            } | null | undefined;
+            root_blockers: {
+                downstream_count: number;
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            }[];
+            root_blockers_partial: boolean;
+            top_open_priority?: number | null | undefined;
+            updated_at: string;
+        }[];
+        has_more: boolean;
+        no_epic_open_count: number;
+    } | TaskEpicEntityCollection>;
+    /**
+     * Create a task Epic
+     * @param input - Request body.
+     * @returns Successful response
+     */
+    create(team: string, input: {
+        description?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        name: string;
+        state?: string | undefined;
+        user?: string | undefined;
+    }): Promise<TaskEpicEntity>;
+}
 export declare class TeamTaskResource {
     private http;
     constructor(http: HttpClient);
@@ -437,6 +561,9 @@ export declare class TeamTaskResource {
      * @param params.status - Filter tasks by status. One of `"open"`, `"in_progress"`, `"in_review"`, or `"done"`. Omit to return tasks in all statuses.
      * @param params.ownerUser - Filter tasks assigned to a specific user. Provide the user's public ID (`usr_...`).
      * @param params.ownerAgent - Filter tasks assigned to a specific agent. Provide the agent's public ID (`agi_...`).
+     * @param params.owner - Return only tasks owned by this user: `me` or a user public ID (`usr_...`).
+     * @param params.involving - Return only tasks owned or created by this user: `me` or a user public ID (`usr_...`). The "My work" predicate.
+     * @param params.summary - When true, omit `description` from every task. Use for list views.
      * @param params.priority - Filter tasks by priority, from 0 (highest) to 4 (lowest).
      * @param params.tag - Return only tasks carrying this tag (matched against the canonical lowercase form).
      * @param params.parent - Return only subtasks of the given task (`tsk_...`), or pass `none` to return only top-level tasks.
@@ -451,6 +578,7 @@ export declare class TeamTaskResource {
      * @param params.dueAfter - Return only tasks with a due date strictly after this ISO 8601 datetime or date. Tasks without a due date are excluded.
      * @param params.overdue - When `true`, return only overdue tasks: a due date before the current UTC day and a status other than `"done"`. A task due today is not overdue.
      * @param params.ready - When true, return only open tasks with no unfinished blockers and no active session lease. This is a projection snapshot; claim a lease before starting work.
+     * @param params.attention - When true, return paused, failed, or in-progress tasks with no lease or a past lease expiry.
      * @param params.limit - Maximum number of tasks to return. Capped at 100.
      * @param params.afterCursor - Opaque cursor returned by the previous page.
      * @returns Successful response
@@ -461,6 +589,9 @@ export declare class TeamTaskResource {
         status?: string;
         ownerUser?: string;
         ownerAgent?: string;
+        owner?: string;
+        involving?: string;
+        summary?: boolean;
         priority?: number;
         tag?: string;
         parent?: string;
@@ -475,6 +606,7 @@ export declare class TeamTaskResource {
         dueAfter?: string;
         overdue?: boolean;
         ready?: boolean;
+        attention?: boolean;
         limit?: number;
         afterCursor?: string;
     }): Promise<{
@@ -484,6 +616,7 @@ export declare class TeamTaskResource {
             agent?: string | null | undefined;
             aggregate_version?: number | null | undefined;
             blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
             closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
@@ -511,9 +644,12 @@ export declare class TeamTaskResource {
             description?: string | null | undefined;
             due_date?: string | null | undefined;
             epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
             id: string;
             is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
             org?: string | null | undefined;
@@ -535,13 +671,18 @@ export declare class TeamTaskResource {
             owner_user?: string | null | undefined;
             parent?: string | null | undefined;
             priority?: number | undefined;
+            project_id?: string | null | undefined;
             sandbox?: string | null | undefined;
             source_id?: string | null | undefined;
             source_scope?: string | null | undefined;
             source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
             status: string;
             subtasks_count?: number | undefined;
             tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
             team?: string | null | undefined;
             thread?: string | null | undefined;
             updated_at?: string | undefined;
@@ -570,9 +711,11 @@ export declare class TeamTaskResource {
         agent?: string | undefined;
         org?: string | undefined;
         task: {
+            blockers?: string[] | undefined;
             description?: string | undefined;
             due_date?: string | undefined;
             epic?: string | undefined;
+            epic_id?: string | undefined;
             id?: string | undefined;
             links?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -581,11 +724,14 @@ export declare class TeamTaskResource {
             owner_user?: string | undefined;
             parent?: string | undefined;
             priority?: number | undefined;
+            project_id?: string | undefined;
             source_id?: string | undefined;
             source_scope?: string | undefined;
             source_type?: string | undefined;
             status?: string | undefined;
             tags?: string[] | undefined;
+            target_binary?: string | undefined;
+            target_version?: string | undefined;
             thread?: string | undefined;
         };
         user?: string | undefined;
@@ -618,6 +764,7 @@ export declare class TeamTaskResource {
                 agent?: string | null | undefined;
                 aggregate_version?: number | null | undefined;
                 blocked_by_count?: number | undefined;
+                blockers?: string[] | undefined;
                 closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
@@ -645,9 +792,12 @@ export declare class TeamTaskResource {
                 description?: string | null | undefined;
                 due_date?: string | null | undefined;
                 epic?: string | null | undefined;
+                human_answer_receipts?: Record<string, unknown> | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
+                is_stalled?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
+                machine_rescope_receipts?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
                 org?: string | null | undefined;
@@ -669,13 +819,18 @@ export declare class TeamTaskResource {
                 owner_user?: string | null | undefined;
                 parent?: string | null | undefined;
                 priority?: number | undefined;
+                project_id?: string | null | undefined;
                 sandbox?: string | null | undefined;
                 source_id?: string | null | undefined;
                 source_scope?: string | null | undefined;
                 source_type?: string | null | undefined;
+                stalled_since?: string | null | undefined;
                 status: string;
                 subtasks_count?: number | undefined;
                 tags?: string[] | undefined;
+                target_binary?: string | null | undefined;
+                target_version?: string | null | undefined;
+                task_epic?: string | null | undefined;
                 team?: string | null | undefined;
                 thread?: string | null | undefined;
                 updated_at?: string | undefined;
@@ -684,6 +839,133 @@ export declare class TeamTaskResource {
         }[];
         has_more: boolean;
     }>;
+    /**
+     * Find an owner's tasks by external reference
+     * Returns all exact external-reference matches owned by the requested principal. Multiple matches remain explicit; callers must not choose an arbitrary task.
+     * @param team - Team ID (`tem_...`). Only tasks belonging to this team are returned.
+     * @param params - Query parameters.
+     * @param params.user - User owner.
+     * @param params.org - Organization consistency check.
+     * @param params.externalScope - External host.
+     * @param params.objectType - External object type.
+     * @param params.objectId - External object identity.
+     * @returns Successful response
+     */
+    byExternalReference(team: string, params?: {
+        user?: string;
+        org?: string;
+        externalScope?: string;
+        objectType?: string;
+        objectId?: string;
+    }): Promise<{
+        data: {
+            agent?: string | null | undefined;
+            aggregate_version?: number | null | undefined;
+            blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
+            closed_at?: string | null | undefined;
+            comments_count?: number | undefined;
+            created_at?: string | undefined;
+            created_by_actor?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            created_by_agent?: string | null | undefined;
+            created_by_user?: string | null | undefined;
+            current_lease?: {
+                expires_at: string;
+                harness: string;
+                session_name: string;
+            } | null | undefined;
+            description?: string | null | undefined;
+            due_date?: string | null | undefined;
+            epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
+            id: string;
+            is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
+            links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            name: string;
+            org?: string | null | undefined;
+            owner_actor?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            owner_agent?: string | null | undefined;
+            owner_user?: string | null | undefined;
+            parent?: string | null | undefined;
+            priority?: number | undefined;
+            project_id?: string | null | undefined;
+            sandbox?: string | null | undefined;
+            source_id?: string | null | undefined;
+            source_scope?: string | null | undefined;
+            source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
+            status: string;
+            subtasks_count?: number | undefined;
+            tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
+            updated_at?: string | undefined;
+            user?: string | null | undefined;
+        }[];
+    }>;
+    /**
+     * Find or create a task by source
+     * Atomically creates one task per owner, tenant and source. Retries return the current task without updating it. Historical tasks created through ordinary create are not adopted.
+     * @param team - Team ID (`tem_...`). Only tasks belonging to this team are returned.
+     * @param input - Request body.
+     * @param input.agent - Explicit acting agent for privileged callers.
+     * @param input.description - Initial task description.
+     * @param input.epic - Initial epic grouping.
+     * @param input.name - Initial task name.
+     * @param input.org - Explicit organization for privileged callers.
+     * @param input.owner_user - Initial assigned user; immutable on retries.
+     * @param input.source_id - Source identity, for example owner/repo#123.
+     * @param input.source_scope - Source scope, for example github.
+     * @param input.source_type - Source type, for example pull_request.
+     * @param input.status - Initial task status.
+     * @param input.user - User owner, or explicit acting user on a team route.
+     * @returns The task and whether this request created it.
+     */
+    bySource(team: string, input: {
+        agent?: string | undefined;
+        description?: string | undefined;
+        epic?: string | undefined;
+        name: string;
+        org?: string | undefined;
+        owner_user?: string | undefined;
+        source_id: string;
+        source_scope: string;
+        source_type: string;
+        status?: string | undefined;
+        user?: string | undefined;
+    }): Promise<TaskEnsureResult>;
     /**
      * Get task activity metrics for a team
      * Returns task activity metrics scoped to one team (the Network in ArchAgents).
@@ -717,6 +999,8 @@ export declare class TeamTaskResource {
      * Returns open tasks with no unfinished blockers and no active session lease.
      * Readiness is calculated by the server from the current task projection. It is
      * a snapshot, not a reservation; claim a task lease before starting work.
+     * Results are ordered by priority (0, the most urgent, first), then oldest
+     * first, so the first page is always the most urgent ready work.
      * Pass `explain=true` to include every open task with a stable readiness reason.
      * @param team - Team ID (`tem_...`). Only tasks belonging to this team are returned.
      * @param params - Query parameters.
@@ -754,6 +1038,7 @@ export declare class TeamTaskResource {
                 agent?: string | null | undefined;
                 aggregate_version?: number | null | undefined;
                 blocked_by_count?: number | undefined;
+                blockers?: string[] | undefined;
                 closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
@@ -781,9 +1066,12 @@ export declare class TeamTaskResource {
                 description?: string | null | undefined;
                 due_date?: string | null | undefined;
                 epic?: string | null | undefined;
+                human_answer_receipts?: Record<string, unknown> | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
+                is_stalled?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
+                machine_rescope_receipts?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
                 org?: string | null | undefined;
@@ -805,13 +1093,18 @@ export declare class TeamTaskResource {
                 owner_user?: string | null | undefined;
                 parent?: string | null | undefined;
                 priority?: number | undefined;
+                project_id?: string | null | undefined;
                 sandbox?: string | null | undefined;
                 source_id?: string | null | undefined;
                 source_scope?: string | null | undefined;
                 source_type?: string | null | undefined;
+                stalled_since?: string | null | undefined;
                 status: string;
                 subtasks_count?: number | undefined;
                 tags?: string[] | undefined;
+                target_binary?: string | null | undefined;
+                target_version?: string | null | undefined;
+                task_epic?: string | null | undefined;
                 team?: string | null | undefined;
                 thread?: string | null | undefined;
                 updated_at?: string | undefined;
@@ -874,6 +1167,7 @@ export declare class TeamTaskResource {
             agent?: string | null | undefined;
             aggregate_version?: number | null | undefined;
             blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
             closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
@@ -901,9 +1195,12 @@ export declare class TeamTaskResource {
             description?: string | null | undefined;
             due_date?: string | null | undefined;
             epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
             id: string;
             is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
             org?: string | null | undefined;
@@ -925,13 +1222,18 @@ export declare class TeamTaskResource {
             owner_user?: string | null | undefined;
             parent?: string | null | undefined;
             priority?: number | undefined;
+            project_id?: string | null | undefined;
             sandbox?: string | null | undefined;
             source_id?: string | null | undefined;
             source_scope?: string | null | undefined;
             source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
             status: string;
             subtasks_count?: number | undefined;
             tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
             team?: string | null | undefined;
             thread?: string | null | undefined;
             updated_at?: string | undefined;
@@ -1008,15 +1310,30 @@ export declare class TeamThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 actors?: {
                     alias?: string | null | undefined;
@@ -1060,8 +1377,10 @@ export declare class TeamThreadResource {
                     type: string;
                     url?: string | null | undefined;
                     variants?: {
+                        byte_size?: number | null | undefined;
                         content_type?: string | null | undefined;
                         created_at?: string | undefined;
+                        duration_ms?: number | null | undefined;
                         file?: string | undefined;
                         filename?: string | null | undefined;
                         height?: number | null | undefined;
@@ -1075,8 +1394,10 @@ export declare class TeamThreadResource {
                             url?: string | null | undefined;
                             width?: number | null | undefined;
                         } | null | undefined;
+                        sha256?: string | null | undefined;
                         updated_at?: string | undefined;
                         url?: string | null | undefined;
+                        url_expires_at?: string | null | undefined;
                         variant_key?: string | undefined;
                         width?: number | null | undefined;
                     }[] | undefined;
@@ -1168,15 +1489,30 @@ export declare class TeamThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 app?: string | undefined;
                 created_at?: string | undefined;
@@ -1349,6 +1685,7 @@ export declare class TeamThreadResource {
             sub_threads?: Record<string, unknown>[] | null | undefined;
             tags?: string[] | undefined;
             team?: string | null | undefined;
+            thread_template_key?: string | null | undefined;
             title?: string | null | undefined;
             ttl?: string | null | undefined;
             unread_count?: number | null | undefined;
@@ -1434,6 +1771,7 @@ export declare class TeamResource {
     readonly custom_objects: TeamCustomObjectResource;
     readonly invite: TeamInviteResource;
     readonly members: MemberResource;
+    readonly task_epics: TeamTaskEpicResource;
     readonly tasks: TeamTaskResource;
     readonly threads: TeamThreadResource;
     constructor(http: HttpClient);
@@ -1476,15 +1814,30 @@ export declare class TeamResource {
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                add_denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
                 grants?: {
                     actions: string[];
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                preserve_denies?: boolean | undefined;
                 remove?: {
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                remove_denies?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
             } | null | undefined;
             app?: string | undefined;
             badges?: Record<string, unknown> | null | undefined;
@@ -1530,15 +1883,30 @@ export declare class TeamResource {
                 principal?: string | undefined;
                 principal_type: string;
             }[] | undefined;
+            add_denies?: {
+                actions: string[];
+                principal?: string | undefined;
+                principal_type: string;
+            }[] | undefined;
+            denies?: {
+                actions: string[];
+                principal?: string | undefined;
+                principal_type: string;
+            }[] | undefined;
             grants?: {
                 actions: string[];
                 principal?: string | undefined;
                 principal_type: string;
             }[] | undefined;
+            preserve_denies?: boolean | undefined;
             remove?: {
                 principal?: string | undefined;
                 principal_type: string;
             }[] | undefined;
+            remove_denies?: {
+                principal?: string | undefined;
+                principal_type: string;
+            }[] | undefined;
         } | undefined;
         description?: string | undefined;
         idempotency_key?: string | undefined;
@@ -1617,15 +1985,30 @@ export declare class TeamResource {
                 principal?: string | undefined;
                 principal_type: string;
             }[] | undefined;
+            add_denies?: {
+                actions: string[];
+                principal?: string | undefined;
+                principal_type: string;
+            }[] | undefined;
+            denies?: {
+                actions: string[];
+                principal?: string | undefined;
+                principal_type: string;
+            }[] | undefined;
             grants?: {
                 actions: string[];
                 principal?: string | undefined;
                 principal_type: string;
             }[] | undefined;
+            preserve_denies?: boolean | undefined;
             remove?: {
                 principal?: string | undefined;
                 principal_type: string;
             }[] | undefined;
+            remove_denies?: {
+                principal?: string | undefined;
+                principal_type: string;
+            }[] | undefined;
         } | undefined;
         description?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -1658,6 +2041,37 @@ export declare class TeamResource {
         groupKeyPrefix?: string;
     }): Promise<{
         data: {
+            acl?: {
+                add?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                add_denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                grants?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                preserve_denies?: boolean | undefined;
+                remove?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                remove_denies?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+            } | null | undefined;
             agent?: string | undefined;
             content_type?: string | undefined;
             created_at?: string | undefined;