@archastro/sdk 0.9.0 → 0.11.0

package/dist/types/tasks.d.ts

@@ -0,0 +1,601 @@
+import { z } from "zod";
+import type { Actor } from "./common.js";
+/** Viewer-safe details about a task's current coding-session lease. */
+export interface TaskSessionLeaseSummary {
+    /** Server-calculated lease expiry in ISO 8601 format. */
+    expires_at: string;
+    /** Bounded harness identifier for the coding session. */
+    harness: string;
+    /** Display name supplied by the coding session that holds the lease. */
+    session_name: string;
+}
+/** Runtime validator for {@link TaskSessionLeaseSummary}. */
+export declare const taskSessionLeaseSummarySchema: 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;
+}>;
+/** 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;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** Long-form description or notes for the task. `null` if no description has been provided. */
+    description?: string | undefined;
+    /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
+    due_date?: string | 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. */
+    is_blocked?: 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. */
+    metadata?: Record<string, unknown> | undefined;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** 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;
+    /** 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. */
+    subtasks_count?: number | undefined;
+    /** 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;
+    /** 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;
+    /** 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;
+}
+/** 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>;
+    /** 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>;
+    /** 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>;
+        }, "strip", z.ZodTypeAny, {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        }, {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }, {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }>>;
+    /** 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>;
+    /** 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>;
+    /** 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<{
+        /** 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.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>;
+    /** 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. */
+    is_blocked: 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.ZodUnknown>>;
+    /** 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.ZodUnknown>>;
+    /** 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>;
+    /** 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>;
+        }, "strip", z.ZodTypeAny, {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        }, {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }, {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }>>;
+    /** 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>;
+    /** 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>;
+    /** 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>;
+    /** 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>;
+    /** 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. */
+    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">>;
+    /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
+    team: z.ZodOptional<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>;
+    /** 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>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    status: string;
+    id: string;
+    agent?: string | undefined;
+    thread?: string | undefined;
+    team?: string | undefined;
+    org?: string | undefined;
+    description?: string | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    user?: string | undefined;
+    sandbox?: string | undefined;
+    parent?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    blocked_by_count?: number | undefined;
+    closed_at?: string | undefined;
+    comments_count?: number | undefined;
+    created_by_actor?: {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    } | undefined;
+    created_by_agent?: string | undefined;
+    created_by_user?: string | undefined;
+    current_lease?: {
+        expires_at: string;
+        harness: string;
+        session_name: string;
+    } | undefined;
+    due_date?: string | undefined;
+    is_blocked?: boolean | undefined;
+    links?: Record<string, unknown> | undefined;
+    owner_actor?: {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    } | undefined;
+    owner_agent?: string | undefined;
+    owner_user?: string | undefined;
+    priority?: number | 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;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    user?: string | undefined;
+    sandbox?: string | undefined;
+    parent?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    blocked_by_count?: number | undefined;
+    closed_at?: string | undefined;
+    comments_count?: number | undefined;
+    created_by_actor?: {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    } | undefined;
+    created_by_agent?: string | undefined;
+    created_by_user?: string | undefined;
+    current_lease?: {
+        expires_at: string;
+        harness: string;
+        session_name: string;
+    } | undefined;
+    due_date?: string | undefined;
+    is_blocked?: boolean | undefined;
+    links?: Record<string, unknown> | undefined;
+    owner_actor?: {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    } | undefined;
+    owner_agent?: string | undefined;
+    owner_user?: string | undefined;
+    priority?: number | undefined;
+    subtasks_count?: number | undefined;
+}>;
+/** A comment posted on a task by a user or an agent, including resolved author information. */
+export interface TaskComment {
+    /** 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?: Actor | 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?: string | undefined;
+    /** ID of the user who posted this comment (`usr_...`). `null` if the author is an agent, or if author provenance was cleared after the authoring agent was deleted. */
+    author_user?: string | undefined;
+    /** Plain-text body of the comment. */
+    body: string;
+    /** When this comment was posted (ISO 8601). */
+    created_at?: string | undefined;
+    /** Comment ID (`tcmt_...`). */
+    id: string;
+    /** ID of the organization that owns this comment (`org_...`). */
+    org?: string | undefined;
+    /** Sandbox ID this comment is scoped to. `null` for comments outside a sandbox environment. */
+    sandbox?: string | undefined;
+    /** ID of the task this comment belongs to (`tsk_...`). */
+    task?: string | undefined;
+    /** ID of the team the task belongs to (`tem_...`). `null` if not scoped to a team. */
+    team?: string | undefined;
+    /** When this comment was last edited (ISO 8601). */
+    updated_at?: string | undefined;
+}
+/** Runtime validator for {@link 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>;
+        }, "strip", z.ZodTypeAny, {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        }, {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }, {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    }>>;
+    /** 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>;
+    /** ID of the user who posted this comment (`usr_...`). `null` if the author is an agent, or if author provenance was cleared after the authoring agent was deleted. */
+    author_user: z.ZodOptional<z.ZodString>;
+    /** Plain-text body of the comment. */
+    body: z.ZodString;
+    /** When this comment was posted (ISO 8601). */
+    created_at: z.ZodOptional<z.ZodString>;
+    /** Comment ID (`tcmt_...`). */
+    id: z.ZodString;
+    /** ID of the organization that owns this comment (`org_...`). */
+    org: z.ZodOptional<z.ZodString>;
+    /** Sandbox ID this comment is scoped to. `null` for comments outside a sandbox environment. */
+    sandbox: z.ZodOptional<z.ZodString>;
+    /** ID of the task this comment belongs to (`tsk_...`). */
+    task: z.ZodOptional<z.ZodString>;
+    /** ID of the team the task belongs to (`tem_...`). `null` if not scoped to a team. */
+    team: z.ZodOptional<z.ZodString>;
+    /** When this comment was last edited (ISO 8601). */
+    updated_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    body: string;
+    id: string;
+    team?: string | undefined;
+    org?: string | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    sandbox?: string | undefined;
+    author_actor?: {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    } | undefined;
+    author_agent?: string | undefined;
+    author_user?: string | undefined;
+    task?: string | undefined;
+}, {
+    body: string;
+    id: string;
+    team?: string | undefined;
+    org?: string | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    sandbox?: string | undefined;
+    author_actor?: {
+        alias?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        profile_picture?: {
+            mime_type?: string | undefined;
+            file?: string | undefined;
+            height?: number | undefined;
+            media?: string | undefined;
+            refresh_url?: string | undefined;
+            url?: string | undefined;
+            width?: number | undefined;
+        } | undefined;
+    } | undefined;
+    author_agent?: string | undefined;
+    author_user?: string | undefined;
+    task?: string | undefined;
+}>;
+/** A task-session lease returned only to its matching holder. */
+export interface TaskSessionLease {
+    /** Server-calculated lease expiry in ISO 8601 format. */
+    expires_at: string;
+    /** Bounded harness identifier for the matching coding session. */
+    harness: string;
+    /** Caller-generated fencing token required for renewal and release. */
+    lease_id: string;
+    /** 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;
+}
+/** Runtime validator for {@link TaskSessionLease}. */
+export declare const taskSessionLeaseSchema: z.ZodObject<{
+    /** Server-calculated lease expiry in ISO 8601 format. */
+    expires_at: z.ZodString;
+    /** Bounded harness identifier for the matching coding session. */
+    harness: z.ZodString;
+    /** Caller-generated fencing token required for renewal and release. */
+    lease_id: z.ZodString;
+    /** 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;
+}, "strip", z.ZodTypeAny, {
+    expires_at: string;
+    harness: string;
+    session_name: string;
+    lease_id: string;
+    renewed_at: string;
+    session_id: string;
+}, {
+    expires_at: string;
+    harness: string;
+    session_name: string;
+    lease_id: string;
+    renewed_at: string;
+    session_id: string;
+}>;
+//# sourceMappingURL=tasks.d.ts.map

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

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