@archastro/sdk 0.20.0 → 0.21.0

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

@@ -1,5 +1,564 @@
 import { HttpClient } from "../../runtime/http-client.js";
+import type { Task, TaskEnsureResult } from "../../types/tasks.js";
 import type { Thread } from "../../types/threads.js";
+export declare class OrgTaskResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List an organization's tasks
+     * Returns org-owned tasks for the specified organization: rows with the org
+     * tenant and no narrower user/team/agent scope. Explicitly personal, team, or
+     * agent tasks are excluded here; list those via the user/team collections or
+     * fetch them directly when authorized.
+     * Every organization member may list. App-scoped developer and
+     * server-to-server callers supply the org in the route.
+     * @param org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param params - Query parameters.
+     * @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.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.
+     * @param params.sourceScope - Return only tasks whose source matches this container. Must be supplied with `source_type` and `source_id`.
+     * @param params.sourceType - Return only tasks whose source matches this object kind. Must be supplied with the other source filters.
+     * @param params.sourceId - Return only tasks whose source matches this object identity. Must be supplied with the other source filters.
+     * @param params.epic - Return only tasks with this exact epic label.
+     * @param params.search - Restrict results to tasks whose name or description contains this string.
+     * @param params.sort - Sort key. One of `"created"` (default — most recently created first), `"due_date"` (soonest due first; tasks without a due date always sort last), or `"priority"` (most urgent first). Ties break by most recently created.
+     * @param params.order - Sort direction, `"asc"` or `"desc"`. Defaults to `"desc"` for `created` and `"asc"` for `due_date` and `priority`.
+     * @param params.dueBefore - Return only tasks with a due date strictly before this ISO 8601 datetime (`2026-08-01T00:00:00Z`) or date (`2026-08-01`, meaning midnight UTC). Tasks without a due date are excluded.
+     * @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
+     */
+    list(org: string, params?: {
+        status?: string;
+        ownerUser?: string;
+        ownerAgent?: string;
+        priority?: number;
+        tag?: string;
+        parent?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
+        search?: string;
+        sort?: string;
+        order?: string;
+        dueBefore?: string;
+        dueAfter?: string;
+        overdue?: boolean;
+        ready?: boolean;
+        attention?: boolean;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
+        data: {
+            agent?: string | null | undefined;
+            aggregate_version?: number | null | undefined;
+            blocked_by_count?: number | 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;
+            id: string;
+            is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
+            links?: 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;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
+            updated_at?: string | undefined;
+            user?: string | null | undefined;
+        }[];
+        has_more: boolean;
+    }>;
+    /**
+     * Create a task for an organization
+     * Creates a new org-owned task (org tenant, no narrower user/team/agent
+     * scope) and returns the full task object. User-authenticated calls are
+     * attributed to the authenticated user or agent. App-scoped developer and
+     * server-to-server callers must provide an explicit `user` or `agent` actor
+     * for the organization. Every referenced principal is validated against the
+     * app and organization before creation.
+     * @param org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param input - Request body.
+     * @param input.agent - Explicit acting agent (`agi_...`) for a developer or server-to-server call. Mutually exclusive with an acting `user`; the agent must belong to the organization.
+     * @param input.task - Attributes for the task to create. `name` is required; all other fields are optional.
+     * @param input.user - Explicit acting user (`usr_...`) for a developer or server-to-server call. Mutually exclusive with an acting `agent`.
+     * @returns The newly created task.
+     */
+    create(org: string, input: {
+        agent?: string | undefined;
+        task: {
+            description?: string | undefined;
+            due_date?: string | undefined;
+            epic?: string | undefined;
+            id?: string | undefined;
+            links?: Record<string, unknown> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            name: string;
+            owner_agent?: string | undefined;
+            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;
+    }): Promise<Task>;
+    /**
+     * List task blocker cycles for an organization
+     * Runs an on-demand diagnostic over unfinished org-owned tasks for the
+     * specified organization and returns a forward cursor-paginated page of
+     * complete cyclic blocker components. Detection is bounded to owners with at
+     * most 100 unfinished tasks. This endpoint is read-only: cycles do not prevent
+     * task updates, lease acquisition, or completion.
+     * @param org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param params - Query parameters.
+     * @param params.limit - Maximum cycle components to return. Defaults to 50; maximum is 100.
+     * @param params.afterCursor - Opaque cursor returned by the preceding page.
+     * @returns Successful response
+     */
+    blockerCycles(org: string, params?: {
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | undefined;
+        before_cursor?: string | undefined;
+        data: {
+            tasks: {
+                agent?: string | null | undefined;
+                aggregate_version?: number | null | undefined;
+                blocked_by_count?: number | 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;
+                id: string;
+                is_blocked?: boolean | undefined;
+                is_stalled?: boolean | undefined;
+                links?: 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;
+                team?: string | null | undefined;
+                thread?: string | null | undefined;
+                updated_at?: string | undefined;
+                user?: string | null | undefined;
+            }[];
+        }[];
+        has_more: boolean;
+    }>;
+    /**
+     * 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 org - Organization ID (`org_...`) whose org-owned tasks should be 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.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.team - Team owner.
+     * @param input.user - User owner, or explicit acting user on a team route.
+     * @returns The task and whether this request created it.
+     */
+    bySource(org: string, input: {
+        agent?: string | undefined;
+        description?: string | undefined;
+        epic?: string | undefined;
+        name: string;
+        source_id: string;
+        source_scope: string;
+        source_type: string;
+        status?: string | undefined;
+        team?: string | undefined;
+        user?: string | undefined;
+    }): Promise<TaskEnsureResult>;
+    /**
+     * Get task activity metrics for an organization
+     * Returns task activity metrics scoped to org-owned tasks (org tenant, no
+     * narrower user/team/agent scope). `open` counts currently open or
+     * in-progress org tasks, `created` counts tasks inserted in the UTC-day
+     * window, and `completed` counts tasks whose `closed_at` falls in that window
+     * while still in a closed status. Hard-deleted tasks are absent from the
+     * projection and therefore omitted. The daily series is zero-filled across
+     * the requested window and includes reconstructed end-of-day `open` stock.
+     * Any organization member may read this count-only summary. Requests from
+     * callers without org access return 404 so organization existence is not
+     * disclosed.
+     * @param org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param params - Query parameters.
+     * @param params.days - UTC-day window. One of 7, 30, 90, or 365; defaults to 30.
+     * @returns Successful response
+     */
+    metrics(org: string, params?: {
+        days?: number;
+    }): Promise<{
+        completed: number;
+        created: number;
+        days: number;
+        end_at: string;
+        open: number;
+        series: Record<string, unknown>[];
+        start_at: string;
+    }>;
+    /**
+     * List an organization's ready tasks
+     * Returns open org-owned 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 org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param params - Query parameters.
+     * @param params.explain - Include blocked and actively leased open tasks with exclusion reasons.
+     * @param params.assignedToMe - Only include tasks assigned to the authenticated user.
+     * @param params.sourceScope - Only include tasks whose source matches this container. Must be supplied with `source_type` and `source_id`.
+     * @param params.sourceType - Only include tasks whose source matches this object kind.
+     * @param params.sourceId - Only include tasks whose source matches this object identity.
+     * @param params.epic - Only include tasks with this exact epic label.
+     * @param params.limit - Maximum number of readiness entries to return. Capped at 100.
+     * @param params.afterCursor - Opaque cursor returned by the previous page.
+     * @returns Successful response
+     */
+    ready(org: string, params?: {
+        explain?: boolean;
+        assignedToMe?: boolean;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | undefined;
+        authoritative: boolean;
+        before_cursor?: string | undefined;
+        data: {
+            readiness: "ready" | "blocked" | "leased";
+            reason?: "open_blockers" | "active_lease" | null | undefined;
+            task: {
+                agent?: string | null | undefined;
+                aggregate_version?: number | null | undefined;
+                blocked_by_count?: number | 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;
+                id: string;
+                is_blocked?: boolean | undefined;
+                is_stalled?: boolean | undefined;
+                links?: 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;
+                team?: string | null | undefined;
+                thread?: string | null | undefined;
+                updated_at?: string | undefined;
+                user?: string | null | undefined;
+            };
+        }[];
+        has_more: boolean;
+    }>;
+    /**
+     * Search an organization's tasks
+     * Performs a full-text search over org-owned tasks for the specified
+     * organization and returns matching results. Combine `q` with the optional
+     * filters to narrow the result set further. When no query is provided, the
+     * endpoint behaves like a filtered list.
+     * The `query` field in the response echoes the effective search query.
+     * Explicitly personal, team, or agent tasks are excluded here.
+     * @param org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param params - Query parameters.
+     * @param params.q - Full-text search query matched against task names and descriptions. Takes precedence over `query` when both are provided.
+     * @param params.query - Alias for `q`. Use `q` when possible; this parameter exists for compatibility.
+     * @param params.status - Filter results by status. One of `"open"`, `"in_progress"`, `"in_review"`, or `"done"`. Omit to include 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.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.
+     * @param params.sourceScope - Return only tasks whose source matches this container. Must be supplied with `source_type` and `source_id`.
+     * @param params.sourceType - Return only tasks whose source matches this object kind. Must be supplied with the other source filters.
+     * @param params.sourceId - Return only tasks whose source matches this object identity. Must be supplied with the other source filters.
+     * @param params.epic - Return only tasks with this exact epic label.
+     * @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
+     */
+    search(org: string, params?: {
+        q?: string;
+        query?: string;
+        status?: string;
+        ownerUser?: string;
+        ownerAgent?: string;
+        priority?: number;
+        tag?: string;
+        parent?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | undefined;
+        before_cursor?: string | undefined;
+        data: {
+            agent?: string | null | undefined;
+            aggregate_version?: number | null | undefined;
+            blocked_by_count?: number | 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;
+            id: string;
+            is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
+            links?: 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;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
+            updated_at?: string | undefined;
+            user?: string | null | undefined;
+        }[];
+        has_more: boolean;
+        query: string;
+    }>;
+}
 export declare class OrgThreadResource {
     private http;
     constructor(http: HttpClient);
@@ -10,7 +569,7 @@ export declare class OrgThreadResource {
      * App-scoped developer tokens for the organization's app can list them too.
      * @param org - Organization ID (`org_...`) whose org-visibility threads should be listed.
      * @param params - Query parameters.
-     * @param params.key - Optional exact thread key, for example `archdev-room`.
+     * @param params.key - Optional exact thread key, for example `support-room`.
      * @returns Successful response
      */
     list(org: string, params?: {
@@ -113,8 +672,10 @@ export declare class OrgThreadResource {
                     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;
@@ -128,8 +689,10 @@ export declare class OrgThreadResource {
                             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;
@@ -456,6 +1019,7 @@ export declare class OrgThreadResource {
 }
 export declare class OrgResource {
     private http;
+    readonly tasks: OrgTaskResource;
     readonly threads: OrgThreadResource;
     constructor(http: HttpClient);
     /**
@@ -514,6 +1078,22 @@ export declare class OrgResource {
         after_cursor?: string | null | undefined;
         before_cursor?: string | null | undefined;
         data: {
+            acl?: {
+                add?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                grants?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                remove?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+            } | null | undefined;
             agent?: string | undefined;
             content_type?: string | undefined;
             created_at?: string | undefined;
@@ -575,5 +1155,54 @@ export declare class OrgResource {
         }[];
         has_more: boolean;
     }>;
+    /**
+     * List an organization's epic summaries
+     * Groups org-owned 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 org - Organization ID (`org_...`) owning the tasks.
+     * @param params - Query parameters.
+     * @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.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
+     */
+    taskEpics(org: string, params?: {
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        topPriority?: number;
+        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;
+            }[];
+            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;
+    }>;
 }
 //# sourceMappingURL=orgs.d.ts.map