@archastro/sdk 0.20.0 → 0.21.0

package/dist/types/tasks.d.ts

@@ -32,7 +32,7 @@ export interface Task {
     agent?: string | null | undefined;
     /** Event-stream version for optimistic update fencing. Pass this value as `expected_version` on an update to reject concurrent writes. */
     aggregate_version?: number | null | undefined;
-    /** Number of tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
+    /** Number of readable tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
     blocked_by_count?: number | undefined;
     /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
     closed_at?: string | null | undefined;
@@ -56,8 +56,10 @@ export interface Task {
     epic?: string | null | undefined;
     /** Task ID (`tsk_...`). */
     id: string;
-    /** `true` while at least one blocking task is not yet done. Informational only — a blocked task can still change status — and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on list/show reads; create/update responses report `false` until the next read. */
+    /** `true` while at least one blocking task is not yet done. Informational only - a blocked task can still change status - and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on reads, including mutation responses. */
     is_blocked?: boolean | undefined;
+    /** True exactly when status is in_progress and the task has no lease or its lease expiry is in the past. Derived at read time from status and lease expiry, including on unannotated reads. */
+    is_stalled?: boolean | undefined;
     /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
     links?: Record<string, unknown> | undefined;
     /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
@@ -72,10 +74,12 @@ export interface Task {
     owner_agent?: string | null | undefined;
     /** ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted. */
     owner_user?: string | null | undefined;
-    /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level. */
+    /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks or when the parent is not readable. Subtasks nest exactly one level. */
     parent?: string | null | undefined;
     /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
     priority?: number | undefined;
+    /** Optional project ID (`prj_...`). Membership does not change task visibility. */
+    project_id?: string | null | undefined;
     /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
     sandbox?: string | null | undefined;
     /** Source object identity (for example `ArchAstro/firstlanding`). `null` when the task has no source. */
@@ -84,15 +88,21 @@ export interface Task {
     source_scope?: string | null | undefined;
     /** Kind of source object (for example `repository`). `null` when the task has no source. */
     source_type?: string | null | undefined;
+    /** Lease expiry for a stalled task, or its last update when no lease expiry exists. Null when not stalled. */
+    stalled_since?: string | null | undefined;
     /** Current status of the task. One of `"open"`, `"in_progress"`, `"in_review"`, `"paused"`, `"failed"`, `"superseding"`, `"done"`, or `"cancelled"`. */
     status: string;
-    /** Number of subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
+    /** Number of readable subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
     subtasks_count?: number | undefined;
     /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
     tags?: string[] | undefined;
+    /** Binary that must run this work (for example `my-cli`). A worker should take the task only when its own `target_binary` build is at least `target_version`. `null` when the task has no target. Set together with `target_version`. */
+    target_binary?: string | null | undefined;
+    /** Minimum semantic version of `target_binary` that can run this work (for example `0.48.9`), in canonical `MAJOR.MINOR.PATCH[-prerelease][+build]` form. `null` when the task has no target. */
+    target_version?: string | null | undefined;
     /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
     team?: string | null | undefined;
-    /** ID of the thread this task is bound to (`thr_...`) — the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
+    /** ID of the thread this task is bound to (`thr_...`) - the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
     thread?: string | null | undefined;
     /** When the task was last modified (ISO 8601). */
     updated_at?: string | undefined;
@@ -105,7 +115,7 @@ export declare const taskSchema: z.ZodObject<{
     agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Event-stream version for optimistic update fencing. Pass this value as `expected_version` on an update to reject concurrent writes. */
     aggregate_version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    /** Number of tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
+    /** Number of readable tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
     blocked_by_count: z.ZodOptional<z.ZodNumber>;
     /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
     closed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -199,8 +209,10 @@ export declare const taskSchema: z.ZodObject<{
     epic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Task ID (`tsk_...`). */
     id: z.ZodString;
-    /** `true` while at least one blocking task is not yet done. Informational only — a blocked task can still change status — and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on list/show reads; create/update responses report `false` until the next read. */
+    /** `true` while at least one blocking task is not yet done. Informational only - a blocked task can still change status - and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on reads, including mutation responses. */
     is_blocked: z.ZodOptional<z.ZodBoolean>;
+    /** True exactly when status is in_progress and the task has no lease or its lease expiry is in the past. Derived at read time from status and lease expiry, including on unannotated reads. */
+    is_stalled: z.ZodOptional<z.ZodBoolean>;
     /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
     links: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
     /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
@@ -270,10 +282,12 @@ export declare const taskSchema: z.ZodObject<{
     owner_agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted. */
     owner_user: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level. */
+    /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks or when the parent is not readable. Subtasks nest exactly one level. */
     parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
     priority: z.ZodOptional<z.ZodNumber>;
+    /** Optional project ID (`prj_...`). Membership does not change task visibility. */
+    project_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
     sandbox: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Source object identity (for example `ArchAstro/firstlanding`). `null` when the task has no source. */
@@ -282,15 +296,21 @@ export declare const taskSchema: z.ZodObject<{
     source_scope: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Kind of source object (for example `repository`). `null` when the task has no source. */
     source_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Lease expiry for a stalled task, or its last update when no lease expiry exists. Null when not stalled. */
+    stalled_since: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** Current status of the task. One of `"open"`, `"in_progress"`, `"in_review"`, `"paused"`, `"failed"`, `"superseding"`, `"done"`, or `"cancelled"`. */
     status: z.ZodString;
-    /** Number of subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
+    /** Number of readable subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
     subtasks_count: z.ZodOptional<z.ZodNumber>;
     /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Binary that must run this work (for example `my-cli`). A worker should take the task only when its own `target_binary` build is at least `target_version`. `null` when the task has no target. Set together with `target_version`. */
+    target_binary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Minimum semantic version of `target_binary` that can run this work (for example `0.48.9`), in canonical `MAJOR.MINOR.PATCH[-prerelease][+build]` form. `null` when the task has no target. */
+    target_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
     team: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** ID of the thread this task is bound to (`thr_...`) — the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
+    /** ID of the thread this task is bound to (`thr_...`) - the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
     thread: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** When the task was last modified (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
@@ -340,6 +360,7 @@ export declare const taskSchema: z.ZodObject<{
     due_date?: string | null | undefined;
     epic?: string | null | undefined;
     is_blocked?: boolean | undefined;
+    is_stalled?: boolean | undefined;
     links?: Record<string, {} | null> | undefined;
     owner_actor?: {
         name?: string | null | undefined;
@@ -358,10 +379,14 @@ export declare const taskSchema: z.ZodObject<{
     owner_agent?: string | null | undefined;
     owner_user?: string | null | undefined;
     priority?: number | undefined;
+    project_id?: string | null | undefined;
     source_id?: string | null | undefined;
     source_scope?: string | null | undefined;
     source_type?: string | null | undefined;
+    stalled_since?: string | null | undefined;
     subtasks_count?: number | undefined;
+    target_binary?: string | null | undefined;
+    target_version?: string | null | undefined;
 }, {
     name: string;
     status: string;
@@ -406,6 +431,7 @@ export declare const taskSchema: z.ZodObject<{
     due_date?: string | null | undefined;
     epic?: string | null | undefined;
     is_blocked?: boolean | undefined;
+    is_stalled?: boolean | undefined;
     links?: Record<string, {} | null> | undefined;
     owner_actor?: {
         name?: string | null | undefined;
@@ -424,10 +450,14 @@ export declare const taskSchema: z.ZodObject<{
     owner_agent?: string | null | undefined;
     owner_user?: string | null | undefined;
     priority?: number | undefined;
+    project_id?: string | null | undefined;
     source_id?: string | null | undefined;
     source_scope?: string | null | undefined;
     source_type?: string | null | undefined;
+    stalled_since?: string | null | undefined;
     subtasks_count?: number | undefined;
+    target_binary?: string | null | undefined;
+    target_version?: string | null | undefined;
 }>;
 /** A comment posted on a task by a user or an agent, including resolved author information. */
 export interface TaskComment {
@@ -541,6 +571,7 @@ export declare const taskCommentSchema: z.ZodObject<{
     created_at?: string | undefined;
     updated_at?: string | undefined;
     sandbox?: string | undefined;
+    task?: string | undefined;
     author_actor?: {
         name?: string | null | undefined;
         alias?: string | null | undefined;
@@ -557,7 +588,6 @@ export declare const taskCommentSchema: z.ZodObject<{
     } | undefined;
     author_agent?: string | undefined;
     author_user?: string | undefined;
-    task?: string | undefined;
 }, {
     body: string;
     id: string;
@@ -566,6 +596,7 @@ export declare const taskCommentSchema: z.ZodObject<{
     created_at?: string | undefined;
     updated_at?: string | undefined;
     sandbox?: string | undefined;
+    task?: string | undefined;
     author_actor?: {
         name?: string | null | undefined;
         alias?: string | null | undefined;
@@ -582,7 +613,516 @@ export declare const taskCommentSchema: z.ZodObject<{
     } | undefined;
     author_agent?: string | undefined;
     author_user?: string | undefined;
-    task?: string | undefined;
+}>;
+/** The current source task and whether this request created it. */
+export interface TaskEnsureResult {
+    /** Whether this request created the task. */
+    created: boolean;
+    /** The current task. */
+    task: Task;
+}
+/** Runtime validator for {@link TaskEnsureResult}. */
+export declare const taskEnsureResultSchema: z.ZodObject<{
+    /** Whether this request created the task. */
+    created: z.ZodBoolean;
+    /** The current task. */
+    task: z.ZodObject<{
+        /** ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user. */
+        agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Event-stream version for optimistic update fencing. Pass this value as `expected_version` on an update to reject concurrent writes. */
+        aggregate_version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        /** Number of readable tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
+        blocked_by_count: z.ZodOptional<z.ZodNumber>;
+        /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
+        closed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Total number of comments posted on this task. */
+        comments_count: z.ZodOptional<z.ZodNumber>;
+        /** When the task was created (ISO 8601). */
+        created_at: z.ZodOptional<z.ZodString>;
+        /** Resolved creator details including `id`, `name`, `alias`, and `profile_picture`. `null` if no creator is set or the creator cannot be resolved (e.g. creating agent was deleted). */
+        created_by_actor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            alias: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            profile_picture: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                media: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                mime_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                refresh_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, "strip", z.ZodTypeAny, {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            }, {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            } | null | undefined;
+        }, {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            } | null | undefined;
+        }>>>;
+        /** ID of the agent that created this task (`agi_...`). `null` if the task was created by a human user, or if the creating agent was later deleted. */
+        created_by_agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the user who created this task (`usr_...`). `null` if the task was created by an agent, or if creator provenance was cleared after the creator was deleted. */
+        created_by_user: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Viewer-safe live coding-session lease summary. `null` when the task is unleased or the projected lease has expired. Fencing identifiers are never included. */
+        current_lease: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            /** Server-calculated lease expiry in ISO 8601 format. */
+            expires_at: z.ZodString;
+            /** Bounded harness identifier for the coding session. */
+            harness: z.ZodString;
+            /** Display name supplied by the coding session that holds the lease. */
+            session_name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            expires_at: string;
+            harness: string;
+            session_name: string;
+        }, {
+            expires_at: string;
+            harness: string;
+            session_name: string;
+        }>>>;
+        /** Long-form description or notes for the task. `null` if no description has been provided. */
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
+        due_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Free-form grouping label. `null` when the task is not in an epic. */
+        epic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Task ID (`tsk_...`). */
+        id: z.ZodString;
+        /** `true` while at least one blocking task is not yet done. Informational only - a blocked task can still change status - and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on reads, including mutation responses. */
+        is_blocked: z.ZodOptional<z.ZodBoolean>;
+        /** True exactly when status is in_progress and the task has no lease or its lease expiry is in the past. Derived at read time from status and lease expiry, including on unannotated reads. */
+        is_stalled: z.ZodOptional<z.ZodBoolean>;
+        /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
+        links: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
+        /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
+        /** Human-readable title of the task. */
+        name: z.ZodString;
+        /** ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context. */
+        org: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Resolved owner details including `id`, `name`, `alias`, and `profile_picture`. `null` if the task is unassigned or the owner cannot be resolved (e.g. assigned agent was deleted). */
+        owner_actor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            alias: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            profile_picture: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                media: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                mime_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                refresh_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, "strip", z.ZodTypeAny, {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            }, {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            } | null | undefined;
+        }, {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: string | null | undefined;
+                refresh_url?: string | null | undefined;
+                url?: string | null | undefined;
+                width?: number | null | undefined;
+            } | null | undefined;
+        }>>>;
+        /** ID of the agent assigned as owner (`agi_...`). `null` if the owner is a human user, the task is unassigned, or the assigned agent was deleted. */
+        owner_agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted. */
+        owner_user: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks or when the parent is not readable. Subtasks nest exactly one level. */
+        parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
+        priority: z.ZodOptional<z.ZodNumber>;
+        /** Optional project ID (`prj_...`). Membership does not change task visibility. */
+        project_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
+        sandbox: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Source object identity (for example `ArchAstro/firstlanding`). `null` when the task has no source. */
+        source_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Container of the work this task is about (for example `github.com`). `null` when the task has no source. Set together with `source_type` and `source_id`. */
+        source_scope: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Kind of source object (for example `repository`). `null` when the task has no source. */
+        source_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Lease expiry for a stalled task, or its last update when no lease expiry exists. Null when not stalled. */
+        stalled_since: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Current status of the task. One of `"open"`, `"in_progress"`, `"in_review"`, `"paused"`, `"failed"`, `"superseding"`, `"done"`, or `"cancelled"`. */
+        status: z.ZodString;
+        /** Number of readable subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
+        subtasks_count: z.ZodOptional<z.ZodNumber>;
+        /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Binary that must run this work (for example `my-cli`). A worker should take the task only when its own `target_binary` build is at least `target_version`. `null` when the task has no target. Set together with `target_version`. */
+        target_binary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Minimum semantic version of `target_binary` that can run this work (for example `0.48.9`), in canonical `MAJOR.MINOR.PATCH[-prerelease][+build]` form. `null` when the task has no target. */
+        target_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
+        team: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the thread this task is bound to (`thr_...`) - the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
+        thread: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** When the task was last modified (ISO 8601). */
+        updated_at: z.ZodOptional<z.ZodString>;
+        /** ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team. */
+        user: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        status: string;
+        id: string;
+        user?: string | null | undefined;
+        org?: string | null | undefined;
+        agent?: string | null | undefined;
+        thread?: string | null | undefined;
+        team?: string | null | undefined;
+        description?: string | null | undefined;
+        created_at?: string | undefined;
+        updated_at?: string | undefined;
+        sandbox?: string | null | undefined;
+        parent?: string | null | undefined;
+        created_by_user?: string | null | undefined;
+        metadata?: Record<string, {} | null> | undefined;
+        tags?: string[] | undefined;
+        aggregate_version?: number | null | undefined;
+        blocked_by_count?: number | undefined;
+        closed_at?: string | null | undefined;
+        comments_count?: number | undefined;
+        created_by_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        current_lease?: {
+            expires_at: string;
+            harness: string;
+            session_name: string;
+        } | null | undefined;
+        due_date?: string | null | undefined;
+        epic?: string | null | undefined;
+        is_blocked?: boolean | undefined;
+        is_stalled?: boolean | undefined;
+        links?: Record<string, {} | null> | undefined;
+        owner_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        priority?: number | undefined;
+        project_id?: string | null | undefined;
+        source_id?: string | null | undefined;
+        source_scope?: string | null | undefined;
+        source_type?: string | null | undefined;
+        stalled_since?: string | null | undefined;
+        subtasks_count?: number | undefined;
+        target_binary?: string | null | undefined;
+        target_version?: string | null | undefined;
+    }, {
+        name: string;
+        status: string;
+        id: string;
+        user?: string | null | undefined;
+        org?: string | null | undefined;
+        agent?: string | null | undefined;
+        thread?: string | null | undefined;
+        team?: string | null | undefined;
+        description?: string | null | undefined;
+        created_at?: string | undefined;
+        updated_at?: string | undefined;
+        sandbox?: string | null | undefined;
+        parent?: string | null | undefined;
+        created_by_user?: string | null | undefined;
+        metadata?: Record<string, {} | null> | undefined;
+        tags?: string[] | undefined;
+        aggregate_version?: number | null | undefined;
+        blocked_by_count?: number | undefined;
+        closed_at?: string | null | undefined;
+        comments_count?: number | undefined;
+        created_by_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        current_lease?: {
+            expires_at: string;
+            harness: string;
+            session_name: string;
+        } | null | undefined;
+        due_date?: string | null | undefined;
+        epic?: string | null | undefined;
+        is_blocked?: boolean | undefined;
+        is_stalled?: boolean | undefined;
+        links?: Record<string, {} | null> | undefined;
+        owner_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        priority?: number | undefined;
+        project_id?: string | null | undefined;
+        source_id?: string | null | undefined;
+        source_scope?: string | null | undefined;
+        source_type?: string | null | undefined;
+        stalled_since?: string | null | undefined;
+        subtasks_count?: number | undefined;
+        target_binary?: string | null | undefined;
+        target_version?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    task: {
+        name: string;
+        status: string;
+        id: string;
+        user?: string | null | undefined;
+        org?: string | null | undefined;
+        agent?: string | null | undefined;
+        thread?: string | null | undefined;
+        team?: string | null | undefined;
+        description?: string | null | undefined;
+        created_at?: string | undefined;
+        updated_at?: string | undefined;
+        sandbox?: string | null | undefined;
+        parent?: string | null | undefined;
+        created_by_user?: string | null | undefined;
+        metadata?: Record<string, {} | null> | undefined;
+        tags?: string[] | undefined;
+        aggregate_version?: number | null | undefined;
+        blocked_by_count?: number | undefined;
+        closed_at?: string | null | undefined;
+        comments_count?: number | undefined;
+        created_by_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        current_lease?: {
+            expires_at: string;
+            harness: string;
+            session_name: string;
+        } | null | undefined;
+        due_date?: string | null | undefined;
+        epic?: string | null | undefined;
+        is_blocked?: boolean | undefined;
+        is_stalled?: boolean | undefined;
+        links?: Record<string, {} | null> | undefined;
+        owner_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        priority?: number | undefined;
+        project_id?: string | null | undefined;
+        source_id?: string | null | undefined;
+        source_scope?: string | null | undefined;
+        source_type?: string | null | undefined;
+        stalled_since?: string | null | undefined;
+        subtasks_count?: number | undefined;
+        target_binary?: string | null | undefined;
+        target_version?: string | null | undefined;
+    };
+    created: boolean;
+}, {
+    task: {
+        name: string;
+        status: string;
+        id: string;
+        user?: string | null | undefined;
+        org?: string | null | undefined;
+        agent?: string | null | undefined;
+        thread?: string | null | undefined;
+        team?: string | null | undefined;
+        description?: string | null | undefined;
+        created_at?: string | undefined;
+        updated_at?: string | undefined;
+        sandbox?: string | null | undefined;
+        parent?: string | null | undefined;
+        created_by_user?: string | null | undefined;
+        metadata?: Record<string, {} | null> | undefined;
+        tags?: string[] | undefined;
+        aggregate_version?: number | null | undefined;
+        blocked_by_count?: number | undefined;
+        closed_at?: string | null | undefined;
+        comments_count?: number | undefined;
+        created_by_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        current_lease?: {
+            expires_at: string;
+            harness: string;
+            session_name: string;
+        } | null | undefined;
+        due_date?: string | null | undefined;
+        epic?: string | null | undefined;
+        is_blocked?: boolean | undefined;
+        is_stalled?: boolean | undefined;
+        links?: Record<string, {} | null> | undefined;
+        owner_actor?: {
+            name?: string | null | undefined;
+            alias?: string | null | undefined;
+            id?: string | null | undefined;
+            profile_picture?: {
+                mime_type?: string | null | undefined;
+                file?: string | null | undefined;
+                height?: number | null | undefined;
+                media?: 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;
+        priority?: number | undefined;
+        project_id?: string | null | undefined;
+        source_id?: string | null | undefined;
+        source_scope?: string | null | undefined;
+        source_type?: string | null | undefined;
+        stalled_since?: string | null | undefined;
+        subtasks_count?: number | undefined;
+        target_binary?: string | null | undefined;
+        target_version?: string | null | undefined;
+    };
+    created: boolean;
 }>;
 /** An indexed external object linked to a task. */
 export interface TaskExternalLink {
@@ -610,6 +1150,32 @@ export declare const taskExternalLinkSchema: z.ZodObject<{
     object_id: string;
     object_type: string;
 }>;
+/** The background job accepted for a task ownership conversion. */
+export interface TaskOwnershipJob {
+    /** Background job ID. */
+    job_id: number;
+    /** Completed transfers are still reaching task read models. */
+    projection_pending?: boolean | undefined;
+    /** Current background job state. */
+    status: string;
+}
+/** Runtime validator for {@link TaskOwnershipJob}. */
+export declare const taskOwnershipJobSchema: z.ZodObject<{
+    /** Background job ID. */
+    job_id: z.ZodNumber;
+    /** Completed transfers are still reaching task read models. */
+    projection_pending: z.ZodOptional<z.ZodBoolean>;
+    /** Current background job state. */
+    status: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    job_id: number;
+    projection_pending?: boolean | undefined;
+}, {
+    status: string;
+    job_id: number;
+    projection_pending?: boolean | undefined;
+}>;
 /** A task-session lease returned only to its matching holder. */
 export interface TaskSessionLease {
     /** Server-calculated lease expiry in ISO 8601 format. */
@@ -618,12 +1184,18 @@ export interface TaskSessionLease {
     harness: string;
     /** Caller-generated fencing token required for renewal and release. */
     lease_id: string;
+    /** Milliseconds of lease left when the response was built, clamped at zero. A renewal made while more than half the lease remains appends no event and leaves the expiry unchanged, so clients derive their deadline from this value. */
+    lease_remaining_ms: number;
     /** Server timestamp for the most recent claim, reclaim, or renewal. */
     renewed_at: string;
     /** Opaque caller-generated coding-session identifier. */
     session_id: string;
     /** Display name supplied by the matching coding session. */
     session_name: string;
+    /** Task aggregate version including the claim, reclaim, or renewal event. */
+    task_aggregate_version: number;
+    /** Native task status after the lease event. */
+    task_status: string;
 }
 /** Runtime validator for {@link TaskSessionLease}. */
 export declare const taskSessionLeaseSchema: z.ZodObject<{
@@ -633,25 +1205,37 @@ export declare const taskSessionLeaseSchema: z.ZodObject<{
     harness: z.ZodString;
     /** Caller-generated fencing token required for renewal and release. */
     lease_id: z.ZodString;
+    /** Milliseconds of lease left when the response was built, clamped at zero. A renewal made while more than half the lease remains appends no event and leaves the expiry unchanged, so clients derive their deadline from this value. */
+    lease_remaining_ms: z.ZodNumber;
     /** Server timestamp for the most recent claim, reclaim, or renewal. */
     renewed_at: z.ZodString;
     /** Opaque caller-generated coding-session identifier. */
     session_id: z.ZodString;
     /** Display name supplied by the matching coding session. */
     session_name: z.ZodString;
+    /** Task aggregate version including the claim, reclaim, or renewal event. */
+    task_aggregate_version: z.ZodNumber;
+    /** Native task status after the lease event. */
+    task_status: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    expires_at: string;
     session_id: string;
+    expires_at: string;
     harness: string;
     session_name: string;
     lease_id: string;
+    lease_remaining_ms: number;
     renewed_at: string;
+    task_aggregate_version: number;
+    task_status: string;
 }, {
-    expires_at: string;
     session_id: string;
+    expires_at: string;
     harness: string;
     session_name: string;
     lease_id: string;
+    lease_remaining_ms: number;
     renewed_at: string;
+    task_aggregate_version: number;
+    task_status: string;
 }>;
 //# sourceMappingURL=tasks.d.ts.map