@archastro/sdk 0.9.0 → 0.11.0

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

@@ -1,5 +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 { Team, TeamInvite, TeamMembership } from "../../types/teams.js";
 import type { Thread } from "../../types/threads.js";
 export declare class TeamCustomObjectResource {
@@ -37,6 +38,22 @@ export declare class TeamCustomObjectResource {
         query?: string;
     }): Promise<{
         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;
+            } | undefined;
             created_at?: string | undefined;
             fields?: Record<string, unknown> | undefined;
             id: string;
@@ -356,6 +373,384 @@ export declare class MemberResource {
         role: string;
     }): Promise<TeamMembership>;
 }
+export declare class TeamTaskResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List an owner's tasks
+     * Returns tasks owned by the specified user or team. You can narrow results using the
+     * optional filters below. By default results are returned in reverse chronological
+     * order (most recently created first); use `sort` and `order` to sort by due date or
+     * priority instead.
+     * User-authenticated callers may list their personal tasks or tasks for teams they
+     * have joined. Privileged callers provide the owner in the route; the owner's
+     * organization is implied by that principal. An explicit `org` is optional and,
+     * when set, must match the owner's organization.
+     * @param team - Team ID (`tem_...`). Only tasks belonging to this team are returned.
+     * @param params - Query parameters.
+     * @param params.user - User ID (`usr_...`) for user-scoped tasks.
+     * @param params.org - Optional organization (`org_...`) for developer and server-to-server calls. When omitted, the org is taken from the owner principal (team, user, or agent). When set, it must match that principal's org; pass null for an owner outside an organization.
+     * @param params.status - Filter tasks by status. One of `"open"`, `"in_progress"`, 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.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.limit - Maximum number of tasks to return. Capped at 100.
+     * @param params.afterCursor - Opaque cursor returned by the previous page.
+     * @returns Successful response
+     */
+    list(team: string, params?: {
+        user?: string;
+        org?: string;
+        status?: string;
+        ownerUser?: string;
+        ownerAgent?: string;
+        priority?: number;
+        tag?: string;
+        parent?: string;
+        search?: string;
+        sort?: string;
+        order?: string;
+        dueBefore?: string;
+        dueAfter?: string;
+        overdue?: boolean;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | undefined;
+        before_cursor?: string | undefined;
+        data: {
+            agent?: string | undefined;
+            blocked_by_count?: number | undefined;
+            closed_at?: string | undefined;
+            comments_count?: number | undefined;
+            created_at?: string | undefined;
+            created_by_actor?: {
+                alias?: string | undefined;
+                id?: string | undefined;
+                name?: string | undefined;
+                profile_picture?: {
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    mime_type?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+            } | undefined;
+            created_by_agent?: string | undefined;
+            created_by_user?: string | undefined;
+            current_lease?: {
+                expires_at: string;
+                harness: string;
+                session_name: string;
+            } | null | undefined;
+            description?: string | undefined;
+            due_date?: string | undefined;
+            id: string;
+            is_blocked?: boolean | undefined;
+            links?: Record<string, unknown> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            name: string;
+            org?: string | undefined;
+            owner_actor?: {
+                alias?: string | undefined;
+                id?: string | undefined;
+                name?: string | undefined;
+                profile_picture?: {
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    mime_type?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+            } | undefined;
+            owner_agent?: string | undefined;
+            owner_user?: string | undefined;
+            parent?: string | undefined;
+            priority?: number | undefined;
+            sandbox?: string | undefined;
+            status: string;
+            subtasks_count?: number | undefined;
+            tags?: string[] | undefined;
+            team?: string | undefined;
+            thread?: string | undefined;
+            updated_at?: string | undefined;
+            user?: string | undefined;
+        }[];
+        has_more: boolean;
+    }>;
+    /**
+     * Create a task for an owner
+     * Creates a new task owned by the specified user or team 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
+     * the task's explicit `org` scope and an explicit `user` or `agent` actor for
+     * team tasks; a user-owned task reuses the user in the route unless an explicit
+     * agent is supplied. Every referenced principal is validated against the app,
+     * owner, and team membership before creation.
+     * @param team - Team ID (`tem_...`). Only tasks belonging to this team are 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 task owner.
+     * @param input.org - Explicit organization (`org_...`) for developer and server-to-server calls. Pass null when the owner is not organization-scoped. The value must match the selected user or team.
+     * @param input.task - Attributes for the task to create. `name` is required; all other fields are optional.
+     * @param input.user - User ID (`usr_...`). On a user route this is the task owner and creator; on a team route it is the explicit acting user for a developer or server-to-server call.
+     * @returns The newly created task.
+     */
+    create(team: string, input: {
+        agent?: string | undefined;
+        org?: string | undefined;
+        task: {
+            description?: string | undefined;
+            due_date?: 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;
+            status?: string | undefined;
+            tags?: string[] | undefined;
+            thread?: string | undefined;
+        };
+        user?: string | undefined;
+    }): Promise<Task>;
+    /**
+     * List task blocker cycles
+     * Runs an on-demand diagnostic over unfinished tasks owned by the specified
+     * team or user 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 team - Team ID (`tem_...`). Only tasks belonging to this team are returned.
+     * @param params - Query parameters.
+     * @param params.user - User ID (`usr_...`) owning the tasks.
+     * @param params.org - Optional organization context for privileged callers.
+     * @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(team: string, params?: {
+        user?: string;
+        org?: string;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | undefined;
+        before_cursor?: string | undefined;
+        data: {
+            tasks: {
+                agent?: string | undefined;
+                blocked_by_count?: number | undefined;
+                closed_at?: string | undefined;
+                comments_count?: number | undefined;
+                created_at?: string | undefined;
+                created_by_actor?: {
+                    alias?: string | undefined;
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    profile_picture?: {
+                        file?: string | undefined;
+                        height?: number | undefined;
+                        media?: string | undefined;
+                        mime_type?: string | undefined;
+                        refresh_url?: string | undefined;
+                        url?: string | undefined;
+                        width?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                created_by_agent?: string | undefined;
+                created_by_user?: string | undefined;
+                current_lease?: {
+                    expires_at: string;
+                    harness: string;
+                    session_name: string;
+                } | null | undefined;
+                description?: string | undefined;
+                due_date?: string | undefined;
+                id: string;
+                is_blocked?: boolean | undefined;
+                links?: Record<string, unknown> | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                name: string;
+                org?: string | undefined;
+                owner_actor?: {
+                    alias?: string | undefined;
+                    id?: string | undefined;
+                    name?: string | undefined;
+                    profile_picture?: {
+                        file?: string | undefined;
+                        height?: number | undefined;
+                        media?: string | undefined;
+                        mime_type?: string | undefined;
+                        refresh_url?: string | undefined;
+                        url?: string | undefined;
+                        width?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                owner_agent?: string | undefined;
+                owner_user?: string | undefined;
+                parent?: string | undefined;
+                priority?: number | undefined;
+                sandbox?: string | undefined;
+                status: string;
+                subtasks_count?: number | undefined;
+                tags?: string[] | undefined;
+                team?: string | undefined;
+                thread?: string | undefined;
+                updated_at?: string | undefined;
+                user?: string | undefined;
+            }[];
+        }[];
+        has_more: boolean;
+    }>;
+    /**
+     * Get task activity metrics for a team
+     * Returns task activity metrics scoped to one team (the Network in ArchAgents).
+     * `open` counts currently open or in-progress team 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 (from remaining projection rows' inserted_at/closed_at).
+     * Any authenticated team member may read this count-only Network summary.
+     * Requests from callers without team access return 404 so team existence is
+     * not disclosed.
+     * @param team - Team ID (`tem_...`). Only tasks belonging to this team are 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(team: string, params?: {
+        days?: number;
+    }): Promise<{
+        completed: number;
+        created: number;
+        days: number;
+        end_at: string;
+        open: number;
+        series: Record<string, unknown>[];
+        start_at: string;
+    }>;
+    /**
+     * Search an owner's tasks
+     * Performs a full-text search over tasks owned by the specified user or team 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.
+     * User-authenticated callers may search their personal tasks or tasks for teams
+     * they have joined. Privileged callers provide the owner in the route; the owner's
+     * organization is implied by that principal. An explicit `org` is optional and,
+     * when set, must match the owner's organization.
+     * @param team - Team ID (`tem_...`). Only tasks belonging to this team are returned.
+     * @param params - Query parameters.
+     * @param params.user - User ID (`usr_...`) whose tasks are searched.
+     * @param params.org - Optional organization (`org_...`) for developer and server-to-server calls. When omitted, the org is taken from the owner principal (team, user, or agent). When set, it must match that principal's org; pass null for an owner outside an organization.
+     * @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"`, or `"done"`. Omit to include all statuses.
+     * @param params.ownerUser - Restrict results to tasks assigned to the user with this public ID (`usr_...`).
+     * @param params.ownerAgent - Restrict results to tasks assigned to the agent with this public ID (`agi_...`).
+     * @param params.priority - Filter results 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.limit - Maximum number of tasks to return. Capped at 100.
+     * @param params.afterCursor - Opaque cursor returned by the previous page.
+     * @returns Successful response
+     */
+    search(team: string, params?: {
+        user?: string;
+        org?: string;
+        q?: string;
+        query?: string;
+        status?: string;
+        ownerUser?: string;
+        ownerAgent?: string;
+        priority?: number;
+        tag?: string;
+        parent?: string;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | undefined;
+        before_cursor?: string | undefined;
+        data: {
+            agent?: string | undefined;
+            blocked_by_count?: number | undefined;
+            closed_at?: string | undefined;
+            comments_count?: number | undefined;
+            created_at?: string | undefined;
+            created_by_actor?: {
+                alias?: string | undefined;
+                id?: string | undefined;
+                name?: string | undefined;
+                profile_picture?: {
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    mime_type?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+            } | undefined;
+            created_by_agent?: string | undefined;
+            created_by_user?: string | undefined;
+            current_lease?: {
+                expires_at: string;
+                harness: string;
+                session_name: string;
+            } | null | undefined;
+            description?: string | undefined;
+            due_date?: string | undefined;
+            id: string;
+            is_blocked?: boolean | undefined;
+            links?: Record<string, unknown> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            name: string;
+            org?: string | undefined;
+            owner_actor?: {
+                alias?: string | undefined;
+                id?: string | undefined;
+                name?: string | undefined;
+                profile_picture?: {
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    mime_type?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+            } | undefined;
+            owner_agent?: string | undefined;
+            owner_user?: string | undefined;
+            parent?: string | undefined;
+            priority?: number | undefined;
+            sandbox?: string | undefined;
+            status: string;
+            subtasks_count?: number | undefined;
+            tags?: string[] | undefined;
+            team?: string | undefined;
+            thread?: string | undefined;
+            updated_at?: string | undefined;
+            user?: string | undefined;
+        }[];
+        has_more: boolean;
+        query: string;
+    }>;
+}
 export declare class TeamThreadResource {
     private http;
     constructor(http: HttpClient);
@@ -512,6 +907,7 @@ export declare class TeamThreadResource {
                 replies_before_cursor?: string | undefined;
                 reply_count?: number | undefined;
                 reply_to?: Record<string, unknown> | undefined;
+                root_message_id?: string | null | undefined;
                 sandbox?: string | undefined;
                 team?: string | undefined;
                 thread?: string | undefined;
@@ -774,11 +1170,38 @@ export declare class TeamThreadResource {
             visibility?: "team" | "restricted" | "private" | undefined;
         };
     }): Promise<Thread>;
+    /**
+     * Get threads-created count for a team
+     * Returns how many **network-public** team threads were created in the UTC-day
+     * window. Counts come from realtime SQL aggregation over append-only
+     * `network_activity_events` (`thread.created` rows co-committed with create):
+     * team- or restricted-visibility threads (plus legacy open-team rows), never
+     * private or mirror. Every Network member sees the same number. Hard-delete
+     * co-commits a separate `thread.deleted` transition event and does not remove
+     * create events (metric is "created", not "still present"). Visibility flips
+     * after insert are ignored in v1.
+     * Any authenticated team member may read this count-only Network summary.
+     * Requests from callers without team access return 404 so team existence is
+     * not disclosed.
+     * @param team - Team ID (`tem_...`) whose threads should be listed.
+     * @param params - Query parameters.
+     * @param params.days - UTC-day window. One of 7, 30, 90, or 365; defaults to 30.
+     * @returns Successful response
+     */
+    metrics(team: string, params?: {
+        days?: number;
+    }): Promise<{
+        days: number;
+        end_at: string;
+        opened: number;
+        start_at: string;
+    }>;
 }
 export declare class TeamResource {
     private http;
     readonly custom_objects: TeamCustomObjectResource;
     readonly members: MemberResource;
+    readonly tasks: TeamTaskResource;
     readonly threads: TeamThreadResource;
     constructor(http: HttpClient);
     /**
@@ -861,6 +1284,7 @@ export declare class TeamResource {
      * @param input - Request body.
      * @param input.acl - Access control configuration for the team. Controls who can discover and join the team.
      * @param input.description - Optional human-readable description of the team's purpose.
+     * @param input.idempotency_key - Optional retry key. Replays in the same app, organization, and sandbox return the original team.
      * @param input.metadata - Arbitrary key-value pairs you can attach to the team for your own use. Values must be strings.
      * @param input.name - Display name for the team.
      * @param input.org - Organization ID (`org_...`) to associate the team with. Omit to create the team without an org affiliation.
@@ -884,6 +1308,7 @@ export declare class TeamResource {
             }[] | undefined;
         } | undefined;
         description?: string | undefined;
+        idempotency_key?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
         name: string;
         org?: string | undefined;
@@ -1084,5 +1509,43 @@ export declare class TeamResource {
      * @returns Empty response — the principal has been removed from the team.
      */
     leave(team: string): Promise<void>;
+    /**
+     * List task assignees for a team
+     * Returns the list of principals — users and agents — that can be assigned
+     * to tasks within the team. Results include both human members and AI agents
+     * and are sorted alphabetically by display name.
+     * This endpoint is only available for team-scoped contexts. Calling it with a
+     * user-scoped owner returns a 400 error. The authenticated user must be a
+     * member of the team or hold org-admin access. App-scoped developer and
+     * server-to-server callers may list assignees for teams in their app so they
+     * can select the explicit user or agent actor required by privileged task
+     * mutations.
+     * @param team - Team ID (`tem_...`).
+     * @param params - Query parameters.
+     * @param params.org - Explicit organization (`org_...`) for developer and server-to-server calls. Pass null for a team outside an organization.
+     * @returns Successful response
+     */
+    taskAssignees(team: string, params?: {
+        org?: string;
+    }): Promise<{
+        data: {
+            actor: {
+                alias?: string | undefined;
+                id?: string | undefined;
+                name?: string | undefined;
+                profile_picture?: {
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    mime_type?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+            };
+            id: string;
+            type: "user" | "agent";
+        }[];
+    }>;
 }
 //# sourceMappingURL=teams.d.ts.map