@archastro/sdk 0.9.0 → 0.10.0

package/dist/types/tasks.d.ts

@@ -0,0 +1,347 @@
+import { z } from "zod";
+import type { Actor } from "./common.js";
+/** 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;
+    /** 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>;
+    /** 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;
+    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;
+    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;
+}>;
+//# 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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"}

package/dist/types/tasks.js

@@ -0,0 +1,67 @@
+// Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
+// This file is auto-generated by @archastro/sdk-generator. Do not edit.
+// Content hash: 464e8cfe5ee1
+import { z } from "zod";
+import { actorSchema } from "./common.js";
+/** Runtime validator for {@link Task}. */
+export const taskSchema = z.object({
+    /** ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user. */
+    agent: z.string().optional().describe("ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user."),
+    /** 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.number().int().optional().describe("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."),
+    /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
+    closed_at: z.string().optional().describe("When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open."),
+    /** Total number of comments posted on this task. */
+    comments_count: z.number().int().optional().describe("Total number of comments posted on this task."),
+    /** When the task was created (ISO 8601). */
+    created_at: z.string().optional().describe("When the task was created (ISO 8601)."),
+    /** 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: actorSchema.optional().describe("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)."),
+    /** 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.string().optional().describe("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."),
+    /** 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.string().optional().describe("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."),
+    /** Long-form description or notes for the task. `null` if no description has been provided. */
+    description: z.string().optional().describe("Long-form description or notes for the task. `null` if no description has been provided."),
+    /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
+    due_date: z.string().optional().describe("Date and time by which the task should be completed (ISO 8601). `null` if no due date is set."),
+    /** Task ID (`tsk_...`). */
+    id: z.string().describe("Task ID (`tsk_...`)."),
+    /** `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.boolean().optional().describe("`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."),
+    /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
+    links: z.record(z.unknown()).optional().describe("Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set."),
+    /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
+    metadata: z.record(z.unknown()).optional().describe("Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set."),
+    /** Human-readable title of the task. */
+    name: z.string().describe("Human-readable title of the task."),
+    /** ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context. */
+    org: z.string().optional().describe("ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context."),
+    /** 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: actorSchema.optional().describe("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)."),
+    /** 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.string().optional().describe("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."),
+    /** 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.string().optional().describe("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."),
+    /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level. */
+    parent: z.string().optional().describe("ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level."),
+    /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
+    priority: z.number().int().optional().describe("Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set."),
+    /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
+    sandbox: z.string().optional().describe("ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment."),
+    /** Current status of the task. One of `"open"`, `"in_progress"`, or `"done"`. */
+    status: z.string().describe("Current status of the task. One of `\"open\"`, `\"in_progress\"`, or `\"done\"`."),
+    /** 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.number().int().optional().describe("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."),
+    /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
+    tags: z.array(z.string()).optional().describe("Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged."),
+    /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
+    team: z.string().optional().describe("ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team."),
+    /** 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.string().optional().describe("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."),
+    /** When the task was last modified (ISO 8601). */
+    updated_at: z.string().optional().describe("When the task was last modified (ISO 8601)."),
+    /** ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team. */
+    user: z.string().optional().describe("ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team."),
+}).describe("A task representing a unit of work, optionally assignable to a user or agent.");
+//# sourceMappingURL=tasks.js.map

package/dist/types/tasks.js.map

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