@archastro/sdk 0.5.2 → 0.5.3

package/dist/types/threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/types/threads.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,oCAAoC;AACpC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,sCAAsC;AACtC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;GACG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/types/threads.ts"],"names":[],"mappings":"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"}

package/dist/types/threads.js

@@ -1,60 +1,93 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 855c979d13fa
+// Content hash: b4d3aee0a9fd
 import { z } from "zod";
-import { agentSchema } from "./agents.js";
-import { messageSchema } from "./common.js";
+import { agentSchema, messageSchema } from "./common.js";
 import { userSchema } from "./users.js";
-/** Schema for thread settings response.
-
-Used by thread settings show/update endpoints.
- */
+/** Runtime validator for {@link ThreadSettings}. */
 export const threadSettingsSchema = z.object({
-    agent_enabled: z.boolean().optional(), // Whether the agent is enabled for this thread
-});
-/** API schema for a chat thread. */
+    /** Whether the AI agent is active for this thread. `true` enables AI responses; `false` disables them. Defaults to `true` when settings have not been explicitly configured. */
+    agent_enabled: z.boolean().optional().describe("Whether the AI agent is active for this thread. `true` enables AI responses; `false` disables them. Defaults to `true` when settings have not been explicitly configured."),
+}).describe("Configuration settings for a thread that control AI agent behavior and other thread-level preferences.");
+/** Runtime validator for {@link Thread}. */
 export const threadSchema = z.object({
-    agent_user: z.string().optional(), // Owning agent user
-    created_at: z.string().optional(), // Creation timestamp
-    creator: userSchema.optional(), // Creator user object
-    description: z.string().optional(), // Thread description
-    id: z.string(), // Thread ID (thr_...)
-    is_channel: z.boolean().optional(), // Whether this is a channel
-    is_default: z.boolean().optional(), // Whether this is the default thread
-    is_transient: z.boolean().optional(), // Whether this thread is transient
-    is_unlisted: z.boolean().optional(), // Whether this thread is unlisted
-    key: z.string().optional(), // Thread key
-    last_activity: z.string().optional(), // Last activity timestamp
-    metadata: z.record(z.unknown()).optional(), // Thread metadata
-    org: z.string().optional(), // Organization
-    parent_message: messageSchema.optional(), // Parent message object
-    participant: z.array(z.string()).optional(), // Participant users
-    participants: z.array(userSchema).optional(), // Participant user objects
-    participating_actor: z.array(z.string()).optional(), // Actors participating in thread
-    participating_agents: z.array(agentSchema).optional(), // Agents participating in thread
-    role: z.string().optional(), // User's role in the thread
-    sandbox: z.string().optional(), // Sandbox identifier
-    settings: threadSettingsSchema.optional(), // Thread settings
-    slug: z.string().optional(), // Thread slug
-    sub_threads: z.array(z.record(z.unknown())).optional(), // Sub-threads
-    team: z.string().optional(), // Owning team
-    title: z.string().optional(), // Thread title
-    ttl: z.number().int().optional(), // Time-to-live in seconds
-    unread_count: z.number().int().optional(), // Unread message count
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.string().optional(), // Owning user
-});
-/** API schema for a thread member. */
+    /** ID of the agent that owns this thread (`agt_...`). `null` for user-owned or team-owned threads. */
+    agent_user: z.string().optional().describe("ID of the agent that owns this thread (`agt_...`). `null` for user-owned or team-owned threads."),
+    /** When the thread was created (ISO 8601). */
+    created_at: z.string().optional().describe("When the thread was created (ISO 8601)."),
+    /** Expanded user object for the user who created this thread. Populated only when the association is loaded. */
+    creator: userSchema.optional().describe("Expanded user object for the user who created this thread. Populated only when the association is loaded."),
+    /** Optional description or purpose statement for the thread. `null` if not set. */
+    description: z.string().optional().describe("Optional description or purpose statement for the thread. `null` if not set."),
+    /** Thread ID (`thr_...`). */
+    id: z.string().describe("Thread ID (`thr_...`)."),
+    /** Whether this thread operates as a channel — a multi-member broadcast-style conversation. */
+    is_channel: z.boolean().optional().describe("Whether this thread operates as a channel — a multi-member broadcast-style conversation."),
+    /** Whether this is the default thread for its owner. Each user or team has at most one default thread. */
+    is_default: z.boolean().optional().describe("Whether this is the default thread for its owner. Each user or team has at most one default thread."),
+    /** Whether this thread is ephemeral and may be deleted automatically after a period of inactivity or when its TTL expires. */
+    is_transient: z.boolean().optional().describe("Whether this thread is ephemeral and may be deleted automatically after a period of inactivity or when its TTL expires."),
+    /** Whether this thread is hidden from public discovery. Unlisted threads are accessible only to direct participants. */
+    is_unlisted: z.boolean().optional().describe("Whether this thread is hidden from public discovery. Unlisted threads are accessible only to direct participants."),
+    /** Application-defined stable key that uniquely identifies the thread within its scope. Useful for idempotent creation. `null` if not set. */
+    key: z.string().optional().describe("Application-defined stable key that uniquely identifies the thread within its scope. Useful for idempotent creation. `null` if not set."),
+    /** When the last message or activity occurred in this thread. Present only when activity enrichment is requested. */
+    last_activity: z.string().optional().describe("When the last message or activity occurred in this thread. Present only when activity enrichment is requested."),
+    /** Arbitrary key-value metadata attached to the thread. Shape is application-defined; `null` if no metadata has been set. */
+    metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to the thread. Shape is application-defined; `null` if no metadata has been set."),
+    /** Whether the authenticated user has muted notifications for this thread. `true` suppresses all notification delivery. */
+    muted: z.boolean().optional().describe("Whether the authenticated user has muted notifications for this thread. `true` suppresses all notification delivery."),
+    /** ID of the organization this thread belongs to (`org_...`). `null` for threads outside an org context. */
+    org: z.string().optional().describe("ID of the organization this thread belongs to (`org_...`). `null` for threads outside an org context."),
+    /** The message that spawned this thread as a sub-thread. `null` for top-level threads. */
+    parent_message: messageSchema.optional().describe("The message that spawned this thread as a sub-thread. `null` for top-level threads."),
+    /** Array of participant user IDs (`usr_...`) who are members of this thread. */
+    participant: z.array(z.string()).optional().describe("Array of participant user IDs (`usr_...`) who are members of this thread."),
+    /** Expanded participant user objects for each member of this thread. Populated only when the association is loaded. */
+    participants: z.array(userSchema).optional().describe("Expanded participant user objects for each member of this thread. Populated only when the association is loaded."),
+    /** Composite actor identifiers for all participants currently active in this thread. Present only when actor enrichment is requested. */
+    participating_actor: z.array(z.string()).optional().describe("Composite actor identifiers for all participants currently active in this thread. Present only when actor enrichment is requested."),
+    /** Expanded agent objects for all agents participating in this thread. Present only when agent enrichment is requested. */
+    participating_agents: z.array(agentSchema).optional().describe("Expanded agent objects for all agents participating in this thread. Present only when agent enrichment is requested."),
+    /** The authenticated user's membership role in this thread, e.g. `"owner"`, `"member"`, or `"viewer"`. `null` if the user is not a member. */
+    role: z.string().optional().describe("The authenticated user's membership role in this thread, e.g. `\"owner\"`, `\"member\"`, or `\"viewer\"`. `null` if the user is not a member."),
+    /** ID of the developer sandbox this thread is scoped to (`sbx_...`). `null` for production threads. */
+    sandbox: z.string().optional().describe("ID of the developer sandbox this thread is scoped to (`sbx_...`). `null` for production threads."),
+    /** Per-thread configuration settings controlling AI agent behavior for this thread. */
+    settings: threadSettingsSchema.optional().describe("Per-thread configuration settings controlling AI agent behavior for this thread."),
+    /** URL-safe slug for the thread, used in human-readable permalinks. `null` if not assigned. */
+    slug: z.string().optional().describe("URL-safe slug for the thread, used in human-readable permalinks. `null` if not assigned."),
+    /** Threads that are nested under this thread as replies to a parent message. Present only when sub-thread enrichment is requested. */
+    sub_threads: z.array(z.record(z.unknown())).optional().describe("Threads that are nested under this thread as replies to a parent message. Present only when sub-thread enrichment is requested."),
+    /** ID of the team that owns this thread (`team_...`). `null` for user-owned or agent-owned threads. */
+    team: z.string().optional().describe("ID of the team that owns this thread (`team_...`). `null` for user-owned or agent-owned threads."),
+    /** Human-readable name of the thread. `null` if no title has been set. */
+    title: z.string().optional().describe("Human-readable name of the thread. `null` if no title has been set."),
+    /** Time-to-live in seconds after which the thread may be automatically cleaned up. `null` if the thread does not expire. */
+    ttl: z.number().int().optional().describe("Time-to-live in seconds after which the thread may be automatically cleaned up. `null` if the thread does not expire."),
+    /** Number of messages in this thread that the authenticated user has not yet read. Present only when read-state enrichment is requested. */
+    unread_count: z.number().int().optional().describe("Number of messages in this thread that the authenticated user has not yet read. Present only when read-state enrichment is requested."),
+    /** When the thread was last modified (ISO 8601). */
+    updated_at: z.string().optional().describe("When the thread was last modified (ISO 8601)."),
+    /** ID of the user who owns this thread (`usr_...`). `null` for team-owned or agent-owned threads. */
+    user: z.string().optional().describe("ID of the user who owns this thread (`usr_...`). `null` for team-owned or agent-owned threads."),
+}).describe("A chat thread, representing a conversation channel that can be owned by a user, team, or agent and may contain messages, participants, and AI agent activity.");
+/** Runtime validator for {@link ThreadMember}. */
 export const threadMemberSchema = z.object({
-    membership_type: z.string().optional(), // Membership type (owner or member)
-    thread: z.string().optional(), // Thread
-    user: userSchema.optional(), // User details (when loaded)
-});
-/** Schema for thread read status response.
- */
+    /** Role of the member within the thread. One of `"owner"` (the user who created or was granted ownership) or `"member"` (a regular participant). */
+    membership_type: z.string().optional().describe("Role of the member within the thread. One of `\"owner\"` (the user who created or was granted ownership) or `\"member\"` (a regular participant)."),
+    /** ID of the thread this membership belongs to (`thr_...`). */
+    thread: z.string().optional().describe("ID of the thread this membership belongs to (`thr_...`)."),
+    /** Full user object for the member (`usr_...`). Present when the association is preloaded; `null` otherwise. */
+    user: userSchema.optional().describe("Full user object for the member (`usr_...`). Present when the association is preloaded; `null` otherwise."),
+}).describe("A user's membership record in a thread, capturing their role and full user profile.");
+/** Runtime validator for {@link ThreadReadStatus}. */
 export const threadReadStatusSchema = z.object({
-    last_read_message: z.string().optional(), // Last read message
-    thread: z.string(), // Thread
-    unread_count: z.number().int(), // Number of unread messages
-});
+    /** Message ID (`msg_...`) of the last message the user has read in this thread. `null` if the user has never read any message in the thread. */
+    last_read_message: z.string().optional().describe("Message ID (`msg_...`) of the last message the user has read in this thread. `null` if the user has never read any message in the thread."),
+    /** Thread ID (`thr_...`) that this read status belongs to. */
+    thread: z.string().describe("Thread ID (`thr_...`) that this read status belongs to."),
+    /** Number of messages in the thread that the user has not yet read. */
+    unread_count: z.number().int().describe("Number of messages in the thread that the user has not yet read."),
+}).describe("The read status of a thread for a specific user, indicating how far they have read and how many messages remain unread.");
 //# sourceMappingURL=threads.js.map

package/dist/types/threads.js.map

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

package/dist/types/users.d.ts

@@ -1,38 +1,119 @@
 import { z } from "zod";
-/** API schema for a user. */
+import type { InviteCreator } from "./invites.js";
+/** A platform user account. Represents a human or system actor that can own threads, belong to an organization, and interact with the API. */
+export interface User {
+    /** Short handle or alias for the user. `null` if not set. */
+    alias?: string | undefined;
+    /** ID of the app this user (and their access token) is scoped to (`dap_...`). `null` if the user is not scoped to an app. */
+    app?: string | undefined;
+    /** Display name of the user's app. `null` when the app association was not preloaded by the caller. */
+    app_name?: string | undefined;
+    /** Email address of the user. */
+    email?: string | undefined;
+    /** User ID (`usr_...`). */
+    id: string;
+    /** `true` if this account is an internal system user rather than a human. System users are created automatically by the platform. */
+    is_system_user?: boolean | undefined;
+    /** Arbitrary key-value metadata attached to the user. Defaults to an empty object. */
+    metadata?: Record<string, unknown> | undefined;
+    /** Full display name of the user. `null` if the user has not set a name. */
+    name?: string | undefined;
+    /** ID of the organization this user belongs to (`org_...`). `null` if the user is not a member of any organization. */
+    org?: string | undefined;
+    /** Display name of the user's organization. `null` when the user is not in an org, or when the org association was not preloaded by the caller. */
+    org_name?: string | undefined;
+    /** Role of the user within their organization. One of `"admin"`, `"member"`, or `"viewer"`. `null` when the user is not a member of any organization. */
+    org_role?: string | undefined;
+    /** ID of the sandbox environment this user is scoped to (`sbx_...`). `null` for production users. */
+    sandbox?: string | undefined;
+    /** Display name of the user's sandbox environment. `null` for production users, or when the sandbox association was not preloaded by the caller. */
+    sandbox_name?: string | undefined;
+}
+/** Runtime validator for {@link User}. */
 export declare const userSchema: z.ZodObject<{
+    /** Short handle or alias for the user. `null` if not set. */
     alias: z.ZodOptional<z.ZodString>;
+    /** ID of the app this user (and their access token) is scoped to (`dap_...`). `null` if the user is not scoped to an app. */
+    app: z.ZodOptional<z.ZodString>;
+    /** Display name of the user's app. `null` when the app association was not preloaded by the caller. */
+    app_name: z.ZodOptional<z.ZodString>;
+    /** Email address of the user. */
     email: z.ZodOptional<z.ZodString>;
+    /** User ID (`usr_...`). */
     id: z.ZodString;
+    /** `true` if this account is an internal system user rather than a human. System users are created automatically by the platform. */
+    is_system_user: z.ZodOptional<z.ZodBoolean>;
+    /** Arbitrary key-value metadata attached to the user. Defaults to an empty object. */
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Full display name of the user. `null` if the user has not set a name. */
     name: z.ZodOptional<z.ZodString>;
+    /** ID of the organization this user belongs to (`org_...`). `null` if the user is not a member of any organization. */
     org: z.ZodOptional<z.ZodString>;
+    /** Display name of the user's organization. `null` when the user is not in an org, or when the org association was not preloaded by the caller. */
+    org_name: z.ZodOptional<z.ZodString>;
+    /** Role of the user within their organization. One of `"admin"`, `"member"`, or `"viewer"`. `null` when the user is not a member of any organization. */
+    org_role: z.ZodOptional<z.ZodString>;
+    /** ID of the sandbox environment this user is scoped to (`sbx_...`). `null` for production users. */
     sandbox: z.ZodOptional<z.ZodString>;
+    /** Display name of the user's sandbox environment. `null` for production users, or when the sandbox association was not preloaded by the caller. */
+    sandbox_name: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     email?: string | undefined;
     alias?: string | undefined;
-    name?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
     org?: string | undefined;
     sandbox?: string | undefined;
+    name?: string | undefined;
+    app?: string | undefined;
+    app_name?: string | undefined;
+    is_system_user?: boolean | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    org_name?: string | undefined;
+    org_role?: string | undefined;
+    sandbox_name?: string | undefined;
 }, {
     id: string;
     email?: string | undefined;
     alias?: string | undefined;
-    name?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
     org?: string | undefined;
     sandbox?: string | undefined;
+    name?: string | undefined;
+    app?: string | undefined;
+    app_name?: string | undefined;
+    is_system_user?: boolean | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    org_name?: string | undefined;
+    org_role?: string | undefined;
+    sandbox_name?: string | undefined;
 }>;
-export type User = z.infer<typeof userSchema>;
-/** API schema for a user invite. */
+/** A shareable invite created by a user, optionally scoped to a thread. Recipients can use the invite key to join or start a conversation. */
+export interface UserInvite {
+    /** When this invite was created (ISO 8601). */
+    created_at?: string | undefined;
+    /** Invite ID (`uin_...`). */
+    id: string;
+    /** Secret bearer token used to accept this invite. Treat this value like a password — do not log or expose it publicly. */
+    key?: string | undefined;
+    /** Arbitrary key-value metadata attached to the invite at creation time. Defaults to an empty object. */
+    metadata?: Record<string, unknown> | undefined;
+    /** ID of the thread this invite is scoped to (`thr_...`). `null` if the invite is not bound to a thread. */
+    thread?: string | undefined;
+    /** The user who created this invite. */
+    user?: InviteCreator | undefined;
+}
+/** Runtime validator for {@link UserInvite}. */
 export declare const userInviteSchema: z.ZodObject<{
+    /** When this invite was created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
+    /** Invite ID (`uin_...`). */
     id: z.ZodString;
+    /** Secret bearer token used to accept this invite. Treat this value like a password — do not log or expose it publicly. */
     key: z.ZodOptional<z.ZodString>;
+    /** Arbitrary key-value metadata attached to the invite at creation time. Defaults to an empty object. */
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** ID of the thread this invite is scoped to (`thr_...`). `null` if the invite is not bound to a thread. */
     thread: z.ZodOptional<z.ZodString>;
+    /** The user who created this invite. */
     user: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -45,18 +126,18 @@ export declare const userInviteSchema: z.ZodObject<{
             url: z.ZodOptional<z.ZodString>;
             width: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
+            mime_type?: string | undefined;
             file?: string | undefined;
             height?: number | undefined;
             media?: string | undefined;
-            mime_type?: string | undefined;
             refresh_url?: string | undefined;
             url?: string | undefined;
             width?: number | undefined;
         }, {
+            mime_type?: string | undefined;
             file?: string | undefined;
             height?: number | undefined;
             media?: string | undefined;
-            mime_type?: string | undefined;
             refresh_url?: string | undefined;
             url?: string | undefined;
             width?: number | undefined;
@@ -65,10 +146,10 @@ export declare const userInviteSchema: z.ZodObject<{
         id: string;
         name?: string | undefined;
         profile_picture?: {
+            mime_type?: string | undefined;
             file?: string | undefined;
             height?: number | undefined;
             media?: string | undefined;
-            mime_type?: string | undefined;
             refresh_url?: string | undefined;
             url?: string | undefined;
             width?: number | undefined;
@@ -77,10 +158,10 @@ export declare const userInviteSchema: z.ZodObject<{
         id: string;
         name?: string | undefined;
         profile_picture?: {
+            mime_type?: string | undefined;
             file?: string | undefined;
             height?: number | undefined;
             media?: string | undefined;
-            mime_type?: string | undefined;
             refresh_url?: string | undefined;
             url?: string | undefined;
             width?: number | undefined;
@@ -89,41 +170,40 @@ export declare const userInviteSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     key?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    created_at?: string | undefined;
     thread?: string | undefined;
+    created_at?: string | undefined;
     user?: {
         id: string;
         name?: string | undefined;
         profile_picture?: {
+            mime_type?: string | undefined;
             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;
+    metadata?: Record<string, unknown> | undefined;
 }, {
     id: string;
     key?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
-    created_at?: string | undefined;
     thread?: string | undefined;
+    created_at?: string | undefined;
     user?: {
         id: string;
         name?: string | undefined;
         profile_picture?: {
+            mime_type?: string | undefined;
             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;
+    metadata?: Record<string, unknown> | undefined;
 }>;
-export type UserInvite = z.infer<typeof userInviteSchema>;
 //# sourceMappingURL=users.d.ts.map

package/dist/types/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/types/users.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,6BAA6B;AAC7B,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAQrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,oCAAoC;AACpC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/types/users.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,8IAA8I;AAC9I,MAAM,WAAW,IAAI;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6HAA6H;IAC7H,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,qIAAqI;IACrI,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uHAAuH;IACvH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,mJAAmJ;IACnJ,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,yJAAyJ;IACzJ,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,oJAAoJ;IACpJ,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,0CAA0C;AAC1C,eAAO,MAAM,UAAU;IACrB,6DAA6D;;IAE7D,6HAA6H;;IAE7H,uGAAuG;;IAEvG,iCAAiC;;IAEjC,2BAA2B;;IAE3B,qIAAqI;;IAErI,sFAAsF;;IAEtF,4EAA4E;;IAE5E,uHAAuH;;IAEvH,mJAAmJ;;IAEnJ,yJAAyJ;;IAEzJ,qGAAqG;;IAErG,oJAAoJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE0B,CAAC;AAEjL,8IAA8I;AAC9I,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,2HAA2H;IAC3H,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,wCAAwC;IACxC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAClC;AAED,gDAAgD;AAChD,eAAO,MAAM,gBAAgB;IAC3B,+CAA+C;;IAE/C,6BAA6B;;IAE7B,2HAA2H;;IAE3H,yGAAyG;;IAEzG,4GAA4G;;IAE5G,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE4I,CAAC"}

package/dist/types/users.js

@@ -1,25 +1,50 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 7015ee861551
+// Content hash: 3adcfad79fb7
 import { z } from "zod";
 import { inviteCreatorSchema } from "./invites.js";
-/** API schema for a user. */
+/** Runtime validator for {@link User}. */
 export const userSchema = z.object({
-    alias: z.string().optional(), // User alias/handle
-    email: z.string().optional(), // User email address
-    id: z.string(), // User ID
-    metadata: z.record(z.unknown()).optional(), // User metadata
-    name: z.string().optional(), // User display name
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox
-});
-/** API schema for a user invite. */
+    /** Short handle or alias for the user. `null` if not set. */
+    alias: z.string().optional().describe("Short handle or alias for the user. `null` if not set."),
+    /** ID of the app this user (and their access token) is scoped to (`dap_...`). `null` if the user is not scoped to an app. */
+    app: z.string().optional().describe("ID of the app this user (and their access token) is scoped to (`dap_...`). `null` if the user is not scoped to an app."),
+    /** Display name of the user's app. `null` when the app association was not preloaded by the caller. */
+    app_name: z.string().optional().describe("Display name of the user's app. `null` when the app association was not preloaded by the caller."),
+    /** Email address of the user. */
+    email: z.string().optional().describe("Email address of the user."),
+    /** User ID (`usr_...`). */
+    id: z.string().describe("User ID (`usr_...`)."),
+    /** `true` if this account is an internal system user rather than a human. System users are created automatically by the platform. */
+    is_system_user: z.boolean().optional().describe("`true` if this account is an internal system user rather than a human. System users are created automatically by the platform."),
+    /** Arbitrary key-value metadata attached to the user. Defaults to an empty object. */
+    metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to the user. Defaults to an empty object."),
+    /** Full display name of the user. `null` if the user has not set a name. */
+    name: z.string().optional().describe("Full display name of the user. `null` if the user has not set a name."),
+    /** ID of the organization this user belongs to (`org_...`). `null` if the user is not a member of any organization. */
+    org: z.string().optional().describe("ID of the organization this user belongs to (`org_...`). `null` if the user is not a member of any organization."),
+    /** Display name of the user's organization. `null` when the user is not in an org, or when the org association was not preloaded by the caller. */
+    org_name: z.string().optional().describe("Display name of the user's organization. `null` when the user is not in an org, or when the org association was not preloaded by the caller."),
+    /** Role of the user within their organization. One of `"admin"`, `"member"`, or `"viewer"`. `null` when the user is not a member of any organization. */
+    org_role: z.string().optional().describe("Role of the user within their organization. One of `\"admin\"`, `\"member\"`, or `\"viewer\"`. `null` when the user is not a member of any organization."),
+    /** ID of the sandbox environment this user is scoped to (`sbx_...`). `null` for production users. */
+    sandbox: z.string().optional().describe("ID of the sandbox environment this user is scoped to (`sbx_...`). `null` for production users."),
+    /** Display name of the user's sandbox environment. `null` for production users, or when the sandbox association was not preloaded by the caller. */
+    sandbox_name: z.string().optional().describe("Display name of the user's sandbox environment. `null` for production users, or when the sandbox association was not preloaded by the caller."),
+}).describe("A platform user account. Represents a human or system actor that can own threads, belong to an organization, and interact with the API.");
+/** Runtime validator for {@link UserInvite}. */
 export const userInviteSchema = z.object({
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Invite ID (uin_...)
-    key: z.string().optional(), // Invite key
-    metadata: z.record(z.unknown()).optional(), // Invite metadata
-    thread: z.string().optional(), // Thread
-    user: inviteCreatorSchema.optional(), // Invite creator
-});
+    /** When this invite was created (ISO 8601). */
+    created_at: z.string().optional().describe("When this invite was created (ISO 8601)."),
+    /** Invite ID (`uin_...`). */
+    id: z.string().describe("Invite ID (`uin_...`)."),
+    /** Secret bearer token used to accept this invite. Treat this value like a password — do not log or expose it publicly. */
+    key: z.string().optional().describe("Secret bearer token used to accept this invite. Treat this value like a password — do not log or expose it publicly."),
+    /** Arbitrary key-value metadata attached to the invite at creation time. Defaults to an empty object. */
+    metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value metadata attached to the invite at creation time. Defaults to an empty object."),
+    /** ID of the thread this invite is scoped to (`thr_...`). `null` if the invite is not bound to a thread. */
+    thread: z.string().optional().describe("ID of the thread this invite is scoped to (`thr_...`). `null` if the invite is not bound to a thread."),
+    /** The user who created this invite. */
+    user: inviteCreatorSchema.optional().describe("The user who created this invite."),
+}).describe("A shareable invite created by a user, optionally scoped to a thread. Recipients can use the invite key to join or start a conversation.");
 //# sourceMappingURL=users.js.map

package/dist/types/users.js.map

@@ -1 +1 @@
-{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/types/users.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IACnD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,gBAAgB;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,eAAe;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU;CAC3C,CAAC,CAAC;AAGH,oCAAoC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qBAAqB;IACxD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,aAAa;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,kBAAkB;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS;IACxC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,EAAE,iBAAiB;CACxD,CAAC,CAAC"}
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/types/users.ts"],"names":[],"mappings":"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"}