@archastro/sdk 0.5.2 → 0.5.3

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

@@ -1,54 +1,40 @@
 import { HttpClient } from "../../runtime/http-client.js";
-import type { Artifact } from "../../types/artifacts.js";
 import type { CustomObject } from "../../types/common.js";
 import type { Team, TeamInvite, TeamMembership } from "../../types/teams.js";
 import type { Thread } from "../../types/threads.js";
-export declare class TeamArtifactResource {
-    private http;
-    constructor(http: HttpClient);
-    list(team: 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(team: string, input: {
-        artifact: Record<string, unknown>;
-    }): Promise<Artifact>;
-}
 export declare class TeamCustomObjectResource {
     private http;
     constructor(http: HttpClient);
+    /**
+     * List a team's custom objects
+     * Returns a paginated list of custom objects owned by the specified team,
+     * filtered to a single schema type. Results are ordered by creation time
+     * descending unless `query` is provided, in which case they are ordered by
+     * full-text relevance score descending.
+     * Use `limit` and `offset` for page-based pagination. Use `row_key` or
+     * `sort_key` to narrow results to objects matching those index values.
+     * Full-text search via `query` operates only against the fields configured
+     * as `search_fields` on the schema.
+     * The authenticated user must be a member of the team with sufficient
+     * access. Returns 404 if the team is not found, the caller lacks access,
+     * or `type` does not match a registered schema for the team's organization.
+     * @param team - Team ID (`team_...`). Scopes results to objects owned by this team.
+     * @param params - Query parameters.
+     * @param params.type - Schema type identifier (`lookup_key`) that filters results to objects of this schema.
+     * @param params.limit - Maximum number of objects to return per page.
+     * @param params.offset - Number of objects to skip before returning results. Use with `limit` for page-based pagination.
+     * @param params.rowKey - Filter results to objects whose `row_key` exactly matches this value.
+     * @param params.sortKey - Filter results to objects whose `sort_key` exactly matches this value.
+     * @param params.query - Full-text search string matched against the schema's configured `search_fields`. When provided, results are ordered by relevance score descending instead of creation time descending.
+     * @returns Successful response
+     */
     list(team: string, params?: {
         type?: string;
         limit?: number;
         offset?: number;
         rowKey?: string;
         sortKey?: string;
+        query?: string;
     }): Promise<{
         data: {
             created_at?: string | undefined;
@@ -65,6 +51,22 @@ export declare class TeamCustomObjectResource {
         }[];
         meta?: Record<string, unknown> | undefined;
     }>;
+    /**
+     * Create a team custom object
+     * Creates a new custom object owned by the specified team. The object is
+     * instantiated against the schema identified by `type` (the schema's
+     * `lookup_key`). All field values are validated against that schema's
+     * field definitions before the object is persisted.
+     * The authenticated user must be a member of the team with sufficient
+     * access. If the team is not found or the caller lacks access, the endpoint
+     * returns 404. If `type` does not match a registered schema for the team's
+     * organization, the endpoint also returns 404.
+     * @param team - Team ID (`team_...`). Scopes results to objects owned by this team.
+     * @param input - Request body.
+     * @param input.fields - Map of field values to set on the new object. Keys and value types must conform to the schema identified by `type`.
+     * @param input.type - Schema type identifier (`lookup_key`) that defines the object's fields and validation rules.
+     * @returns The newly created custom object.
+     */
     create(team: string, input: {
         fields: Record<string, unknown>;
         type: string;
@@ -73,6 +75,32 @@ export declare class TeamCustomObjectResource {
 export declare class MemberResource {
     private http;
     constructor(http: HttpClient);
+    /**
+     * Remove a member or org from a team
+     * Removes a user, agent, or all members of an organization from the specified
+     * team. Provide exactly one of `user`, `agent`, or `org` — supplying more than
+     * one or none returns a 400 error. On success, returns 204 No Content.
+     * When `org` is provided, every user and agent membership belonging to that org
+     * is removed in a single call. The caller must be a member of the team's owning
+     * org to perform an org-scoped removal. You cannot target the team's owning org
+     * itself with this parameter.
+     * The caller must have permission to manage the team. When `app` is present, the
+     * request is scoped to that app and requires a valid app-scoped token.
+     * @param team - Team ID (`team_...`). The team to remove the member from.
+     * @returns Empty response. Returns 204 No Content on success.
+     */
+    remove(team: string): Promise<void>;
+    /**
+     * List members of a team
+     * Returns all members of the specified team, including both users and agents.
+     * Members are returned in a single non-paginated array ordered by join time.
+     * Bearer-authenticated users must be a member of the team to retrieve its
+     * member list. Developer and server-to-server callers can retrieve members for
+     * any team visible to their app scope. When `app` is provided, the request is
+     * scoped to that app and requires a valid app-scoped token.
+     * @param team - Team ID (`team_...`). The team to remove the member from.
+     * @returns Successful response
+     */
     list(team: string): Promise<{
         data: {
             agent?: {
@@ -98,12 +126,71 @@ export declare class MemberResource {
                 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;
@@ -128,36 +215,93 @@ export declare class MemberResource {
             updated_at?: string | undefined;
             user?: {
                 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;
         }[];
     }>;
+    /**
+     * Add a member to a team
+     * Adds a user or agent as a member of the specified team and returns the new
+     * membership with HTTP 201. Provide exactly one of `user` or `agent` — supplying
+     * both or neither returns a 400 error.
+     * The caller must have permission to manage the team. When an `app` is provided,
+     * the request is scoped to that app and the caller must hold a valid app-scoped
+     * token. The default role is `"member"` when `role` is omitted.
+     * @param team - Team ID (`team_...`). The team to remove the member from.
+     * @param input - Request body.
+     * @param input.agent - Agent ID (`agt_...`) to add as a member. Provide exactly one of `user` or `agent`.
+     * @param input.role - Role to assign. One of `"owner"`, `"admin"`, or `"member"`. Defaults to `"member"` when omitted.
+     * @param input.user - User ID (`usr_...`) to add as a member. Provide exactly one of `user` or `agent`.
+     * @returns The newly created team membership.
+     */
     create(team: string, input: {
         agent?: string | undefined;
         role?: string | undefined;
         user?: string | undefined;
     }): Promise<TeamMembership>;
+    /**
+     * Update a team member's role
+     * Changes the role of an existing user member on the specified team. Returns the
+     * updated membership on success.
+     * Only user memberships are supported by this endpoint. Attempting to update an
+     * agent membership returns 404. To change an agent's role, remove the existing
+     * membership and re-add the agent with the desired role.
+     * The caller must have permission to modify the team. You cannot change a member's
+     * role across organization boundaries. Demoting the last owner of a team returns
+     * 409. An invalid `role` value returns 422. When `app` is provided, the request
+     * is scoped to that app and requires a valid app-scoped token.
+     * @param team - Team ID (`team_...`). The team to remove the member from.
+     * @param user - User ID (`usr_...`) of the existing member whose role should be changed.
+     * @param input - Request body.
+     * @param input.role - New role to assign. One of `"owner"`, `"admin"`, or `"member"`.
+     * @returns The updated team membership reflecting the new role.
+     */
+    update(team: string, user: string, input: {
+        role: string;
+    }): Promise<TeamMembership>;
 }
 export declare class TeamThreadResource {
     private http;
     constructor(http: HttpClient);
+    /**
+     * List threads for a team
+     * Returns all threads owned by the specified team that the authenticated caller
+     * has permission to view. The caller must have access to the team; requests
+     * without team access are rejected with 404.
+     * Threads are returned in a single `data` array. Use the team-scoped thread
+     * endpoints to create, update, or delete individual threads.
+     * @param team - Team ID (`tem_...`) whose threads should be listed.
+     * @returns Successful response
+     */
     list(team: string): Promise<{
         data: {
             agent_user?: string | undefined;
             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;
@@ -168,6 +312,7 @@ export declare class TeamThreadResource {
             key?: string | undefined;
             last_activity?: string | undefined;
             metadata?: Record<string, unknown> | undefined;
+            muted?: boolean | undefined;
             org?: string | undefined;
             parent_message?: {
                 actors?: {
@@ -261,12 +406,18 @@ export declare class TeamThreadResource {
             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?: {
@@ -292,12 +443,71 @@ export declare class TeamThreadResource {
                 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;
@@ -317,6 +527,23 @@ export declare class TeamThreadResource {
             user?: string | undefined;
         }[];
     }>;
+    /**
+     * Create a thread for a team
+     * Creates a new thread owned by the specified team. The authenticated caller must
+     * have access to the team; requests from callers without team access are rejected
+     * with 404.
+     * If a `profile_picture` is provided in the thread params, it must be
+     * base64-encoded image data. The image is uploaded and associated with the thread
+     * before creation completes. Omit `profile_picture` to skip this step.
+     * By default the platform sends an automatic welcome message into the new thread.
+     * Pass `skip_welcome_message: true` to suppress this behavior, for example when
+     * creating threads programmatically in bulk or seeding test data.
+     * @param team - Team ID (`tem_...`) 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 available fields.
+     * @returns The newly created thread.
+     */
     create(team: string, input: {
         skip_welcome_message?: boolean | undefined;
         thread: {
@@ -325,6 +552,7 @@ export declare class TeamThreadResource {
             is_unlisted?: boolean | undefined;
             key?: string | undefined;
             metadata?: Record<string, unknown> | undefined;
+            muted?: boolean | undefined;
             org_id?: string | undefined;
             profile_picture?: {
                 data?: string | undefined;
@@ -340,15 +568,40 @@ export declare class TeamThreadResource {
 }
 export declare class TeamResource {
     private http;
-    readonly artifacts: TeamArtifactResource;
     readonly custom_objects: TeamCustomObjectResource;
     readonly members: MemberResource;
     readonly threads: TeamThreadResource;
     constructor(http: HttpClient);
+    /**
+     * List teams
+     * Returns a paginated list of teams visible to the authenticated user, ordered
+     * by creation time descending. Use `membership` to narrow results to teams the
+     * caller has joined or teams they are eligible to join based on their ACL
+     * visibility.
+     * Supports full-text search across team name and description via `search`, and
+     * structured metadata filtering via `metadata`. When `app` is present, results
+     * are scoped to that app and the caller must hold the corresponding app scope.
+     * @param params - Query parameters.
+     * @param params.page - Page number to retrieve, starting at 1. Defaults to 1.
+     * @param params.pageSize - Number of teams to return per page. Defaults to 25.
+     * @param params.search - Full-text search string matched against team name and description.
+     * @param params.metadata - Structured metadata filter expression. Only teams whose metadata satisfies the expression are returned.
+     * @param params.membership - Filter teams by membership status. `"joined"` returns only teams the caller is a member of. `"joinable"` returns ACL-visible teams the caller has not yet joined. Omit to return all visible teams.
+     * @returns Successful response
+     */
     list(params?: {
         page?: number;
         pageSize?: number;
         search?: string;
+        metadata?: {
+            clause?: Record<string, unknown> | undefined;
+            clauses?: Record<string, unknown>[] | undefined;
+            key?: string | undefined;
+            operator?: "and" | "or" | "eq" | "contains" | "exists" | "not" | undefined;
+            path?: string[] | undefined;
+            type?: string | undefined;
+            value?: unknown | undefined;
+        };
         membership?: string;
     }): Promise<{
         data: {
@@ -388,6 +641,22 @@ export declare class TeamResource {
         total_entries: number;
         total_pages: number;
     }>;
+    /**
+     * Create a team
+     * Creates a new team and returns the created team object. The authenticated
+     * user becomes the team's owner.
+     * When `app` is supplied, the request is scoped to that app and the caller
+     * must hold the corresponding app scope. Omit `org` unless you want the team
+     * pinned to a specific organization. A default chat thread is provisioned for
+     * the team automatically after creation.
+     * @param input - Request body.
+     * @param input.acl - Access control configuration for the team. Controls who can discover and join the team.
+     * @param input.description - Optional human-readable description of the team's purpose.
+     * @param input.metadata - Arbitrary key-value pairs you can attach to the team for your own use. Values must be strings.
+     * @param input.name - Display name for the team.
+     * @param input.org - Organization ID (`org_...`) to associate the team with. Omit to create the team without an org affiliation.
+     * @returns The newly created team.
+     */
     create(input: {
         acl?: {
             add?: {
@@ -411,11 +680,23 @@ export declare class TeamResource {
         org?: string | undefined;
     }): Promise<Team>;
     /**
-     * Join a team using an invite code
-     * Accepts either `join_code` or `invite_code`.
-     * For user-authenticated requests, the current user joins the team identified by
-     * the invite code. For server-to-server requests, provide `agent` or `user` to
-     * add that principal to the team instead.
+     * Join a team with an invite code
+     * Adds a principal to a team using a 12-character invite code. The invite
+     * code can be supplied as either `join_code` or `invite_code`; both are
+     * accepted for backwards compatibility.
+     * For user-authenticated requests, the currently authenticated user is added
+     * to the team. For server-to-server requests, you must supply either `agent`
+     * (to add an agent) or `user` (to add a specific user by ID). If the user
+     * is already a member of the team, the request succeeds without creating a
+     * duplicate membership.
+     * This endpoint is rate-limited to 10 requests per minute per IP address to
+     * prevent invite-code enumeration.
+     * @param input - Request body.
+     * @param input.agent - Agent ID (`agent_...`) to add to the team. When provided, the agent is joined instead of the authenticated user. Requires a server-to-server session.
+     * @param input.invite_code - 12-character invite code — alias for `join_code` accepted for backwards compatibility.
+     * @param input.join_code - 12-character invite code that identifies the team. Mutually usable with `invite_code`.
+     * @param input.user - User ID (`user_...`) to add to the team. Required for server-to-server requests when `agent` is not supplied.
+     * @returns The team the principal has joined.
      */
     joinByCode(input: {
         agent?: string | undefined;
@@ -423,8 +704,45 @@ export declare class TeamResource {
         join_code?: string | undefined;
         user?: string | undefined;
     }): Promise<Team>;
+    /**
+     * Delete a team
+     * Permanently deletes the team identified by `team`. This action is
+     * irreversible — all team memberships, settings, and associated data are
+     * removed.
+     * The caller must be the team owner or an org admin. When `app` is present,
+     * the caller must also hold the corresponding app scope.
+     * @param team - Team ID (`team_...`) of the team to delete.
+     * @returns Empty response — the team has been deleted.
+     */
     delete(team: string): Promise<void>;
+    /**
+     * Retrieve a team
+     * Returns the full team object for the given `team` ID, including its current
+     * member list and all associated threads.
+     * The authenticated user must be a member of the team or hold a role that
+     * grants visibility (org admin, app scope). When `app` is supplied, the
+     * caller must hold the corresponding app scope.
+     * @param team - Team ID (`team_...`) of the team to retrieve.
+     * @returns The requested team, including its members and threads.
+     */
     get(team: string): Promise<Team>;
+    /**
+     * Update a team
+     * Updates one or more attributes of the team identified by `team`. Only the
+     * fields you provide are changed; omitted fields are left as-is.
+     * To replace the team's profile picture, supply the `profile_picture` object
+     * with base64-encoded image data. The previous picture is deleted after the
+     * new one is successfully uploaded. When `app` is present, the caller must hold
+     * the corresponding app scope. The caller must be a team owner or org admin.
+     * @param team - Team ID (`team_...`) of the team to update.
+     * @param input - Request body.
+     * @param input.acl - New access control configuration for the team. Replaces the existing ACL.
+     * @param input.description - New human-readable description of the team's purpose.
+     * @param input.metadata - Arbitrary key-value pairs to set on the team. Replaces the existing metadata map entirely.
+     * @param input.name - New display name for the team.
+     * @param input.profile_picture - New profile picture for the team. Provide this object to upload and replace the current picture.
+     * @returns The updated team with all changes applied.
+     */
     update(team: string, input: {
         acl?: {
             add?: {
@@ -451,20 +769,111 @@ export declare class TeamResource {
             mime_type?: string | undefined;
         } | undefined;
     }): Promise<Team>;
+    /**
+     * List a team's artifacts
+     * Returns all artifacts owned by the specified team. 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 a member of the team. Attempting to list
+     * artifacts for a team the caller does not have access to returns 404
+     * rather than 403 to avoid leaking team existence.
+     * 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 team - Team ID (`tea_...`). The authenticated user must be a member of this team.
+     * @returns Successful response
+     */
+    artifacts(team: 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 team invite
+     * Generates a new invite code for the specified team. The authenticated user
+     * must be a member of the team with the `owner` or `admin` role.
+     * The returned code is a short alphanumeric string that other users can
+     * present to join the team. Each call produces a new code; previously issued
+     * codes are not invalidated by this request.
+     * @param team - Team ID (`tm_...`) identifying the team for which to generate the invite code.
+     * @returns The newly created team invite containing the join code.
+     */
     invite(team: string): Promise<TeamInvite>;
+    /**
+     * Create a team invite (server-to-server)
+     * Generates a new invite code for the specified team using server-to-server
+     * authentication. Unlike the user-facing create endpoint, this variant does not
+     * require the caller to be a team member — it is intended for privileged
+     * back-end services acting on behalf of your platform.
+     * The returned code is a short alphanumeric string that users can present to
+     * join the team. Each call produces a new code; previously issued codes are
+     * not invalidated by this request.
+     * @param team - Team ID (`tm_...`) identifying the team for which to generate the invite code.
+     * @returns Successful response
+     */
     invites(team: string): Promise<{
         code: string;
     }>;
     /**
-     * Join a team the current user can see
-     * Joins a specific visible team by team ID.
-     * For standard user requests, the current user is added to the team. When
-     * `agent` is provided, the current user must already be a team member and the
-     * agent is added instead.
+     * Join a team
+     * Adds a principal to a team that is visible to the authenticated user.
+     * By default, the currently authenticated user joins the team. Provide `agent`
+     * to add an agent to the team instead — the caller must already be a member of
+     * the team to do so. Provide `user` (by ID) or `email` to add another user from
+     * your organization — the caller must be a team owner, team admin, or org admin.
+     * Only one of `agent`, `user`, or `email` may be supplied per request.
+     * If the target principal is already a member of the team, the request succeeds
+     * without creating a duplicate membership. Server-to-server callers are not
+     * permitted to use this endpoint; use the invite-code endpoint instead.
+     * @param team - Team ID (`team_...`) to join.
+     * @param input - Request body.
+     * @param input.agent - Agent ID (`agent_...`) to add to the team. The caller must already be a member of the team.
+     * @param input.email - Email address of a member of the caller's organization to add to the team. Requires team-owner, team-admin, or org-admin role.
+     * @param input.user - User ID (`user_...`) of a member of the caller's organization to add to the team. Requires team-owner, team-admin, or org-admin role.
+     * @returns Empty response — the principal is now a member of the team.
      */
     join(team: string, input: {
         agent?: string | undefined;
+        email?: string | undefined;
+        user?: string | undefined;
     }): Promise<void>;
+    /**
+     * Leave a team
+     * Removes a principal from a team. By default, the authenticated user removes
+     * themselves from the team. Provide `agent` to remove an agent instead — the
+     * caller must be a member of the team to do so.
+     * Team owners cannot leave their own team. To transfer ownership first, use
+     * the update-membership endpoint, then call this endpoint.
+     * For server-to-server requests, `user` is required to identify which user
+     * should be removed.
+     * @param team - Team ID (`team_...`) to leave.
+     * @returns Empty response — the principal has been removed from the team.
+     */
     leave(team: string): Promise<void>;
 }
 //# sourceMappingURL=teams.d.ts.map