@loculabs/api-client 1.3.0 → 2.0.0

package/dist/index.d.mts

@@ -109,6 +109,12 @@ interface paths {
                     folderId?: string;
                     /** @description Include HTML representation of the note content */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the note content */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the note content */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the note content */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -182,6 +188,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the note content */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the note content */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the note content */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the note content */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -271,6 +283,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the note content */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the note content */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the note content */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the note content */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -422,6 +440,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the note content */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the note content */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the note content */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the note content */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -510,12 +534,22 @@ interface paths {
                 query?: {
                     /** @description Number of projects to return */
                     limit?: number;
-                    /** @description Cursor for pagination */
+                    /** @description Cursor for pagination. Use an ISO 8601 datetime cursor when orderBy=createdAt. */
                     cursor?: string;
+                    /** @description Field to order results by */
+                    orderBy?: "updatedAt" | "createdAt";
+                    /** @description Sort order (ascending or descending) */
+                    order?: "asc" | "desc";
                     /** @description Filter by project state */
                     state?: "planned" | "completed";
                     /** @description Include HTML representation of the project description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the project description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the project description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the project description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -589,6 +623,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the project description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the project description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the project description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the project description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -678,6 +718,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the project description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the project description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the project description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the project description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -829,6 +875,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the project description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the project description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the project description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the project description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -917,11 +969,15 @@ interface paths {
                 query?: {
                     /** @description Number of sessions to return */
                     limit?: number;
-                    /** @description Cursor for pagination */
+                    /** @description Cursor for pagination. Use ISO 8601 datetime cursors when orderBy is createdAt or finishedAt. */
                     cursor?: string;
-                    /** @description Filter sessions starting after this date (Unix seconds or ISO 8601) */
+                    /** @description Field to order results by */
+                    orderBy?: "updatedAt" | "createdAt" | "finishedAt";
+                    /** @description Sort order (ascending or descending) */
+                    order?: "asc" | "desc";
+                    /** @description Filter sessions starting after this date (ISO 8601) */
                     startAfter?: string;
-                    /** @description Filter sessions starting before this date (Unix seconds or ISO 8601) */
+                    /** @description Filter sessions starting before this date (ISO 8601) */
                     startBefore?: string;
                     /** @description Include activities in response */
                     includeActivities?: boolean | null;
@@ -1068,6 +1124,103 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/sessions/activities": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List activities
+         * @description Retrieve a paginated list of session activities. Supports filtering by task ID or session ID.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Number of activities to return */
+                    limit?: number;
+                    /** @description Cursor for pagination. Use an ISO 8601 datetime cursor when orderBy=createdAt. */
+                    cursor?: string;
+                    /** @description Field to order results by */
+                    orderBy?: "updatedAt" | "createdAt";
+                    /** @description Sort order (ascending or descending) */
+                    order?: "asc" | "desc";
+                    /** @description Filter activities by task ID */
+                    taskId?: string;
+                    /** @description Filter activities by session ID */
+                    sessionId?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Successful response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ActivityPaginatedListResponse"];
+                    };
+                };
+                /** @description Bad request - validation error */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Unauthorized - invalid or missing API key */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Resource not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/sessions/{id}": {
         parameters: {
             query?: never;
@@ -1643,10 +1796,14 @@ interface paths {
         get: {
             parameters: {
                 query?: {
-                    /** @description Cursor for pagination */
+                    /** @description Cursor for pagination. Use an ISO 8601 datetime cursor when ordering by doneAt. */
                     cursor?: string;
                     /** @description Number of items to return (max 100) */
                     limit?: string;
+                    /** @description Field to order results by. Note: doneAt ordering only applies to completed tasks */
+                    orderBy?: "updatedAt" | "doneAt";
+                    /** @description Sort order (ascending or descending) */
+                    order?: "asc" | "desc";
                     /** @description Filter by completion status */
                     done?: "true" | "false";
                     /** @description Filter by project */
@@ -1655,12 +1812,18 @@ interface paths {
                     parentId?: string;
                     /** @description Filter by section */
                     section?: "today" | "sooner" | "later";
-                    /** @description Filter tasks completed after this date (Unix seconds or ISO 8601) */
+                    /** @description Filter tasks completed after this date (ISO 8601) */
                     doneAfter?: string;
-                    /** @description Filter tasks completed before this date (Unix seconds or ISO 8601) */
+                    /** @description Filter tasks completed before this date (ISO 8601) */
                     doneBefore?: string;
                     /** @description Include HTML representation of the task description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the task description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the task description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the task description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -1734,6 +1897,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the task description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the task description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the task description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the task description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -1825,6 +1994,12 @@ interface paths {
                     section?: "today" | "sooner" | "later";
                     /** @description Include HTML representation of the task description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the task description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the task description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the task description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path?: never;
@@ -1905,13 +2080,19 @@ interface paths {
         };
         /**
          * Get task
-         * @description Retrieve a single task by ID.
+         * @description Retrieve a single task by ID with section, description, and subtask tree.
          */
         get: {
             parameters: {
                 query?: {
                     /** @description Include HTML representation of the task description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the task description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the task description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the task description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -1928,7 +2109,7 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["Task"];
+                        "application/json": components["schemas"]["TaskDetailResponse"];
                     };
                 };
                 /** @description Bad request - validation error */
@@ -2063,6 +2244,12 @@ interface paths {
                 query?: {
                     /** @description Include HTML representation of the task description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the task description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the task description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the task description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -2157,6 +2344,12 @@ interface paths {
                     done?: "true" | "false";
                     /** @description Include HTML representation of the task description */
                     includeHtml?: boolean | null;
+                    /** @description Include Markdown representation of the task description */
+                    includeMarkdown?: boolean | null;
+                    /** @description Include plain text representation of the task description */
+                    includePlainText?: boolean | null;
+                    /** @description Include ProseMirror JSON representation of the task description */
+                    includeJson?: boolean | null;
                 };
                 header?: never;
                 path: {
@@ -3307,15 +3500,28 @@ interface components {
             id: string;
             name: string;
             done: "completed" | "canceled" | null;
-            doneAt: number | null;
-            createdAt: number;
+            /**
+             * Format: date-time
+             * @description Completion timestamp (ISO 8601)
+             */
+            doneAt: string | null;
+            /**
+             * Format: date-time
+             * @description Creation timestamp (ISO 8601)
+             */
+            createdAt: string;
             parent: {
                 id: string;
                 order: number | null;
             } | null;
+            /** @description Task waiting state */
             waiting?: {
                 reason?: string;
-                waitingAt: number;
+                /**
+                 * Format: date-time
+                 * @description Timestamp when task entered waiting state (ISO 8601)
+                 */
+                waitingAt: string;
             } | null;
             projectId?: string | null;
             cursorAgentUrl?: string | null;
@@ -3328,12 +3534,12 @@ interface components {
             type: "locu";
             /** @description Task description in multiple formats */
             description?: {
-                /** @description Description content as Markdown */
-                markdown: string;
-                /** @description Description content as HTML (only included when includeHtml=true) */
+                /** @description Description content as Markdown (included when includeMarkdown=true) */
+                markdown?: string;
+                /** @description Description content as HTML (included when includeHtml=true) */
                 html?: string;
                 /**
-                 * @description Description content as ProseMirror JSON document
+                 * @description Description content as ProseMirror JSON document (included when includeJson=true)
                  * @example {
                  *       "type": "doc",
                  *       "content": [
@@ -3387,23 +3593,36 @@ interface components {
                         }[];
                     }[];
                 };
-                /** @description Description content as plain text */
-                plainText: string;
+                /** @description Description content as plain text (included when includePlainText=true) */
+                plainText?: string;
             } | null;
         };
         LinearTask: {
             id: string;
             name: string;
             done: "completed" | "canceled" | null;
-            doneAt: number | null;
-            createdAt: number;
+            /**
+             * Format: date-time
+             * @description Completion timestamp (ISO 8601)
+             */
+            doneAt: string | null;
+            /**
+             * Format: date-time
+             * @description Creation timestamp (ISO 8601)
+             */
+            createdAt: string;
             parent: {
                 id: string;
                 order: number | null;
             } | null;
+            /** @description Task waiting state */
             waiting?: {
                 reason?: string;
-                waitingAt: number;
+                /**
+                 * Format: date-time
+                 * @description Timestamp when task entered waiting state (ISO 8601)
+                 */
+                waitingAt: string;
             } | null;
             projectId?: string | null;
             cursorAgentUrl?: string | null;
@@ -3414,12 +3633,12 @@ interface components {
             teamId: string;
             /** @description Task description in multiple formats */
             description?: {
-                /** @description Description content as Markdown */
-                markdown: string;
-                /** @description Description content as HTML (only included when includeHtml=true) */
+                /** @description Description content as Markdown (included when includeMarkdown=true) */
+                markdown?: string;
+                /** @description Description content as HTML (included when includeHtml=true) */
                 html?: string;
                 /**
-                 * @description Description content as ProseMirror JSON document
+                 * @description Description content as ProseMirror JSON document (included when includeJson=true)
                  * @example {
                  *       "type": "doc",
                  *       "content": [
@@ -3473,8 +3692,8 @@ interface components {
                         }[];
                     }[];
                 };
-                /** @description Description content as plain text */
-                plainText: string;
+                /** @description Description content as plain text (included when includePlainText=true) */
+                plainText?: string;
             } | null;
             assignee: {
                 id: string;
@@ -3492,32 +3711,46 @@ interface components {
              * @enum {string}
              */
             type: "linear";
+            integrationDescription: string;
         };
         JiraTask: {
             id: string;
             name: string;
             done: "completed" | "canceled" | null;
-            doneAt: number | null;
-            createdAt: number;
+            /**
+             * Format: date-time
+             * @description Completion timestamp (ISO 8601)
+             */
+            doneAt: string | null;
+            /**
+             * Format: date-time
+             * @description Creation timestamp (ISO 8601)
+             */
+            createdAt: string;
             parent: {
                 id: string;
                 order: number | null;
             } | null;
+            /** @description Task waiting state */
             waiting?: {
                 reason?: string;
-                waitingAt: number;
+                /**
+                 * Format: date-time
+                 * @description Timestamp when task entered waiting state (ISO 8601)
+                 */
+                waitingAt: string;
             } | null;
             projectId: string;
             cursorAgentUrl?: string | null;
             integrationId: string;
             /** @description Task description in multiple formats */
             description?: {
-                /** @description Description content as Markdown */
-                markdown: string;
-                /** @description Description content as HTML (only included when includeHtml=true) */
+                /** @description Description content as Markdown (included when includeMarkdown=true) */
+                markdown?: string;
+                /** @description Description content as HTML (included when includeHtml=true) */
                 html?: string;
                 /**
-                 * @description Description content as ProseMirror JSON document
+                 * @description Description content as ProseMirror JSON document (included when includeJson=true)
                  * @example {
                  *       "type": "doc",
                  *       "content": [
@@ -3571,8 +3804,8 @@ interface components {
                         }[];
                     }[];
                 };
-                /** @description Description content as plain text */
-                plainText: string;
+                /** @description Description content as plain text (included when includePlainText=true) */
+                plainText?: string;
             } | null;
             assignee: {
                 id: string;
@@ -3602,7 +3835,24 @@ interface components {
              * @enum {string}
              */
             type: "jira";
+            integrationDescription: string;
+        };
+        TaskDetailResponse: components["schemas"]["Task"] & {
+            /**
+             * @description Section the task belongs to
+             * @enum {string|null}
+             */
+            section: "today" | "sooner" | "later" | null;
+            /** @description Subtask tree with descriptions */
+            subtasks?: components["schemas"]["SubTask"][];
         };
+        SubTask: (components["schemas"]["LocuTask"] & {
+            subtasks?: unknown[];
+        }) | (components["schemas"]["LinearTask"] & {
+            subtasks?: unknown[];
+        }) | (components["schemas"]["JiraTask"] & {
+            subtasks?: unknown[];
+        });
         MeResponse: {
             /** @description Email of the authenticated user */
             email: string;
@@ -3632,14 +3882,22 @@ interface components {
                 id: string;
                 type: "folder" | "virtual-folder";
             } | null;
-            createdAt?: number;
-            updatedAt?: number;
-            /** @description Note content as Markdown */
-            markdown: string;
-            /** @description Note content as HTML (only included when includeHtml=true) */
+            /**
+             * Format: date-time
+             * @description Creation timestamp (ISO 8601)
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Last update timestamp (ISO 8601)
+             */
+            updatedAt?: string;
+            /** @description Note content as Markdown (included when includeMarkdown=true) */
+            markdown?: string;
+            /** @description Note content as HTML (included when includeHtml=true) */
             html?: string;
             /**
-             * @description Note content as ProseMirror JSON document
+             * @description Note content as ProseMirror JSON document (included when includeJson=true)
              * @example {
              *       "type": "doc",
              *       "content": [
@@ -3693,8 +3951,8 @@ interface components {
                     }[];
                 }[];
             };
-            /** @description Note content as plain text */
-            plainText: string;
+            /** @description Note content as plain text (included when includePlainText=true) */
+            plainText?: string;
         };
         CreateNoteRequest: {
             /**
@@ -3710,6 +3968,11 @@ interface components {
             color?: string | null;
             /** @description Parent folder ID */
             folderId?: string;
+            /**
+             * @description Preserve extra blank lines as empty paragraphs instead of collapsing them
+             * @default true
+             */
+            keepBreaks: boolean;
         };
         UpdateNoteRequest: {
             /** @description New text content for the note */
@@ -3720,6 +3983,11 @@ interface components {
             color?: string | null;
             /** @description New parent folder ID */
             folderId?: string | null;
+            /**
+             * @description Preserve extra blank lines as empty paragraphs instead of collapsing them
+             * @default true
+             */
+            keepBreaks: boolean;
         };
         DeleteNoteResponse: {
             success: boolean;
@@ -3734,18 +4002,31 @@ interface components {
             name: string;
             icon: string | null;
             color: string | null;
-            state: "planned" | "completed";
-            completedAt?: number | null;
-            createdAt: number;
-            updatedAt: number;
+            state: "planned" | "completed" | "canceled";
+            /**
+             * Format: date-time
+             * @description Completion timestamp (ISO 8601)
+             */
+            completedAt?: string | null;
+            canceledAt?: number | null;
+            /**
+             * Format: date-time
+             * @description Creation timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Last update timestamp (ISO 8601)
+             */
+            updatedAt: string;
             /** @description Project description in multiple formats */
             description?: {
-                /** @description Description content as Markdown */
-                markdown: string;
-                /** @description Description content as HTML (only included when includeHtml=true) */
+                /** @description Description content as Markdown (included when includeMarkdown=true) */
+                markdown?: string;
+                /** @description Description content as HTML (included when includeHtml=true) */
                 html?: string;
                 /**
-                 * @description Description content as ProseMirror JSON document
+                 * @description Description content as ProseMirror JSON document (included when includeJson=true)
                  * @example {
                  *       "type": "doc",
                  *       "content": [
@@ -3799,8 +4080,8 @@ interface components {
                         }[];
                     }[];
                 };
-                /** @description Description content as plain text */
-                plainText: string;
+                /** @description Description content as plain text (included when includePlainText=true) */
+                plainText?: string;
             } | null;
         };
         CreateProjectRequest: {
@@ -3817,6 +4098,11 @@ interface components {
             icon?: string | null;
             /** @description Hex color for the icon (e.g., "#FF5733"). Only applies to Lucide icons, not emojis. */
             color?: string | null;
+            /**
+             * @description Preserve extra blank lines as empty paragraphs instead of collapsing them
+             * @default true
+             */
+            keepBreaks: boolean;
         };
         UpdateProjectRequest: {
             /** @description New name for the project */
@@ -3832,6 +4118,11 @@ interface components {
              * @enum {string}
              */
             state?: "planned" | "completed";
+            /**
+             * @description Preserve extra blank lines as empty paragraphs instead of collapsing them
+             * @default true
+             */
+            keepBreaks: boolean;
         };
         DeleteProjectResponse: {
             success: boolean;
@@ -3846,42 +4137,115 @@ interface components {
             activities: components["schemas"]["SessionActivity"][];
         };
         SessionActivity: {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the activity
+             */
+            id: string;
+            /**
+             * Format: date-time
+             * @description Activity start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Activity end timestamp (ISO 8601)
+             */
+            finishedAt: string;
+            /**
+             * Format: uuid
+             * @description Session ID this activity belongs to
+             */
+            sessionId: string;
+            /** @description Whether the activity was manually created */
+            isManual: boolean;
             /** @enum {string} */
             type: "TASK";
+            /** @description Associated task ID */
             taskId: string;
+        } | {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the activity
+             */
             id: string;
-            createdAt: number;
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Activity start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Activity end timestamp (ISO 8601)
+             */
+            finishedAt: string;
+            /**
+             * Format: uuid
+             * @description Session ID this activity belongs to
+             */
             sessionId: string;
+            /** @description Whether the activity was manually created */
             isManual: boolean;
-        } | {
             /** @enum {string} */
             type: "MEETING";
+            /** @description Meeting title */
             title: string;
-            htmlLink: string;
+            /** @description Meeting URL */
+            htmlLink?: string;
+            /** @description Meeting identifier */
             meetingId: string;
+            /** @description Calendar identifier */
             calendarId?: string;
+        } | {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the activity
+             */
             id: string;
-            createdAt: number;
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Activity start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Activity end timestamp (ISO 8601)
+             */
+            finishedAt: string;
+            /**
+             * Format: uuid
+             * @description Session ID this activity belongs to
+             */
             sessionId: string;
+            /** @description Whether the activity was manually created */
             isManual: boolean;
-        } | {
             /** @enum {string} */
             type: "PLANNING";
+        } | {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the activity
+             */
             id: string;
-            createdAt: number;
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Activity start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Activity end timestamp (ISO 8601)
+             */
+            finishedAt: string;
+            /**
+             * Format: uuid
+             * @description Session ID this activity belongs to
+             */
             sessionId: string;
+            /** @description Whether the activity was manually created */
             isManual: boolean;
-        } | {
             /** @enum {string} */
             type: "WRAP_UP";
-            id: string;
-            createdAt: number;
-            finishedAt: number;
-            sessionId: string;
-            isManual: boolean;
         };
         Session: {
             /**
@@ -3891,10 +4255,21 @@ interface components {
             id: string;
             /** @description Whether the session was manually created */
             isManual: boolean;
-            /** @description Start timestamp (Unix seconds) */
-            createdAt: number;
-            /** @description End timestamp (Unix seconds) */
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Session start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Session end timestamp (ISO 8601)
+             */
+            finishedAt: string;
+        };
+        ActivityPaginatedListResponse: {
+            data: components["schemas"]["SessionActivity"][];
+            nextCursor: string | null;
+            hasMore: boolean;
         };
         CreateSessionRequest: {
             /**
@@ -3902,16 +4277,28 @@ interface components {
              * @description Optional custom ID for the session
              */
             id?: string;
-            /** @description Start timestamp (Unix seconds) */
-            createdAt: number;
-            /** @description End timestamp (Unix seconds) */
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Session start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Session end timestamp (ISO 8601)
+             */
+            finishedAt: string;
         };
         UpdateSessionRequest: {
-            /** @description New start timestamp (Unix seconds) */
-            createdAt?: number;
-            /** @description New end timestamp (Unix seconds) */
-            finishedAt?: number;
+            /**
+             * Format: date-time
+             * @description New session start timestamp (ISO 8601)
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description New session end timestamp (ISO 8601)
+             */
+            finishedAt?: string;
         };
         DeleteSessionResponse: {
             success: boolean;
@@ -3926,16 +4313,28 @@ interface components {
             type: "TASK";
             /** @description Associated task ID */
             taskId: string;
-            /** @description Start timestamp (Unix seconds) */
-            createdAt: number;
-            /** @description End timestamp (Unix seconds) */
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Activity start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Activity end timestamp (ISO 8601)
+             */
+            finishedAt: string;
         };
         UpdateActivityRequest: {
-            /** @description New start timestamp (Unix seconds) */
-            createdAt?: number;
-            /** @description New end timestamp (Unix seconds) */
-            finishedAt?: number;
+            /**
+             * Format: date-time
+             * @description New activity start timestamp (ISO 8601)
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description New activity end timestamp (ISO 8601)
+             */
+            finishedAt?: string;
         };
         DeleteActivityResponse: {
             success: boolean;
@@ -3988,6 +4387,11 @@ interface components {
              * @enum {string}
              */
             section?: "today" | "sooner" | "later";
+            /**
+             * @description Preserve extra blank lines as empty paragraphs instead of collapsing them
+             * @default true
+             */
+            keepBreaks: boolean;
         };
         UpdateTaskRequest: {
             /** @description Task name */
@@ -4005,6 +4409,11 @@ interface components {
             waiting?: {
                 reason?: string;
             } | null;
+            /**
+             * @description Preserve extra blank lines as empty paragraphs instead of collapsing them
+             * @default true
+             */
+            keepBreaks: boolean;
         };
         DeleteTaskResponse: {
             success: boolean;
@@ -4019,8 +4428,8 @@ interface components {
             duration?: number;
             /** @description ID of the task being worked on (only present when ACTIVE with a task) */
             currentTaskId?: string;
-            /** @description When the timer was started as Unix timestamp in seconds (only present when not IDLE) */
-            startedAt?: number;
+            /** @description When the timer was started as an ISO 8601 datetime (only present when not IDLE) */
+            startedAt?: string;
         };
         StartTimerRequest: {
             /** @description Duration in seconds (must be positive) */
@@ -4037,10 +4446,16 @@ interface components {
             id: string;
             /** @description Whether the session was manually created */
             isManual: boolean;
-            /** @description Start timestamp (Unix seconds) */
-            createdAt: number;
-            /** @description End timestamp (Unix seconds) */
-            finishedAt: number;
+            /**
+             * Format: date-time
+             * @description Start timestamp (ISO 8601)
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description End timestamp (ISO 8601)
+             */
+            finishedAt: string;
         };
         WebhookListResponse: {
             data: components["schemas"]["Webhook"][];
@@ -4173,16 +4588,21 @@ interface components {
 type $defs = Record<string, never>;
 type operations = Record<string, never>;
 
+/** Helper to make keepBreaks optional (has server default) */
+type WithOptionalKeepBreaks<T> = Omit<T, "keepBreaks"> & {
+    keepBreaks?: boolean;
+};
 type Task = components["schemas"]["Task"];
-type CreateTaskRequest = components["schemas"]["CreateTaskRequest"];
-type UpdateTaskRequest = components["schemas"]["UpdateTaskRequest"];
+type TaskDetailResponse = components["schemas"]["TaskDetailResponse"];
+type CreateTaskRequest = WithOptionalKeepBreaks<components["schemas"]["CreateTaskRequest"]>;
+type UpdateTaskRequest = WithOptionalKeepBreaks<components["schemas"]["UpdateTaskRequest"]>;
 type TaskSectionsResponse = components["schemas"]["TaskSectionsResponse"];
 type Project = components["schemas"]["Project"];
-type CreateProjectRequest = components["schemas"]["CreateProjectRequest"];
-type UpdateProjectRequest = components["schemas"]["UpdateProjectRequest"];
+type CreateProjectRequest = WithOptionalKeepBreaks<components["schemas"]["CreateProjectRequest"]>;
+type UpdateProjectRequest = WithOptionalKeepBreaks<components["schemas"]["UpdateProjectRequest"]>;
 type Note = components["schemas"]["Note"];
-type CreateNoteRequest = components["schemas"]["CreateNoteRequest"];
-type UpdateNoteRequest = components["schemas"]["UpdateNoteRequest"];
+type CreateNoteRequest = WithOptionalKeepBreaks<components["schemas"]["CreateNoteRequest"]>;
+type UpdateNoteRequest = WithOptionalKeepBreaks<components["schemas"]["UpdateNoteRequest"]>;
 type Session = components["schemas"]["Session"];
 type SessionWithActivities = components["schemas"]["SessionWithActivities"];
 type SessionActivity = components["schemas"]["SessionActivity"];
@@ -4230,6 +4650,7 @@ type SubtaskListParams = Omit<NonNullable<paths["/tasks/{id}/subtasks"]["get"]["
 type ProjectListParams = NonNullable<paths["/projects"]["get"]["parameters"]["query"]>;
 type NoteListParams = NonNullable<paths["/notes"]["get"]["parameters"]["query"]>;
 type SessionListParams = NonNullable<paths["/sessions"]["get"]["parameters"]["query"]>;
+type ActivityListParams = NonNullable<paths["/sessions/activities"]["get"]["parameters"]["query"]>;
 type WebhookListParams = Omit<NonNullable<paths["/webhooks"]["get"]["parameters"]["query"]>, "isActive"> & {
     isActive?: BooleanParam;
 };
@@ -4270,7 +4691,7 @@ declare const createLocuClient: (config: LocuClientConfig) => {
         /** List all tasks */
         list: (params?: TaskListParams) => Promise<PaginatedResponse<Task>>;
         /** Get a single task by ID */
-        get: (id: string) => Promise<Task>;
+        get: (id: string) => Promise<TaskDetailResponse>;
         /** Create a new task */
         create: (data: CreateTaskRequest) => Promise<Task>;
         /** Update an existing task */
@@ -4318,7 +4739,7 @@ declare const createLocuClient: (config: LocuClientConfig) => {
         /** List all sessions */
         list: (params?: SessionListParams) => Promise<PaginatedResponse<SessionWithActivities>>;
         /** Get a single session by ID */
-        get: (id: string) => Promise<SessionWithActivities>;
+        get: (id: string) => Promise<Session>;
         /** Create a new session */
         create: (data: CreateSessionRequest) => Promise<Session>;
         /** Update an existing session */
@@ -4327,6 +4748,8 @@ declare const createLocuClient: (config: LocuClientConfig) => {
         delete: (id: string) => Promise<{
             success: boolean;
         }>;
+        /** List all activities with optional filters */
+        listActivities: (params?: ActivityListParams) => Promise<PaginatedResponse<SessionActivity>>;
         activities: {
             /** List activities for a session */
             list: (sessionId: string) => Promise<{