Merge pull request #27 from ZoriHQ/release-please--branches--main--changes--next--components--zorihq

release: 0.21.0

Author: le-vlad

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.20.0"
+  ".": "0.21.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 47
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/zorihq%2Fzoriapi-7e1ec42ddb33d95fb98aa302249071c3b5ef4087fb242f57be0928eb8b161354.yml
-openapi_spec_hash: fa440c6912192834484897bb1674c60e
-config_hash: 3f5e48e491b083b54610789873b94cc6
+configured_endpoints: 51
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/zorihq%2Fzoriapi-8a5ed6a51cb2f132ad9eeb1fc36b8bfefa11fd35954f62ef96ee02dc8b1f063d.yml
+openapi_spec_hash: 4e7112ed8d36d0cd080a75f90b7dd067
+config_hash: 852a355d70ade9bf524e82678f9a094c

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.21.0 (2025-12-06)
+
+Full Changelog: [v0.20.0...v0.21.0](https://github.com/ZoriHQ/typescript-api-sdk/compare/v0.20.0...v0.21.0)
+
+### Features
+
+* **traces:** added llm traces endpoints ([f1074f7](https://github.com/ZoriHQ/typescript-api-sdk/commit/f1074f71a1dd3801c4df41417ebfd981b0c18754))
+
 ## 0.20.0 (2025-12-06)
 
 Full Changelog: [v0.19.1...v0.20.0](https://github.com/ZoriHQ/typescript-api-sdk/compare/v0.19.1...v0.20.0)

api.md

@@ -29,6 +29,12 @@ Types:
 - <code><a href="./src/resources/v1/analytics/analytics.ts">EventsOverTimeDataPoint</a></code>
 - <code><a href="./src/resources/v1/analytics/analytics.ts">ExitPagesData</a></code>
 - <code><a href="./src/resources/v1/analytics/analytics.ts">ExitPagesResponse</a></code>
+- <code><a href="./src/resources/v1/analytics/analytics.ts">LlmCostResponse</a></code>
+- <code><a href="./src/resources/v1/analytics/analytics.ts">LlmModelCostData</a></code>
+- <code><a href="./src/resources/v1/analytics/analytics.ts">LlmTopModelsCostResponse</a></code>
+- <code><a href="./src/resources/v1/analytics/analytics.ts">LlmTraceFilterOptionsResponse</a></code>
+- <code><a href="./src/resources/v1/analytics/analytics.ts">LlmTraceItem</a></code>
+- <code><a href="./src/resources/v1/analytics/analytics.ts">LlmTracesListResponse</a></code>
 - <code><a href="./src/resources/v1/analytics/analytics.ts">ManualIdentifyRequest</a></code>
 - <code><a href="./src/resources/v1/analytics/analytics.ts">ManualIdentifyResponse</a></code>
 - <code><a href="./src/resources/v1/analytics/analytics.ts">MauResponse</a></code>
@@ -75,6 +81,13 @@ Methods:
 - <code title="get /api/v1/analytics/events/filter-options">client.v1.analytics.events.<a href="./src/resources/v1/analytics/events.ts">filterOptions</a>({ ...params }) -> EventFilterOptionsResponse</code>
 - <code title="get /api/v1/analytics/events/recent">client.v1.analytics.events.<a href="./src/resources/v1/analytics/events.ts">recent</a>({ ...params }) -> RecentEventsResponse</code>
 
+### Llm
+
+Methods:
+
+- <code title="get /api/v1/analytics/llm/traces">client.v1.analytics.llm.<a href="./src/resources/v1/analytics/llm.ts">traces</a>({ ...params }) -> LlmTracesListResponse</code>
+- <code title="get /api/v1/analytics/llm/traces/filter-options">client.v1.analytics.llm.<a href="./src/resources/v1/analytics/llm.ts">tracesFilterOptions</a>({ ...params }) -> LlmTraceFilterOptionsResponse</code>
+
 ### Tiles
 
 Methods:
@@ -83,6 +96,8 @@ Methods:
 - <code title="get /api/v1/analytics/tiles/dau">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">dau</a>({ ...params }) -> DauResponse</code>
 - <code title="get /api/v1/analytics/tiles/entry-pages">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">entryPages</a>({ ...params }) -> EntryPagesResponse</code>
 - <code title="get /api/v1/analytics/tiles/exit-pages">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">exitPages</a>({ ...params }) -> ExitPagesResponse</code>
+- <code title="get /api/v1/analytics/tiles/llm-cost">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">llmCost</a>({ ...params }) -> LlmCostResponse</code>
+- <code title="get /api/v1/analytics/tiles/llm-top-models-cost">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">llmTopModelsCost</a>({ ...params }) -> LlmTopModelsCostResponse</code>
 - <code title="get /api/v1/analytics/tiles/mau">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">mau</a>({ ...params }) -> MauResponse</code>
 - <code title="get /api/v1/analytics/tiles/pages-per-session">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">pagesPerSession</a>({ ...params }) -> PagesPerSessionResponse</code>
 - <code title="get /api/v1/analytics/tiles/return-rate">client.v1.analytics.tiles.<a href="./src/resources/v1/analytics/tiles.ts">returnRate</a>({ ...params }) -> ReturnRateResponse</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "zorihq",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "The official TypeScript library for the Zoriapi API",
   "author": "Zoriapi <support@zorihq.com>",
   "types": "dist/index.d.ts",

src/resources/v1/analytics/analytics.ts

@@ -3,6 +3,8 @@
 import { APIResource } from '../../../core/resource';
 import * as EventsAPI from './events';
 import { EventFilterOptionsParams, EventRecentParams, Events } from './events';
+import * as LlmAPI from './llm';
+import { Llm, LlmTracesFilterOptionsParams, LlmTracesParams } from './llm';
 import * as RetentionAPI from './retention';
 import { Retention, RetentionChurnRateParams, RetentionCohortsParams } from './retention';
 import * as TilesAPI from './tiles';
@@ -11,6 +13,8 @@ import {
   TileDauParams,
   TileEntryPagesParams,
   TileExitPagesParams,
+  TileLlmCostParams,
+  TileLlmTopModelsCostParams,
   TileMauParams,
   TilePagesPerSessionParams,
   TileReturnRateParams,
@@ -40,6 +44,7 @@ import { RequestOptions } from '../../../internal/request-options';
 export class Analytics extends APIResource {
   visitors: VisitorsAPI.Visitors = new VisitorsAPI.Visitors(this._client);
   events: EventsAPI.Events = new EventsAPI.Events(this._client);
+  llm: LlmAPI.Llm = new LlmAPI.Llm(this._client);
   tiles: TilesAPI.Tiles = new TilesAPI.Tiles(this._client);
   retention: RetentionAPI.Retention = new RetentionAPI.Retention(this._client);
 
@@ -157,6 +162,88 @@ export interface ExitPagesResponse {
   data?: Array<ExitPagesData>;
 }
 
+export interface LlmCostResponse {
+  cost?: number;
+
+  previous_cost?: number;
+}
+
+export interface LlmModelCostData {
+  cost?: number;
+
+  model?: string;
+
+  previous_cost?: number;
+}
+
+export interface LlmTopModelsCostResponse {
+  data?: Array<LlmModelCostData>;
+}
+
+export interface LlmTraceFilterOptionsResponse {
+  models?: Array<string>;
+
+  names?: Array<string>;
+
+  session_ids?: Array<string>;
+
+  user_ids?: Array<string>;
+}
+
+export interface LlmTraceItem {
+  avg_latency_ms?: number;
+
+  created_at?: string;
+
+  generation_count?: number;
+
+  input?: string;
+
+  input_tokens?: number;
+
+  metadata?: string;
+
+  models?: Array<string>;
+
+  name?: string;
+
+  output?: string;
+
+  output_tokens?: number;
+
+  public?: boolean;
+
+  release?: string;
+
+  session_id?: string;
+
+  tags?: Array<string>;
+
+  timestamp?: string;
+
+  total_cost?: number;
+
+  total_tokens?: number;
+
+  trace_id?: string;
+
+  updated_at?: string;
+
+  user_id?: string;
+
+  version?: string;
+}
+
+export interface LlmTracesListResponse {
+  limit?: number;
+
+  offset?: number;
+
+  total?: number;
+
+  traces?: Array<LlmTraceItem>;
+}
+
 export interface ManualIdentifyRequest {
   project_id: string;
 
@@ -547,6 +634,7 @@ export interface AnalyticsTimelineParams {
 
 Analytics.Visitors = Visitors;
 Analytics.Events = Events;
+Analytics.Llm = Llm;
 Analytics.Tiles = Tiles;
 Analytics.Retention = Retention;
 
@@ -566,6 +654,12 @@ export declare namespace Analytics {
     type EventsOverTimeDataPoint as EventsOverTimeDataPoint,
     type ExitPagesData as ExitPagesData,
     type ExitPagesResponse as ExitPagesResponse,
+    type LlmCostResponse as LlmCostResponse,
+    type LlmModelCostData as LlmModelCostData,
+    type LlmTopModelsCostResponse as LlmTopModelsCostResponse,
+    type LlmTraceFilterOptionsResponse as LlmTraceFilterOptionsResponse,
+    type LlmTraceItem as LlmTraceItem,
+    type LlmTracesListResponse as LlmTracesListResponse,
     type ManualIdentifyRequest as ManualIdentifyRequest,
     type ManualIdentifyResponse as ManualIdentifyResponse,
     type MauResponse as MauResponse,
@@ -608,12 +702,20 @@ export declare namespace Analytics {
     type EventRecentParams as EventRecentParams,
   };
 
+  export {
+    Llm as Llm,
+    type LlmTracesParams as LlmTracesParams,
+    type LlmTracesFilterOptionsParams as LlmTracesFilterOptionsParams,
+  };
+
   export {
     Tiles as Tiles,
     type TileBounceRateParams as TileBounceRateParams,
     type TileDauParams as TileDauParams,
     type TileEntryPagesParams as TileEntryPagesParams,
     type TileExitPagesParams as TileExitPagesParams,
+    type TileLlmCostParams as TileLlmCostParams,
+    type TileLlmTopModelsCostParams as TileLlmTopModelsCostParams,
     type TileMauParams as TileMauParams,
     type TilePagesPerSessionParams as TilePagesPerSessionParams,
     type TileReturnRateParams as TileReturnRateParams,

src/resources/v1/analytics/index.ts

@@ -16,6 +16,12 @@ export {
   type EventsOverTimeDataPoint,
   type ExitPagesData,
   type ExitPagesResponse,
+  type LlmCostResponse,
+  type LlmModelCostData,
+  type LlmTopModelsCostResponse,
+  type LlmTraceFilterOptionsResponse,
+  type LlmTraceItem,
+  type LlmTracesListResponse,
   type ManualIdentifyRequest,
   type ManualIdentifyResponse,
   type MauResponse,
@@ -44,13 +50,16 @@ export {
   type AnalyticsTimelineParams,
 } from './analytics';
 export { Events, type EventFilterOptionsParams, type EventRecentParams } from './events';
+export { Llm, type LlmTracesParams, type LlmTracesFilterOptionsParams } from './llm';
 export { Retention, type RetentionChurnRateParams, type RetentionCohortsParams } from './retention';
 export {
   Tiles,
   type TileBounceRateParams,
   type TileDauParams,
   type TileEntryPagesParams,
   type TileExitPagesParams,
+  type TileLlmCostParams,
+  type TileLlmTopModelsCostParams,
   type TileMauParams,
   type TilePagesPerSessionParams,
   type TileReturnRateParams,

src/resources/v1/analytics/llm.ts

@@ -0,0 +1,99 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as AnalyticsAPI from './analytics';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Llm extends APIResource {
+  /**
+   * Get a paginated list of LLM traces with optional filters (name, user_id,
+   * session_id, model)
+   *
+   * @example
+   * ```ts
+   * const llmTracesListResponse =
+   *   await client.v1.analytics.llm.traces({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  traces(query: LlmTracesParams, options?: RequestOptions): APIPromise<AnalyticsAPI.LlmTracesListResponse> {
+    return this._client.get('/api/v1/analytics/llm/traces', { query, ...options });
+  }
+
+  /**
+   * Get unique names, user_ids, session_ids, and models to populate filter dropdowns
+   *
+   * @example
+   * ```ts
+   * const llmTraceFilterOptionsResponse =
+   *   await client.v1.analytics.llm.tracesFilterOptions({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  tracesFilterOptions(
+    query: LlmTracesFilterOptionsParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.LlmTraceFilterOptionsResponse> {
+    return this._client.get('/api/v1/analytics/llm/traces/filter-options', { query, ...options });
+  }
+}
+
+export interface LlmTracesParams {
+  project_id: string;
+
+  time_range: 'last_hour' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  customer_id?: string;
+
+  limit?: number;
+
+  model?: string;
+
+  name?: string;
+
+  offset?: number;
+
+  referrer?: string;
+
+  session_id?: string;
+
+  user_id?: string;
+
+  utmtag?: string;
+
+  utmtagValue?: string;
+
+  visitor_id?: string;
+}
+
+export interface LlmTracesFilterOptionsParams {
+  project_id: string;
+
+  time_range: 'last_hour' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  customer_id?: string;
+
+  limit?: number;
+
+  offset?: number;
+
+  referrer?: string;
+
+  utmtag?: string;
+
+  utmtagValue?: string;
+
+  visitor_id?: string;
+}
+
+export declare namespace Llm {
+  export {
+    type LlmTracesParams as LlmTracesParams,
+    type LlmTracesFilterOptionsParams as LlmTracesFilterOptionsParams,
+  };
+}