openlayer 0.25.1 → 0.26.1

package/src/resources/inference-pipelines/inference-pipelines.ts

@@ -4,7 +4,16 @@ import { APIResource } from '../../core/resource';
 import * as DataAPI from './data';
 import { Data, DataStreamParams, DataStreamResponse } from './data';
 import * as RowsAPI from './rows';
-import { RowListParams, RowListResponse, RowUpdateParams, RowUpdateResponse, Rows } from './rows';
+import {
+  RowDeleteParams,
+  RowListParams,
+  RowListResponse,
+  RowRetrieveParams,
+  RowRetrieveResponse,
+  RowUpdateParams,
+  RowUpdateResponse,
+  Rows,
+} from './rows';
 import * as TestResultsAPI from './test-results';
 import { TestResultListParams, TestResultListResponse, TestResults } from './test-results';
 import { APIPromise } from '../../core/api-promise';
@@ -72,6 +81,35 @@ export class InferencePipelines extends APIResource {
     });
   }
 
+  /**
+   * Get aggregated session data for an inference pipeline with pagination and
+   * metadata.
+   *
+   * Returns a list of sessions for the inference pipeline, including activity
+   * statistics such as record counts, token usage, cost, latency, and the first and
+   * last records.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.inferencePipelines.retrieveSessions(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   );
+   * ```
+   */
+  retrieveSessions(
+    inferencePipelineID: string,
+    params: InferencePipelineRetrieveSessionsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<InferencePipelineRetrieveSessionsResponse> {
+    const { asc, page, perPage, sortColumn, ...body } = params ?? {};
+    return this._client.post(path`/inference-pipelines/${inferencePipelineID}/sessions`, {
+      query: { asc, page, perPage, sortColumn },
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Get aggregated user data for an inference pipeline with pagination and metadata.
    *
@@ -89,10 +127,15 @@ export class InferencePipelines extends APIResource {
    */
   retrieveUsers(
     inferencePipelineID: string,
-    query: InferencePipelineRetrieveUsersParams | null | undefined = {},
+    params: InferencePipelineRetrieveUsersParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<InferencePipelineRetrieveUsersResponse> {
-    return this._client.get(path`/inference-pipelines/${inferencePipelineID}/users`, { query, ...options });
+    const { asc, page, perPage, sortColumn, ...body } = params ?? {};
+    return this._client.post(path`/inference-pipelines/${inferencePipelineID}/users`, {
+      query: { asc, page, perPage, sortColumn },
+      body,
+      ...options,
+    });
   }
 }
 
@@ -832,6 +875,77 @@ export namespace InferencePipelineUpdateResponse {
   }
 }
 
+export interface InferencePipelineRetrieveSessionsResponse {
+  /**
+   * Array of session aggregation data
+   */
+  items: Array<InferencePipelineRetrieveSessionsResponse.Item>;
+}
+
+export namespace InferencePipelineRetrieveSessionsResponse {
+  export interface Item {
+    /**
+     * The unique session identifier
+     */
+    id: string;
+
+    /**
+     * Total cost for the session
+     */
+    cost: number;
+
+    /**
+     * Latest/most recent timestamp in the session
+     */
+    dateCreated: string;
+
+    /**
+     * Timestamp of the first request in the session
+     */
+    dateOfFirstRecord: string;
+
+    /**
+     * Timestamp of the last request in the session
+     */
+    dateOfLastRecord: string;
+
+    /**
+     * Duration between first and last request (in milliseconds)
+     */
+    duration: number;
+
+    /**
+     * The complete first record in the session
+     */
+    firstRecord: { [key: string]: unknown };
+
+    /**
+     * The complete last record in the session
+     */
+    lastRecord: { [key: string]: unknown };
+
+    /**
+     * Total latency for the session (in milliseconds)
+     */
+    latency: number;
+
+    /**
+     * Total number of records/traces in the session
+     */
+    records: number;
+
+    /**
+     * Total token count for the session
+     */
+    tokens: number;
+
+    /**
+     * List of unique user IDs that participated in this session
+     */
+    userIds: Array<string>;
+  }
+}
+
 export interface InferencePipelineRetrieveUsersResponse {
   /**
    * Array of user aggregation data
@@ -903,16 +1017,196 @@ export interface InferencePipelineUpdateParams {
   referenceDatasetUri?: string | null;
 }
 
+export interface InferencePipelineRetrieveSessionsParams {
+  /**
+   * Query param: Whether or not to sort on the sortColumn in ascending order.
+   */
+  asc?: boolean;
+
+  /**
+   * Query param: The page to return in a paginated query.
+   */
+  page?: number;
+
+  /**
+   * Query param: Maximum number of items to return per page.
+   */
+  perPage?: number;
+
+  /**
+   * Query param: Name of the column to sort on
+   */
+  sortColumn?: string;
+
+  /**
+   * Body param
+   */
+  columnFilters?: Array<
+    | InferencePipelineRetrieveSessionsParams.SetColumnFilter
+    | InferencePipelineRetrieveSessionsParams.NumericColumnFilter
+    | InferencePipelineRetrieveSessionsParams.StringColumnFilter
+  > | null;
+
+  /**
+   * Body param
+   */
+  excludeRowIdList?: Array<number> | null;
+
+  /**
+   * Body param
+   */
+  notSearchQueryAnd?: Array<string> | null;
+
+  /**
+   * Body param
+   */
+  notSearchQueryOr?: Array<string> | null;
+
+  /**
+   * Body param
+   */
+  rowIdList?: Array<number> | null;
+
+  /**
+   * Body param
+   */
+  searchQueryAnd?: Array<string> | null;
+
+  /**
+   * Body param
+   */
+  searchQueryOr?: Array<string> | null;
+}
+
+export namespace InferencePipelineRetrieveSessionsParams {
+  export interface SetColumnFilter {
+    /**
+     * The name of the column.
+     */
+    measurement: string;
+
+    operator: 'contains_none' | 'contains_any' | 'contains_all' | 'one_of' | 'none_of';
+
+    value: Array<string | number>;
+  }
+
+  export interface NumericColumnFilter {
+    /**
+     * The name of the column.
+     */
+    measurement: string;
+
+    operator: '>' | '>=' | 'is' | '<' | '<=' | '!=';
+
+    value: number | null;
+  }
+
+  export interface StringColumnFilter {
+    /**
+     * The name of the column.
+     */
+    measurement: string;
+
+    operator: 'is' | '!=';
+
+    value: string | boolean;
+  }
+}
+
 export interface InferencePipelineRetrieveUsersParams {
   /**
-   * The page to return in a paginated query.
+   * Query param: Whether or not to sort on the sortColumn in ascending order.
+   */
+  asc?: boolean;
+
+  /**
+   * Query param: The page to return in a paginated query.
    */
   page?: number;
 
   /**
-   * Maximum number of items to return per page.
+   * Query param: Maximum number of items to return per page.
    */
   perPage?: number;
+
+  /**
+   * Query param: Name of the column to sort on
+   */
+  sortColumn?: string;
+
+  /**
+   * Body param
+   */
+  columnFilters?: Array<
+    | InferencePipelineRetrieveUsersParams.SetColumnFilter
+    | InferencePipelineRetrieveUsersParams.NumericColumnFilter
+    | InferencePipelineRetrieveUsersParams.StringColumnFilter
+  > | null;
+
+  /**
+   * Body param
+   */
+  excludeRowIdList?: Array<number> | null;
+
+  /**
+   * Body param
+   */
+  notSearchQueryAnd?: Array<string> | null;
+
+  /**
+   * Body param
+   */
+  notSearchQueryOr?: Array<string> | null;
+
+  /**
+   * Body param
+   */
+  rowIdList?: Array<number> | null;
+
+  /**
+   * Body param
+   */
+  searchQueryAnd?: Array<string> | null;
+
+  /**
+   * Body param
+   */
+  searchQueryOr?: Array<string> | null;
+}
+
+export namespace InferencePipelineRetrieveUsersParams {
+  export interface SetColumnFilter {
+    /**
+     * The name of the column.
+     */
+    measurement: string;
+
+    operator: 'contains_none' | 'contains_any' | 'contains_all' | 'one_of' | 'none_of';
+
+    value: Array<string | number>;
+  }
+
+  export interface NumericColumnFilter {
+    /**
+     * The name of the column.
+     */
+    measurement: string;
+
+    operator: '>' | '>=' | 'is' | '<' | '<=' | '!=';
+
+    value: number | null;
+  }
+
+  export interface StringColumnFilter {
+    /**
+     * The name of the column.
+     */
+    measurement: string;
+
+    operator: 'is' | '!=';
+
+    value: string | boolean;
+  }
 }
 
 InferencePipelines.Data = Data;
@@ -923,9 +1217,11 @@ export declare namespace InferencePipelines {
   export {
     type InferencePipelineRetrieveResponse as InferencePipelineRetrieveResponse,
     type InferencePipelineUpdateResponse as InferencePipelineUpdateResponse,
+    type InferencePipelineRetrieveSessionsResponse as InferencePipelineRetrieveSessionsResponse,
     type InferencePipelineRetrieveUsersResponse as InferencePipelineRetrieveUsersResponse,
     type InferencePipelineRetrieveParams as InferencePipelineRetrieveParams,
     type InferencePipelineUpdateParams as InferencePipelineUpdateParams,
+    type InferencePipelineRetrieveSessionsParams as InferencePipelineRetrieveSessionsParams,
     type InferencePipelineRetrieveUsersParams as InferencePipelineRetrieveUsersParams,
   };
 
@@ -937,10 +1233,13 @@ export declare namespace InferencePipelines {
 
   export {
     Rows as Rows,
+    type RowRetrieveResponse as RowRetrieveResponse,
     type RowUpdateResponse as RowUpdateResponse,
     type RowListResponse as RowListResponse,
+    type RowRetrieveParams as RowRetrieveParams,
     type RowUpdateParams as RowUpdateParams,
     type RowListParams as RowListParams,
+    type RowDeleteParams as RowDeleteParams,
   };
 
   export {

package/src/resources/inference-pipelines/rows.ts

@@ -2,10 +2,34 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Rows extends APIResource {
+  /**
+   * Fetch a single inference pipeline row by inference ID, including OTel steps.
+   *
+   * @example
+   * ```ts
+   * const row = await client.inferencePipelines.rows.retrieve(
+   *   'inferenceId',
+   *   {
+   *     inferencePipelineId:
+   *       '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   },
+   * );
+   * ```
+   */
+  retrieve(
+    inferenceID: string,
+    params: RowRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<RowRetrieveResponse> {
+    const { inferencePipelineId } = params;
+    return this._client.get(path`/inference-pipelines/${inferencePipelineId}/rows/${inferenceID}`, options);
+  }
+
   /**
    * Update an inference data point in an inference pipeline.
    *
@@ -55,6 +79,32 @@ export class Rows extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * Delete a single inference pipeline row by inference ID. Only project admins can
+   * perform this action.
+   *
+   * @example
+   * ```ts
+   * await client.inferencePipelines.rows.delete('inferenceId', {
+   *   inferencePipelineId:
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * });
+   * ```
+   */
+  delete(inferenceID: string, params: RowDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { inferencePipelineId } = params;
+    return this._client.delete(path`/inference-pipelines/${inferencePipelineId}/rows/${inferenceID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface RowRetrieveResponse {
+  row?: unknown;
+
+  success?: boolean;
 }
 
 export interface RowUpdateResponse {
@@ -71,6 +121,13 @@ export namespace RowListResponse {
   }
 }
 
+export interface RowRetrieveParams {
+  /**
+   * The inference pipeline id (a UUID).
+   */
+  inferencePipelineId: string;
+}
+
 export interface RowUpdateParams {
   /**
    * Query param: Specify the inference id as a query param.
@@ -214,11 +271,21 @@ export namespace RowListParams {
   }
 }
 
+export interface RowDeleteParams {
+  /**
+   * The inference pipeline id (a UUID).
+   */
+  inferencePipelineId: string;
+}
+
 export declare namespace Rows {
   export {
+    type RowRetrieveResponse as RowRetrieveResponse,
     type RowUpdateResponse as RowUpdateResponse,
     type RowListResponse as RowListResponse,
+    type RowRetrieveParams as RowRetrieveParams,
     type RowUpdateParams as RowUpdateParams,
     type RowListParams as RowListParams,
+    type RowDeleteParams as RowDeleteParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.25.1'; // x-release-please-version
+export const VERSION = '0.26.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.25.1";
+export declare const VERSION = "0.26.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.25.1";
+export declare const VERSION = "0.26.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.25.1'; // x-release-please-version
+exports.VERSION = '0.26.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.25.1'; // x-release-please-version
+export const VERSION = '0.26.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map