@archastro/sdk 0.21.0 → 0.22.0

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

@@ -1,7 +1,7 @@
 import { HttpClient } from "../../runtime/http-client.js";
 import type { CurrentUser } from "../../types/common.js";
 import type { SystemAccessToken } from "../../types/system.js";
-import type { Task, TaskEnsureResult } from "../../types/tasks.js";
+import type { Task, TaskEnsureResult, TaskEpicEntity, TaskEpicEntityCollection } from "../../types/tasks.js";
 import type { Thread } from "../../types/threads.js";
 import type { User, UserInvite, UserSSHKey } from "../../types/users.js";
 export declare class IntegrationResource {
@@ -76,6 +76,98 @@ export declare class UserSshKeyResource {
         public_key: string;
     }): Promise<UserSSHKey>;
 }
+export declare class UserTaskEpicResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List an owner's epic summaries
+     * Groups tasks by their exact epic label, ordered by label. Closed tasks include cancelled tasks, but cancelled prerequisites still block. Source filters select the tasks summarized; blockers outside that selection still affect readiness. Root ranking is capped per epic and root_blockers_partial is true when that graph is truncated. No epic entity is created.
+     * @param params - Query parameters.
+     * @param params.representation - labels (default) or entities.
+     * @param params.name - Exact entity name; only used for entities.
+     * @param params.sourceScope - Exact source scope; supply all three source fields.
+     * @param params.sourceType - Exact source type.
+     * @param params.sourceId - Exact source ID.
+     * @param params.topPriority - Exact highest open priority, from 0 to 4.
+     * @param params.owner - Keep only epics with at least one non-closed task owned by this user: `me` or a user public ID (`usr_...`).
+     * @param params.includeClosed - Include epics with no non-closed tasks; defaults to false.
+     * @param params.limit - Maximum epics; defaults to 50, capped at 100.
+     * @param params.afterCursor - Opaque forward cursor from the preceding page.
+     * @returns Successful response
+     */
+    list(user: string, params?: {
+        representation?: string;
+        name?: string;
+        team?: string;
+        org?: string;
+        sourceScope?: string;
+        sourceType?: string;
+        sourceId?: string;
+        topPriority?: number;
+        owner?: string;
+        includeClosed?: boolean;
+        limit?: number;
+        afterCursor?: string;
+    }): Promise<{
+        after_cursor?: string | null | undefined;
+        before_cursor?: string | null | undefined;
+        data: {
+            blocked_count: number;
+            counts: Record<string, unknown>;
+            epic: string;
+            next_ready: {
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            }[];
+            owner?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            primary_task?: {
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            } | null | undefined;
+            root_blockers: {
+                downstream_count: number;
+                id: string;
+                name: string;
+                priority: number;
+                status: string;
+            }[];
+            root_blockers_partial: boolean;
+            top_open_priority?: number | null | undefined;
+            updated_at: string;
+        }[];
+        has_more: boolean;
+        no_epic_open_count: number;
+    } | TaskEpicEntityCollection>;
+    /**
+     * Create a task Epic
+     * @param input - Request body.
+     * @returns Successful response
+     */
+    create(user: string, input: {
+        description?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        name: string;
+        state?: string | undefined;
+        team?: string | undefined;
+    }): Promise<TaskEpicEntity>;
+}
 export declare class UserTaskResource {
     private http;
     constructor(http: HttpClient);
@@ -96,6 +188,9 @@ export declare class UserTaskResource {
      * @param params.status - Filter tasks by status. One of `"open"`, `"in_progress"`, `"in_review"`, or `"done"`. Omit to return tasks in all statuses.
      * @param params.ownerUser - Filter tasks assigned to a specific user. Provide the user's public ID (`usr_...`).
      * @param params.ownerAgent - Filter tasks assigned to a specific agent. Provide the agent's public ID (`agi_...`).
+     * @param params.owner - Return only tasks owned by this user: `me` or a user public ID (`usr_...`).
+     * @param params.involving - Return only tasks owned or created by this user: `me` or a user public ID (`usr_...`). The "My work" predicate.
+     * @param params.summary - When true, omit `description` from every task. Use for list views.
      * @param params.priority - Filter tasks by priority, from 0 (highest) to 4 (lowest).
      * @param params.tag - Return only tasks carrying this tag (matched against the canonical lowercase form).
      * @param params.parent - Return only subtasks of the given task (`tsk_...`), or pass `none` to return only top-level tasks.
@@ -121,6 +216,9 @@ export declare class UserTaskResource {
         status?: string;
         ownerUser?: string;
         ownerAgent?: string;
+        owner?: string;
+        involving?: string;
+        summary?: boolean;
         priority?: number;
         tag?: string;
         parent?: string;
@@ -145,6 +243,7 @@ export declare class UserTaskResource {
             agent?: string | null | undefined;
             aggregate_version?: number | null | undefined;
             blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
             closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
@@ -172,10 +271,12 @@ export declare class UserTaskResource {
             description?: string | null | undefined;
             due_date?: string | null | undefined;
             epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
             id: string;
             is_blocked?: boolean | undefined;
             is_stalled?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
             org?: string | null | undefined;
@@ -208,6 +309,7 @@ export declare class UserTaskResource {
             tags?: string[] | undefined;
             target_binary?: string | null | undefined;
             target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
             team?: string | null | undefined;
             thread?: string | null | undefined;
             updated_at?: string | undefined;
@@ -236,9 +338,11 @@ export declare class UserTaskResource {
         agent?: string | undefined;
         org?: string | undefined;
         task: {
+            blockers?: string[] | undefined;
             description?: string | undefined;
             due_date?: string | undefined;
             epic?: string | undefined;
+            epic_id?: string | undefined;
             id?: string | undefined;
             links?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -287,6 +391,7 @@ export declare class UserTaskResource {
                 agent?: string | null | undefined;
                 aggregate_version?: number | null | undefined;
                 blocked_by_count?: number | undefined;
+                blockers?: string[] | undefined;
                 closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
@@ -314,10 +419,12 @@ export declare class UserTaskResource {
                 description?: string | null | undefined;
                 due_date?: string | null | undefined;
                 epic?: string | null | undefined;
+                human_answer_receipts?: Record<string, unknown> | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
                 is_stalled?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
+                machine_rescope_receipts?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
                 org?: string | null | undefined;
@@ -350,6 +457,7 @@ export declare class UserTaskResource {
                 tags?: string[] | undefined;
                 target_binary?: string | null | undefined;
                 target_version?: string | null | undefined;
+                task_epic?: string | null | undefined;
                 team?: string | null | undefined;
                 thread?: string | null | undefined;
                 updated_at?: string | undefined;
@@ -358,6 +466,102 @@ export declare class UserTaskResource {
         }[];
         has_more: boolean;
     }>;
+    /**
+     * Find an owner's tasks by external reference
+     * Returns all exact external-reference matches owned by the requested principal. Multiple matches remain explicit; callers must not choose an arbitrary task.
+     * @param user - User ID (`usr_...`) for user-scoped tasks.
+     * @param params - Query parameters.
+     * @param params.team - Team owner.
+     * @param params.org - Organization consistency check.
+     * @param params.externalScope - External host.
+     * @param params.objectType - External object type.
+     * @param params.objectId - External object identity.
+     * @returns Successful response
+     */
+    byExternalReference(user: string, params?: {
+        team?: string;
+        org?: string;
+        externalScope?: string;
+        objectType?: string;
+        objectId?: string;
+    }): Promise<{
+        data: {
+            agent?: string | null | undefined;
+            aggregate_version?: number | null | undefined;
+            blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
+            closed_at?: string | null | undefined;
+            comments_count?: number | undefined;
+            created_at?: string | undefined;
+            created_by_actor?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            created_by_agent?: string | null | undefined;
+            created_by_user?: string | null | undefined;
+            current_lease?: {
+                expires_at: string;
+                harness: string;
+                session_name: string;
+            } | null | undefined;
+            description?: string | null | undefined;
+            due_date?: string | null | undefined;
+            epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
+            id: string;
+            is_blocked?: boolean | undefined;
+            is_stalled?: boolean | undefined;
+            links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            name: string;
+            org?: string | null | undefined;
+            owner_actor?: {
+                alias?: string | null | undefined;
+                id?: string | null | undefined;
+                name?: string | null | undefined;
+                profile_picture?: {
+                    file?: string | null | undefined;
+                    height?: number | null | undefined;
+                    media?: string | null | undefined;
+                    mime_type?: string | null | undefined;
+                    refresh_url?: string | null | undefined;
+                    url?: string | null | undefined;
+                    width?: number | null | undefined;
+                } | null | undefined;
+            } | null | undefined;
+            owner_agent?: string | null | undefined;
+            owner_user?: string | null | undefined;
+            parent?: string | null | undefined;
+            priority?: number | undefined;
+            project_id?: string | null | undefined;
+            sandbox?: string | null | undefined;
+            source_id?: string | null | undefined;
+            source_scope?: string | null | undefined;
+            source_type?: string | null | undefined;
+            stalled_since?: string | null | undefined;
+            status: string;
+            subtasks_count?: number | undefined;
+            tags?: string[] | undefined;
+            target_binary?: string | null | undefined;
+            target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
+            team?: string | null | undefined;
+            thread?: string | null | undefined;
+            updated_at?: string | undefined;
+            user?: string | null | undefined;
+        }[];
+    }>;
     /**
      * Find or create a task by source
      * Atomically creates one task per owner, tenant and source. Retries return the current task without updating it. Historical tasks created through ordinary create are not adopted.
@@ -368,6 +572,7 @@ export declare class UserTaskResource {
      * @param input.epic - Initial epic grouping.
      * @param input.name - Initial task name.
      * @param input.org - Explicit organization for privileged callers.
+     * @param input.owner_user - Initial assigned user; immutable on retries.
      * @param input.source_id - Source identity, for example owner/repo#123.
      * @param input.source_scope - Source scope, for example github.
      * @param input.source_type - Source type, for example pull_request.
@@ -381,6 +586,7 @@ export declare class UserTaskResource {
         epic?: string | undefined;
         name: string;
         org?: string | undefined;
+        owner_user?: string | undefined;
         source_id: string;
         source_scope: string;
         source_type: string;
@@ -431,6 +637,7 @@ export declare class UserTaskResource {
                 agent?: string | null | undefined;
                 aggregate_version?: number | null | undefined;
                 blocked_by_count?: number | undefined;
+                blockers?: string[] | undefined;
                 closed_at?: string | null | undefined;
                 comments_count?: number | undefined;
                 created_at?: string | undefined;
@@ -458,10 +665,12 @@ export declare class UserTaskResource {
                 description?: string | null | undefined;
                 due_date?: string | null | undefined;
                 epic?: string | null | undefined;
+                human_answer_receipts?: Record<string, unknown> | undefined;
                 id: string;
                 is_blocked?: boolean | undefined;
                 is_stalled?: boolean | undefined;
                 links?: Record<string, unknown> | undefined;
+                machine_rescope_receipts?: Record<string, unknown> | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 name: string;
                 org?: string | null | undefined;
@@ -494,6 +703,7 @@ export declare class UserTaskResource {
                 tags?: string[] | undefined;
                 target_binary?: string | null | undefined;
                 target_version?: string | null | undefined;
+                task_epic?: string | null | undefined;
                 team?: string | null | undefined;
                 thread?: string | null | undefined;
                 updated_at?: string | undefined;
@@ -556,6 +766,7 @@ export declare class UserTaskResource {
             agent?: string | null | undefined;
             aggregate_version?: number | null | undefined;
             blocked_by_count?: number | undefined;
+            blockers?: string[] | undefined;
             closed_at?: string | null | undefined;
             comments_count?: number | undefined;
             created_at?: string | undefined;
@@ -583,10 +794,12 @@ export declare class UserTaskResource {
             description?: string | null | undefined;
             due_date?: string | null | undefined;
             epic?: string | null | undefined;
+            human_answer_receipts?: Record<string, unknown> | undefined;
             id: string;
             is_blocked?: boolean | undefined;
             is_stalled?: boolean | undefined;
             links?: Record<string, unknown> | undefined;
+            machine_rescope_receipts?: Record<string, unknown> | undefined;
             metadata?: Record<string, unknown> | undefined;
             name: string;
             org?: string | null | undefined;
@@ -619,6 +832,7 @@ export declare class UserTaskResource {
             tags?: string[] | undefined;
             target_binary?: string | null | undefined;
             target_version?: string | null | undefined;
+            task_epic?: string | null | undefined;
             team?: string | null | undefined;
             thread?: string | null | undefined;
             updated_at?: string | undefined;
@@ -702,15 +916,30 @@ export declare class UserThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 actors?: {
                     alias?: string | null | undefined;
@@ -866,15 +1095,30 @@ export declare class UserThreadResource {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    add_denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
+                    denies?: {
+                        actions: string[];
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                     grants?: {
                         actions: string[];
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    preserve_denies?: boolean | undefined;
                     remove?: {
                         principal?: string | undefined;
                         principal_type: string;
                     }[] | undefined;
+                    remove_denies?: {
+                        principal?: string | undefined;
+                        principal_type: string;
+                    }[] | undefined;
                 } | null | undefined;
                 app?: string | undefined;
                 created_at?: string | undefined;
@@ -1047,6 +1291,7 @@ export declare class UserThreadResource {
             sub_threads?: Record<string, unknown>[] | null | undefined;
             tags?: string[] | undefined;
             team?: string | null | undefined;
+            thread_template_key?: string | null | undefined;
             title?: string | null | undefined;
             ttl?: string | null | undefined;
             unread_count?: number | null | undefined;
@@ -1096,6 +1341,38 @@ export declare class UserThreadResource {
             visibility?: "team" | "restricted" | "private" | "org" | undefined;
         };
     }): Promise<Thread>;
+    /**
+     * Create a private thread from a template
+     * Creates a private personal thread, installs the template's agent once per user,
+     * and atomically adds its members and a dedicated E2B computer. Requires
+     * `devbox_access`. The computer starts pending and provisions asynchronously.
+     * `key` is prefixed by the template namespace and is unique for the user. Replays return
+     * 200 and never provision another computer or resend the first message; creation
+     * returns 201. Initial-message delivery occurs after commit; a delivery failure
+     * is returned as `first_message_error` so the caller can resend it.
+     * `computer` is optional and applies on creation only: a replay with the same
+     * `key` returns the original thread and computer, ignoring any different
+     * `computer`, exactly like `title` and `first_message`. Invalid `computer`
+     * input returns 422 `invalid_parameters` before anything is created; a provider
+     * this deployment has no credentials for returns 422 `provider_unavailable`.
+     * Unknown templates return 422 `unknown_thread_template`; installation failures
+     * return 502 `agent_install_failed`. Computer config and credentials are never returned.
+     * @param user - User ID (`usr_...`) whose threads should be listed.
+     * @param input - Request body.
+     * @param input.computer - Optional computer choice, applied on creation only: `provider` (`sprites`, `vercel`, `e2b` or `devbox`; defaults to the template's) and `repositories` (0 to 16 `{repository: owner/name, ref: optional}`; the first is the primary working directory).
+     * @param input.first_message - Optional first user message, posted only on creation.
+     * @param input.key - Required nonempty client idempotency key.
+     * @param input.template - Thread template lookup key.
+     * @param input.title - Title for the new thread.
+     * @returns Thread fields plus agent and computers summaries, and optional first_message_error.
+     */
+    fromTemplate(user: string, input: {
+        computer?: Record<string, unknown> | undefined;
+        first_message?: string | undefined;
+        key?: string | undefined;
+        template: string;
+        title?: string | undefined;
+    }): Promise<Record<string, unknown>>;
 }
 export declare class TokenResource {
     private http;
@@ -1172,6 +1449,7 @@ export declare class UserResource {
     private http;
     readonly integrations: IntegrationResource;
     readonly ssh_keys: UserSshKeyResource;
+    readonly task_epics: UserTaskEpicResource;
     readonly tasks: UserTaskResource;
     readonly threads: UserThreadResource;
     readonly tokens: TokenResource;
@@ -1232,15 +1510,30 @@ export declare class UserResource {
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                add_denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
+                denies?: {
+                    actions: string[];
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
                 grants?: {
                     actions: string[];
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                preserve_denies?: boolean | undefined;
                 remove?: {
                     principal?: string | undefined;
                     principal_type: string;
                 }[] | undefined;
+                remove_denies?: {
+                    principal?: string | undefined;
+                    principal_type: string;
+                }[] | undefined;
             } | null | undefined;
             agent?: string | undefined;
             content_type?: string | undefined;
@@ -1357,55 +1650,5 @@ export declare class UserResource {
             mime_type?: string | undefined;
         } | null | undefined;
     }): Promise<User>;
-    /**
-     * List an owner's epic summaries
-     * Groups tasks by their exact epic label, ordered by label. Closed tasks include cancelled tasks, but cancelled prerequisites still block. Source filters select the tasks summarized; blockers outside that selection still affect readiness. Root ranking is capped per epic and root_blockers_partial is true when that graph is truncated. No epic entity is created.
-     * @param params - Query parameters.
-     * @param params.sourceScope - Exact source scope; supply all three source fields.
-     * @param params.sourceType - Exact source type.
-     * @param params.sourceId - Exact source ID.
-     * @param params.topPriority - Exact highest open priority, from 0 to 4.
-     * @param params.includeClosed - Include epics with no non-closed tasks; defaults to false.
-     * @param params.limit - Maximum epics; defaults to 50, capped at 100.
-     * @param params.afterCursor - Opaque forward cursor from the preceding page.
-     * @returns Successful response
-     */
-    taskEpics(user: string, params?: {
-        team?: string;
-        org?: string;
-        sourceScope?: string;
-        sourceType?: string;
-        sourceId?: string;
-        topPriority?: number;
-        includeClosed?: boolean;
-        limit?: number;
-        afterCursor?: string;
-    }): Promise<{
-        after_cursor?: string | null | undefined;
-        before_cursor?: string | null | undefined;
-        data: {
-            blocked_count: number;
-            counts: Record<string, unknown>;
-            epic: string;
-            next_ready: {
-                id: string;
-                name: string;
-                priority: number;
-                status: string;
-            }[];
-            root_blockers: {
-                downstream_count: number;
-                id: string;
-                name: string;
-                priority: number;
-                status: string;
-            }[];
-            root_blockers_partial: boolean;
-            top_open_priority?: number | null | undefined;
-            updated_at: string;
-        }[];
-        has_more: boolean;
-        no_epic_open_count: number;
-    }>;
 }
 //# sourceMappingURL=users.d.ts.map