@taico/client 0.6.0 → 0.7.0

package/README.md

@@ -1,3 +1,3 @@
 # @taico/client
 
-[![Socket Badge](https://badge.socket.dev/npm/package/@taico/client/0.6.0)](https://badge.socket.dev/npm/package/@taico/client/0.6.0)
+[![Socket Badge](https://badge.socket.dev/npm/package/@taico/client/0.7.0)](https://badge.socket.dev/npm/package/@taico/client/0.7.0)

package/dist/contracts/types.d.ts

@@ -1436,6 +1436,23 @@ export interface paths {
         patch: operations["ThreadsController_updateThreadState"];
         trace?: never;
     };
+    "/api/v1/threads/{id}/token-usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get the token usage the model provider reported for a thread (debug) */
+        get: operations["ThreadsController_getThreadTokenUsage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/threads/{id}/state/append": {
         parameters: {
             query?: never;
@@ -1460,7 +1477,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List messages in a thread */
+        /** List messages in a thread, newest first */
         get: operations["ThreadsController_listMessages"];
         put?: never;
         /** Create a message in the thread */
@@ -1471,6 +1488,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/threads/{id}/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Mark every message in the thread as read by the caller */
+        post: operations["ThreadsController_markThreadRead"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/agents": {
         parameters: {
             query?: never;
@@ -4682,6 +4716,16 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             stateContextBlockId: string;
+            /**
+             * @description When the latest message people can see was posted, or when the thread was created if it has none. The list is ordered by this, newest first
+             * @example 2026-01-01T00:00:00.000Z
+             */
+            lastActivityAt: string;
+            /**
+             * @description Messages in this thread written by someone else that the caller has not read yet
+             * @example 2
+             */
+            unreadCount: number;
         };
         ThreadListResponseDto: {
             /** @description Array of thread list items */
@@ -4736,6 +4780,28 @@ export interface components {
              */
             content: string;
         };
+        ThreadTokenUsageResponseDto: {
+            /**
+             * @description Input tokens of the most recent model step: roughly the size of the conversation the model reads now. Null when the provider reported no figure.
+             * @example 42351
+             */
+            contextTokens: number | null;
+            /**
+             * @description Input tokens summed over every model step in the thread. Null when no step reported a figure.
+             * @example 423512
+             */
+            inputTokens: number | null;
+            /**
+             * @description Output tokens summed over every model step in the thread. Null when no step reported a figure.
+             * @example 8123
+             */
+            outputTokens: number | null;
+            /**
+             * @description Number of model steps that reported token usage
+             * @example 12
+             */
+            steps: number;
+        };
         UpdateThreadStateDto: {
             /**
              * @description New content for the thread state
@@ -10253,6 +10319,36 @@ export interface operations {
             };
         };
     };
+    ThreadsController_getThreadTokenUsage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Thread UUID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Token usage retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ThreadTokenUsageResponseDto"];
+                };
+            };
+            /** @description Thread not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     ThreadsController_appendThreadState: {
         parameters: {
             query?: never;
@@ -10370,6 +10466,34 @@ export interface operations {
             };
         };
     };
+    ThreadsController_markThreadRead: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Thread UUID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Thread marked as read */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Thread not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     AgentsController_listAgents: {
         parameters: {
             query?: {

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

@@ -139,6 +139,7 @@ export type { ThreadListResponseDto } from './models/ThreadListResponseDto.js';
 export type { ThreadMessageResponseDto } from './models/ThreadMessageResponseDto.js';
 export type { ThreadResponseDto } from './models/ThreadResponseDto.js';
 export type { ThreadStateResponseDto } from './models/ThreadStateResponseDto.js';
+export type { ThreadTokenUsageResponseDto } from './models/ThreadTokenUsageResponseDto.js';
 export { TokenExchangeRequestDto } from './models/TokenExchangeRequestDto.js';
 export type { TokenExchangeResponseDto } from './models/TokenExchangeResponseDto.js';
 export { TokenRequestDto } from './models/TokenRequestDto.js';

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

@@ -11,4 +11,12 @@ export type ThreadListItemResponseDto = {
      * State context block ID that tracks the evolving state of this thread
      */
     stateContextBlockId: string;
+    /**
+     * When the latest message people can see was posted, or when the thread was created if it has none. The list is ordered by this, newest first
+     */
+    lastActivityAt: string;
+    /**
+     * Messages in this thread written by someone else that the caller has not read yet
+     */
+    unreadCount: number;
 };

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

@@ -0,0 +1,18 @@
+export type ThreadTokenUsageResponseDto = {
+    /**
+     * Input tokens of the most recent model step: roughly the size of the conversation the model reads now. Null when the provider reported no figure.
+     */
+    contextTokens: number | null;
+    /**
+     * Input tokens summed over every model step in the thread. Null when no step reported a figure.
+     */
+    inputTokens: number | null;
+    /**
+     * Output tokens summed over every model step in the thread. Null when no step reported a figure.
+     */
+    outputTokens: number | null;
+    /**
+     * Number of model steps that reported token usage
+     */
+    steps: number;
+};

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

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

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

@@ -10,6 +10,7 @@ import type { ThreadListResponseDto } from '../models/ThreadListResponseDto.js';
 import type { ThreadMessageResponseDto } from '../models/ThreadMessageResponseDto.js';
 import type { ThreadResponseDto } from '../models/ThreadResponseDto.js';
 import type { ThreadStateResponseDto } from '../models/ThreadStateResponseDto.js';
+import type { ThreadTokenUsageResponseDto } from '../models/ThreadTokenUsageResponseDto.js';
 import type { UpdateThreadDto } from '../models/UpdateThreadDto.js';
 import type { UpdateThreadStateDto } from '../models/UpdateThreadStateDto.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
@@ -121,6 +122,13 @@ export declare class ThreadsService {
      * @throws ApiError
      */
     static threadsControllerUpdateThreadState(id: string, requestBody: UpdateThreadStateDto, config?: OpenAPIConfig): CancelablePromise<ThreadStateResponseDto>;
+    /**
+     * Get the token usage the model provider reported for a thread (debug)
+     * @param id Thread UUID
+     * @returns ThreadTokenUsageResponseDto Token usage retrieved successfully
+     * @throws ApiError
+     */
+    static threadsControllerGetThreadTokenUsage(id: string, config?: OpenAPIConfig): CancelablePromise<ThreadTokenUsageResponseDto>;
     /**
      * Append content to the state of a thread
      * @param id Thread UUID
@@ -138,7 +146,7 @@ export declare class ThreadsService {
      */
     static threadsControllerCreateMessage(id: string, requestBody: CreateThreadMessageDto, config?: OpenAPIConfig): CancelablePromise<ThreadMessageResponseDto>;
     /**
-     * List messages in a thread
+     * List messages in a thread, newest first
      * @param id Thread UUID
      * @param page Page number
      * @param limit Number of items per page
@@ -146,4 +154,11 @@ export declare class ThreadsService {
      * @throws ApiError
      */
     static threadsControllerListMessages(id: string, page?: number, limit?: number, config?: OpenAPIConfig): CancelablePromise<ListThreadMessagesResponseDto>;
+    /**
+     * Mark every message in the thread as read by the caller
+     * @param id Thread UUID
+     * @returns void
+     * @throws ApiError
+     */
+    static threadsControllerMarkThreadRead(id: string, config?: OpenAPIConfig): CancelablePromise<void>;
 }

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

@@ -271,6 +271,24 @@ export class ThreadsService {
             },
         });
     }
+    /**
+     * Get the token usage the model provider reported for a thread (debug)
+     * @param id Thread UUID
+     * @returns ThreadTokenUsageResponseDto Token usage retrieved successfully
+     * @throws ApiError
+     */
+    static threadsControllerGetThreadTokenUsage(id, config = OpenAPI) {
+        return __request(config, {
+            method: 'GET',
+            url: '/api/v1/threads/{id}/token-usage',
+            path: {
+                'id': id,
+            },
+            errors: {
+                404: `Thread not found`,
+            },
+        });
+    }
     /**
      * Append content to the state of a thread
      * @param id Thread UUID
@@ -316,7 +334,7 @@ export class ThreadsService {
         });
     }
     /**
-     * List messages in a thread
+     * List messages in a thread, newest first
      * @param id Thread UUID
      * @param page Page number
      * @param limit Number of items per page
@@ -339,4 +357,22 @@ export class ThreadsService {
             },
         });
     }
+    /**
+     * Mark every message in the thread as read by the caller
+     * @param id Thread UUID
+     * @returns void
+     * @throws ApiError
+     */
+    static threadsControllerMarkThreadRead(id, config = OpenAPI) {
+        return __request(config, {
+            method: 'POST',
+            url: '/api/v1/threads/{id}/read',
+            path: {
+                'id': id,
+            },
+            errors: {
+                404: `Thread not found`,
+            },
+        });
+    }
 }

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

@@ -1,5 +1,5 @@
 import { BaseClient, ClientConfig } from './base-client.js';
-import type { AddParticipantDto, AppendThreadStateDto, AttachTaskDto, CreateTagDto, CreateThreadDto, CreateThreadMessageDto, ListThreadMessagesResponseDto, ReferenceContextBlockDto, ThreadListResponseDto, ThreadMessageResponseDto, ThreadResponseDto, ThreadStateResponseDto, UpdateThreadDto, UpdateThreadStateDto } from './types.js';
+import type { AddParticipantDto, AppendThreadStateDto, AttachTaskDto, CreateTagDto, CreateThreadDto, CreateThreadMessageDto, ListThreadMessagesResponseDto, ReferenceContextBlockDto, ThreadListResponseDto, ThreadMessageResponseDto, ThreadResponseDto, ThreadStateResponseDto, ThreadTokenUsageResponseDto, UpdateThreadDto, UpdateThreadStateDto } from './types.js';
 export declare class ThreadsResource extends BaseClient {
     constructor(config: ClientConfig);
     /** Create a new thread */
@@ -80,6 +80,11 @@ export declare class ThreadsResource extends BaseClient {
         body: UpdateThreadStateDto;
         signal?: AbortSignal;
     }): Promise<ThreadStateResponseDto>;
+    /** Get the token usage the model provider reported for a thread (debug) */
+    ThreadsController_getThreadTokenUsage(params: {
+        id: string;
+        signal?: AbortSignal;
+    }): Promise<ThreadTokenUsageResponseDto>;
     /** Append content to the state of a thread */
     ThreadsController_appendThreadState(params: {
         id: string;
@@ -92,11 +97,16 @@ export declare class ThreadsResource extends BaseClient {
         body: CreateThreadMessageDto;
         signal?: AbortSignal;
     }): Promise<ThreadMessageResponseDto>;
-    /** List messages in a thread */
+    /** List messages in a thread, newest first */
     ThreadsController_listMessages(params: {
         id: string;
         page?: number;
         limit?: number;
         signal?: AbortSignal;
     }): Promise<ListThreadMessagesResponseDto>;
+    /** Mark every message in the thread as read by the caller */
+    ThreadsController_markThreadRead(params: {
+        id: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
 }

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

@@ -59,6 +59,10 @@ export class ThreadsResource extends BaseClient {
     async ThreadsController_updateThreadState(params) {
         return this.request('PATCH', `/api/v1/threads/${params.id}/state`, { body: params.body, signal: params?.signal });
     }
+    /** Get the token usage the model provider reported for a thread (debug) */
+    async ThreadsController_getThreadTokenUsage(params) {
+        return this.request('GET', `/api/v1/threads/${params.id}/token-usage`, { signal: params?.signal });
+    }
     /** Append content to the state of a thread */
     async ThreadsController_appendThreadState(params) {
         return this.request('POST', `/api/v1/threads/${params.id}/state/append`, { body: params.body, signal: params?.signal });
@@ -67,8 +71,12 @@ export class ThreadsResource extends BaseClient {
     async ThreadsController_createMessage(params) {
         return this.request('POST', `/api/v1/threads/${params.id}/messages`, { body: params.body, signal: params?.signal });
     }
-    /** List messages in a thread */
+    /** List messages in a thread, newest first */
     async ThreadsController_listMessages(params) {
         return this.request('GET', `/api/v1/threads/${params.id}/messages`, { params: { page: params.page, limit: params.limit }, signal: params?.signal });
     }
+    /** Mark every message in the thread as read by the caller */
+    async ThreadsController_markThreadRead(params) {
+        return this.request('POST', `/api/v1/threads/${params.id}/read`, { responseType: 'void', signal: params?.signal });
+    }
 }

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

@@ -620,6 +620,8 @@ export interface ThreadListItemResponseDto {
     id: string;
     title: string;
     stateContextBlockId: string;
+    lastActivityAt: string;
+    unreadCount: number;
 }
 export interface ThreadListResponseDto {
     items: ThreadListItemResponseDto[];
@@ -640,6 +642,12 @@ export interface AddParticipantDto {
 export interface ThreadStateResponseDto {
     content: string;
 }
+export interface ThreadTokenUsageResponseDto {
+    contextTokens: number | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    steps: number;
+}
 export interface UpdateThreadStateDto {
     content: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taico/client",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "private": false,
   "license": "PolyForm-Small-Business-1.0.0",