@archastro/sdk 0.20.0 → 0.22.0

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

@@ -1,5 +1,819 @@
 import { HttpClient } from "../../runtime/http-client.js";
+import type { Task, TaskDeletion, TaskEnsureResult, TaskEpicEntity, TaskEpicEntityCollection } from "../../types/tasks.js";
 import type { Thread } from "../../types/threads.js";
+export declare class OrgTaskEpicResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * 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.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(org: string, params?: {
+        representation?: string;
+        name?: 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 an organization task Epic
+     * @param org - Organization ID (`org_...`) owning the tasks.
+     * @param input - Request body.
+     * @returns Successful response
+     */
+    create(org: string, input: {
+        description?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        name: string;
+        state?: string | undefined;
+    }): Promise<TaskEpicEntity>;
+}
+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.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.
+     * @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.include - Set to `blockers` to include visible blocker task IDs.
+     * @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), `"priority"` (most urgent first), or `"updated"` (latest-state sync, ties by ID). Updated rows can coalesce or reappear: upsert by ID and aggregate version. Delayed/backdated or equal-time updates behind a cursor require periodic reconciliation. This is not a lossless mutation log.
+     * @param params.order - Sort direction, `"asc"` or `"desc"`. Defaults to `"desc"` for `created` and `"asc"` for `updated`, `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;
+        owner?: string;
+        involving?: string;
+        summary?: boolean;
+        priority?: number;
+        tag?: string;
+        parent?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
+        search?: string;
+        include?: 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;
+            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;
+        }[];
+        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: {
+            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;
+            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;
+                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;
+            }[];
+        }[];
+        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 org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @param params - Query parameters.
+     * @param params.user - User owner.
+     * @param params.team - Team owner.
+     * @param params.externalScope - External host.
+     * @param params.objectType - External object type.
+     * @param params.objectId - External object identity.
+     * @returns Successful response
+     */
+    byExternalReference(org: string, params?: {
+        user?: string;
+        team?: 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 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.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.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;
+        owner_user?: string | undefined;
+        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. Equivalent to `owner[]=me`; sending it together with `owner` returns 422.
+     * @param params.owner - Owner kinds to include; the result is the union of the listed kinds. Accepted values: `me` (assigned to the authenticated user) and `unassigned` (no user or agent owner). Agent-assigned tasks match neither value. Omit to include every owner.
+     * @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;
+        owner?: string[];
+        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;
+                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;
+            };
+        }[];
+        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;
+            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;
+        }[];
+        has_more: boolean;
+        query: string;
+    }>;
+    /**
+     * Stream organization task changes
+     * Organization task hints, not a lossless mutation log. Subscribe before reading
+     * ready cursors. Resume tasks with sort=updated&order=asc and deletions with their
+     * own cursor, retaining each page's after_cursor. Rows may coalesce or reappear;
+     * upsert by ID/version and periodically reconcile late/backdated/equal-time rows
+     * behind a cursor. Gaps beyond seven-day tombstone retention require full resync.
+     * Projector commit/ack failures can lose hints, so clients must reconcile too.
+     * Cross-batch deduplication retains at most 1024 task IDs in FIFO order; hints
+     * for evicted IDs can reappear, so clients must discard older/equal versions.
+     * Pending batches admit at most 512 distinct IDs, bounding visibility queries
+     * and emitted event lists. Overflow closes the stream; reconnect and reconcile.
+     * The independently released Rust Factory panel and assignment sweeps consume
+     * this contract in https://archdev.ai/tasks/tsk_6ttk2gUwttt6wwkiprwui7.
+     * That consumer must not roll out until this provider endpoint and the cursor /
+     * deletion contracts are deployed and verified on Platform. Its old-server 404
+     * polling fallback is compatibility protection, not a substitute for this gate.
+     * @param org - Organization ID (`org_...`) whose org-owned tasks should be returned.
+     * @returns Server-Sent Events stream
+     */
+    stream(org: string): AsyncIterable<{
+        event: "ready";
+        data: {
+            deletions_after_cursor: string | null;
+            tasks_after_cursor: string | null;
+        };
+    } | {
+        event: "task_changed";
+        data: {
+            aggregate_version: number;
+            id: string;
+            status: string;
+            updated_at: string;
+        };
+    } | {
+        event: "task_deleted";
+        data: TaskDeletion;
+    }>;
+}
 export declare class OrgThreadResource {
     private http;
     constructor(http: HttpClient);
@@ -10,7 +824,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?: {
@@ -61,15 +875,30 @@ export declare class OrgThreadResource {
                         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;
@@ -113,8 +942,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 +959,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;
@@ -221,15 +1054,30 @@ export declare class OrgThreadResource {
                         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;
@@ -402,6 +1250,7 @@ export declare class OrgThreadResource {
             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;
@@ -456,6 +1305,8 @@ export declare class OrgThreadResource {
 }
 export declare class OrgResource {
     private http;
+    readonly task_epics: OrgTaskEpicResource;
+    readonly tasks: OrgTaskResource;
     readonly threads: OrgThreadResource;
     constructor(http: HttpClient);
     /**
@@ -514,6 +1365,37 @@ 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;
+                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;
@@ -575,5 +1457,29 @@ export declare class OrgResource {
         }[];
         has_more: boolean;
     }>;
+    /**
+     * List visible task deletions
+     * Returns visible task tombstones in ascending (deleted_at, task) order.
+     * Tombstones are retained for seven days. Clients must fully resynchronize after
+     * retention gaps, and periodically reconcile delayed projections. This is not an
+     * immutable mutation log. Upsert live tasks by ID and aggregate version.
+     * @param org - Organization ID (`org_...`).
+     * @param params - Query parameters.
+     * @param params.limit - Page size, capped at 100.
+     * @param params.afterCursor - Opaque cursor from the previous page.
+     * @returns Successful response
+     */
+    taskDeletions(org: string, params?: {
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
+        data: {
+            deleted_at: string;
+            task: string;
+        }[];
+        has_more: boolean;
+    }>;
 }
 //# sourceMappingURL=orgs.d.ts.map