@archastro/sdk 0.5.2 → 0.6.0

package/dist/types/threads.d.ts

@@ -1,55 +1,156 @@
 import { z } from "zod";
-/** Schema for thread settings response.
-
-Used by thread settings show/update endpoints.
- */
+import type { Agent, Message } from "./common.js";
+import type { User } from "./users.js";
+/** Configuration settings for a thread that control AI agent behavior and other thread-level preferences. */
+export interface ThreadSettings {
+    /** 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?: boolean | undefined;
+}
+/** Runtime validator for {@link ThreadSettings}. */
 export declare const threadSettingsSchema: z.ZodObject<{
+    /** 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.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     agent_enabled?: boolean | undefined;
 }, {
     agent_enabled?: boolean | undefined;
 }>;
-export type ThreadSettings = z.infer<typeof threadSettingsSchema>;
-/** API schema for a chat thread. */
+/** 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. */
+export interface Thread {
+    /** ID of the agent that owns this thread (`agt_...`). `null` for user-owned or team-owned threads. */
+    agent_user?: string | undefined;
+    /** When the thread was created (ISO 8601). */
+    created_at?: string | undefined;
+    /** Expanded user object for the user who created this thread. Populated only when the association is loaded. */
+    creator?: User | undefined;
+    /** Optional description or purpose statement for the thread. `null` if not set. */
+    description?: string | undefined;
+    /** Thread ID (`thr_...`). */
+    id: string;
+    /** Whether this thread operates as a channel — a multi-member broadcast-style conversation. */
+    is_channel?: boolean | undefined;
+    /** Whether this is the default thread for its owner. Each user or team has at most one default thread. */
+    is_default?: boolean | undefined;
+    /** Whether this thread is ephemeral and may be deleted automatically after a period of inactivity or when its TTL expires. */
+    is_transient?: boolean | undefined;
+    /** Whether this thread is hidden from public discovery. Unlisted threads are accessible only to direct participants. */
+    is_unlisted?: boolean | undefined;
+    /** Application-defined stable key that uniquely identifies the thread within its scope. Useful for idempotent creation. `null` if not set. */
+    key?: string | undefined;
+    /** When the last message or activity occurred in this thread. Present only when activity enrichment is requested. */
+    last_activity?: string | undefined;
+    /** Arbitrary key-value metadata attached to the thread. Shape is application-defined; `null` if no metadata has been set. */
+    metadata?: Record<string, unknown> | undefined;
+    /** Whether the authenticated user has muted notifications for this thread. `true` suppresses all notification delivery. */
+    muted?: boolean | undefined;
+    /** ID of the organization this thread belongs to (`org_...`). `null` for threads outside an org context. */
+    org?: string | undefined;
+    /** The message that spawned this thread as a sub-thread. `null` for top-level threads. */
+    parent_message?: Message | undefined;
+    /** Array of participant user IDs (`usr_...`) who are members of this thread. */
+    participant?: string[] | undefined;
+    /** Expanded participant user objects for each member of this thread. Populated only when the association is loaded. */
+    participants?: User[] | undefined;
+    /** Composite actor identifiers for all participants currently active in this thread. Present only when actor enrichment is requested. */
+    participating_actor?: string[] | undefined;
+    /** Expanded agent objects for all agents participating in this thread. Present only when agent enrichment is requested. */
+    participating_agents?: Agent[] | undefined;
+    /** The authenticated user's membership role in this thread, e.g. `"owner"`, `"member"`, or `"viewer"`. `null` if the user is not a member. */
+    role?: string | undefined;
+    /** ID of the developer sandbox this thread is scoped to (`sbx_...`). `null` for production threads. */
+    sandbox?: string | undefined;
+    /** Per-thread configuration settings controlling AI agent behavior for this thread. */
+    settings?: ThreadSettings | undefined;
+    /** URL-safe slug for the thread, used in human-readable permalinks. `null` if not assigned. */
+    slug?: string | undefined;
+    /** Threads that are nested under this thread as replies to a parent message. Present only when sub-thread enrichment is requested. */
+    sub_threads?: Record<string, unknown>[] | undefined;
+    /** ID of the team that owns this thread (`team_...`). `null` for user-owned or agent-owned threads. */
+    team?: string | undefined;
+    /** Human-readable name of the thread. `null` if no title has been set. */
+    title?: string | undefined;
+    /** Time-to-live in seconds after which the thread may be automatically cleaned up. `null` if the thread does not expire. */
+    ttl?: number | undefined;
+    /** Number of messages in this thread that the authenticated user has not yet read. Present only when read-state enrichment is requested. */
+    unread_count?: number | undefined;
+    /** When the thread was last modified (ISO 8601). */
+    updated_at?: string | undefined;
+    /** ID of the user who owns this thread (`usr_...`). `null` for team-owned or agent-owned threads. */
+    user?: string | undefined;
+}
+/** Runtime validator for {@link Thread}. */
 export declare const threadSchema: z.ZodObject<{
+    /** ID of the agent that owns this thread (`agt_...`). `null` for user-owned or team-owned threads. */
     agent_user: z.ZodOptional<z.ZodString>;
+    /** When the thread was created (ISO 8601). */
     created_at: z.ZodOptional<z.ZodString>;
+    /** Expanded user object for the user who created this thread. Populated only when the association is loaded. */
     creator: z.ZodOptional<z.ZodObject<{
         alias: z.ZodOptional<z.ZodString>;
+        app: z.ZodOptional<z.ZodString>;
+        app_name: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
+        is_system_user: z.ZodOptional<z.ZodBoolean>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         name: z.ZodOptional<z.ZodString>;
         org: z.ZodOptional<z.ZodString>;
+        org_name: z.ZodOptional<z.ZodString>;
+        org_role: z.ZodOptional<z.ZodString>;
         sandbox: z.ZodOptional<z.ZodString>;
+        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;
     }>>;
+    /** Optional description or purpose statement for the thread. `null` if not set. */
     description: z.ZodOptional<z.ZodString>;
+    /** Thread ID (`thr_...`). */
     id: z.ZodString;
+    /** Whether this thread operates as a channel — a multi-member broadcast-style conversation. */
     is_channel: z.ZodOptional<z.ZodBoolean>;
+    /** Whether this is the default thread for its owner. Each user or team has at most one default thread. */
     is_default: z.ZodOptional<z.ZodBoolean>;
+    /** Whether this thread is ephemeral and may be deleted automatically after a period of inactivity or when its TTL expires. */
     is_transient: z.ZodOptional<z.ZodBoolean>;
+    /** Whether this thread is hidden from public discovery. Unlisted threads are accessible only to direct participants. */
     is_unlisted: z.ZodOptional<z.ZodBoolean>;
+    /** Application-defined stable key that uniquely identifies the thread within its scope. Useful for idempotent creation. `null` if not set. */
     key: z.ZodOptional<z.ZodString>;
+    /** When the last message or activity occurred in this thread. Present only when activity enrichment is requested. */
     last_activity: z.ZodOptional<z.ZodString>;
+    /** Arbitrary key-value metadata attached to the thread. Shape is application-defined; `null` if no metadata has been set. */
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Whether the authenticated user has muted notifications for this thread. `true` suppresses all notification delivery. */
+    muted: z.ZodOptional<z.ZodBoolean>;
+    /** ID of the organization this thread belongs to (`org_...`). `null` for threads outside an org context. */
     org: z.ZodOptional<z.ZodString>;
+    /** The message that spawned this thread as a sub-thread. `null` for top-level threads. */
     parent_message: z.ZodOptional<z.ZodObject<{
         actors: z.ZodOptional<z.ZodArray<z.ZodObject<{
             alias: z.ZodOptional<z.ZodString>;
@@ -64,18 +165,18 @@ export declare const threadSchema: 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;
@@ -85,10 +186,10 @@ export declare const threadSchema: z.ZodObject<{
             id?: string | undefined;
             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;
@@ -98,16 +199,17 @@ export declare const threadSchema: z.ZodObject<{
             id?: string | undefined;
             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;
         }>, "many">>;
         agent: z.ZodOptional<z.ZodString>;
+        agent_mode: z.ZodOptional<z.ZodEnum<["cli", "embedded"]>>;
         attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
             content_type: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
@@ -124,18 +226,18 @@ export declare const threadSchema: 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;
@@ -164,18 +266,18 @@ export declare const threadSchema: 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;
@@ -186,43 +288,43 @@ export declare const threadSchema: z.ZodObject<{
                 width: z.ZodOptional<z.ZodNumber>;
             }, "strip", z.ZodTypeAny, {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }, {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }>, "many">>;
             version: z.ZodOptional<z.ZodNumber>;
@@ -235,42 +337,42 @@ export declare const threadSchema: z.ZodObject<{
             url?: string | undefined;
             width?: number | undefined;
             name?: string | undefined;
+            description?: string | undefined;
+            title?: string | undefined;
             content_type?: string | undefined;
             filename?: string | undefined;
             image_source?: {
+                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;
-            description?: string | undefined;
             image_height?: number | undefined;
             image_url?: string | undefined;
             image_width?: number | undefined;
             media_type?: string | undefined;
-            title?: string | undefined;
             variants?: {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | undefined;
@@ -282,42 +384,42 @@ export declare const threadSchema: z.ZodObject<{
             url?: string | undefined;
             width?: number | undefined;
             name?: string | undefined;
+            description?: string | undefined;
+            title?: string | undefined;
             content_type?: string | undefined;
             filename?: string | undefined;
             image_source?: {
+                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;
-            description?: string | undefined;
             image_height?: number | undefined;
             image_url?: string | undefined;
             image_width?: number | undefined;
             media_type?: string | undefined;
-            title?: string | undefined;
             variants?: {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | undefined;
@@ -357,28 +459,14 @@ export declare const threadSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         content?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
+        agent?: string | undefined;
+        thread?: string | undefined;
+        team?: string | undefined;
         org?: string | undefined;
-        sandbox?: string | undefined;
         created_at?: string | undefined;
-        thread?: string | undefined;
+        sandbox?: string | undefined;
         user?: string | undefined;
-        team?: string | undefined;
-        agent?: string | undefined;
-        actors?: {
-            alias?: string | undefined;
-            id?: string | undefined;
-            name?: string | undefined;
-            profile_picture?: {
-                file?: string | undefined;
-                height?: number | undefined;
-                media?: string | undefined;
-                mime_type?: string | undefined;
-                refresh_url?: string | undefined;
-                url?: string | undefined;
-                width?: number | undefined;
-            } | undefined;
-        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
         attachments?: {
             type: string;
             id: string;
@@ -387,46 +475,61 @@ export declare const threadSchema: z.ZodObject<{
             url?: string | undefined;
             width?: number | undefined;
             name?: string | undefined;
+            description?: string | undefined;
+            title?: string | undefined;
             content_type?: string | undefined;
             filename?: string | undefined;
             image_source?: {
+                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;
-            description?: string | undefined;
             image_height?: number | undefined;
             image_url?: string | undefined;
             image_width?: number | undefined;
             media_type?: string | undefined;
-            title?: string | undefined;
             variants?: {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | undefined;
         }[] | undefined;
+        actors?: {
+            alias?: string | undefined;
+            id?: string | undefined;
+            name?: string | undefined;
+            profile_picture?: {
+                mime_type?: string | undefined;
+                file?: string | undefined;
+                height?: number | undefined;
+                media?: string | undefined;
+                refresh_url?: string | undefined;
+                url?: string | undefined;
+                width?: number | undefined;
+            } | undefined;
+        }[] | undefined;
+        agent_mode?: "cli" | "embedded" | undefined;
         branched_thread?: string | undefined;
         has_replies?: boolean | undefined;
         idempotency_key?: string | undefined;
@@ -445,28 +548,14 @@ export declare const threadSchema: z.ZodObject<{
     }, {
         id: string;
         content?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
+        agent?: string | undefined;
+        thread?: string | undefined;
+        team?: string | undefined;
         org?: string | undefined;
-        sandbox?: string | undefined;
         created_at?: string | undefined;
-        thread?: string | undefined;
+        sandbox?: string | undefined;
         user?: string | undefined;
-        team?: string | undefined;
-        agent?: string | undefined;
-        actors?: {
-            alias?: string | undefined;
-            id?: string | undefined;
-            name?: string | undefined;
-            profile_picture?: {
-                file?: string | undefined;
-                height?: number | undefined;
-                media?: string | undefined;
-                mime_type?: string | undefined;
-                refresh_url?: string | undefined;
-                url?: string | undefined;
-                width?: number | undefined;
-            } | undefined;
-        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
         attachments?: {
             type: string;
             id: string;
@@ -475,46 +564,61 @@ export declare const threadSchema: z.ZodObject<{
             url?: string | undefined;
             width?: number | undefined;
             name?: string | undefined;
+            description?: string | undefined;
+            title?: string | undefined;
             content_type?: string | undefined;
             filename?: string | undefined;
             image_source?: {
+                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;
-            description?: string | undefined;
             image_height?: number | undefined;
             image_url?: string | undefined;
             image_width?: number | undefined;
             media_type?: string | undefined;
-            title?: string | undefined;
             variants?: {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | undefined;
         }[] | undefined;
+        actors?: {
+            alias?: string | undefined;
+            id?: string | undefined;
+            name?: string | undefined;
+            profile_picture?: {
+                mime_type?: string | undefined;
+                file?: string | undefined;
+                height?: number | undefined;
+                media?: string | undefined;
+                refresh_url?: string | undefined;
+                url?: string | undefined;
+                width?: number | undefined;
+            } | undefined;
+        }[] | undefined;
+        agent_mode?: "cli" | "embedded" | undefined;
         branched_thread?: string | undefined;
         has_replies?: boolean | undefined;
         idempotency_key?: string | undefined;
@@ -531,33 +635,55 @@ export declare const threadSchema: z.ZodObject<{
         reply_count?: number | undefined;
         reply_to?: Record<string, unknown> | undefined;
     }>>;
+    /** Array of participant user IDs (`usr_...`) who are members of this thread. */
     participant: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Expanded participant user objects for each member of this thread. Populated only when the association is loaded. */
     participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
         alias: z.ZodOptional<z.ZodString>;
+        app: z.ZodOptional<z.ZodString>;
+        app_name: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
+        is_system_user: z.ZodOptional<z.ZodBoolean>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         name: z.ZodOptional<z.ZodString>;
         org: z.ZodOptional<z.ZodString>;
+        org_name: z.ZodOptional<z.ZodString>;
+        org_role: z.ZodOptional<z.ZodString>;
         sandbox: z.ZodOptional<z.ZodString>;
+        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;
     }>, "many">>;
+    /** Composite actor identifiers for all participants currently active in this thread. Present only when actor enrichment is requested. */
     participating_actor: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Expanded agent objects for all agents participating in this thread. Present only when agent enrichment is requested. */
     participating_agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         acl: z.ZodOptional<z.ZodObject<{
             add: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -633,149 +759,583 @@ export declare const threadSchema: z.ZodObject<{
         email: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
         identity: z.ZodOptional<z.ZodString>;
+        last_applied_template_config: z.ZodOptional<z.ZodString>;
         lookup_key: z.ZodOptional<z.ZodString>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         name: z.ZodOptional<z.ZodString>;
         org: z.ZodOptional<z.ZodString>;
+        org_name: z.ZodOptional<z.ZodString>;
+        originator: z.ZodOptional<z.ZodString>;
         phone_number: z.ZodOptional<z.ZodString>;
         sandbox: z.ZodOptional<z.ZodString>;
-        team: z.ZodOptional<z.ZodString>;
-        updated_at: z.ZodOptional<z.ZodString>;
-        user: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        email?: string | undefined;
-        name?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        org?: string | undefined;
-        sandbox?: string | undefined;
-        created_at?: string | undefined;
-        user?: string | undefined;
-        updated_at?: string | undefined;
-        team?: string | undefined;
-        lookup_key?: string | undefined;
-        acl?: {
-            add?: {
-                actions: string[];
-                principal_type: string;
-                principal?: string | undefined;
-            }[] | undefined;
-            grants?: {
-                actions: string[];
-                principal_type: string;
-                principal?: string | undefined;
-            }[] | undefined;
-            remove?: {
-                principal_type: string;
-                principal?: string | undefined;
-            }[] | undefined;
-        } | undefined;
-        app?: string | undefined;
-        default_model?: string | undefined;
-        identity?: string | undefined;
-        phone_number?: string | undefined;
-    }, {
-        id: string;
-        email?: string | undefined;
-        name?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        org?: string | undefined;
-        sandbox?: string | undefined;
-        created_at?: string | undefined;
-        user?: string | undefined;
-        updated_at?: string | undefined;
-        team?: string | undefined;
-        lookup_key?: string | undefined;
-        acl?: {
-            add?: {
-                actions: string[];
-                principal_type: string;
-                principal?: string | undefined;
-            }[] | undefined;
-            grants?: {
-                actions: string[];
-                principal_type: string;
-                principal?: string | undefined;
+        source_solution: z.ZodOptional<z.ZodObject<{
+            solution: z.ZodObject<{
+                category_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                created_at: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                id: z.ZodString;
+                kind: z.ZodString;
+                latest_solution: z.ZodOptional<z.ZodString>;
+                latest_version: z.ZodOptional<z.ZodString>;
+                lookup_key: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                name: z.ZodOptional<z.ZodString>;
+                org: z.ZodOptional<z.ZodString>;
+                org_logo: z.ZodOptional<z.ZodObject<{
+                    file: z.ZodOptional<z.ZodString>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    media: z.ZodOptional<z.ZodString>;
+                    mime_type: z.ZodOptional<z.ZodString>;
+                    refresh_url: z.ZodOptional<z.ZodString>;
+                    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;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                }, {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                }>>;
+                org_name: z.ZodOptional<z.ZodString>;
+                org_slug: z.ZodOptional<z.ZodString>;
+                owners: z.ZodArray<z.ZodString, "many">;
+                readme_url: z.ZodOptional<z.ZodString>;
+                solution_id: z.ZodOptional<z.ZodString>;
+                solution_version: z.ZodOptional<z.ZodString>;
+                tag_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                template_kind: z.ZodOptional<z.ZodString>;
+                templates: z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    display_name: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                    kind: z.ZodString;
+                    lookup_key: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                    readme_url: z.ZodOptional<z.ZodString>;
+                    virtual_path: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }, {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }>, "many">;
+                updated_at: z.ZodOptional<z.ZodString>;
+                upgrade_available: z.ZodBoolean;
+                virtual_path: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            }, {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            }>;
+            template: z.ZodObject<{
+                created_at: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                display_name: z.ZodOptional<z.ZodString>;
+                id: z.ZodString;
+                kind: z.ZodString;
+                lookup_key: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                updated_at: z.ZodOptional<z.ZodString>;
+                virtual_path: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            }, {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            solution: {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            };
+            template: {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            };
+        }, {
+            solution: {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            };
+            template: {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            };
+        }>>;
+        team: z.ZodOptional<z.ZodString>;
+        template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
+        updated_at: z.ZodOptional<z.ZodString>;
+        user: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        email?: string | undefined;
+        team?: string | undefined;
+        org?: string | undefined;
+        created_at?: string | undefined;
+        sandbox?: string | undefined;
+        lookup_key?: string | undefined;
+        updated_at?: string | undefined;
+        user?: string | undefined;
+        name?: string | undefined;
+        app?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        org_name?: string | undefined;
+        acl?: {
+            add?: {
+                actions: string[];
+                principal_type: string;
+                principal?: string | undefined;
+            }[] | undefined;
+            grants?: {
+                actions: string[];
+                principal_type: string;
+                principal?: string | undefined;
             }[] | undefined;
             remove?: {
                 principal_type: string;
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
+        default_model?: string | undefined;
+        identity?: string | undefined;
+        last_applied_template_config?: string | undefined;
+        originator?: string | undefined;
+        phone_number?: string | undefined;
+        source_solution?: {
+            solution: {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            };
+            template: {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            };
+        } | undefined;
+        template_upgrade_available?: boolean | undefined;
+    }, {
+        id: string;
+        email?: string | undefined;
+        team?: string | undefined;
+        org?: string | undefined;
+        created_at?: string | undefined;
+        sandbox?: string | undefined;
+        lookup_key?: string | undefined;
+        updated_at?: string | undefined;
+        user?: string | undefined;
+        name?: string | undefined;
         app?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        org_name?: string | undefined;
+        acl?: {
+            add?: {
+                actions: string[];
+                principal_type: string;
+                principal?: string | undefined;
+            }[] | undefined;
+            grants?: {
+                actions: string[];
+                principal_type: string;
+                principal?: string | undefined;
+            }[] | undefined;
+            remove?: {
+                principal_type: string;
+                principal?: string | undefined;
+            }[] | undefined;
+        } | undefined;
         default_model?: string | undefined;
         identity?: string | undefined;
+        last_applied_template_config?: string | undefined;
+        originator?: string | undefined;
         phone_number?: string | undefined;
+        source_solution?: {
+            solution: {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            };
+            template: {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            };
+        } | undefined;
+        template_upgrade_available?: boolean | undefined;
     }>, "many">>;
+    /** 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.ZodOptional<z.ZodString>;
+    /** ID of the developer sandbox this thread is scoped to (`sbx_...`). `null` for production threads. */
     sandbox: z.ZodOptional<z.ZodString>;
+    /** Per-thread configuration settings controlling AI agent behavior for this thread. */
     settings: z.ZodOptional<z.ZodObject<{
+        /** 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.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         agent_enabled?: boolean | undefined;
     }, {
         agent_enabled?: boolean | undefined;
     }>>;
+    /** URL-safe slug for the thread, used in human-readable permalinks. `null` if not assigned. */
     slug: z.ZodOptional<z.ZodString>;
+    /** Threads that are nested under this thread as replies to a parent message. Present only when sub-thread enrichment is requested. */
     sub_threads: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    /** ID of the team that owns this thread (`team_...`). `null` for user-owned or agent-owned threads. */
     team: z.ZodOptional<z.ZodString>;
+    /** Human-readable name of the thread. `null` if no title has been set. */
     title: z.ZodOptional<z.ZodString>;
+    /** Time-to-live in seconds after which the thread may be automatically cleaned up. `null` if the thread does not expire. */
     ttl: z.ZodOptional<z.ZodNumber>;
+    /** 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.ZodOptional<z.ZodNumber>;
+    /** When the thread was last modified (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
+    /** ID of the user who owns this thread (`usr_...`). `null` for team-owned or agent-owned threads. */
     user: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     key?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
+    team?: string | undefined;
     org?: string | undefined;
-    sandbox?: string | undefined;
     created_at?: string | undefined;
-    user?: string | undefined;
+    sandbox?: string | undefined;
     updated_at?: string | undefined;
+    user?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
     description?: string | undefined;
     title?: string | undefined;
-    team?: string | undefined;
+    role?: string | undefined;
     agent_user?: string | undefined;
     creator?: {
         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;
     } | undefined;
     is_channel?: boolean | undefined;
     is_default?: boolean | undefined;
     is_transient?: boolean | undefined;
     is_unlisted?: boolean | undefined;
     last_activity?: string | undefined;
+    muted?: boolean | undefined;
     parent_message?: {
         id: string;
         content?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
+        agent?: string | undefined;
+        thread?: string | undefined;
+        team?: string | undefined;
         org?: string | undefined;
-        sandbox?: string | undefined;
         created_at?: string | undefined;
-        thread?: string | undefined;
+        sandbox?: string | undefined;
         user?: string | undefined;
-        team?: string | undefined;
-        agent?: string | undefined;
-        actors?: {
-            alias?: string | undefined;
-            id?: string | undefined;
-            name?: string | undefined;
-            profile_picture?: {
-                file?: string | undefined;
-                height?: number | undefined;
-                media?: string | undefined;
-                mime_type?: string | undefined;
-                refresh_url?: string | undefined;
-                url?: string | undefined;
-                width?: number | undefined;
-            } | undefined;
-        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
         attachments?: {
             type: string;
             id: string;
@@ -784,46 +1344,61 @@ export declare const threadSchema: z.ZodObject<{
             url?: string | undefined;
             width?: number | undefined;
             name?: string | undefined;
+            description?: string | undefined;
+            title?: string | undefined;
             content_type?: string | undefined;
             filename?: string | undefined;
             image_source?: {
+                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;
-            description?: string | undefined;
             image_height?: number | undefined;
             image_url?: string | undefined;
             image_width?: number | undefined;
             media_type?: string | undefined;
-            title?: string | undefined;
             variants?: {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | undefined;
         }[] | undefined;
+        actors?: {
+            alias?: string | undefined;
+            id?: string | undefined;
+            name?: string | undefined;
+            profile_picture?: {
+                mime_type?: string | undefined;
+                file?: string | undefined;
+                height?: number | undefined;
+                media?: string | undefined;
+                refresh_url?: string | undefined;
+                url?: string | undefined;
+                width?: number | undefined;
+            } | undefined;
+        }[] | undefined;
+        agent_mode?: "cli" | "embedded" | undefined;
         branched_thread?: string | undefined;
         has_replies?: boolean | undefined;
         idempotency_key?: string | undefined;
@@ -845,24 +1420,32 @@ export declare const threadSchema: z.ZodObject<{
         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;
     }[] | undefined;
     participating_actor?: string[] | undefined;
     participating_agents?: {
         id: string;
         email?: string | undefined;
-        name?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
+        team?: string | undefined;
         org?: string | undefined;
-        sandbox?: string | undefined;
         created_at?: string | undefined;
-        user?: string | undefined;
-        updated_at?: string | undefined;
-        team?: string | undefined;
+        sandbox?: string | undefined;
         lookup_key?: string | undefined;
+        updated_at?: string | undefined;
+        user?: string | undefined;
+        name?: string | undefined;
+        app?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        org_name?: string | undefined;
         acl?: {
             add?: {
                 actions: string[];
@@ -879,12 +1462,69 @@ export declare const threadSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
-        app?: string | undefined;
         default_model?: string | undefined;
         identity?: string | undefined;
+        last_applied_template_config?: string | undefined;
+        originator?: string | undefined;
         phone_number?: string | undefined;
+        source_solution?: {
+            solution: {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            };
+            template: {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            };
+        } | undefined;
+        template_upgrade_available?: boolean | undefined;
     }[] | undefined;
-    role?: string | undefined;
     settings?: {
         agent_enabled?: boolean | undefined;
     } | undefined;
@@ -895,55 +1535,49 @@ export declare const threadSchema: z.ZodObject<{
 }, {
     id: string;
     key?: string | undefined;
-    metadata?: Record<string, unknown> | undefined;
+    team?: string | undefined;
     org?: string | undefined;
-    sandbox?: string | undefined;
     created_at?: string | undefined;
-    user?: string | undefined;
+    sandbox?: string | undefined;
     updated_at?: string | undefined;
+    user?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
     description?: string | undefined;
     title?: string | undefined;
-    team?: string | undefined;
+    role?: string | undefined;
     agent_user?: string | undefined;
     creator?: {
         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;
     } | undefined;
     is_channel?: boolean | undefined;
     is_default?: boolean | undefined;
     is_transient?: boolean | undefined;
     is_unlisted?: boolean | undefined;
     last_activity?: string | undefined;
+    muted?: boolean | undefined;
     parent_message?: {
         id: string;
         content?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
+        agent?: string | undefined;
+        thread?: string | undefined;
+        team?: string | undefined;
         org?: string | undefined;
-        sandbox?: string | undefined;
         created_at?: string | undefined;
-        thread?: string | undefined;
+        sandbox?: string | undefined;
         user?: string | undefined;
-        team?: string | undefined;
-        agent?: string | undefined;
-        actors?: {
-            alias?: string | undefined;
-            id?: string | undefined;
-            name?: string | undefined;
-            profile_picture?: {
-                file?: string | undefined;
-                height?: number | undefined;
-                media?: string | undefined;
-                mime_type?: string | undefined;
-                refresh_url?: string | undefined;
-                url?: string | undefined;
-                width?: number | undefined;
-            } | undefined;
-        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
         attachments?: {
             type: string;
             id: string;
@@ -952,46 +1586,61 @@ export declare const threadSchema: z.ZodObject<{
             url?: string | undefined;
             width?: number | undefined;
             name?: string | undefined;
+            description?: string | undefined;
+            title?: string | undefined;
             content_type?: string | undefined;
             filename?: string | undefined;
             image_source?: {
+                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;
-            description?: string | undefined;
             image_height?: number | undefined;
             image_url?: string | undefined;
             image_width?: number | undefined;
             media_type?: string | undefined;
-            title?: string | undefined;
             variants?: {
                 id: string;
+                created_at?: string | undefined;
+                updated_at?: string | undefined;
                 file?: string | undefined;
                 height?: number | undefined;
                 url?: string | undefined;
                 width?: number | undefined;
-                created_at?: string | undefined;
                 content_type?: string | undefined;
                 filename?: string | undefined;
                 image_source?: {
+                    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;
-                updated_at?: string | undefined;
                 variant_key?: string | undefined;
             }[] | undefined;
             version?: number | undefined;
         }[] | undefined;
+        actors?: {
+            alias?: string | undefined;
+            id?: string | undefined;
+            name?: string | undefined;
+            profile_picture?: {
+                mime_type?: string | undefined;
+                file?: string | undefined;
+                height?: number | undefined;
+                media?: string | undefined;
+                refresh_url?: string | undefined;
+                url?: string | undefined;
+                width?: number | undefined;
+            } | undefined;
+        }[] | undefined;
+        agent_mode?: "cli" | "embedded" | undefined;
         branched_thread?: string | undefined;
         has_replies?: boolean | undefined;
         idempotency_key?: string | undefined;
@@ -1013,24 +1662,32 @@ export declare const threadSchema: z.ZodObject<{
         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;
     }[] | undefined;
     participating_actor?: string[] | undefined;
     participating_agents?: {
         id: string;
         email?: string | undefined;
-        name?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
+        team?: string | undefined;
         org?: string | undefined;
-        sandbox?: string | undefined;
         created_at?: string | undefined;
-        user?: string | undefined;
-        updated_at?: string | undefined;
-        team?: string | undefined;
+        sandbox?: string | undefined;
         lookup_key?: string | undefined;
+        updated_at?: string | undefined;
+        user?: string | undefined;
+        name?: string | undefined;
+        app?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        org_name?: string | undefined;
         acl?: {
             add?: {
                 actions: string[];
@@ -1047,12 +1704,69 @@ export declare const threadSchema: z.ZodObject<{
                 principal?: string | undefined;
             }[] | undefined;
         } | undefined;
-        app?: string | undefined;
         default_model?: string | undefined;
         identity?: string | undefined;
+        last_applied_template_config?: string | undefined;
+        originator?: string | undefined;
         phone_number?: string | undefined;
+        source_solution?: {
+            solution: {
+                kind: string;
+                id: string;
+                owners: string[];
+                templates: {
+                    kind: string;
+                    id?: string | undefined;
+                    lookup_key?: string | undefined;
+                    virtual_path?: string | undefined;
+                    name?: string | undefined;
+                    description?: string | undefined;
+                    readme_url?: string | undefined;
+                    display_name?: string | undefined;
+                }[];
+                upgrade_available: boolean;
+                org?: string | undefined;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                org_name?: string | undefined;
+                category_keys?: string[] | undefined;
+                description?: string | undefined;
+                latest_solution?: string | undefined;
+                latest_version?: string | undefined;
+                org_logo?: {
+                    mime_type?: string | undefined;
+                    file?: string | undefined;
+                    height?: number | undefined;
+                    media?: string | undefined;
+                    refresh_url?: string | undefined;
+                    url?: string | undefined;
+                    width?: number | undefined;
+                } | undefined;
+                org_slug?: string | undefined;
+                readme_url?: string | undefined;
+                solution_id?: string | undefined;
+                solution_version?: string | undefined;
+                tag_keys?: string[] | undefined;
+                template_kind?: string | undefined;
+            };
+            template: {
+                kind: string;
+                id: string;
+                created_at?: string | undefined;
+                lookup_key?: string | undefined;
+                updated_at?: string | undefined;
+                virtual_path?: string | undefined;
+                name?: string | undefined;
+                description?: string | undefined;
+                display_name?: string | undefined;
+            };
+        } | undefined;
+        template_upgrade_available?: boolean | undefined;
     }[] | undefined;
-    role?: string | undefined;
     settings?: {
         agent_enabled?: boolean | undefined;
     } | undefined;
@@ -1061,35 +1775,64 @@ export declare const threadSchema: z.ZodObject<{
     ttl?: number | undefined;
     unread_count?: number | undefined;
 }>;
-export type Thread = z.infer<typeof threadSchema>;
-/** API schema for a thread member. */
+/** A user's membership record in a thread, capturing their role and full user profile. */
+export interface ThreadMember {
+    /** 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?: string | undefined;
+    /** ID of the thread this membership belongs to (`thr_...`). */
+    thread?: string | undefined;
+    /** Full user object for the member (`usr_...`). Present when the association is preloaded; `null` otherwise. */
+    user?: User | undefined;
+}
+/** Runtime validator for {@link ThreadMember}. */
 export declare const threadMemberSchema: z.ZodObject<{
+    /** 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.ZodOptional<z.ZodString>;
+    /** ID of the thread this membership belongs to (`thr_...`). */
     thread: z.ZodOptional<z.ZodString>;
+    /** Full user object for the member (`usr_...`). Present when the association is preloaded; `null` otherwise. */
     user: z.ZodOptional<z.ZodObject<{
         alias: z.ZodOptional<z.ZodString>;
+        app: z.ZodOptional<z.ZodString>;
+        app_name: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
         id: z.ZodString;
+        is_system_user: z.ZodOptional<z.ZodBoolean>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         name: z.ZodOptional<z.ZodString>;
         org: z.ZodOptional<z.ZodString>;
+        org_name: z.ZodOptional<z.ZodString>;
+        org_role: z.ZodOptional<z.ZodString>;
         sandbox: z.ZodOptional<z.ZodString>;
+        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;
     }>>;
 }, "strip", z.ZodTypeAny, {
     thread?: string | undefined;
@@ -1097,10 +1840,16 @@ export declare const threadMemberSchema: z.ZodObject<{
         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;
     } | undefined;
     membership_type?: string | undefined;
 }, {
@@ -1109,19 +1858,35 @@ export declare const threadMemberSchema: z.ZodObject<{
         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;
     } | undefined;
     membership_type?: string | undefined;
 }>;
-export type ThreadMember = z.infer<typeof threadMemberSchema>;
-/** Schema for thread read status response.
- */
+/** The read status of a thread for a specific user, indicating how far they have read and how many messages remain unread. */
+export interface ThreadReadStatus {
+    /** 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?: string | undefined;
+    /** Thread ID (`thr_...`) that this read status belongs to. */
+    thread: string;
+    /** Number of messages in the thread that the user has not yet read. */
+    unread_count: number;
+}
+/** Runtime validator for {@link ThreadReadStatus}. */
 export declare const threadReadStatusSchema: z.ZodObject<{
+    /** 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.ZodOptional<z.ZodString>;
+    /** Thread ID (`thr_...`) that this read status belongs to. */
     thread: z.ZodString;
+    /** Number of messages in the thread that the user has not yet read. */
     unread_count: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     thread: string;
@@ -1132,5 +1897,4 @@ export declare const threadReadStatusSchema: z.ZodObject<{
     unread_count: number;
     last_read_message?: string | undefined;
 }>;
-export type ThreadReadStatus = z.infer<typeof threadReadStatusSchema>;
 //# sourceMappingURL=threads.d.ts.map