@taico/client 0.2.14 → 0.2.16

package/dist/contracts/types.d.ts

@@ -1688,7 +1688,7 @@ export interface paths {
         };
         /**
          * List the current task execution work queue
-         * @description Returns the tasks currently present in the execution queue. Presence means the task is ready to be picked by the executor.
+         * @description Returns the tasks currently present in the execution queue with pagination. Presence means the task is ready to be picked by the executor.
          */
         get: operations["TaskExecutionQueueController_listQueue"];
         put?: never;
@@ -1728,7 +1728,7 @@ export interface paths {
         };
         /**
          * List active task executions
-         * @description Returns the tasks currently being worked on in the execution system.
+         * @description Returns the tasks currently being worked on in the execution system with pagination.
          */
         get: operations["ActiveTaskExecutionController_listActiveExecutions"];
         put?: never;
@@ -1759,6 +1759,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/executions/active/{executionId}/unclaim": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Unclaim an active task execution and return it to the queue
+         * @description Atomically removes the execution from the active execution table and returns its task to the execution queue. Only the worker that claimed the execution may unclaim it.
+         */
+        post: operations["ActiveTaskExecutionController_unclaimTaskExecution"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/executions/active/{executionId}/session": {
         parameters: {
             query?: never;
@@ -1799,6 +1819,26 @@ export interface paths {
         patch: operations["ActiveTaskExecutionController_incrementToolCallCount"];
         trace?: never;
     };
+    "/api/v1/executions/active/{executionId}/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Patch execution stats and metadata
+         * @description Atomically updates one or more execution metadata fields such as harness, model details, or token usage.
+         */
+        patch: operations["ActiveTaskExecutionController_updateExecutionStats"];
+        trace?: never;
+    };
     "/api/v1/executions/active/{executionId}/interrupt": {
         parameters: {
             query?: never;
@@ -1828,7 +1868,7 @@ export interface paths {
         };
         /**
          * List task execution history
-         * @description Returns the persisted execution history rows in the execution system.
+         * @description Returns the persisted execution history rows in the execution system with pagination.
          */
         get: operations["TaskExecutionHistoryController_listHistory"];
         put?: never;
@@ -5237,6 +5277,30 @@ export interface components {
              */
             taskStatus: "NOT_STARTED" | "IN_PROGRESS" | "FOR_REVIEW" | "DONE" | null;
         };
+        TaskExecutionQueueListResponseDto: {
+            /** @description List of task execution queue entries */
+            items: components["schemas"]["TaskExecutionQueueEntryResponseDto"][];
+            /**
+             * @description Total number of queue entries
+             * @example 42
+             */
+            total: number;
+            /**
+             * @description Current page number
+             * @example 1
+             */
+            page: number;
+            /**
+             * @description Number of items per page
+             * @example 50
+             */
+            limit: number;
+            /**
+             * @description Total number of pages
+             * @example 3
+             */
+            totalPages: number;
+        };
         ActiveTaskExecutionTagSnapshotResponseDto: {
             /**
              * @description Tag ID at the time the task was claimed
@@ -5249,6 +5313,38 @@ export interface components {
              */
             name: string;
         };
+        ExecutionStatsResponseDto: {
+            /**
+             * @description Harness used to execute the run
+             * @example opencode
+             */
+            harness: string | null;
+            /**
+             * @description LLM provider id resolved for this run
+             * @example openai
+             */
+            providerId: string | null;
+            /**
+             * @description LLM model id resolved for this run
+             * @example gpt-5.4
+             */
+            modelId: string | null;
+            /**
+             * @description Input token usage when available
+             * @example 1200
+             */
+            inputTokens: number | null;
+            /**
+             * @description Output token usage when available
+             * @example 380
+             */
+            outputTokens: number | null;
+            /**
+             * @description Total token usage when available
+             * @example 1580
+             */
+            totalTokens: number | null;
+        };
         ActiveTaskExecutionResponseDto: {
             /**
              * @description Execution ID
@@ -5312,6 +5408,32 @@ export interface components {
              * @example 19dc147c-6051-49e3-bf7a-404e3bb575d3
              */
             agentActorId: string;
+            /** @description Execution metadata and usage stats */
+            stats: components["schemas"]["ExecutionStatsResponseDto"] | null;
+        };
+        ActiveTaskExecutionListResponseDto: {
+            /** @description List of active task executions */
+            items: components["schemas"]["ActiveTaskExecutionResponseDto"][];
+            /**
+             * @description Total number of active executions
+             * @example 42
+             */
+            total: number;
+            /**
+             * @description Current page number
+             * @example 1
+             */
+            page: number;
+            /**
+             * @description Number of items per page
+             * @example 50
+             */
+            limit: number;
+            /**
+             * @description Total number of pages
+             * @example 3
+             */
+            totalPages: number;
         };
         StopActiveTaskExecutionDto: {
             /**
@@ -5398,6 +5520,8 @@ export interface components {
              * @example ADK runner failed: 429 quota exceeded.
              */
             errorMessage: string | null;
+            /** @description Execution metadata and usage stats */
+            stats: components["schemas"]["ExecutionStatsResponseDto"] | null;
         };
         UpdateRunnerSessionIdDto: {
             /**
@@ -5406,6 +5530,62 @@ export interface components {
              */
             sessionId: string;
         };
+        UpdateExecutionStatsDto: {
+            /**
+             * @description Harness used by the worker to run this execution
+             * @example opencode
+             */
+            harness?: string | null;
+            /**
+             * @description Model provider id used by the harness
+             * @example openai
+             */
+            providerId?: string | null;
+            /**
+             * @description Model id used by the harness
+             * @example gpt-5.4
+             */
+            modelId?: string | null;
+            /**
+             * @description Input token usage when available
+             * @example 1200
+             */
+            inputTokens?: number | null;
+            /**
+             * @description Output token usage when available
+             * @example 380
+             */
+            outputTokens?: number | null;
+            /**
+             * @description Total token usage when available
+             * @example 1580
+             */
+            totalTokens?: number | null;
+        };
+        TaskExecutionHistoryListResponseDto: {
+            /** @description List of task execution history entries */
+            items: components["schemas"]["TaskExecutionHistoryResponseDto"][];
+            /**
+             * @description Total number of history entries
+             * @example 42
+             */
+            total: number;
+            /**
+             * @description Current page number
+             * @example 1
+             */
+            page: number;
+            /**
+             * @description Number of items per page
+             * @example 50
+             */
+            limit: number;
+            /**
+             * @description Total number of pages
+             * @example 3
+             */
+            totalPages: number;
+        };
         WorkerResponseDto: {
             /** Format: uuid */
             id: string;
@@ -9968,7 +10148,12 @@ export interface operations {
     };
     TaskExecutionQueueController_listQueue: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page number (1-indexed) */
+                page?: number;
+                /** @description Items per page (1-100) */
+                limit?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -9980,7 +10165,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TaskExecutionQueueEntryResponseDto"][];
+                    "application/json": components["schemas"]["TaskExecutionQueueListResponseDto"];
                 };
             };
         };
@@ -10009,7 +10194,14 @@ export interface operations {
     };
     ActiveTaskExecutionController_listActiveExecutions: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page number (1-indexed) */
+                page?: number;
+                /** @description Items per page (1-100) */
+                limit?: number;
+                /** @description Filter by task ID */
+                taskId?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10021,7 +10213,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActiveTaskExecutionResponseDto"][];
+                    "application/json": components["schemas"]["ActiveTaskExecutionListResponseDto"];
                 };
             };
         };
@@ -10052,6 +10244,26 @@ export interface operations {
             };
         };
     };
+    ActiveTaskExecutionController_unclaimTaskExecution: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Execution ID to unclaim */
+                executionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     ActiveTaskExecutionController_updateRunnerSessionId: {
         parameters: {
             query?: never;
@@ -10096,6 +10308,30 @@ export interface operations {
             };
         };
     };
+    ActiveTaskExecutionController_updateExecutionStats: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Execution ID to update */
+                executionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateExecutionStatsDto"];
+            };
+        };
+        responses: {
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     ActiveTaskExecutionController_interruptExecution: {
         parameters: {
             query?: never;
@@ -10118,7 +10354,14 @@ export interface operations {
     };
     TaskExecutionHistoryController_listHistory: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page number (1-indexed) */
+                page?: number;
+                /** @description Items per page (1-100) */
+                limit?: number;
+                /** @description Filter by task ID */
+                taskId?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -10130,7 +10373,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TaskExecutionHistoryResponseDto"][];
+                    "application/json": components["schemas"]["TaskExecutionHistoryListResponseDto"];
                 };
             };
         };

package/dist/src/v1/client/index.d.ts

@@ -2,6 +2,7 @@ export { ApiError } from './core/ApiError.js';
 export { CancelablePromise, CancelError } from './core/CancelablePromise.js';
 export { OpenAPI } from './core/OpenAPI.js';
 export type { OpenAPIConfig } from './core/OpenAPI.js';
+export type { ActiveTaskExecutionListResponseDto } from './models/ActiveTaskExecutionListResponseDto.js';
 export { ActiveTaskExecutionResponseDto } from './models/ActiveTaskExecutionResponseDto.js';
 export type { ActiveTaskExecutionTagSnapshotResponseDto } from './models/ActiveTaskExecutionTagSnapshotResponseDto.js';
 export { ActorResponseDto } from './models/ActorResponseDto.js';
@@ -65,6 +66,7 @@ export type { DeleteConnectionResponseDto } from './models/DeleteConnectionRespo
 export type { DeleteMappingResponseDto } from './models/DeleteMappingResponseDto.js';
 export type { DeleteScopeResponseDto } from './models/DeleteScopeResponseDto.js';
 export type { DeleteServerResponseDto } from './models/DeleteServerResponseDto.js';
+export type { ExecutionStatsResponseDto } from './models/ExecutionStatsResponseDto.js';
 export type { FlowClientDto } from './models/FlowClientDto.js';
 export type { FlowServerDto } from './models/FlowServerDto.js';
 export { GetConsentMetadataResponseDto } from './models/GetConsentMetadataResponseDto.js';
@@ -109,8 +111,10 @@ export { StopActiveTaskExecutionDto } from './models/StopActiveTaskExecutionDto.
 export type { TagResponseDto } from './models/TagResponseDto.js';
 export type { TaskBlueprintListResponseDto } from './models/TaskBlueprintListResponseDto.js';
 export type { TaskBlueprintResponseDto } from './models/TaskBlueprintResponseDto.js';
+export type { TaskExecutionHistoryListResponseDto } from './models/TaskExecutionHistoryListResponseDto.js';
 export { TaskExecutionHistoryResponseDto } from './models/TaskExecutionHistoryResponseDto.js';
 export { TaskExecutionQueueEntryResponseDto } from './models/TaskExecutionQueueEntryResponseDto.js';
+export type { TaskExecutionQueueListResponseDto } from './models/TaskExecutionQueueListResponseDto.js';
 export type { TaskInfoDto } from './models/TaskInfoDto.js';
 export type { TaskListResponseDto } from './models/TaskListResponseDto.js';
 export { TaskResponseDto } from './models/TaskResponseDto.js';
@@ -129,6 +133,7 @@ export type { UpdateAgentRunDto } from './models/UpdateAgentRunDto.js';
 export type { UpdateBlockDto } from './models/UpdateBlockDto.js';
 export type { UpdateChatProviderDto } from './models/UpdateChatProviderDto.js';
 export type { UpdateConnectionDto } from './models/UpdateConnectionDto.js';
+export type { UpdateExecutionStatsDto } from './models/UpdateExecutionStatsDto.js';
 export type { UpdateRunnerSessionIdDto } from './models/UpdateRunnerSessionIdDto.js';
 export type { UpdateScheduledTaskDto } from './models/UpdateScheduledTaskDto.js';
 export type { UpdateSecretDto } from './models/UpdateSecretDto.js';

package/dist/src/v1/client/models/ActiveTaskExecutionListResponseDto.d.ts

@@ -0,0 +1,23 @@
+import type { ActiveTaskExecutionResponseDto } from './ActiveTaskExecutionResponseDto.js';
+export type ActiveTaskExecutionListResponseDto = {
+    /**
+     * List of active task executions
+     */
+    items: Array<ActiveTaskExecutionResponseDto>;
+    /**
+     * Total number of active executions
+     */
+    total: number;
+    /**
+     * Current page number
+     */
+    page: number;
+    /**
+     * Number of items per page
+     */
+    limit: number;
+    /**
+     * Total number of pages
+     */
+    totalPages: number;
+};

package/dist/src/v1/client/models/ActiveTaskExecutionListResponseDto.js

@@ -0,0 +1 @@
+export {};

package/dist/src/v1/client/models/ActiveTaskExecutionResponseDto.d.ts

@@ -1,4 +1,5 @@
 import type { ActiveTaskExecutionTagSnapshotResponseDto } from './ActiveTaskExecutionTagSnapshotResponseDto.js';
+import type { ExecutionStatsResponseDto } from './ExecutionStatsResponseDto.js';
 export type ActiveTaskExecutionResponseDto = {
     /**
      * Execution ID
@@ -52,6 +53,10 @@ export type ActiveTaskExecutionResponseDto = {
      * Agent actor id that picked up the task
      */
     agentActorId: string;
+    /**
+     * Execution metadata and usage stats
+     */
+    stats: ExecutionStatsResponseDto | null;
 };
 export declare namespace ActiveTaskExecutionResponseDto {
     /**

package/dist/src/v1/client/models/ExecutionStatsResponseDto.d.ts

@@ -0,0 +1,26 @@
+export type ExecutionStatsResponseDto = {
+    /**
+     * Harness used to execute the run
+     */
+    harness: string | null;
+    /**
+     * LLM provider id resolved for this run
+     */
+    providerId: string | null;
+    /**
+     * LLM model id resolved for this run
+     */
+    modelId: string | null;
+    /**
+     * Input token usage when available
+     */
+    inputTokens: number | null;
+    /**
+     * Output token usage when available
+     */
+    outputTokens: number | null;
+    /**
+     * Total token usage when available
+     */
+    totalTokens: number | null;
+};

package/dist/src/v1/client/models/ExecutionStatsResponseDto.js

@@ -0,0 +1 @@
+export {};

package/dist/src/v1/client/models/TaskExecutionHistoryListResponseDto.d.ts

@@ -0,0 +1,23 @@
+import type { TaskExecutionHistoryResponseDto } from './TaskExecutionHistoryResponseDto.js';
+export type TaskExecutionHistoryListResponseDto = {
+    /**
+     * List of task execution history entries
+     */
+    items: Array<TaskExecutionHistoryResponseDto>;
+    /**
+     * Total number of history entries
+     */
+    total: number;
+    /**
+     * Current page number
+     */
+    page: number;
+    /**
+     * Number of items per page
+     */
+    limit: number;
+    /**
+     * Total number of pages
+     */
+    totalPages: number;
+};

package/dist/src/v1/client/models/TaskExecutionHistoryListResponseDto.js

@@ -0,0 +1 @@
+export {};

package/dist/src/v1/client/models/TaskExecutionHistoryResponseDto.d.ts

@@ -1,3 +1,4 @@
+import type { ExecutionStatsResponseDto } from './ExecutionStatsResponseDto.js';
 export type TaskExecutionHistoryResponseDto = {
     /**
      * History row ID
@@ -51,6 +52,10 @@ export type TaskExecutionHistoryResponseDto = {
      * Optional human-readable error message for failed or cancelled executions
      */
     errorMessage: string | null;
+    /**
+     * Execution metadata and usage stats
+     */
+    stats: ExecutionStatsResponseDto | null;
 };
 export declare namespace TaskExecutionHistoryResponseDto {
     /**

package/dist/src/v1/client/models/TaskExecutionQueueListResponseDto.d.ts

@@ -0,0 +1,23 @@
+import type { TaskExecutionQueueEntryResponseDto } from './TaskExecutionQueueEntryResponseDto.js';
+export type TaskExecutionQueueListResponseDto = {
+    /**
+     * List of task execution queue entries
+     */
+    items: Array<TaskExecutionQueueEntryResponseDto>;
+    /**
+     * Total number of queue entries
+     */
+    total: number;
+    /**
+     * Current page number
+     */
+    page: number;
+    /**
+     * Number of items per page
+     */
+    limit: number;
+    /**
+     * Total number of pages
+     */
+    totalPages: number;
+};

package/dist/src/v1/client/models/TaskExecutionQueueListResponseDto.js

@@ -0,0 +1 @@
+export {};

package/dist/src/v1/client/models/UpdateExecutionStatsDto.d.ts

@@ -0,0 +1,26 @@
+export type UpdateExecutionStatsDto = {
+    /**
+     * Harness used by the worker to run this execution
+     */
+    harness?: string | null;
+    /**
+     * Model provider id used by the harness
+     */
+    providerId?: string | null;
+    /**
+     * Model id used by the harness
+     */
+    modelId?: string | null;
+    /**
+     * Input token usage when available
+     */
+    inputTokens?: number | null;
+    /**
+     * Output token usage when available
+     */
+    outputTokens?: number | null;
+    /**
+     * Total token usage when available
+     */
+    totalTokens?: number | null;
+};

package/dist/src/v1/client/models/UpdateExecutionStatsDto.js

@@ -0,0 +1 @@
+export {};

package/dist/src/v1/client/services/ExecutionsService.d.ts

@@ -1,18 +1,23 @@
+import type { ActiveTaskExecutionListResponseDto } from '../models/ActiveTaskExecutionListResponseDto.js';
 import type { ActiveTaskExecutionResponseDto } from '../models/ActiveTaskExecutionResponseDto.js';
 import type { StopActiveTaskExecutionDto } from '../models/StopActiveTaskExecutionDto.js';
+import type { TaskExecutionHistoryListResponseDto } from '../models/TaskExecutionHistoryListResponseDto.js';
 import type { TaskExecutionHistoryResponseDto } from '../models/TaskExecutionHistoryResponseDto.js';
-import type { TaskExecutionQueueEntryResponseDto } from '../models/TaskExecutionQueueEntryResponseDto.js';
+import type { TaskExecutionQueueListResponseDto } from '../models/TaskExecutionQueueListResponseDto.js';
+import type { UpdateExecutionStatsDto } from '../models/UpdateExecutionStatsDto.js';
 import type { UpdateRunnerSessionIdDto } from '../models/UpdateRunnerSessionIdDto.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 import type { OpenAPIConfig } from '../core/OpenAPI.js';
 export declare class ExecutionsService {
     /**
      * List the current task execution work queue
-     * Returns the tasks currently present in the execution queue. Presence means the task is ready to be picked by the executor.
-     * @returns TaskExecutionQueueEntryResponseDto
+     * Returns the tasks currently present in the execution queue with pagination. Presence means the task is ready to be picked by the executor.
+     * @param page Page number (1-indexed)
+     * @param limit Items per page (1-100)
+     * @returns TaskExecutionQueueListResponseDto
      * @throws ApiError
      */
-    static taskExecutionQueueControllerListQueue(config?: OpenAPIConfig): CancelablePromise<Array<TaskExecutionQueueEntryResponseDto>>;
+    static taskExecutionQueueControllerListQueue(page?: number, limit?: number, config?: OpenAPIConfig): CancelablePromise<TaskExecutionQueueListResponseDto>;
     /**
      * Claim a specific task from the execution queue
      * Atomically removes the task from the queue and inserts it into the active execution table.
@@ -23,11 +28,14 @@ export declare class ExecutionsService {
     static taskExecutionQueueControllerClaimTask(taskId: string, config?: OpenAPIConfig): CancelablePromise<ActiveTaskExecutionResponseDto>;
     /**
      * List active task executions
-     * Returns the tasks currently being worked on in the execution system.
-     * @returns ActiveTaskExecutionResponseDto
+     * Returns the tasks currently being worked on in the execution system with pagination.
+     * @param page Page number (1-indexed)
+     * @param limit Items per page (1-100)
+     * @param taskId Filter by task ID
+     * @returns ActiveTaskExecutionListResponseDto
      * @throws ApiError
      */
-    static activeTaskExecutionControllerListActiveExecutions(config?: OpenAPIConfig): CancelablePromise<Array<ActiveTaskExecutionResponseDto>>;
+    static activeTaskExecutionControllerListActiveExecutions(page?: number, limit?: number, taskId?: string, config?: OpenAPIConfig): CancelablePromise<ActiveTaskExecutionListResponseDto>;
     /**
      * Stop an active task execution and move it to history
      * Atomically removes the execution from the active execution table and inserts it into the history table.
@@ -37,6 +45,14 @@ export declare class ExecutionsService {
      * @throws ApiError
      */
     static activeTaskExecutionControllerStopTaskExecution(executionId: string, requestBody: StopActiveTaskExecutionDto, config?: OpenAPIConfig): CancelablePromise<TaskExecutionHistoryResponseDto>;
+    /**
+     * Unclaim an active task execution and return it to the queue
+     * Atomically removes the execution from the active execution table and returns its task to the execution queue. Only the worker that claimed the execution may unclaim it.
+     * @param executionId Execution ID to unclaim
+     * @returns void
+     * @throws ApiError
+     */
+    static activeTaskExecutionControllerUnclaimTaskExecution(executionId: string, config?: OpenAPIConfig): CancelablePromise<void>;
     /**
      * Attach the runner session id to an active execution
      * Stores the runtime session identifier emitted by the agent harness so it can be propagated to execution history.
@@ -54,6 +70,15 @@ export declare class ExecutionsService {
      * @throws ApiError
      */
     static activeTaskExecutionControllerIncrementToolCallCount(executionId: string, config?: OpenAPIConfig): CancelablePromise<void>;
+    /**
+     * Patch execution stats and metadata
+     * Atomically updates one or more execution metadata fields such as harness, model details, or token usage.
+     * @param executionId Execution ID to update
+     * @param requestBody
+     * @returns void
+     * @throws ApiError
+     */
+    static activeTaskExecutionControllerUpdateExecutionStats(executionId: string, requestBody: UpdateExecutionStatsDto, config?: OpenAPIConfig): CancelablePromise<void>;
     /**
      * Request interruption of an active execution
      * Signals the worker to abort the currently running agent execution.
@@ -64,9 +89,12 @@ export declare class ExecutionsService {
     static activeTaskExecutionControllerInterruptExecution(executionId: string, config?: OpenAPIConfig): CancelablePromise<void>;
     /**
      * List task execution history
-     * Returns the persisted execution history rows in the execution system.
-     * @returns TaskExecutionHistoryResponseDto
+     * Returns the persisted execution history rows in the execution system with pagination.
+     * @param page Page number (1-indexed)
+     * @param limit Items per page (1-100)
+     * @param taskId Filter by task ID
+     * @returns TaskExecutionHistoryListResponseDto
      * @throws ApiError
      */
-    static taskExecutionHistoryControllerListHistory(config?: OpenAPIConfig): CancelablePromise<Array<TaskExecutionHistoryResponseDto>>;
+    static taskExecutionHistoryControllerListHistory(page?: number, limit?: number, taskId?: string, config?: OpenAPIConfig): CancelablePromise<TaskExecutionHistoryListResponseDto>;
 }

package/dist/src/v1/client/services/ExecutionsService.js

@@ -3,14 +3,20 @@ import { request as __request } from '../core/request.js';
 export class ExecutionsService {
     /**
      * List the current task execution work queue
-     * Returns the tasks currently present in the execution queue. Presence means the task is ready to be picked by the executor.
-     * @returns TaskExecutionQueueEntryResponseDto
+     * Returns the tasks currently present in the execution queue with pagination. Presence means the task is ready to be picked by the executor.
+     * @param page Page number (1-indexed)
+     * @param limit Items per page (1-100)
+     * @returns TaskExecutionQueueListResponseDto
      * @throws ApiError
      */
-    static taskExecutionQueueControllerListQueue(config = OpenAPI) {
+    static taskExecutionQueueControllerListQueue(page = 1, limit = 50, config = OpenAPI) {
         return __request(config, {
             method: 'GET',
             url: '/api/v1/executions/queue',
+            query: {
+                'page': page,
+                'limit': limit,
+            },
         });
     }
     /**
@@ -31,14 +37,22 @@ export class ExecutionsService {
     }
     /**
      * List active task executions
-     * Returns the tasks currently being worked on in the execution system.
-     * @returns ActiveTaskExecutionResponseDto
+     * Returns the tasks currently being worked on in the execution system with pagination.
+     * @param page Page number (1-indexed)
+     * @param limit Items per page (1-100)
+     * @param taskId Filter by task ID
+     * @returns ActiveTaskExecutionListResponseDto
      * @throws ApiError
      */
-    static activeTaskExecutionControllerListActiveExecutions(config = OpenAPI) {
+    static activeTaskExecutionControllerListActiveExecutions(page = 1, limit = 50, taskId, config = OpenAPI) {
         return __request(config, {
             method: 'GET',
             url: '/api/v1/executions/active',
+            query: {
+                'page': page,
+                'limit': limit,
+                'taskId': taskId,
+            },
         });
     }
     /**
@@ -60,6 +74,22 @@ export class ExecutionsService {
             mediaType: 'application/json',
         });
     }
+    /**
+     * Unclaim an active task execution and return it to the queue
+     * Atomically removes the execution from the active execution table and returns its task to the execution queue. Only the worker that claimed the execution may unclaim it.
+     * @param executionId Execution ID to unclaim
+     * @returns void
+     * @throws ApiError
+     */
+    static activeTaskExecutionControllerUnclaimTaskExecution(executionId, config = OpenAPI) {
+        return __request(config, {
+            method: 'POST',
+            url: '/api/v1/executions/active/{executionId}/unclaim',
+            path: {
+                'executionId': executionId,
+            },
+        });
+    }
     /**
      * Attach the runner session id to an active execution
      * Stores the runtime session identifier emitted by the agent harness so it can be propagated to execution history.
@@ -95,6 +125,25 @@ export class ExecutionsService {
             },
         });
     }
+    /**
+     * Patch execution stats and metadata
+     * Atomically updates one or more execution metadata fields such as harness, model details, or token usage.
+     * @param executionId Execution ID to update
+     * @param requestBody
+     * @returns void
+     * @throws ApiError
+     */
+    static activeTaskExecutionControllerUpdateExecutionStats(executionId, requestBody, config = OpenAPI) {
+        return __request(config, {
+            method: 'PATCH',
+            url: '/api/v1/executions/active/{executionId}/stats',
+            path: {
+                'executionId': executionId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+        });
+    }
     /**
      * Request interruption of an active execution
      * Signals the worker to abort the currently running agent execution.
@@ -113,14 +162,22 @@ export class ExecutionsService {
     }
     /**
      * List task execution history
-     * Returns the persisted execution history rows in the execution system.
-     * @returns TaskExecutionHistoryResponseDto
+     * Returns the persisted execution history rows in the execution system with pagination.
+     * @param page Page number (1-indexed)
+     * @param limit Items per page (1-100)
+     * @param taskId Filter by task ID
+     * @returns TaskExecutionHistoryListResponseDto
      * @throws ApiError
      */
-    static taskExecutionHistoryControllerListHistory(config = OpenAPI) {
+    static taskExecutionHistoryControllerListHistory(page = 1, limit = 50, taskId, config = OpenAPI) {
         return __request(config, {
             method: 'GET',
             url: '/api/v1/executions/history',
+            query: {
+                'page': page,
+                'limit': limit,
+                'taskId': taskId,
+            },
         });
     }
 }

package/dist/src/v2/executions-resource.d.ts

@@ -1,11 +1,13 @@
 import { BaseClient, ClientConfig } from './base-client.js';
-import type { ActiveTaskExecutionResponseDto, StopActiveTaskExecutionDto, TaskExecutionHistoryResponseDto, TaskExecutionQueueEntryResponseDto, UpdateRunnerSessionIdDto } from './types.js';
+import type { ActiveTaskExecutionListResponseDto, ActiveTaskExecutionResponseDto, StopActiveTaskExecutionDto, TaskExecutionHistoryListResponseDto, TaskExecutionHistoryResponseDto, TaskExecutionQueueListResponseDto, UpdateExecutionStatsDto, UpdateRunnerSessionIdDto } from './types.js';
 export declare class ExecutionsResource extends BaseClient {
     constructor(config: ClientConfig);
     /** List the current task execution work queue */
     TaskExecutionQueueController_listQueue(params?: {
+        page?: number;
+        limit?: number;
         signal?: AbortSignal;
-    }): Promise<TaskExecutionQueueEntryResponseDto[]>;
+    }): Promise<TaskExecutionQueueListResponseDto>;
     /** Claim a specific task from the execution queue */
     TaskExecutionQueueController_claimTask(params: {
         taskId: string;
@@ -13,14 +15,22 @@ export declare class ExecutionsResource extends BaseClient {
     }): Promise<ActiveTaskExecutionResponseDto>;
     /** List active task executions */
     ActiveTaskExecutionController_listActiveExecutions(params?: {
+        page?: number;
+        limit?: number;
+        taskId?: string;
         signal?: AbortSignal;
-    }): Promise<ActiveTaskExecutionResponseDto[]>;
+    }): Promise<ActiveTaskExecutionListResponseDto>;
     /** Stop an active task execution and move it to history */
     ActiveTaskExecutionController_stopTaskExecution(params: {
         executionId: string;
         body: StopActiveTaskExecutionDto;
         signal?: AbortSignal;
     }): Promise<TaskExecutionHistoryResponseDto>;
+    /** Unclaim an active task execution and return it to the queue */
+    ActiveTaskExecutionController_unclaimTaskExecution(params: {
+        executionId: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
     /** Attach the runner session id to an active execution */
     ActiveTaskExecutionController_updateRunnerSessionId(params: {
         executionId: string;
@@ -32,6 +42,12 @@ export declare class ExecutionsResource extends BaseClient {
         executionId: string;
         signal?: AbortSignal;
     }): Promise<void>;
+    /** Patch execution stats and metadata */
+    ActiveTaskExecutionController_updateExecutionStats(params: {
+        executionId: string;
+        body: UpdateExecutionStatsDto;
+        signal?: AbortSignal;
+    }): Promise<void>;
     /** Request interruption of an active execution */
     ActiveTaskExecutionController_interruptExecution(params: {
         executionId: string;
@@ -39,6 +55,9 @@ export declare class ExecutionsResource extends BaseClient {
     }): Promise<void>;
     /** List task execution history */
     TaskExecutionHistoryController_listHistory(params?: {
+        page?: number;
+        limit?: number;
+        taskId?: string;
         signal?: AbortSignal;
-    }): Promise<TaskExecutionHistoryResponseDto[]>;
+    }): Promise<TaskExecutionHistoryListResponseDto>;
 }

package/dist/src/v2/executions-resource.js

@@ -5,7 +5,7 @@ export class ExecutionsResource extends BaseClient {
     }
     /** List the current task execution work queue */
     async TaskExecutionQueueController_listQueue(params) {
-        return this.request('GET', '/api/v1/executions/queue', { signal: params?.signal });
+        return this.request('GET', '/api/v1/executions/queue', { params: { page: params?.page, limit: params?.limit }, signal: params?.signal });
     }
     /** Claim a specific task from the execution queue */
     async TaskExecutionQueueController_claimTask(params) {
@@ -13,12 +13,16 @@ export class ExecutionsResource extends BaseClient {
     }
     /** List active task executions */
     async ActiveTaskExecutionController_listActiveExecutions(params) {
-        return this.request('GET', '/api/v1/executions/active', { signal: params?.signal });
+        return this.request('GET', '/api/v1/executions/active', { params: { page: params?.page, limit: params?.limit, taskId: params?.taskId }, signal: params?.signal });
     }
     /** Stop an active task execution and move it to history */
     async ActiveTaskExecutionController_stopTaskExecution(params) {
         return this.request('POST', `/api/v1/executions/active/${params.executionId}/stop`, { body: params.body, signal: params?.signal });
     }
+    /** Unclaim an active task execution and return it to the queue */
+    async ActiveTaskExecutionController_unclaimTaskExecution(params) {
+        return this.request('POST', `/api/v1/executions/active/${params.executionId}/unclaim`, { responseType: 'void', signal: params?.signal });
+    }
     /** Attach the runner session id to an active execution */
     async ActiveTaskExecutionController_updateRunnerSessionId(params) {
         return this.request('PATCH', `/api/v1/executions/active/${params.executionId}/session`, { body: params.body, responseType: 'void', signal: params?.signal });
@@ -27,12 +31,16 @@ export class ExecutionsResource extends BaseClient {
     async ActiveTaskExecutionController_incrementToolCallCount(params) {
         return this.request('PATCH', `/api/v1/executions/active/${params.executionId}/tool-calls/increment`, { responseType: 'void', signal: params?.signal });
     }
+    /** Patch execution stats and metadata */
+    async ActiveTaskExecutionController_updateExecutionStats(params) {
+        return this.request('PATCH', `/api/v1/executions/active/${params.executionId}/stats`, { body: params.body, responseType: 'void', signal: params?.signal });
+    }
     /** Request interruption of an active execution */
     async ActiveTaskExecutionController_interruptExecution(params) {
         return this.request('POST', `/api/v1/executions/active/${params.executionId}/interrupt`, { responseType: 'void', signal: params?.signal });
     }
     /** List task execution history */
     async TaskExecutionHistoryController_listHistory(params) {
-        return this.request('GET', '/api/v1/executions/history', { signal: params?.signal });
+        return this.request('GET', '/api/v1/executions/history', { params: { page: params?.page, limit: params?.limit, taskId: params?.taskId }, signal: params?.signal });
     }
 }

package/dist/src/v2/types.d.ts

@@ -823,10 +823,25 @@ export interface TaskExecutionQueueEntryResponseDto {
     taskName: string | null;
     taskStatus: 'NOT_STARTED' | 'IN_PROGRESS' | 'FOR_REVIEW' | 'DONE';
 }
+export interface TaskExecutionQueueListResponseDto {
+    items: TaskExecutionQueueEntryResponseDto[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
 export interface ActiveTaskExecutionTagSnapshotResponseDto {
     id: string;
     name: string;
 }
+export interface ExecutionStatsResponseDto {
+    harness: string | null;
+    providerId: string | null;
+    modelId: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    totalTokens: number | null;
+}
 export interface ActiveTaskExecutionResponseDto {
     id: string;
     taskId: string;
@@ -841,6 +856,14 @@ export interface ActiveTaskExecutionResponseDto {
     workerClientId: string;
     taskAssigneeActorIdBeforeClaim: string | null;
     agentActorId: string;
+    stats: ExecutionStatsResponseDto;
+}
+export interface ActiveTaskExecutionListResponseDto {
+    items: ActiveTaskExecutionResponseDto[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
 }
 export interface StopActiveTaskExecutionDto {
     status: 'SUCCEEDED' | 'FAILED' | 'STALE' | 'CANCELLED';
@@ -861,10 +884,26 @@ export interface TaskExecutionHistoryResponseDto {
     status: 'SUCCEEDED' | 'FAILED' | 'STALE' | 'CANCELLED';
     errorCode: 'OUT_OF_QUOTA' | 'INTERRUPTED' | 'UNKNOWN';
     errorMessage: string | null;
+    stats: ExecutionStatsResponseDto;
 }
 export interface UpdateRunnerSessionIdDto {
     sessionId: string;
 }
+export interface UpdateExecutionStatsDto {
+    harness?: string | null;
+    providerId?: string | null;
+    modelId?: string | null;
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    totalTokens?: number | null;
+}
+export interface TaskExecutionHistoryListResponseDto {
+    items: TaskExecutionHistoryResponseDto[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
 export interface WorkerResponseDto {
     id: string;
     oauthClientId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taico/client",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "type": "module",
   "private": false,
   "license": "MIT",