@archastro/sdk 0.13.0 → 0.15.0

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

@@ -2,7 +2,53 @@ 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";
+import type { User, UserInvite, UserSSHKey } from "../../types/users.js";
+export declare class UserSshKeyResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List registered SSH keys
+     * Returns a cursor-paginated page of SSH-key metadata for the authenticated user.
+     * @param user - User ID (`usr_...`) or `me`.
+     * @param params - Query parameters.
+     * @param params.limit - Maximum keys per page. Defaults to 50; maximum is 100.
+     * @param params.afterCursor - Opaque cursor for the next page of older keys.
+     * @returns Successful response
+     */
+    list(user: string, params?: {
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
+        data: {
+            algorithm: string;
+            created_at: string;
+            fingerprint: string;
+            id: string;
+            label: string;
+            revoked_at?: string | null | undefined;
+        }[];
+        has_more: boolean;
+    }>;
+    /**
+     * Register an SSH public key
+     * Registers one comment-free Ed25519 public key for Git-over-SSH. The key is
+     * encrypted before storage; responses expose only its label, algorithm and
+     * OpenSSH SHA-256 fingerprint.
+     * The caller must be the user named by `user` and must present a first-party
+     * session or a `full_access` personal access token.
+     * @param user - User ID (`usr_...`) or `me`.
+     * @param input - Request body.
+     * @param input.label - A label such as `Work laptop`.
+     * @param input.public_key - One `ssh-ed25519 <base64>` public key without options or a comment.
+     * @returns Metadata for the registered key; no key material.
+     */
+    create(user: string, input: {
+        label: string;
+        public_key: string;
+    }): Promise<UserSSHKey>;
+}
 export declare class UserTaskResource {
     private http;
     constructor(http: HttpClient);
@@ -26,6 +72,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`.
@@ -46,6 +96,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;
@@ -56,69 +110,74 @@ 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;
+            aggregate_version?: number | 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;
     }>;
@@ -145,6 +204,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;
@@ -152,6 +212,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;
@@ -183,66 +246,71 @@ export declare class UserTaskResource {
         before_cursor?: string | undefined;
         data: {
             tasks: {
-                agent?: string | undefined;
+                agent?: string | null | undefined;
+                aggregate_version?: number | 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;
@@ -259,6 +327,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
@@ -268,6 +340,10 @@ export declare class UserTaskResource {
         org?: string;
         explain?: boolean;
         assignedToMe?: boolean;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        epic?: string;
         limit?: number;
         afterCursor?: string;
     }): Promise<{
@@ -276,68 +352,73 @@ 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;
+                aggregate_version?: number | 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;
@@ -364,6 +445,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
@@ -379,72 +464,81 @@ 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;
+            aggregate_version?: number | 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;
@@ -480,38 +574,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;
-                org_slug?: 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?: {
@@ -528,116 +627,147 @@ 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 | null | undefined;
+                content?: string | null | undefined;
+                context?: {
+                    attributes?: Record<string, unknown> | undefined;
+                    content?: string | null | undefined;
+                    title?: string | null | undefined;
+                    type: string;
                 }[] | undefined;
-                branched_thread?: string | undefined;
-                content?: string | 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;
-                org_slug?: 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?: {
@@ -656,181 +786,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";
         }[];
     }>;
@@ -854,6 +984,7 @@ export declare class UserThreadResource {
             description?: string | undefined;
             is_unlisted?: boolean | undefined;
             key?: string | undefined;
+            kind?: "personal" | undefined;
             members?: {
                 id: string;
                 type: "user" | "agent";
@@ -867,7 +998,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;
@@ -891,12 +1022,17 @@ export declare class TokenResource {
     list(user: string): Promise<{
         data: {
             created_at?: string | undefined;
-            expires_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 | undefined;
-            name?: string | undefined;
-            revoked_at?: string | undefined;
-            scopes?: string | undefined;
+            last_used_at?: string | null | undefined;
+            name?: string | null | undefined;
+            revoked_at?: string | null | undefined;
+            scopes?: string | null | undefined;
             token?: string | undefined;
         }[];
     }>;
@@ -943,6 +1079,7 @@ export declare class TokenResource {
 }
 export declare class UserResource {
     private http;
+    readonly ssh_keys: UserSshKeyResource;
     readonly tasks: UserTaskResource;
     readonly threads: UserThreadResource;
     readonly tokens: TokenResource;
@@ -997,13 +1134,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;
@@ -1065,19 +1202,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;
         }[];
     }>;