@archastro/sdk 0.12.0 → 0.14.0

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

@@ -1,4 +1,5 @@
 import { HttpClient } from "../../runtime/http-client.js";
+import type { SystemAccessToken } from "../../types/system.js";
 import type { Task } from "../../types/tasks.js";
 import type { Thread } from "../../types/threads.js";
 import type { User, UserInvite } from "../../types/users.js";
@@ -25,6 +26,10 @@ export declare class UserTaskResource {
      * @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`.
@@ -45,6 +50,10 @@ export declare class UserTaskResource {
         priority?: number;
         tag?: string;
         parent?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
         search?: string;
         sort?: string;
         order?: string;
@@ -55,69 +64,73 @@ export declare class UserTaskResource {
         limit?: number;
         afterCursor?: string;
     }): Promise<{
-        after_cursor?: string | undefined;
-        before_cursor?: string | undefined;
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
         data: {
-            agent?: string | undefined;
+            agent?: string | null | undefined;
             blocked_by_count?: number | undefined;
-            closed_at?: string | undefined;
+            closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
             created_by_actor?: {
-                alias?: string | undefined;
-                id?: string | undefined;
-                name?: string | undefined;
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | 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;
+                    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 | undefined;
-            due_date?: string | undefined;
+            description?: string | null | undefined;
+            due_date?: string | null | undefined;
+            epic?: string | null | undefined;
             id: string;
             is_blocked?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
-            org?: string | undefined;
+            org?: string | null | undefined;
             owner_actor?: {
-                alias?: string | undefined;
-                id?: string | undefined;
-                name?: string | undefined;
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | 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;
+                    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;
-            sandbox?: string | undefined;
+            sandbox?: string | null | undefined;
+            source_id?: string | null | undefined;
+            source_scope?: string | null | undefined;
+            source_type?: string | null | undefined;
             status: string;
             subtasks_count?: number | undefined;
             tags?: string[] | undefined;
-            team?: string | undefined;
-            thread?: string | undefined;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
             updated_at?: string | undefined;
-            user?: string | undefined;
+            user?: string | null | undefined;
         }[];
         has_more: boolean;
     }>;
@@ -144,6 +157,7 @@ export declare class UserTaskResource {
         task: {
             description?: string | undefined;
             due_date?: string | undefined;
+            epic?: string | undefined;
             links?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
@@ -151,6 +165,9 @@ export declare class UserTaskResource {
             owner_user?: string | undefined;
             parent?: string | undefined;
             priority?: number | undefined;
+            source_id?: string | undefined;
+            source_scope?: string | undefined;
+            source_type?: string | undefined;
             status?: string | undefined;
             tags?: string[] | undefined;
             thread?: string | undefined;
@@ -182,66 +199,70 @@ export declare class UserTaskResource {
         before_cursor?: string | undefined;
         data: {
             tasks: {
-                agent?: string | undefined;
+                agent?: string | null | undefined;
                 blocked_by_count?: number | undefined;
-                closed_at?: string | undefined;
+                closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
                 created_by_actor?: {
-                    alias?: string | undefined;
-                    id?: string | undefined;
-                    name?: string | undefined;
+                    alias?: string | null | undefined;
+                    id?: string | null | undefined;
+                    name?: string | null | 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;
+                        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 | undefined;
-                due_date?: string | undefined;
+                description?: string | null | undefined;
+                due_date?: string | null | undefined;
+                epic?: string | null | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
-                org?: string | undefined;
+                org?: string | null | undefined;
                 owner_actor?: {
-                    alias?: string | undefined;
-                    id?: string | undefined;
-                    name?: string | undefined;
+                    alias?: string | null | undefined;
+                    id?: string | null | undefined;
+                    name?: string | null | 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;
+                        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;
-                sandbox?: string | undefined;
+                sandbox?: string | null | undefined;
+                source_id?: string | null | undefined;
+                source_scope?: string | null | undefined;
+                source_type?: string | null | undefined;
                 status: string;
                 subtasks_count?: number | undefined;
                 tags?: string[] | undefined;
-                team?: string | undefined;
-                thread?: string | undefined;
+                team?: string | null | undefined;
+                thread?: string | null | undefined;
                 updated_at?: string | undefined;
-                user?: string | undefined;
+                user?: string | null | undefined;
             }[];
         }[];
         has_more: boolean;
@@ -258,6 +279,10 @@ export declare class UserTaskResource {
      * @param params.org - Optional organization context for privileged callers.
      * @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
@@ -267,6 +292,10 @@ export declare class UserTaskResource {
         org?: string;
         explain?: boolean;
         assignedToMe?: boolean;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
         limit?: number;
         afterCursor?: string;
     }): Promise<{
@@ -275,68 +304,72 @@ export declare class UserTaskResource {
         before_cursor?: string | undefined;
         data: {
             readiness: "ready" | "blocked" | "leased";
-            reason?: "open_blockers" | "active_lease" | undefined;
+            reason?: "open_blockers" | "active_lease" | null | undefined;
             task: {
-                agent?: string | undefined;
+                agent?: string | null | undefined;
                 blocked_by_count?: number | undefined;
-                closed_at?: string | undefined;
+                closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
                 created_by_actor?: {
-                    alias?: string | undefined;
-                    id?: string | undefined;
-                    name?: string | undefined;
+                    alias?: string | null | undefined;
+                    id?: string | null | undefined;
+                    name?: string | null | 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;
+                        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 | undefined;
-                due_date?: string | undefined;
+                description?: string | null | undefined;
+                due_date?: string | null | undefined;
+                epic?: string | null | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
-                org?: string | undefined;
+                org?: string | null | undefined;
                 owner_actor?: {
-                    alias?: string | undefined;
-                    id?: string | undefined;
-                    name?: string | undefined;
+                    alias?: string | null | undefined;
+                    id?: string | null | undefined;
+                    name?: string | null | 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;
+                        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;
-                sandbox?: string | undefined;
+                sandbox?: string | null | undefined;
+                source_id?: string | null | undefined;
+                source_scope?: string | null | undefined;
+                source_type?: string | null | undefined;
                 status: string;
                 subtasks_count?: number | undefined;
                 tags?: string[] | undefined;
-                team?: string | undefined;
-                thread?: string | undefined;
+                team?: string | null | undefined;
+                thread?: string | null | undefined;
                 updated_at?: string | undefined;
-                user?: string | undefined;
+                user?: string | null | undefined;
             };
         }[];
         has_more: boolean;
@@ -363,6 +396,10 @@ export declare class UserTaskResource {
      * @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.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.
+     * @param params.sourceId - Return only tasks whose source matches this object identity.
+     * @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
@@ -378,72 +415,80 @@ export declare class UserTaskResource {
         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 | undefined;
+            agent?: string | null | undefined;
             blocked_by_count?: number | undefined;
-            closed_at?: string | undefined;
+            closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
             created_by_actor?: {
-                alias?: string | undefined;
-                id?: string | undefined;
-                name?: string | undefined;
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | 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;
+                    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 | undefined;
-            due_date?: string | undefined;
+            description?: string | null | undefined;
+            due_date?: string | null | undefined;
+            epic?: string | null | undefined;
             id: string;
             is_blocked?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
-            org?: string | undefined;
+            org?: string | null | undefined;
             owner_actor?: {
-                alias?: string | undefined;
-                id?: string | undefined;
-                name?: string | undefined;
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | 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;
+                    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;
-            sandbox?: string | undefined;
+            sandbox?: string | null | undefined;
+            source_id?: string | null | undefined;
+            source_scope?: string | null | undefined;
+            source_type?: string | null | undefined;
             status: string;
             subtasks_count?: number | undefined;
             tags?: string[] | undefined;
-            team?: string | undefined;
-            thread?: string | undefined;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
             updated_at?: string | undefined;
-            user?: string | undefined;
+            user?: string | null | undefined;
         }[];
         has_more: boolean;
         query: string;
@@ -479,37 +524,43 @@ export declare class UserThreadResource {
         }[];
     }): Promise<{
         data: {
-            agent_user?: string | undefined;
+            agent_user?: string | null | undefined;
             created_at?: string | undefined;
             creator?: string | {
-                alias?: string | undefined;
-                app?: string | undefined;
-                app_name?: string | undefined;
-                email?: string | undefined;
+                alias?: string | null | undefined;
+                app?: string | null | undefined;
+                app_name?: string | null | undefined;
+                created_by_agent_user?: string | null | undefined;
+                created_by_developer?: string | null | undefined;
+                created_by_org?: string | null | undefined;
+                created_by_team?: string | null | undefined;
+                created_by_user?: string | null | undefined;
+                email?: string | null | undefined;
                 id: string;
                 is_system_user?: boolean | undefined;
                 metadata?: Record<string, unknown> | undefined;
-                name?: string | undefined;
-                org?: string | undefined;
-                org_name?: string | undefined;
-                org_role?: string | undefined;
-                sandbox?: string | undefined;
-                sandbox_name?: string | undefined;
-            } | undefined;
-            description?: string | undefined;
+                name?: string | null | undefined;
+                org?: string | null | undefined;
+                org_name?: string | null | undefined;
+                org_role?: string | null | undefined;
+                org_slug?: string | null | undefined;
+                sandbox?: string | null | undefined;
+                sandbox_name?: string | null | undefined;
+            } | null | undefined;
+            description?: string | null | undefined;
             id: string;
             is_channel?: boolean | undefined;
             is_default?: boolean | undefined;
             is_transient?: boolean | undefined;
             is_unlisted?: boolean | undefined;
-            key?: string | undefined;
-            kind?: string | undefined;
-            last_activity?: string | undefined;
-            last_message_preview?: string | undefined;
-            last_message_sender?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
+            key?: string | null | undefined;
+            kind?: string | null | undefined;
+            last_activity?: string | null | undefined;
+            last_message_preview?: string | null | undefined;
+            last_message_sender?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
             muted?: boolean | undefined;
-            org?: string | undefined;
+            org?: string | null | undefined;
             parent_message?: {
                 acl?: {
                     add?: {
@@ -526,115 +577,141 @@ export declare class UserThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
-                } | undefined;
+                } | null | undefined;
                 actors?: {
-                    alias?: string | undefined;
-                    id?: string | undefined;
-                    name?: string | undefined;
+                    alias?: string | null | undefined;
+                    id?: string | null | undefined;
+                    name?: string | null | 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;
+                        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;
                 }[] | undefined;
-                agent?: string | undefined;
-                agent_mode?: "cli" | "embedded" | undefined;
+                agent?: string | null | undefined;
+                agent_mode?: "cli" | "embedded" | null | undefined;
                 attachments?: {
-                    content_type?: string | undefined;
-                    description?: string | undefined;
-                    filename?: string | undefined;
-                    height?: number | undefined;
+                    content_type?: string | null | undefined;
+                    description?: string | null | undefined;
+                    filename?: string | null | undefined;
+                    height?: number | null | undefined;
                     id: string;
-                    image_height?: number | undefined;
+                    image_height?: number | null | undefined;
                     image_source?: {
-                        file?: string | undefined;
-                        height?: number | undefined;
-                        media?: string | undefined;
-                        mime_type?: string | undefined;
-                        refresh_url?: string | undefined;
-                        url?: string | undefined;
-                        width?: number | undefined;
-                    } | undefined;
-                    image_url?: string | undefined;
-                    image_width?: number | undefined;
+                        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;
+                    image_url?: string | null | undefined;
+                    image_width?: number | null | undefined;
                     media_type?: string | undefined;
-                    name?: string | undefined;
+                    name?: string | null | undefined;
                     object?: Record<string, unknown> | undefined;
-                    title?: string | undefined;
+                    title?: string | null | undefined;
                     type: string;
-                    url?: string | undefined;
+                    url?: string | null | undefined;
                     variants?: {
-                        content_type?: string | undefined;
+                        content_type?: string | null | undefined;
                         created_at?: string | undefined;
                         file?: string | undefined;
-                        filename?: string | undefined;
-                        height?: number | undefined;
+                        filename?: string | null | undefined;
+                        height?: number | null | undefined;
                         id: string;
                         image_source?: {
-                            file?: string | undefined;
-                            height?: number | undefined;
-                            media?: string | undefined;
-                            mime_type?: string | undefined;
-                            refresh_url?: string | undefined;
-                            url?: string | undefined;
-                            width?: number | undefined;
-                        } | undefined;
+                            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;
                         updated_at?: string | undefined;
-                        url?: string | undefined;
+                        url?: string | null | undefined;
                         variant_key?: string | undefined;
-                        width?: number | undefined;
+                        width?: number | null | undefined;
                     }[] | undefined;
-                    version?: number | undefined;
-                    width?: number | undefined;
+                    version?: number | null | undefined;
+                    width?: number | null | undefined;
                 }[] | undefined;
-                branched_thread?: string | undefined;
-                content?: string | undefined;
+                branched_thread?: string | null | undefined;
+                content?: string | null | undefined;
                 created_at?: string | undefined;
                 has_replies?: boolean | undefined;
                 id: string;
-                idempotency_key?: string | undefined;
+                idempotency_key?: string | null | undefined;
                 is_deleted?: boolean | undefined;
-                legacy_agent?: string | undefined;
+                legacy_agent?: string | null | undefined;
                 metadata?: Record<string, unknown> | undefined;
-                org?: string | undefined;
+                org?: string | null | undefined;
                 reactions?: {
                     payload?: Record<string, unknown> | undefined;
                     type: string;
                     user?: string | undefined;
                 }[] | undefined;
-                rendering_mode?: string | undefined;
+                rendering_mode?: string | null | undefined;
                 replies?: Record<string, unknown>[] | undefined;
-                replies_after_cursor?: string | undefined;
-                replies_before_cursor?: string | undefined;
+                replies_after_cursor?: string | null | undefined;
+                replies_before_cursor?: string | null | undefined;
                 reply_count?: number | undefined;
-                reply_to?: Record<string, unknown> | undefined;
+                reply_to?: Record<string, unknown> | null | undefined;
                 root_message_id?: string | null | undefined;
-                sandbox?: string | undefined;
-                team?: string | undefined;
+                sandbox?: string | null | undefined;
+                team?: string | null | undefined;
                 thread?: string | undefined;
-                type?: string | undefined;
-                user?: string | undefined;
+                type?: string | null | undefined;
+                user?: string | {
+                    alias?: string | null | undefined;
+                    app?: string | null | undefined;
+                    app_name?: string | null | undefined;
+                    created_by_agent_user?: string | null | undefined;
+                    created_by_developer?: string | null | undefined;
+                    created_by_org?: string | null | undefined;
+                    created_by_team?: string | null | undefined;
+                    created_by_user?: string | null | undefined;
+                    email?: string | null | undefined;
+                    id: string;
+                    is_system_user?: boolean | undefined;
+                    metadata?: Record<string, unknown> | undefined;
+                    name?: string | null | undefined;
+                    org?: string | null | undefined;
+                    org_name?: string | null | undefined;
+                    org_role?: string | null | undefined;
+                    org_slug?: string | null | undefined;
+                    sandbox?: string | null | undefined;
+                    sandbox_name?: string | null | undefined;
+                } | null | undefined;
                 visibility?: "default" | "private" | undefined;
-            } | undefined;
+            } | null | undefined;
             participant?: string[] | undefined;
             participants?: {
-                alias?: string | undefined;
-                app?: string | undefined;
-                app_name?: string | undefined;
-                email?: string | undefined;
+                alias?: string | null | undefined;
+                app?: string | null | undefined;
+                app_name?: string | null | undefined;
+                created_by_agent_user?: string | null | undefined;
+                created_by_developer?: string | null | undefined;
+                created_by_org?: string | null | undefined;
+                created_by_team?: string | null | undefined;
+                created_by_user?: string | null | undefined;
+                email?: string | null | undefined;
                 id: string;
                 is_system_user?: boolean | undefined;
                 metadata?: Record<string, unknown> | undefined;
-                name?: string | undefined;
-                org?: string | undefined;
-                org_name?: string | undefined;
-                org_role?: string | undefined;
-                sandbox?: string | undefined;
-                sandbox_name?: string | undefined;
+                name?: string | null | undefined;
+                org?: string | null | undefined;
+                org_name?: string | null | undefined;
+                org_role?: string | null | undefined;
+                org_slug?: string | null | undefined;
+                sandbox?: string | null | undefined;
+                sandbox_name?: string | null | undefined;
             }[] | undefined;
             participating_actor?: string[] | undefined;
             participating_agents?: {
@@ -653,181 +730,181 @@ export declare class UserThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
-                } | undefined;
+                } | null | undefined;
                 app?: string | undefined;
                 created_at?: string | undefined;
-                default_model?: string | undefined;
-                description?: string | undefined;
-                email?: string | undefined;
+                default_model?: string | null | undefined;
+                description?: string | null | undefined;
+                email?: string | null | undefined;
                 id: string;
-                identity?: string | undefined;
-                last_applied_template_config?: string | undefined;
-                lookup_key?: string | undefined;
+                identity?: string | null | undefined;
+                last_applied_template_config?: string | null | undefined;
+                lookup_key?: string | null | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name?: string | undefined;
-                org?: string | undefined;
-                org_name?: string | undefined;
-                originator?: string | undefined;
-                phone_number?: string | undefined;
-                sandbox?: string | undefined;
+                org?: string | null | undefined;
+                org_name?: string | null | undefined;
+                originator?: string | null | undefined;
+                phone_number?: string | null | undefined;
+                sandbox?: string | null | undefined;
                 source_solution?: {
                     current_solution?: {
                         category_keys?: string[] | undefined;
                         created_at?: string | undefined;
-                        description?: string | undefined;
+                        description?: string | null | undefined;
                         events?: Record<string, unknown> | undefined;
                         id: string;
-                        image_url?: string | undefined;
+                        image_url?: string | null | undefined;
                         kind: string;
-                        latest_solution?: string | undefined;
-                        latest_version?: string | undefined;
-                        lookup_key?: string | undefined;
+                        latest_solution?: string | null | undefined;
+                        latest_version?: string | null | undefined;
+                        lookup_key?: string | null | undefined;
                         metadata?: Record<string, unknown> | undefined;
-                        name?: string | undefined;
-                        org?: string | undefined;
+                        name?: string | null | undefined;
+                        org?: string | null | undefined;
                         org_logo?: {
-                            file?: string | undefined;
-                            height?: number | undefined;
-                            media?: string | undefined;
-                            mime_type?: string | undefined;
-                            refresh_url?: string | undefined;
-                            url?: string | undefined;
-                            width?: number | undefined;
-                        } | undefined;
-                        org_name?: string | undefined;
-                        org_slug?: string | undefined;
+                            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;
+                        org_name?: string | null | undefined;
+                        org_slug?: string | null | undefined;
                         owners: string[];
-                        readme_url?: string | undefined;
+                        readme_url?: string | null | undefined;
                         screenshot_urls?: string[] | undefined;
-                        solution_id?: string | undefined;
-                        solution_version?: string | undefined;
+                        solution_id?: string | null | undefined;
+                        solution_version?: string | null | undefined;
                         tag_keys?: string[] | undefined;
-                        template_kind?: string | undefined;
+                        template_kind?: string | null | undefined;
                         templates: {
-                            description?: string | undefined;
+                            description?: string | null | undefined;
                             details?: {
-                                automation_type?: string | undefined;
+                                automation_type?: string | null | undefined;
                                 invoke_contract?: {
-                                    input_schema?: Record<string, unknown> | undefined;
+                                    input_schema?: Record<string, unknown> | null | undefined;
                                     participants?: {
-                                        description?: string | undefined;
+                                        description?: string | null | undefined;
                                         name: string;
                                         required: boolean;
                                         type: string;
-                                    }[] | undefined;
+                                    }[] | null | undefined;
                                     prefills: {
                                         participants?: Record<string, unknown> | undefined;
                                         payload?: Record<string, unknown> | undefined;
                                     };
-                                } | undefined;
+                                } | null | undefined;
                                 type: "automation";
-                            } | undefined;
-                            display_name?: string | undefined;
-                            id?: string | undefined;
+                            } | null | undefined;
+                            display_name?: string | null | undefined;
+                            id?: string | null | undefined;
                             kind: string;
-                            lookup_key?: string | undefined;
-                            name?: string | undefined;
-                            readme_url?: string | undefined;
-                            virtual_path?: string | undefined;
+                            lookup_key?: string | null | undefined;
+                            name?: string | null | undefined;
+                            readme_url?: string | null | undefined;
+                            virtual_path?: string | null | undefined;
                         }[];
                         updated_at?: string | undefined;
                         upgrade_available: boolean;
-                        virtual_path?: string | undefined;
+                        virtual_path?: string | null | undefined;
                     } | undefined;
                     solution: {
                         category_keys?: string[] | undefined;
                         created_at?: string | undefined;
-                        description?: string | undefined;
+                        description?: string | null | undefined;
                         events?: Record<string, unknown> | undefined;
                         id: string;
-                        image_url?: string | undefined;
+                        image_url?: string | null | undefined;
                         kind: string;
-                        latest_solution?: string | undefined;
-                        latest_version?: string | undefined;
-                        lookup_key?: string | undefined;
+                        latest_solution?: string | null | undefined;
+                        latest_version?: string | null | undefined;
+                        lookup_key?: string | null | undefined;
                         metadata?: Record<string, unknown> | undefined;
-                        name?: string | undefined;
-                        org?: string | undefined;
+                        name?: string | null | undefined;
+                        org?: string | null | undefined;
                         org_logo?: {
-                            file?: string | undefined;
-                            height?: number | undefined;
-                            media?: string | undefined;
-                            mime_type?: string | undefined;
-                            refresh_url?: string | undefined;
-                            url?: string | undefined;
-                            width?: number | undefined;
-                        } | undefined;
-                        org_name?: string | undefined;
-                        org_slug?: string | undefined;
+                            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;
+                        org_name?: string | null | undefined;
+                        org_slug?: string | null | undefined;
                         owners: string[];
-                        readme_url?: string | undefined;
+                        readme_url?: string | null | undefined;
                         screenshot_urls?: string[] | undefined;
-                        solution_id?: string | undefined;
-                        solution_version?: string | undefined;
+                        solution_id?: string | null | undefined;
+                        solution_version?: string | null | undefined;
                         tag_keys?: string[] | undefined;
-                        template_kind?: string | undefined;
+                        template_kind?: string | null | undefined;
                         templates: {
-                            description?: string | undefined;
+                            description?: string | null | undefined;
                             details?: {
-                                automation_type?: string | undefined;
+                                automation_type?: string | null | undefined;
                                 invoke_contract?: {
-                                    input_schema?: Record<string, unknown> | undefined;
+                                    input_schema?: Record<string, unknown> | null | undefined;
                                     participants?: {
-                                        description?: string | undefined;
+                                        description?: string | null | undefined;
                                         name: string;
                                         required: boolean;
                                         type: string;
-                                    }[] | undefined;
+                                    }[] | null | undefined;
                                     prefills: {
                                         participants?: Record<string, unknown> | undefined;
                                         payload?: Record<string, unknown> | undefined;
                                     };
-                                } | undefined;
+                                } | null | undefined;
                                 type: "automation";
-                            } | undefined;
-                            display_name?: string | undefined;
-                            id?: string | undefined;
+                            } | null | undefined;
+                            display_name?: string | null | undefined;
+                            id?: string | null | undefined;
                             kind: string;
-                            lookup_key?: string | undefined;
-                            name?: string | undefined;
-                            readme_url?: string | undefined;
-                            virtual_path?: string | undefined;
+                            lookup_key?: string | null | undefined;
+                            name?: string | null | undefined;
+                            readme_url?: string | null | undefined;
+                            virtual_path?: string | null | undefined;
                         }[];
                         updated_at?: string | undefined;
                         upgrade_available: boolean;
-                        virtual_path?: string | undefined;
+                        virtual_path?: string | null | undefined;
                     };
                     template: {
                         created_at?: string | undefined;
-                        description?: string | undefined;
-                        display_name?: string | undefined;
+                        description?: string | null | undefined;
+                        display_name?: string | null | undefined;
                         id: string;
                         kind: string;
-                        lookup_key?: string | undefined;
-                        name?: string | undefined;
+                        lookup_key?: string | null | undefined;
+                        name?: string | null | undefined;
                         updated_at?: string | undefined;
-                        virtual_path?: string | undefined;
+                        virtual_path?: string | null | undefined;
                     };
-                } | undefined;
-                team?: string | undefined;
-                template_upgrade_available?: boolean | undefined;
+                } | null | undefined;
+                team?: string | null | undefined;
+                template_upgrade_available?: boolean | null | undefined;
                 updated_at?: string | undefined;
-                user?: string | undefined;
-            }[] | undefined;
-            role?: string | undefined;
-            sandbox?: string | undefined;
+                user?: string | null | undefined;
+            }[] | null | undefined;
+            role?: string | null | undefined;
+            sandbox?: string | null | undefined;
             settings?: {
-                agent_enabled?: boolean | undefined;
+                agent_enabled?: boolean | null | undefined;
             } | undefined;
-            slug?: string | undefined;
-            sub_threads?: Record<string, unknown>[] | undefined;
+            slug?: string | null | undefined;
+            sub_threads?: Record<string, unknown>[] | null | undefined;
             tags?: string[] | undefined;
-            team?: string | undefined;
-            title?: string | undefined;
-            ttl?: number | undefined;
-            unread_count?: number | undefined;
+            team?: string | null | undefined;
+            title?: string | null | undefined;
+            ttl?: string | null | undefined;
+            unread_count?: number | null | undefined;
             updated_at?: string | undefined;
-            user?: string | undefined;
+            user?: string | null | undefined;
             visibility: "team" | "restricted" | "private";
         }[];
     }>;
@@ -851,6 +928,7 @@ export declare class UserThreadResource {
             description?: string | undefined;
             is_unlisted?: boolean | undefined;
             key?: string | undefined;
+            kind?: "personal" | undefined;
             members?: {
                 id: string;
                 type: "user" | "agent";
@@ -864,7 +942,7 @@ export declare class UserThreadResource {
                 mime_type?: string | undefined;
             } | undefined;
             settings?: {
-                agent_enabled?: boolean | undefined;
+                agent_enabled?: boolean | null | undefined;
             } | undefined;
             slug?: string | undefined;
             title?: string | undefined;
@@ -872,10 +950,82 @@ export declare class UserThreadResource {
         };
     }): Promise<Thread>;
 }
+export declare class TokenResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List personal access tokens
+     * Returns all access tokens associated with the authenticated user, including
+     * active and revoked tokens. Tokens are returned without their raw JWT values
+     * — the plaintext JWT is only available at creation time.
+     * The caller must be the user identified by `user` and must present a
+     * first-party session (or a `full_access` access token).
+     * @param user - User ID (`usr_...`) or `me` for the authenticated user.
+     * @returns Successful response
+     */
+    list(user: string): Promise<{
+        data: {
+            created_at?: string | undefined;
+            created_by_agent_user?: string | null | undefined;
+            created_by_developer?: string | null | undefined;
+            created_by_org?: string | null | undefined;
+            created_by_team?: string | null | undefined;
+            created_by_user?: string | null | undefined;
+            expires_at?: string | null | undefined;
+            id: string;
+            last_used_at?: string | null | undefined;
+            name?: string | null | undefined;
+            revoked_at?: string | null | undefined;
+            scopes?: string | null | undefined;
+            token?: string | undefined;
+        }[];
+    }>;
+    /**
+     * Create a personal access token
+     * Issues a new long-lived access token for the authenticated user. The raw
+     * JWT is returned in the `token` field of the response exactly once and
+     * cannot be retrieved again — store it securely immediately after creation.
+     * `scopes` is optional. When omitted the token receives `full_access`.
+     * Known catalog scopes (for example `profile`) restrict the token through
+     * the same `ScopeGuard` used by OAuth.
+     * `expires_in_days` is optional and must be one of `7`, `30`, `60`, `90`,
+     * or `365`. When omitted the token lasts 30 days. Each user may hold at
+     * most 50 active tokens; exceeding that limit returns 429.
+     * The caller must be the user identified by `user` and must present a
+     * first-party session (or a `full_access` access token). A restricted
+     * access token cannot mint another token.
+     * @param user - User ID (`usr_...`) or `me` for the authenticated user.
+     * @param input - Request body.
+     * @param input.expires_in_days - Lifetime in days. One of `7`, `30`, `60`, `90`, or `365`. Defaults to `30`.
+     * @param input.name - Human-readable label for the token (e.g. `"Codex MCP"`). Stored as metadata only.
+     * @param input.scopes - Optional OAuth scopes to stamp on the token. Omit for `full_access`.
+     * @returns The newly created access token. The `token` field contains the raw JWT and is present only in this response — it is not stored and cannot be retrieved later.
+     */
+    create(user: string, input: {
+        expires_in_days?: number | undefined;
+        name?: string | undefined;
+        scopes?: string[] | undefined;
+    }): Promise<SystemAccessToken>;
+    /**
+     * Revoke a personal access token
+     * Permanently revokes the specified access token belonging to the
+     * authenticated user. Once revoked, the token is immediately rejected by
+     * all API endpoints and cannot be reinstated. The token record is retained
+     * and returned in the response with `revoked_at` populated.
+     * The caller must be the user identified by `user` and must present a
+     * first-party session (or a `full_access` access token). Returns 404 if
+     * the token does not exist or does not belong to the caller.
+     * @param user - User ID (`usr_...`) or `me` for the authenticated user.
+     * @param token - Access token ID (`sat_...`). Must belong to the authenticated user.
+     * @returns The revoked access token. The `revoked_at` field is populated with the time of revocation.
+     */
+    delete(user: string, token: string): Promise<SystemAccessToken>;
+}
 export declare class UserResource {
     private http;
     readonly tasks: UserTaskResource;
     readonly threads: UserThreadResource;
+    readonly tokens: TokenResource;
     constructor(http: HttpClient);
     /**
      * Retrieve the current user
@@ -927,13 +1077,13 @@ export declare class UserResource {
             file_url?: string | undefined;
             id: string;
             image_source?: {
-                file?: string | undefined;
-                height?: number | undefined;
-                media?: string | undefined;
-                mime_type?: string | undefined;
-                refresh_url?: string | undefined;
-                url?: string | undefined;
-                width?: number | undefined;
+                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;
             } | undefined;
             name?: string | undefined;
             org?: string | undefined;
@@ -995,19 +1145,6 @@ export declare class UserResource {
             slug?: string | undefined;
             status?: string | undefined;
             updated_at?: string | undefined;
-            vendor?: {
-                id: string;
-                logo?: {
-                    file?: string | undefined;
-                    height?: number | undefined;
-                    media?: string | undefined;
-                    mime_type?: string | undefined;
-                    refresh_url?: string | undefined;
-                    url?: string | undefined;
-                    width?: number | undefined;
-                } | undefined;
-                name?: string | undefined;
-            } | undefined;
             website?: string | undefined;
         }[];
     }>;