@archastro/sdk 0.13.0 → 0.14.0

package/dist/types/tasks.d.ts

@@ -29,27 +29,29 @@ export declare const taskSessionLeaseSummarySchema: z.ZodObject<{
 /** A task representing a unit of work, optionally assignable to a user or agent. */
 export interface Task {
     /** ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user. */
-    agent?: string | undefined;
+    agent?: string | 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. */
     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 | undefined;
+    closed_at?: string | null | undefined;
     /** Total number of comments posted on this task. */
     comments_count?: number | undefined;
     /** When the task was created (ISO 8601). */
     created_at?: string | undefined;
     /** 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?: Actor | undefined;
+    created_by_actor?: Actor | 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?: string | undefined;
+    created_by_agent?: string | null | undefined;
     /** 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?: string | undefined;
+    created_by_user?: string | null | undefined;
     /** 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?: TaskSessionLeaseSummary | undefined;
+    current_lease?: TaskSessionLeaseSummary | null | undefined;
     /** Long-form description or notes for the task. `null` if no description has been provided. */
-    description?: string | undefined;
+    description?: string | null | undefined;
     /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
-    due_date?: string | undefined;
+    due_date?: string | null | undefined;
+    /** Free-form grouping label. `null` when the task is not in an epic. */
+    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. */
@@ -61,19 +63,25 @@ export interface Task {
     /** Human-readable title of the task. */
     name: string;
     /** ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context. */
-    org?: string | undefined;
+    org?: string | null | undefined;
     /** 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?: Actor | undefined;
+    owner_actor?: Actor | 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?: string | undefined;
+    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 | undefined;
+    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. */
-    parent?: string | undefined;
+    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;
     /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
-    sandbox?: string | undefined;
+    sandbox?: string | null | undefined;
+    /** Source object identity (for example `ArchAstro/firstlanding`). `null` when the task has no source. */
+    source_id?: string | null | undefined;
+    /** 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?: string | null | undefined;
+    /** Kind of source object (for example `repository`). `null` when the task has no source. */
+    source_type?: string | null | undefined;
     /** Current status of the task. One of `"open"`, `"in_progress"`, or `"done"`. */
     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. */
@@ -81,89 +89,89 @@ export interface Task {
     /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
     tags?: string[] | undefined;
     /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
-    team?: string | undefined;
+    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. */
-    thread?: string | undefined;
+    thread?: string | null | undefined;
     /** When the task was last modified (ISO 8601). */
     updated_at?: string | undefined;
     /** ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team. */
-    user?: string | undefined;
+    user?: string | null | undefined;
 }
 /** Runtime validator for {@link Task}. */
 export declare const taskSchema: 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.ZodString>;
+    agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     /** 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. */
     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.ZodString>;
+    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.ZodObject<{
-        alias: z.ZodOptional<z.ZodString>;
-        id: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        profile_picture: 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>;
+    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 | undefined;
-            file?: string | undefined;
-            height?: number | undefined;
-            media?: string | undefined;
-            refresh_url?: string | undefined;
-            url?: string | undefined;
-            width?: number | 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;
         }, {
-            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 | 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, {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
+            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;
     }, {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
-    }>>;
+            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.ZodString>;
+    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.ZodString>;
+    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.ZodObject<{
+    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. */
@@ -178,11 +186,13 @@ export declare const taskSchema: z.ZodObject<{
         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.ZodString>;
+    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.ZodString>;
+    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 list/show reads; create/update responses report `false` until the next read. */
@@ -194,74 +204,80 @@ export declare const taskSchema: z.ZodObject<{
     /** 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.ZodString>;
+    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.ZodObject<{
-        alias: z.ZodOptional<z.ZodString>;
-        id: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        profile_picture: 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>;
+    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 | undefined;
-            file?: string | undefined;
-            height?: number | undefined;
-            media?: string | undefined;
-            refresh_url?: string | undefined;
-            url?: string | undefined;
-            width?: number | 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;
         }, {
-            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 | 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, {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
+            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;
     }, {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
-    }>>;
+            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.ZodString>;
+    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.ZodString>;
+    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. */
-    parent: z.ZodOptional<z.ZodString>;
+    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>;
     /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
-    sandbox: z.ZodOptional<z.ZodString>;
+    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>>;
     /** Current status of the task. One of `"open"`, `"in_progress"`, or `"done"`. */
     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. */
@@ -269,134 +285,142 @@ export declare const taskSchema: z.ZodObject<{
     /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
-    team: z.ZodOptional<z.ZodString>;
+    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.ZodString>;
+    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.ZodString>;
+    user: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     status: string;
     id: string;
-    agent?: string | undefined;
-    thread?: string | undefined;
-    team?: string | undefined;
-    org?: string | undefined;
-    description?: string | undefined;
+    agent?: string | null | undefined;
+    thread?: string | null | undefined;
+    team?: string | null | undefined;
+    org?: string | null | undefined;
+    description?: string | null | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
-    user?: string | undefined;
-    sandbox?: string | undefined;
-    parent?: string | undefined;
+    user?: string | null | undefined;
+    sandbox?: string | null | undefined;
+    parent?: string | null | undefined;
+    created_by_user?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
     tags?: string[] | undefined;
     blocked_by_count?: number | undefined;
-    closed_at?: string | undefined;
+    closed_at?: string | null | undefined;
     comments_count?: number | undefined;
     created_by_actor?: {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
-    created_by_agent?: string | undefined;
-    created_by_user?: string | 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;
+        } | null | undefined;
+    } | null | undefined;
+    created_by_agent?: string | null | undefined;
     current_lease?: {
         expires_at: string;
         harness: string;
         session_name: string;
-    } | undefined;
-    due_date?: string | undefined;
+    } | null | undefined;
+    due_date?: string | null | undefined;
+    epic?: string | null | undefined;
     is_blocked?: boolean | undefined;
     links?: Record<string, unknown> | undefined;
     owner_actor?: {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
-    owner_agent?: string | undefined;
-    owner_user?: string | 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;
+        } | null | undefined;
+    } | null | undefined;
+    owner_agent?: string | null | undefined;
+    owner_user?: string | null | undefined;
     priority?: number | undefined;
+    source_id?: string | null | undefined;
+    source_scope?: string | null | undefined;
+    source_type?: string | null | undefined;
     subtasks_count?: number | undefined;
 }, {
     name: string;
     status: string;
     id: string;
-    agent?: string | undefined;
-    thread?: string | undefined;
-    team?: string | undefined;
-    org?: string | undefined;
-    description?: string | undefined;
+    agent?: string | null | undefined;
+    thread?: string | null | undefined;
+    team?: string | null | undefined;
+    org?: string | null | undefined;
+    description?: string | null | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
-    user?: string | undefined;
-    sandbox?: string | undefined;
-    parent?: string | undefined;
+    user?: string | null | undefined;
+    sandbox?: string | null | undefined;
+    parent?: string | null | undefined;
+    created_by_user?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
     tags?: string[] | undefined;
     blocked_by_count?: number | undefined;
-    closed_at?: string | undefined;
+    closed_at?: string | null | undefined;
     comments_count?: number | undefined;
     created_by_actor?: {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
-    created_by_agent?: string | undefined;
-    created_by_user?: string | 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;
+        } | null | undefined;
+    } | null | undefined;
+    created_by_agent?: string | null | undefined;
     current_lease?: {
         expires_at: string;
         harness: string;
         session_name: string;
-    } | undefined;
-    due_date?: string | undefined;
+    } | null | undefined;
+    due_date?: string | null | undefined;
+    epic?: string | null | undefined;
     is_blocked?: boolean | undefined;
     links?: Record<string, unknown> | undefined;
     owner_actor?: {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
-    owner_agent?: string | undefined;
-    owner_user?: string | 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;
+        } | null | undefined;
+    } | null | undefined;
+    owner_agent?: string | null | undefined;
+    owner_user?: string | null | undefined;
     priority?: number | undefined;
+    source_id?: string | null | undefined;
+    source_scope?: string | null | undefined;
+    source_type?: string | null | undefined;
     subtasks_count?: number | undefined;
 }>;
 /** A comment posted on a task by a user or an agent, including resolved author information. */
@@ -428,60 +452,60 @@ export interface TaskComment {
 export declare const taskCommentSchema: z.ZodObject<{
     /** Resolved author details including `id`, `name`, `alias`, and `profile_picture`. `null` if no author is set or the author cannot be resolved (e.g. authoring agent was deleted). */
     author_actor: z.ZodOptional<z.ZodObject<{
-        alias: z.ZodOptional<z.ZodString>;
-        id: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        profile_picture: 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>;
+        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 | undefined;
-            file?: string | undefined;
-            height?: number | undefined;
-            media?: string | undefined;
-            refresh_url?: string | undefined;
-            url?: string | undefined;
-            width?: number | 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;
         }, {
-            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 | 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, {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
+            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;
     }, {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
+            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 posted this comment (`agi_...`). `null` if the author is a human user, or if the authoring agent was later deleted. */
     author_agent: z.ZodOptional<z.ZodString>;
@@ -512,18 +536,18 @@ export declare const taskCommentSchema: z.ZodObject<{
     updated_at?: string | undefined;
     sandbox?: string | undefined;
     author_actor?: {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
+            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;
     } | undefined;
     author_agent?: string | undefined;
     author_user?: string | undefined;
@@ -537,18 +561,18 @@ export declare const taskCommentSchema: z.ZodObject<{
     updated_at?: string | undefined;
     sandbox?: string | undefined;
     author_actor?: {
-        alias?: string | undefined;
-        name?: string | undefined;
-        id?: string | undefined;
+        alias?: string | null | undefined;
+        name?: string | null | undefined;
+        id?: string | null | 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;
+            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;
     } | undefined;
     author_agent?: string | undefined;
     author_user?: string | undefined;