@agentuity/core 1.0.32 → 1.0.34

package/dist/services/{task.d.ts → task/service.d.ts}

@@ -1,8 +1,15 @@
-import { FetchAdapter } from './adapter.ts';
+import { FetchAdapter } from '../adapter.ts';
+import { z } from 'zod';
 /**
  * Priority level for a task, from highest (`'high'`) to no priority (`'none'`).
  */
-export type TaskPriority = 'high' | 'medium' | 'low' | 'none';
+export declare const TaskPrioritySchema: z.ZodEnum<{
+    high: "high";
+    medium: "medium";
+    low: "low";
+    none: "none";
+}>;
+export type TaskPriority = z.infer<typeof TaskPrioritySchema>;
 /**
  * The classification of a task.
  *
@@ -12,7 +19,14 @@ export type TaskPriority = 'high' | 'medium' | 'low' | 'none';
  * - `'bug'` — Defects to be fixed.
  * - `'task'` — General work items.
  */
-export type TaskType = 'epic' | 'feature' | 'enhancement' | 'bug' | 'task';
+export declare const TaskTypeSchema: z.ZodEnum<{
+    epic: "epic";
+    feature: "feature";
+    enhancement: "enhancement";
+    bug: "bug";
+    task: "task";
+}>;
+export type TaskType = z.infer<typeof TaskTypeSchema>;
 /**
  * The lifecycle status of a task.
  *
@@ -22,37 +36,48 @@ export type TaskType = 'epic' | 'feature' | 'enhancement' | 'bug' | 'task';
  * - `'closed'` — Resolved and closed.
  * - `'cancelled'` — Abandoned.
  */
-export type TaskStatus = 'open' | 'in_progress' | 'closed' | 'done' | 'cancelled';
+export declare const TaskStatusSchema: z.ZodEnum<{
+    open: "open";
+    in_progress: "in_progress";
+    closed: "closed";
+    done: "done";
+    cancelled: "cancelled";
+}>;
+export type TaskStatus = z.infer<typeof TaskStatusSchema>;
 /**
  * A lightweight reference to a user or project entity, containing just the ID
  * and display name. Used for creator, assignee, closer, and project associations.
  */
-export interface EntityRef {
-    /** Unique identifier of the referenced entity. */
-    id: string;
-    /** Human-readable display name of the entity. */
-    name: string;
-}
+export declare const EntityRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type EntityRef = z.infer<typeof EntityRefSchema>;
 /**
  * The type of user entity.
  *
  * - `'human'` — A human user.
  * - `'agent'` — An AI agent.
  */
-export type UserType = 'human' | 'agent';
+export declare const UserTypeSchema: z.ZodEnum<{
+    human: "human";
+    agent: "agent";
+}>;
+export type UserType = z.infer<typeof UserTypeSchema>;
 /**
  * A reference to a user entity with type discrimination.
  * Extends {@link EntityRef} with a {@link UserEntityRef.type | type} field
  * to distinguish between human users and AI agents.
  */
-export interface UserEntityRef extends EntityRef {
-    /**
-     * The type of user. Defaults to `'human'` if not specified.
-     *
-     * @default 'human'
-     */
-    type?: UserType;
-}
+export declare const UserEntityRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        human: "human";
+        agent: "agent";
+    }>>;
+}, z.core.$strip>;
+export type UserEntityRef = z.infer<typeof UserEntityRefSchema>;
 /**
  * A work item in the task management system.
  *
@@ -65,495 +90,624 @@ export interface UserEntityRef extends EntityRef {
  * the corresponding date field (e.g., {@link Task.open_date | open_date},
  * {@link Task.in_progress_date | in_progress_date}) is set by the server.
  */
-export interface Task {
-    /** Unique identifier for the task. */
-    id: string;
-    /** ISO 8601 timestamp when the task was created. */
-    created_at: string;
-    /** ISO 8601 timestamp when the task was last modified. */
-    updated_at: string;
-    /**
-     * The task title.
-     *
-     * @remarks Must be non-empty and at most 1024 characters.
-     */
-    title: string;
-    /**
-     * Detailed description of the task.
-     *
-     * @remarks Maximum 65,536 characters.
-     */
-    description?: string;
-    /**
-     * Arbitrary key-value metadata attached to the task.
-     * Can be used for custom fields, integrations, or filtering.
-     */
-    metadata?: Record<string, unknown>;
-    /** The priority level of the task. */
-    priority: TaskPriority;
-    /**
-     * ID of the parent task, enabling hierarchical task organization
-     * (e.g., an epic containing features).
-     */
-    parent_id?: string;
-    /** The classification of this task. */
-    type: TaskType;
-    /** The current lifecycle status of the task. */
-    status: TaskStatus;
-    /** ISO 8601 timestamp when the task was moved to `'open'` status. */
-    open_date?: string;
-    /** ISO 8601 timestamp when the task was moved to `'in_progress'` status. */
-    in_progress_date?: string;
-    /** ISO 8601 timestamp when the task was closed. */
-    closed_date?: string;
-    /**
-     * ID of the user who created the task.
-     *
-     * @remarks Legacy field; prefer {@link Task.creator | creator}.
-     */
-    created_id: string;
-    /**
-     * ID of the user the task is assigned to.
-     *
-     * @remarks Legacy field; prefer {@link Task.assignee | assignee}.
-     */
-    assigned_id?: string;
-    /**
-     * ID of the user who closed the task.
-     *
-     * @remarks Legacy field; prefer {@link Task.closer | closer}.
-     */
-    closed_id?: string;
-    /** Reference to the user who created the task. */
-    creator?: UserEntityRef;
-    /** Reference to the user the task is assigned to. */
-    assignee?: UserEntityRef;
-    /** Reference to the user who closed the task. */
-    closer?: UserEntityRef;
-    /** Reference to the project this task belongs to. */
-    project?: EntityRef;
-    /** ISO 8601 timestamp when the task was cancelled. */
-    cancelled_date?: string;
-    /** Array of tags associated with this task. */
-    tags?: Tag[];
-    /** Array of comments on this task. */
-    comments?: Comment[];
-}
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    priority: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
+    }>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        epic: "epic";
+        feature: "feature";
+        enhancement: "enhancement";
+        bug: "bug";
+        task: "task";
+    }>;
+    status: z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        closed: "closed";
+        done: "done";
+        cancelled: "cancelled";
+    }>;
+    open_date: z.ZodOptional<z.ZodString>;
+    in_progress_date: z.ZodOptional<z.ZodString>;
+    closed_date: z.ZodOptional<z.ZodString>;
+    created_id: z.ZodString;
+    assigned_id: z.ZodOptional<z.ZodString>;
+    closed_id: z.ZodOptional<z.ZodString>;
+    creator: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>>;
+    assignee: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>>;
+    closer: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>>;
+    project: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    cancelled_date: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    comments: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        task_id: z.ZodString;
+        user_id: z.ZodString;
+        author: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>;
+        body: z.ZodString;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export type Task = z.infer<typeof TaskSchema>;
 /**
  * A comment on a task, supporting threaded discussion.
  */
-export interface Comment {
-    /** Unique identifier for the comment. */
-    id: string;
-    /** ISO 8601 timestamp when the comment was created. */
-    created_at: string;
-    /** ISO 8601 timestamp when the comment was last edited. */
-    updated_at: string;
-    /** ID of the task this comment belongs to. */
-    task_id: string;
-    /** ID of the user who authored the comment. */
-    user_id: string;
-    /** Reference to the comment author with display name. */
-    author?: UserEntityRef;
-    /**
-     * The comment text content.
-     *
-     * @remarks Must be non-empty.
-     */
-    body: string;
-}
+export declare const CommentSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    task_id: z.ZodString;
+    user_id: z.ZodString;
+    author: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type Comment = z.infer<typeof CommentSchema>;
 /**
  * A label that can be applied to tasks for categorization and filtering.
  */
-export interface Tag {
-    /** Unique identifier for the tag. */
-    id: string;
-    /** ISO 8601 timestamp when the tag was created. */
-    created_at: string;
-    /** Display name of the tag. */
-    name: string;
-    /**
-     * Optional hex color code for the tag.
-     *
-     * @example '#ff0000'
-     */
-    color?: string;
-}
+export declare const TagSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    name: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Tag = z.infer<typeof TagSchema>;
 /**
  * A record of a single field change on a task, providing an audit trail.
  */
-export interface TaskChangelogEntry {
-    /** Unique identifier for the changelog entry. */
-    id: string;
-    /** ISO 8601 timestamp when the change occurred. */
-    created_at: string;
-    /** ID of the task that was changed. */
-    task_id: string;
-    /**
-     * Name of the field that was changed.
-     *
-     * @example 'status'
-     * @example 'priority'
-     * @example 'assigned_id'
-     */
-    field: string;
-    /** The previous value of the field (as a string), or `undefined` if the field was newly set. */
-    old_value?: string;
-    /** The new value of the field (as a string), or `undefined` if the field was cleared. */
-    new_value?: string;
-}
+export declare const TaskChangelogEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    task_id: z.ZodString;
+    field: z.ZodString;
+    old_value: z.ZodOptional<z.ZodString>;
+    new_value: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TaskChangelogEntry = z.infer<typeof TaskChangelogEntrySchema>;
 /**
  * Parameters for creating a new task.
  */
-export interface CreateTaskParams {
-    /**
-     * The task title (required).
-     *
-     * @remarks Must be non-empty and at most 1024 characters.
-     */
-    title: string;
-    /**
-     * Detailed description of the task.
-     *
-     * @remarks Maximum 65,536 characters.
-     */
-    description?: string;
-    /** Arbitrary key-value metadata. */
-    metadata?: Record<string, unknown>;
-    /**
-     * Priority level. Defaults to `'none'` if not provided.
-     *
-     * @default 'none'
-     */
-    priority?: TaskPriority;
-    /** ID of the parent task for hierarchical organization. */
-    parent_id?: string;
-    /** The task classification (required). */
-    type: TaskType;
-    /**
-     * Initial status. Defaults to `'open'` if not provided.
-     *
-     * @default 'open'
-     */
-    status?: TaskStatus;
-    /**
-     * ID of the creator.
-     *
-     * @remarks Legacy field; prefer {@link CreateTaskParams.creator | creator}.
-     */
-    created_id: string;
-    /**
-     * ID of the assigned user.
-     *
-     * @remarks Legacy field; prefer {@link CreateTaskParams.assignee | assignee}.
-     */
-    assigned_id?: string;
-    /** Reference to the user creating the task (id, name, and optional type). */
-    creator?: UserEntityRef;
-    /** Reference to the user being assigned the task. */
-    assignee?: UserEntityRef;
-    /** Reference to the project this task belongs to. */
-    project?: EntityRef;
-    /** Array of tag IDs to associate with the task at creation. */
-    tag_ids?: string[];
-}
+export declare const CreateTaskParamsSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
+    }>>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        epic: "epic";
+        feature: "feature";
+        enhancement: "enhancement";
+        bug: "bug";
+        task: "task";
+    }>;
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        closed: "closed";
+        done: "done";
+        cancelled: "cancelled";
+    }>>;
+    created_id: z.ZodString;
+    assigned_id: z.ZodOptional<z.ZodString>;
+    creator: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+    assignee: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+    project: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    tag_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CreateTaskParams = z.infer<typeof CreateTaskParamsSchema>;
 /**
  * Parameters for partially updating an existing task.
  *
  * @remarks Only provided fields are modified; omitted fields remain unchanged.
  */
-export interface UpdateTaskParams {
-    /**
-     * Updated task title.
-     *
-     * @remarks Must be non-empty and at most 1024 characters if provided.
-     */
-    title?: string;
-    /**
-     * Updated description.
-     *
-     * @remarks Maximum 65,536 characters.
-     */
-    description?: string;
-    /** Updated key-value metadata. */
-    metadata?: Record<string, unknown>;
-    /** Updated priority level. */
-    priority?: TaskPriority;
-    /** Updated parent task ID. */
-    parent_id?: string;
-    /** Updated task classification. */
-    type?: TaskType;
-    /** Updated lifecycle status. */
-    status?: TaskStatus;
-    /**
-     * Updated assigned user ID.
-     *
-     * @remarks Legacy field; prefer {@link UpdateTaskParams.assignee | assignee}.
-     */
-    assigned_id?: string;
-    /**
-     * ID of the user closing the task.
-     *
-     * @remarks Legacy field; prefer {@link UpdateTaskParams.closer | closer}.
-     */
-    closed_id?: string;
-    /** Reference to the user being assigned the task. */
-    assignee?: UserEntityRef;
-    /** Reference to the user closing the task. */
-    closer?: UserEntityRef;
-    /** Reference to the project this task belongs to. */
-    project?: EntityRef;
-}
+export declare const UpdateTaskParamsSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
+    }>>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        epic: "epic";
+        feature: "feature";
+        enhancement: "enhancement";
+        bug: "bug";
+        task: "task";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        closed: "closed";
+        done: "done";
+        cancelled: "cancelled";
+    }>>;
+    assigned_id: z.ZodOptional<z.ZodString>;
+    closed_id: z.ZodOptional<z.ZodString>;
+    assignee: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+    closer: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+    project: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UpdateTaskParams = z.infer<typeof UpdateTaskParamsSchema>;
 /**
  * Parameters for filtering and paginating the task list.
  */
-export interface ListTasksParams {
-    /** Filter by task status. */
-    status?: TaskStatus;
-    /** Filter by task type. */
-    type?: TaskType;
-    /** Filter by priority level. */
-    priority?: TaskPriority;
-    /** Filter by assigned user ID. */
-    assigned_id?: string;
-    /** Filter by parent task ID (get subtasks). */
-    parent_id?: string;
-    /** Filter by project ID. */
-    project_id?: string;
-    /** Filter by tag ID. */
-    tag_id?: string;
-    /**
-     * Filter for soft-deleted tasks.
-     *
-     * @default false
-     */
-    deleted?: boolean;
-    /**
-     * Sort field. Prefix with `-` for descending order.
-     *
-     * @remarks Supported values: `'created_at'`, `'updated_at'`, `'priority'`.
-     * Prefix with `-` for descending (e.g., `'-created_at'`).
-     */
-    sort?: string;
-    /** Sort direction: `'asc'` or `'desc'`. */
-    order?: 'asc' | 'desc';
-    /** Maximum number of results to return. */
-    limit?: number;
-    /** Number of results to skip for pagination. */
-    offset?: number;
-}
+export declare const ListTasksParamsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        closed: "closed";
+        done: "done";
+        cancelled: "cancelled";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        epic: "epic";
+        feature: "feature";
+        enhancement: "enhancement";
+        bug: "bug";
+        task: "task";
+    }>>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
+    }>>;
+    assigned_id: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
+    tag_id: z.ZodOptional<z.ZodString>;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    sort: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ListTasksParams = z.infer<typeof ListTasksParamsSchema>;
 /**
  * Paginated list of tasks with total count.
  */
-export interface ListTasksResult {
-    /** Array of tasks matching the query. */
-    tasks: Task[];
-    /** Total number of tasks matching the filters (before pagination). */
-    total: number;
-    /** The limit that was applied. */
-    limit: number;
-    /** The offset that was applied. */
-    offset: number;
-}
+export declare const ListTasksResultSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        priority: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+            none: "none";
+        }>;
+        parent_id: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            epic: "epic";
+            feature: "feature";
+            enhancement: "enhancement";
+            bug: "bug";
+            task: "task";
+        }>;
+        status: z.ZodEnum<{
+            open: "open";
+            in_progress: "in_progress";
+            closed: "closed";
+            done: "done";
+            cancelled: "cancelled";
+        }>;
+        open_date: z.ZodOptional<z.ZodString>;
+        in_progress_date: z.ZodOptional<z.ZodString>;
+        closed_date: z.ZodOptional<z.ZodString>;
+        created_id: z.ZodString;
+        assigned_id: z.ZodOptional<z.ZodString>;
+        closed_id: z.ZodOptional<z.ZodString>;
+        creator: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>>;
+        assignee: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>>;
+        closer: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>>;
+        project: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        cancelled_date: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            created_at: z.ZodString;
+            name: z.ZodString;
+            color: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        comments: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            task_id: z.ZodString;
+            user_id: z.ZodString;
+            author: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                type: z.ZodOptional<z.ZodEnum<{
+                    human: "human";
+                    agent: "agent";
+                }>>;
+            }, z.core.$strip>>;
+            body: z.ZodString;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+export type ListTasksResult = z.infer<typeof ListTasksResultSchema>;
 /**
  * Parameters for batch-deleting tasks by filter.
  * At least one filter must be provided.
  */
-export interface BatchDeleteTasksParams {
-    /** Filter by task status. */
-    status?: TaskStatus;
-    /** Filter by task type. */
-    type?: TaskType;
-    /** Filter by priority level. */
-    priority?: TaskPriority;
-    /** Filter by parent task ID (delete subtasks). */
-    parent_id?: string;
-    /** Filter by creator ID. */
-    created_id?: string;
-    /**
-     * Delete tasks older than this duration.
-     * Accepts Go-style duration strings: `'30m'`, `'24h'`, `'7d'`, `'2w'`.
-     */
-    older_than?: string;
-    /**
-     * Maximum number of tasks to delete.
-     * @default 50
-     * @maximum 200
-     */
-    limit?: number;
-}
+export declare const BatchDeleteTasksParamsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        closed: "closed";
+        done: "done";
+        cancelled: "cancelled";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        epic: "epic";
+        feature: "feature";
+        enhancement: "enhancement";
+        bug: "bug";
+        task: "task";
+    }>>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+        none: "none";
+    }>>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    created_id: z.ZodOptional<z.ZodString>;
+    older_than: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type BatchDeleteTasksParams = z.infer<typeof BatchDeleteTasksParamsSchema>;
 /**
  * A single task that was deleted in a batch operation.
  */
-export interface BatchDeletedTask {
-    /** The ID of the deleted task. */
-    id: string;
-    /** The title of the deleted task. */
-    title: string;
-}
+export declare const BatchDeletedTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+export type BatchDeletedTask = z.infer<typeof BatchDeletedTaskSchema>;
 /**
  * Result of a batch delete operation.
  */
-export interface BatchDeleteTasksResult {
-    /** Array of tasks that were deleted. */
-    deleted: BatchDeletedTask[];
-    /** Total number of tasks deleted. */
-    count: number;
-}
+export declare const BatchDeleteTasksResultSchema: z.ZodObject<{
+    deleted: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export type BatchDeleteTasksResult = z.infer<typeof BatchDeleteTasksResultSchema>;
 /**
  * Paginated list of changelog entries for a task.
  */
-export interface TaskChangelogResult {
-    /** Array of change records. */
-    changelog: TaskChangelogEntry[];
-    /** Total number of changelog entries. */
-    total: number;
-    /** Applied limit. */
-    limit: number;
-    /** Applied offset. */
-    offset: number;
-}
+export declare const TaskChangelogResultSchema: z.ZodObject<{
+    changelog: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        task_id: z.ZodString;
+        field: z.ZodString;
+        old_value: z.ZodOptional<z.ZodString>;
+        new_value: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+export type TaskChangelogResult = z.infer<typeof TaskChangelogResultSchema>;
 /**
  * Paginated list of comments on a task.
  */
-export interface ListCommentsResult {
-    /** Array of comments. */
-    comments: Comment[];
-    /** Total number of comments. */
-    total: number;
-    /** Applied limit. */
-    limit: number;
-    /** Applied offset. */
-    offset: number;
-}
+export declare const ListCommentsResultSchema: z.ZodObject<{
+    comments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+        task_id: z.ZodString;
+        user_id: z.ZodString;
+        author: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>;
+        body: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+export type ListCommentsResult = z.infer<typeof ListCommentsResultSchema>;
 /**
  * List of all tags in the organization.
  */
-export interface ListTagsResult {
-    /** Array of tags. */
-    tags: Tag[];
-}
+export declare const ListTagsResultSchema: z.ZodObject<{
+    tags: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListTagsResult = z.infer<typeof ListTagsResultSchema>;
 /**
  * A file attachment on a task. Attachments are stored in S3 and accessed via presigned URLs.
  */
-export interface Attachment {
-    /** Unique identifier for the attachment. */
-    id: string;
-    /** ISO 8601 timestamp when the attachment was uploaded. */
-    created_at: string;
-    /** ID of the task this attachment belongs to. */
-    task_id: string;
-    /** ID of the user who uploaded the attachment. */
-    user_id: string;
-    /** Reference to the uploader with display name. */
-    author?: UserEntityRef;
-    /** Original filename of the uploaded file. */
-    filename: string;
-    /**
-     * MIME type of the file.
-     *
-     * @example 'application/pdf'
-     */
-    content_type?: string;
-    /** File size in bytes. */
-    size?: number;
-}
+export declare const AttachmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    task_id: z.ZodString;
+    user_id: z.ZodString;
+    author: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+    filename: z.ZodString;
+    content_type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Attachment = z.infer<typeof AttachmentSchema>;
 /**
  * Parameters for initiating a file upload to a task.
  */
-export interface CreateAttachmentParams {
-    /** The filename for the attachment (required). */
-    filename: string;
-    /** MIME type of the file. */
-    content_type?: string;
-    /** File size in bytes. */
-    size?: number;
-}
+export declare const CreateAttachmentParamsSchema: z.ZodObject<{
+    filename: z.ZodString;
+    content_type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateAttachmentParams = z.infer<typeof CreateAttachmentParamsSchema>;
 /**
  * Response from initiating an attachment upload. Contains a presigned S3 URL for direct upload.
  */
-export interface PresignUploadResponse {
-    /** The created attachment record. */
-    attachment: Attachment;
-    /** A presigned S3 URL to upload the file content via HTTP PUT. */
-    presigned_url: string;
-    /** Number of seconds until the presigned URL expires. */
-    expiry_seconds: number;
-}
+export declare const PresignUploadResponseSchema: z.ZodObject<{
+    attachment: z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        task_id: z.ZodString;
+        user_id: z.ZodString;
+        author: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>;
+        filename: z.ZodString;
+        content_type: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    presigned_url: z.ZodString;
+    expiry_seconds: z.ZodNumber;
+}, z.core.$strip>;
+export type PresignUploadResponse = z.infer<typeof PresignUploadResponseSchema>;
 /**
  * Response containing a presigned S3 URL for downloading an attachment.
  */
-export interface PresignDownloadResponse {
-    /** A presigned S3 URL to download the file via HTTP GET. */
-    presigned_url: string;
-    /** Number of seconds until the presigned URL expires. */
-    expiry_seconds: number;
-}
+export declare const PresignDownloadResponseSchema: z.ZodObject<{
+    presigned_url: z.ZodString;
+    expiry_seconds: z.ZodNumber;
+}, z.core.$strip>;
+export type PresignDownloadResponse = z.infer<typeof PresignDownloadResponseSchema>;
 /**
  * List of attachments on a task.
  */
-export interface ListAttachmentsResult {
-    /** Array of attachment records. */
-    attachments: Attachment[];
-    /** Total number of attachments. */
-    total: number;
-}
+export declare const ListAttachmentsResultSchema: z.ZodObject<{
+    attachments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        task_id: z.ZodString;
+        user_id: z.ZodString;
+        author: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<{
+                human: "human";
+                agent: "agent";
+            }>>;
+        }, z.core.$strip>>;
+        filename: z.ZodString;
+        content_type: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ListAttachmentsResult = z.infer<typeof ListAttachmentsResultSchema>;
 /**
  * List of all users who have been referenced in tasks (as creators, assignees, or closers).
  */
-export interface ListUsersResult {
-    /** Array of user entity references with type information. */
-    users: UserEntityRef[];
-}
+export declare const ListUsersResultSchema: z.ZodObject<{
+    users: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            agent: "agent";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListUsersResult = z.infer<typeof ListUsersResultSchema>;
 /**
  * List of all projects that have been referenced in tasks.
  */
-export interface ListProjectsResult {
-    /** Array of project entity references. */
-    projects: EntityRef[];
-}
+export declare const ListProjectsResultSchema: z.ZodObject<{
+    projects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListProjectsResult = z.infer<typeof ListProjectsResultSchema>;
 /**
  * Parameters for querying task activity time-series data.
  */
-export interface TaskActivityParams {
-    /**
-     * Number of days of activity to retrieve.
-     *
-     * @remarks Minimum 7, maximum 365.
-     * @default 90
-     */
-    days?: number;
-}
+export declare const TaskActivityParamsSchema: z.ZodObject<{
+    days: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TaskActivityParams = z.infer<typeof TaskActivityParamsSchema>;
 /**
  * A single day's snapshot of task counts by status.
  */
-export interface TaskActivityDataPoint {
-    /**
-     * The date in `YYYY-MM-DD` format.
-     *
-     * @example '2026-02-28'
-     */
-    date: string;
-    /** Number of tasks in `'open'` status on this date. */
-    open: number;
-    /** Number of tasks in `'in_progress'` status on this date. */
-    inProgress: number;
-    /** Number of tasks in `'done'` status on this date. */
-    done: number;
-    /** Number of tasks in `'closed'` status on this date. */
-    closed: number;
-    /** Number of tasks in `'cancelled'` status on this date. */
-    cancelled: number;
-}
+export declare const TaskActivityDataPointSchema: z.ZodObject<{
+    date: z.ZodString;
+    open: z.ZodNumber;
+    inProgress: z.ZodNumber;
+    done: z.ZodNumber;
+    closed: z.ZodNumber;
+    cancelled: z.ZodNumber;
+}, z.core.$strip>;
+export type TaskActivityDataPoint = z.infer<typeof TaskActivityDataPointSchema>;
 /**
  * Task activity time-series data.
  */
-export interface TaskActivityResult {
-    /** Array of daily activity snapshots, ordered chronologically. */
-    activity: TaskActivityDataPoint[];
-    /** The number of days of data returned. */
-    days: number;
-}
+export declare const TaskActivityResultSchema: z.ZodObject<{
+    activity: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        open: z.ZodNumber;
+        inProgress: z.ZodNumber;
+        done: z.ZodNumber;
+        closed: z.ZodNumber;
+        cancelled: z.ZodNumber;
+    }, z.core.$strip>>;
+    days: z.ZodNumber;
+}, z.core.$strip>;
+export type TaskActivityResult = z.infer<typeof TaskActivityResultSchema>;
 /**
  * Interface defining the contract for task storage operations.
  *
@@ -1334,4 +1488,4 @@ export declare class TaskStorageService implements TaskStorage {
      */
     getActivity(params?: TaskActivityParams): Promise<TaskActivityResult>;
 }
-//# sourceMappingURL=task.d.ts.map
+//# sourceMappingURL=service.d.ts.map