@archastro/sdk 0.5.2 → 0.5.3

package/dist/v1/resources/threads.js

@@ -1,17 +1,52 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 8f2a76296776
+// Content hash: 631811b3d935
 export class ThreadMemberResource {
     http;
     constructor(http) {
         this.http = http;
     }
+    /**
+     * Remove a member from a thread
+     * Removes a user or agent membership from the specified thread. The authenticated
+     * user must have access to the thread. A successful removal returns HTTP 204 with
+     * no response body.
+     * Supply either `user` or `agent` depending on the value of `type`. Returns 404
+     * if the thread or the membership record does not exist.
+     * @param thread - Thread ID (`thr_...`) identifying the thread to remove the member from.
+     * @returns Empty response body. HTTP 204 on success.
+     */
     async remove(thread) {
         await this.http.request(`/api/v1/threads/${thread}/members`, { method: "DELETE" });
     }
+    /**
+     * List members of a thread
+     * Returns all current members of the specified thread, including both user and
+     * agent members. The authenticated user must have visibility into the thread;
+     * requests from users without access return 403.
+     * Results are returned as a flat array in the `data` field. The list is not
+     * paginated — all members are returned in a single response.
+     * @param thread - Thread ID (`thr_...`) identifying the thread to remove the member from.
+     * @returns Successful response
+     */
     async list(thread) {
         return this.http.request(`/api/v1/threads/${thread}/members`);
     }
+    /**
+     * Add a member to a thread
+     * Adds a user or agent as a member of the specified thread. The authenticated
+     * user must have access to the thread. On success the new membership record is
+     * returned with HTTP 201.
+     * Supply either `user` or `agent` depending on the value of `type`. Attempting
+     * to add a principal that is already a member of the thread returns a 422 error.
+     * @param thread - Thread ID (`thr_...`) identifying the thread to remove the member from.
+     * @param input - Request body.
+     * @param input.agent - Agent ID of the principal to add. Required when `type` is `"agent"`.
+     * @param input.membership_type - Role granted to the new member. One of `"owner"` or `"member"`. Defaults to `"member"`.
+     * @param input.type - Kind of principal being added. Must be `"user"` or `"agent"`.
+     * @param input.user - User ID of the principal to add. Required when `type` is `"user"`.
+     * @returns The newly created thread membership record.
+     */
     async create(thread, input) {
         return this.http.request(`/api/v1/threads/${thread}/members`, { method: "POST", body: input });
     }
@@ -21,9 +56,31 @@ export class SettingResource {
     constructor(http) {
         this.http = http;
     }
+    /**
+     * Retrieve thread settings
+     * Returns the current settings for the specified thread. Settings control
+     * per-thread behavior such as whether the AI agent is enabled.
+     * The authenticated user must own the thread or be a member of its workspace.
+     * If settings have never been explicitly configured, defaults are returned
+     * (for example, `agent_enabled` defaults to `true`).
+     * @param thread - Thread ID (`thr_...`). Must belong to the authenticated user's workspace.
+     * @returns Successful response
+     */
     async list(thread) {
         return this.http.request(`/api/v1/threads/${thread}/settings`);
     }
+    /**
+     * Update thread settings
+     * Updates the settings for the specified thread. Only fields included in
+     * the `settings` map are modified; omitted fields retain their current values.
+     * The authenticated user must own the thread or be a member of its workspace.
+     * Returns the full settings object reflecting the state after the update.
+     * Validation errors are returned as `422 Unprocessable Entity`.
+     * @param thread - Thread ID (`thr_...`). Must belong to the authenticated user's workspace.
+     * @param input - Request body.
+     * @param input.settings - Map of settings fields to update. Include only the keys you want to change.
+     * @returns The thread settings object after the update has been applied.
+     */
     async replace(thread, input) {
         return this.http.request(`/api/v1/threads/${thread}/settings`, { method: "PUT", body: input });
     }
@@ -37,35 +94,194 @@ export class ThreadResource {
         this.members = new ThreadMemberResource(http);
         this.settings = new SettingResource(http);
     }
+    /**
+     * Delete a thread
+     * Permanently deletes a thread and all of its messages and artifacts. This action
+     * cannot be undone.
+     * The authenticated user must own the thread or be an owner of the team the thread
+     * belongs to. Attempting to delete a thread owned by another user or team returns 403.
+     * @param thread - Thread ID (`thr_...`). The authenticated user must own this thread.
+     * @returns Empty response on successful deletion.
+     */
     async delete(thread) {
         await this.http.request(`/api/v1/threads/${thread}`, { method: "DELETE" });
     }
+    /**
+     * Retrieve a thread
+     * Returns the full thread record for the given thread ID. The authenticated user
+     * must own the thread or be a member of the workspace it belongs to.
+     * Use this endpoint to fetch the current state of a single thread, including its
+     * title, description, and metadata. To list many threads, use the list endpoint
+     * with cursor-based pagination.
+     * @param thread - Thread ID (`thr_...`). The authenticated user must have access to this thread.
+     * @returns The requested thread object.
+     */
     async get(thread) {
         return this.http.request(`/api/v1/threads/${thread}`);
     }
+    /**
+     * Update a thread
+     * Updates one or more mutable properties of the specified thread and returns
+     * the full thread object with the applied changes. Only the fields you provide
+     * are modified; omitted fields retain their current values.
+     * If `profile_picture` is supplied, the image is uploaded before the other
+     * fields are saved. Supplying invalid base64 picture data returns 422 and no
+     * other fields are updated.
+     * The authenticated user must own the thread or be a team owner of the workspace
+     * the thread belongs to.
+     * @param thread - Thread ID (`thr_...`). The authenticated user must have permission to update this thread.
+     * @param input - Request body.
+     * @param input.description - Optional longer text describing the thread's purpose. Replaces the existing description when provided.
+     * @param input.metadata - Arbitrary key-value metadata to store on the thread. Merged with or replaces existing metadata.
+     * @param input.muted - When `true`, suppresses notifications for new messages in this thread for the authenticated user.
+     * @param input.profile_picture - New profile picture for the thread. Provide all three inner fields to replace the existing image.
+     * @param input.title - Human-readable display name for the thread. Replaces the existing title when provided.
+     * @returns The thread object after the update has been applied.
+     */
     async replace(thread, input) {
         return this.http.request(`/api/v1/threads/${thread}`, { method: "PUT", body: input });
     }
+    /**
+     * List agents in a thread
+     * Returns the agents participating in the specified thread. Only personal user
+     * threads (threads owned by a single user, not a team) expose agents through
+     * this endpoint; requests for team threads return 404.
+     * The authenticated user must have visibility into the thread. Each agent entry
+     * includes display information such as name and profile picture. Thread-level
+     * overrides (e.g. a custom name or profile picture set for this thread) take
+     * precedence over the agent's default values. When the caller is the thread
+     * owner, each entry also includes an `agent_config` object describing the
+     * agent's message policy and context configuration.
+     * @param thread - Thread ID (`thr_...`). Must be a personal user thread visible to the authenticated user.
+     * @returns Successful response
+     */
     async agents(thread) {
         return this.http.request(`/api/v1/threads/${thread}/agents`);
     }
+    /**
+     * List artifacts for a thread
+     * Returns all artifacts produced during a thread's AI conversation. Artifacts are
+     * structured outputs such as code files, documents, or generated assets created
+     * by the AI agent in response to messages in the thread.
+     * The authenticated user must have access to the specified thread. Results are
+     * returned in a single page; there is no cursor-based pagination for this endpoint.
+     * @param thread - Thread ID (`thr_...`). Must be accessible to the authenticated user.
+     * @returns Successful response
+     */
     async artifacts(thread) {
         return this.http.request(`/api/v1/threads/${thread}/artifacts`);
     }
+    /**
+     * Mark a thread as read
+     * Records that a user has read up to a specific message in the thread. Unread
+     * indicators and badge counts are cleared up to the specified message.
+     * You must supply exactly one of `last_read_message` or `use_latest_message`.
+     * Omitting both returns 400. If `use_latest_message` is `true` and the thread
+     * has no messages, the request succeeds silently with no state change.
+     * For server-to-server (S2S) requests where no user identity is present in the
+     * token, the `user` param is required to identify whose read state to update.
+     * @param thread - Thread ID (`thr_...`). The thread to mark as read.
+     * @param input - Request body.
+     * @param input.last_read_message - Message ID (`msg_...`) to record as the last read message. Mutually exclusive with `use_latest_message`.
+     * @param input.use_latest_message - When `true`, marks the thread as read up to the latest message. Mutually exclusive with `last_read_message`.
+     * @param input.user - User ID (`usr_...`) whose read state to update. Required for S2S requests; ignored when an authenticated user is present in the token.
+     * @returns Empty response on success.
+     */
     async markRead(thread, input) {
         await this.http.request(`/api/v1/threads/${thread}/mark_read`, { method: "POST", body: input });
     }
+    /**
+     * List messages in a thread
+     * Returns a cursor-paginated list of messages belonging to the specified thread,
+     * ordered from oldest to newest. Supply `before_cursor` or `after_cursor` (not both)
+     * to page through the result set; omit both to receive the most recent page.
+     * The authenticated user must have access to the thread's owner (workspace or user).
+     * A 403 is returned if the thread exists but is not accessible to the caller; a 404
+     * is returned if the thread does not exist or is not visible to the authenticated user.
+     * Pass `include_reply_counts: true` to annotate each message with the number of
+     * threaded replies it has received. This adds a small amount of latency and should
+     * be omitted when reply counts are not needed.
+     * @param thread - Thread ID (`thr_...`). The authenticated user must have access to this thread.
+     * @param params - Query parameters.
+     * @param params.beforeCursor - Opaque cursor returned in a previous response's `before_cursor` field. When provided, returns the page of messages immediately before that position. Cannot be combined with `after_cursor`.
+     * @param params.afterCursor - Opaque cursor returned in a previous response's `after_cursor` field. When provided, returns the page of messages immediately after that position. Cannot be combined with `before_cursor`.
+     * @param params.limit - Maximum number of messages to return per page. Defaults to 20.
+     * @param params.includeReplyCounts - When `true`, each message in the response is annotated with its threaded reply count. Defaults to `false`. Adds latency; omit when reply counts are not needed.
+     * @returns Successful response
+     */
     async messages(thread, params) {
-        return this.http.request(`/api/v1/threads/${thread}/messages`, { query: params });
+        const query = {};
+        if (params?.beforeCursor !== undefined) {
+            query["before_cursor"] = params?.beforeCursor;
+        }
+        if (params?.afterCursor !== undefined) {
+            query["after_cursor"] = params?.afterCursor;
+        }
+        if (params?.limit !== undefined) {
+            query["limit"] = params?.limit;
+        }
+        if (params?.includeReplyCounts !== undefined) {
+            query["include_reply_counts"] = params?.includeReplyCounts;
+        }
+        return this.http.request(`/api/v1/threads/${thread}/messages`, { query });
     }
+    /**
+     * Update a thread's profile picture
+     * Uploads a new profile picture for the specified thread and returns the updated
+     * thread object. The image must be supplied as a base64-encoded string with its
+     * MIME type.
+     * The authenticated user must own the thread or be a team owner of the workspace
+     * the thread belongs to. Supplying invalid base64 data returns 422.
+     * @param thread - Thread ID (`thr_...`). The authenticated user must have permission to update this thread.
+     * @param input - Request body.
+     * @param input.picture - Profile picture payload. Must include the base64-encoded image data and its MIME type.
+     * @returns The thread object after the profile picture has been updated.
+     */
     async picture(thread, input) {
         return this.http.request(`/api/v1/threads/${thread}/picture`, { method: "PUT", body: input });
     }
+    /**
+     * Retrieve a thread's read status
+     * Returns the read status of a thread for the specified user, including the ID
+     * of the last message they have read and the number of unread messages remaining.
+     * For user-authenticated requests, the status is always returned for the
+     * authenticated user and the `user` parameter is ignored. For server-to-server
+     * (S2S) requests, the `user` parameter is required and must be a valid user ID.
+     * Returns 404 if the thread does not exist or the caller does not have access
+     * to it.
+     * @param thread - Thread ID (`thr_...`). Must be accessible to the authenticated user or, for S2S requests, to the specified user.
+     * @param params - Query parameters.
+     * @param params.user - User ID (`usr_...`) whose read status to retrieve. Required for S2S requests; ignored for user-authenticated requests, which always return the status for the authenticated user.
+     * @returns The read status record for the requested thread and user.
+     */
     async readStatus(thread, params) {
-        return this.http.request(`/api/v1/threads/${thread}/read_status`, { query: params });
+        const query = {};
+        if (params?.user !== undefined) {
+            query["user"] = params?.user;
+        }
+        return this.http.request(`/api/v1/threads/${thread}/read_status`, { query });
     }
+    /**
+     * Search context items within a thread
+     * Performs a full-text search over context items (messages, files, and other
+     * indexed sources) attached to the specified thread. Returns tagged objects
+     * whose content matches the query string.
+     * Use the `type` param to restrict results to a particular context source. All
+     * accessible context source types are searched when `type` is omitted. The
+     * authenticated user must have access to the thread.
+     * @param thread - Thread ID (`thr_...`). Must be accessible to the authenticated user.
+     * @param params - Query parameters.
+     * @param params.q - Full-text search query. Results are ranked by relevance to this string.
+     * @param params.type - Context source type to restrict the search to, e.g. `"thread/messages"`. Omit to search across all context sources for the thread.
+     * @returns Successful response
+     */
     async search(thread, params) {
-        return this.http.request(`/api/v1/threads/${thread}/search`, { query: params });
+        const query = {};
+        query["q"] = params?.q;
+        if (params?.type !== undefined) {
+            query["type"] = params?.type;
+        }
+        return this.http.request(`/api/v1/threads/${thread}/search`, { query });
     }
 }
 //# sourceMappingURL=threads.js.map

package/dist/v1/resources/threads.js.map

@@ -1 +1 @@
-{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../src/v1/resources/threads.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../src/v1/resources/threads.ts"],"names":[],"mappings":"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"}

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

@@ -1,47 +1,25 @@
 import { HttpClient } from "../../runtime/http-client.js";
-import type { Artifact } from "../../types/artifacts.js";
 import type { Thread } from "../../types/threads.js";
 import type { User, UserInvite } from "../../types/users.js";
-export declare class UserArtifactResource {
-    private http;
-    constructor(http: HttpClient);
-    list(user: string): Promise<{
-        data: {
-            agent?: string | undefined;
-            content_type?: string | undefined;
-            created_at?: string | undefined;
-            current_version?: string | undefined;
-            description?: string | undefined;
-            file?: string | undefined;
-            file_name?: string | undefined;
-            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;
-            } | undefined;
-            name?: string | undefined;
-            org?: string | undefined;
-            sandbox?: string | undefined;
-            team?: string | undefined;
-            thread?: string | undefined;
-            updated_at?: string | undefined;
-            user?: string | undefined;
-            version?: number | undefined;
-        }[];
-    }>;
-    create(user: string, input: {
-        artifact: Record<string, unknown>;
-    }): Promise<Artifact>;
-}
 export declare class UserThreadResource {
     private http;
     constructor(http: HttpClient);
+    /**
+     * List threads for a user
+     * Returns all threads visible to the specified user. The authenticated caller must
+     * have access to the target user's account; a 403 is returned otherwise.
+     * Pass one or more `agent` IDs to narrow results to threads where at least one of
+     * the listed agents is also a member — useful for displaying every thread a user
+     * shares with a particular agent. Pass one or more `filter` objects to narrow
+     * results by thread metadata key/value pairs. Both narrowings may be combined in
+     * a single request.
+     * Results are returned as a flat array; no cursor-based pagination is applied.
+     * @param user - User ID (`usr_...`) whose threads should be listed.
+     * @param params - Query parameters.
+     * @param params.agent - Array of agent user IDs (`usr_...`). When provided, only threads where at least one of the listed agents is also a member are returned. Omit or pass an empty array to return all threads regardless of agent membership.
+     * @param params.filter - Array of metadata filter objects. Each filter matches threads whose `metadata` map contains the specified key/value pair. All filters must match (logical AND). Omit to return threads regardless of metadata.
+     * @returns Successful response
+     */
     list(user: string, params?: {
         agent?: string[];
         filter?: {
@@ -55,12 +33,18 @@ export declare class UserThreadResource {
             created_at?: string | undefined;
             creator?: {
                 alias?: string | undefined;
+                app?: string | undefined;
+                app_name?: string | undefined;
                 email?: string | 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;
             id: string;
@@ -71,6 +55,7 @@ export declare class UserThreadResource {
             key?: string | undefined;
             last_activity?: string | undefined;
             metadata?: Record<string, unknown> | undefined;
+            muted?: boolean | undefined;
             org?: string | undefined;
             parent_message?: {
                 actors?: {
@@ -164,12 +149,18 @@ export declare class UserThreadResource {
             participant?: string[] | undefined;
             participants?: {
                 alias?: string | undefined;
+                app?: string | undefined;
+                app_name?: string | undefined;
                 email?: string | 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;
             participating_actor?: string[] | undefined;
             participating_agents?: {
@@ -195,12 +186,71 @@ export declare class UserThreadResource {
                 email?: string | undefined;
                 id: string;
                 identity?: string | undefined;
+                last_applied_template_config?: string | undefined;
                 lookup_key?: string | 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;
+                source_solution?: {
+                    solution: {
+                        category_keys?: string[] | undefined;
+                        created_at?: string | undefined;
+                        description?: string | undefined;
+                        id: string;
+                        kind: string;
+                        latest_solution?: string | undefined;
+                        latest_version?: string | undefined;
+                        lookup_key?: string | undefined;
+                        metadata?: Record<string, unknown> | undefined;
+                        name?: string | undefined;
+                        org?: string | 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;
+                        owners: string[];
+                        readme_url?: string | undefined;
+                        solution_id?: string | undefined;
+                        solution_version?: string | undefined;
+                        tag_keys?: string[] | undefined;
+                        template_kind?: string | undefined;
+                        templates: {
+                            description?: string | undefined;
+                            display_name?: string | undefined;
+                            id?: string | undefined;
+                            kind: string;
+                            lookup_key?: string | undefined;
+                            name?: string | undefined;
+                            readme_url?: string | undefined;
+                            virtual_path?: string | undefined;
+                        }[];
+                        updated_at?: string | undefined;
+                        upgrade_available: boolean;
+                        virtual_path?: string | undefined;
+                    };
+                    template: {
+                        created_at?: string | undefined;
+                        description?: string | undefined;
+                        display_name?: string | undefined;
+                        id: string;
+                        kind: string;
+                        lookup_key?: string | undefined;
+                        name?: string | undefined;
+                        updated_at?: string | undefined;
+                        virtual_path?: string | undefined;
+                    };
+                } | undefined;
                 team?: string | undefined;
                 updated_at?: string | undefined;
                 user?: string | undefined;
@@ -220,6 +270,19 @@ export declare class UserThreadResource {
             user?: string | undefined;
         }[];
     }>;
+    /**
+     * Create a thread for a user
+     * Creates a new thread owned by the specified user. The authenticated caller must
+     * have access to the target user's account; a 403 is returned otherwise.
+     * An automatic welcome message is sent into the thread upon creation unless
+     * `skip_welcome_message` is set to `true`. The thread is immediately visible to
+     * the owning user and any members added at creation time.
+     * @param user - User ID (`usr_...`) whose threads should be listed.
+     * @param input - Request body.
+     * @param input.skip_welcome_message - When `true`, suppresses the automatic welcome message that is otherwise sent into the thread on creation. Defaults to `false`.
+     * @param input.thread - Attributes for the new thread. See ThreadCreateParams for the full set of accepted fields.
+     * @returns The newly created thread object.
+     */
     create(user: string, input: {
         skip_welcome_message?: boolean | undefined;
         thread: {
@@ -228,6 +291,7 @@ export declare class UserThreadResource {
             is_unlisted?: boolean | undefined;
             key?: string | undefined;
             metadata?: Record<string, unknown> | undefined;
+            muted?: boolean | undefined;
             org_id?: string | undefined;
             profile_picture?: {
                 data?: string | undefined;
@@ -243,11 +307,94 @@ export declare class UserThreadResource {
 }
 export declare class UserResource {
     private http;
-    readonly artifacts: UserArtifactResource;
     readonly threads: UserThreadResource;
     constructor(http: HttpClient);
+    /**
+     * Retrieve the current user
+     * Returns the user associated with the authenticated session or bearer
+     * token. This is the canonical way to resolve "who am I?" after
+     * authentication.
+     * The response includes the user's profile, notification settings, and
+     * profile picture, along with the app, organization, and sandbox the
+     * token is scoped to and their display names — enough to establish full
+     * session context in a single call. Unauthenticated requests return 401.
+     * @returns The authenticated user object.
+     */
     me(): Promise<User>;
+    /**
+     * Retrieve a user by ID
+     * Returns the user identified by `user`. The authenticated user must share
+     * at least one team with the target user; requests for users outside any
+     * shared team are rejected with 403.
+     * A user may always retrieve their own profile with this endpoint. Use the
+     * `GET /users/me` endpoint as a convenience alias for retrieving the
+     * authenticated user without specifying an ID.
+     * @param user - User ID (`usr_...`) of the user to retrieve.
+     * @returns The requested user object.
+     */
     get(user: string): Promise<User>;
+    /**
+     * List a user's artifacts
+     * Returns all artifacts owned by the specified user. Artifacts represent
+     * AI-generated or user-uploaded files associated with agent sessions,
+     * threads, or sandboxes — such as images, documents, and code outputs.
+     * The authenticated user must be requesting their own artifacts or must
+     * have administrative access. Attempting to list artifacts for a user
+     * the caller is not authorized to access returns 403.
+     * Results are returned in a single page without cursor pagination. Each
+     * artifact in the response reflects the state of its current version,
+     * including a short-lived signed `file_url` for direct download.
+     * @param user - User ID (`usr_...`). The authenticated user must be this user or have access to their artifacts.
+     * @returns Successful response
+     */
+    artifacts(user: string): Promise<{
+        data: {
+            agent?: string | undefined;
+            content_type?: string | undefined;
+            created_at?: string | undefined;
+            current_version?: string | undefined;
+            description?: string | undefined;
+            file?: string | undefined;
+            file_name?: string | undefined;
+            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;
+            } | undefined;
+            name?: string | undefined;
+            org?: string | undefined;
+            sandbox?: string | undefined;
+            team?: string | undefined;
+            thread?: string | undefined;
+            updated_at?: string | undefined;
+            user?: string | undefined;
+            version?: number | undefined;
+        }[];
+    }>;
+    /**
+     * Create a user invite
+     * Creates a new invite for the authenticated user. The invite can optionally be
+     * scoped to a specific thread, a persona, or carry arbitrary metadata. The
+     * caller receives the new invite object at HTTP 201.
+     * The invite key is always generated server-side (192-bit URL-safe random
+     * string) and cannot be supplied by the caller.
+     * The path `:user` must match the authenticated user. If a `thread_id` is
+     * provided, the authenticated user must have permission to invite others to that
+     * thread; team threads are not supported and return an error. Supplying a
+     * `thread_id` that does not exist or that belongs to a different user returns
+     * an error. If a key collision occurs during creation the call returns a 409
+     * conflict — simply retry to generate a new key.
+     * @param user - User ID (`usr_...`). Must match the authenticated user.
+     * @param input - Request body.
+     * @param input.invite - Parameters for the new invite. See the UserInviteCreateParams schema for field details.
+     * @returns The newly created invite object.
+     */
     invites(user: string, input: {
         invite: {
             metadata?: Record<string, unknown> | undefined;
@@ -255,6 +402,16 @@ export declare class UserResource {
             thread_id?: string | undefined;
         };
     }): Promise<UserInvite>;
+    /**
+     * List organizations for a user
+     * Returns the organizations the specified user belongs to. A user can belong
+     * to at most one organization, so the `data` array contains either zero or one
+     * items.
+     * The authenticated viewer must have permission to inspect the target user.
+     * Returns an empty `data` array when the user has no organization membership.
+     * @param user - User ID (`usr_...`) whose organization membership you want to retrieve.
+     * @returns Successful response
+     */
     orgs(user: string): Promise<{
         data: {
             created_at?: string | undefined;
@@ -263,6 +420,7 @@ export declare class UserResource {
             id: string;
             industry?: string | undefined;
             name?: string | undefined;
+            onboarding_track?: string | undefined;
             sandbox?: string | undefined;
             slug?: string | undefined;
             status?: string | undefined;
@@ -270,6 +428,22 @@ export declare class UserResource {
             website?: string | undefined;
         }[];
     }>;
+    /**
+     * Update the current user's profile
+     * Updates one or more profile fields for the authenticated user. All
+     * fields are optional; omit any you do not want to change.
+     * When `profile_picture` is supplied, the image is uploaded and replaces
+     * the existing picture. The previous picture is deleted after the new one
+     * is stored. Image upload failures return 422 without modifying other
+     * profile fields.
+     * @param user - User ID (`usr_...`) or `"me"` for the authenticated user.
+     * @param input - Request body.
+     * @param input.alias - Short display alias shown in place of the full name in compact UI contexts.
+     * @param input.full_name - Updated display name for the user.
+     * @param input.metadata - Arbitrary key-value metadata to associate with the user. Existing keys are merged; pass `null` for a key to remove it.
+     * @param input.profile_picture - New profile picture to upload as a base64-encoded image. Replaces any existing picture.
+     * @returns The user object with updated profile fields.
+     */
     profile(user: string, input: {
         alias?: string | undefined;
         full_name?: string | undefined;