@meetkai/mka1 0.54.44 → 0.54.46

package/src/models/operations/index.ts

@@ -7,6 +7,7 @@ export * from "./activateagentconnector.js";
 export * from "./addmodelcatalogorgaccess.js";
 export * from "./addteammember.js";
 export * from "./analyticscapture.js";
+export * from "./analyticseventssearch.js";
 export * from "./analyticskeyscreate.js";
 export * from "./analyticskeyslist.js";
 export * from "./analyticskeysrevoke.js";
@@ -15,6 +16,7 @@ export * from "./analyticsprojectsget.js";
 export * from "./analyticsprojectslist.js";
 export * from "./analyticsprojectsupdate.js";
 export * from "./analyticsquery.js";
+export * from "./analyticsvisitorssearch.js";
 export * from "./appendagentevaltrials.js";
 export * from "./batchgetcompletionfeedback.js";
 export * from "./batchgetresponsefeedback.js";

package/src/react-query/analyticsEventsSearch.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { analyticsEventsSearch } from "../funcs/analyticsEventsSearch.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type AnalyticsEventsSearchMutationVariables = {
+  request: operations.AnalyticsEventsSearchRequest;
+  options?: RequestOptions;
+};
+
+export type AnalyticsEventsSearchMutationData =
+  components.AnalyticsEventSearchResponse;
+
+export type AnalyticsEventsSearchMutationError =
+  | errors.AnalyticsError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Search events in a time range
+ *
+ * @remarks
+ * List individual events in a time range, newest first, with their properties. Optionally filter by event name, event properties, or one visitor's distinct_id. The range includes from and excludes to, and duplicate event IDs are returned once, so a search over a chart bucket's range with the same filters lists exactly the events that bucket counted. A page holds up to 100 events; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: no event repeats or is skipped, and events received after the snapshot, including a redelivery that revises a listed event, appear only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted event it adds or moves ahead of the cursor is skipped and a listed event that a lower-hash redelivery moves behind the cursor repeats at its revised position. A cursor that does not decode, or one from another list, returns 400. A page whose events exceed the response size limit returns 413; request a smaller limit.
+ */
+export function useAnalyticsEventsSearchMutation(
+  options?: MutationHookOptions<
+    AnalyticsEventsSearchMutationData,
+    AnalyticsEventsSearchMutationError,
+    AnalyticsEventsSearchMutationVariables
+  >,
+): UseMutationResult<
+  AnalyticsEventsSearchMutationData,
+  AnalyticsEventsSearchMutationError,
+  AnalyticsEventsSearchMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAnalyticsEventsSearchMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAnalyticsEventsSearch(): MutationKey {
+  return ["@meetkai/mka1", "events", "search"];
+}
+
+export function buildAnalyticsEventsSearchMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AnalyticsEventsSearchMutationVariables,
+  ) => Promise<AnalyticsEventsSearchMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAnalyticsEventsSearch(),
+    mutationFn: function analyticsEventsSearchMutationFn({
+      request,
+      options,
+    }): Promise<AnalyticsEventsSearchMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(analyticsEventsSearch(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/analyticsVisitorsSearch.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { analyticsVisitorsSearch } from "../funcs/analyticsVisitorsSearch.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type AnalyticsVisitorsSearchMutationVariables = {
+  request: operations.AnalyticsVisitorsSearchRequest;
+  options?: RequestOptions;
+};
+
+export type AnalyticsVisitorsSearchMutationData =
+  components.AnalyticsVisitorSearchResponse;
+
+export type AnalyticsVisitorsSearchMutationError =
+  | errors.AnalyticsError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Search visitors in a time range
+ *
+ * @remarks
+ * List visitors with matching events in a time range, most recently active first. Each visitor is one distinct_id with the timestamps of its first and last matching event and its event count over the whole range, so for a range that receives no further events the number of visitors across all pages equals the unique_visitors query for the same range and filters. The range includes from and excludes to, and duplicate event IDs are counted once. A page holds up to 100 visitors; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: a visitor keeps the position, first_seen, last_seen and event_count the sequence started with, no visitor repeats or is skipped, and activity received after the snapshot appears only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted visitor it adds or moves ahead of the cursor is skipped and a listed visitor whose winning delivery a lower-hash redelivery moves behind the cursor repeats with revised totals; a listed visitor's totals otherwise stay as listed. A cursor that does not decode, or one from another list, returns 400.
+ */
+export function useAnalyticsVisitorsSearchMutation(
+  options?: MutationHookOptions<
+    AnalyticsVisitorsSearchMutationData,
+    AnalyticsVisitorsSearchMutationError,
+    AnalyticsVisitorsSearchMutationVariables
+  >,
+): UseMutationResult<
+  AnalyticsVisitorsSearchMutationData,
+  AnalyticsVisitorsSearchMutationError,
+  AnalyticsVisitorsSearchMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAnalyticsVisitorsSearchMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAnalyticsVisitorsSearch(): MutationKey {
+  return ["@meetkai/mka1", "visitors", "search"];
+}
+
+export function buildAnalyticsVisitorsSearchMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AnalyticsVisitorsSearchMutationVariables,
+  ) => Promise<AnalyticsVisitorsSearchMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAnalyticsVisitorsSearch(),
+    mutationFn: function analyticsVisitorsSearchMutationFn({
+      request,
+      options,
+    }): Promise<AnalyticsVisitorsSearchMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(analyticsVisitorsSearch(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -33,6 +33,7 @@ export * from "./agentVersionsGetAgentVersion.js";
 export * from "./agentVersionsListAgentVersions.js";
 export * from "./agentVersionsRollbackAgentVersion.js";
 export * from "./analyticsCapture.js";
+export * from "./analyticsEventsSearch.js";
 export * from "./analyticsKeysCreate.js";
 export * from "./analyticsKeysList.js";
 export * from "./analyticsKeysRevoke.js";
@@ -42,6 +43,7 @@ export * from "./analyticsProjectsGet.js";
 export * from "./analyticsProjectsList.js";
 export * from "./analyticsProjectsUpdate.js";
 export * from "./analyticsQuery.js";
+export * from "./analyticsVisitorsSearch.js";
 export * from "./authApiKeyGetJwtFromKey.js";
 export * from "./authApiKeysCreate.js";
 export * from "./authApiKeysExchangeToken.js";

package/src/react-query/llmModelsListEffectivePrices.ts

@@ -54,7 +54,7 @@ export type LlmModelsListEffectivePricesQueryError =
  * List effective prices for the caller's models
  *
  * @remarks
- * For every active model, returns its registry-aware price: an org row, a cluster default for cluster lineage, or unpriced ($0).
+ * For every active model, returns its registry-aware price: an org row, a cluster default for cluster lineage, or unpriced ($0). Also lists the `auto` routing alias, priced at the per-metric maximum across every model it can be billed as (`resolves_to`): a judge policy's active candidates, or the direct/YAML target plus any reroute target it can fall through to.
  */
 export function useLlmModelsListEffectivePrices(
   request: operations.ListEffectivePricesRequest,
@@ -81,7 +81,7 @@ export function useLlmModelsListEffectivePrices(
  * List effective prices for the caller's models
  *
  * @remarks
- * For every active model, returns its registry-aware price: an org row, a cluster default for cluster lineage, or unpriced ($0).
+ * For every active model, returns its registry-aware price: an org row, a cluster default for cluster lineage, or unpriced ($0). Also lists the `auto` routing alias, priced at the per-metric maximum across every model it can be billed as (`resolves_to`): a judge policy's active candidates, or the direct/YAML target plus any reroute target it can fall through to.
  */
 export function useLlmModelsListEffectivePricesSuspense(
   request: operations.ListEffectivePricesRequest,

package/src/sdk/analytics.ts

@@ -8,8 +8,10 @@ import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
+import { Events } from "./events.js";
 import { Keys } from "./keys.js";
 import { Projects } from "./projects.js";
+import { Visitors } from "./visitors.js";
 
 export class Analytics extends ClientSDK {
   private _projects?: Projects;
@@ -22,6 +24,16 @@ export class Analytics extends ClientSDK {
     return (this._keys ??= new Keys(this._options));
   }
 
+  private _events?: Events;
+  get events(): Events {
+    return (this._events ??= new Events(this._options));
+  }
+
+  private _visitors?: Visitors;
+  get visitors(): Visitors {
+    return (this._visitors ??= new Visitors(this._options));
+  }
+
   /**
    * Durably accept a batch of events
    *

package/src/sdk/events.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { analyticsEventsSearch } from "../funcs/analyticsEventsSearch.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Events extends ClientSDK {
+  /**
+   * Search events in a time range
+   *
+   * @remarks
+   * List individual events in a time range, newest first, with their properties. Optionally filter by event name, event properties, or one visitor's distinct_id. The range includes from and excludes to, and duplicate event IDs are returned once, so a search over a chart bucket's range with the same filters lists exactly the events that bucket counted. A page holds up to 100 events; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: no event repeats or is skipped, and events received after the snapshot, including a redelivery that revises a listed event, appear only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted event it adds or moves ahead of the cursor is skipped and a listed event that a lower-hash redelivery moves behind the cursor repeats at its revised position. A cursor that does not decode, or one from another list, returns 400. A page whose events exceed the response size limit returns 413; request a smaller limit.
+   */
+  async search(
+    request: operations.AnalyticsEventsSearchRequest,
+    options?: RequestOptions,
+  ): Promise<components.AnalyticsEventSearchResponse> {
+    return unwrapAsync(analyticsEventsSearch(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/models.ts

@@ -455,7 +455,7 @@ export class Models extends ClientSDK {
    * List effective prices for the caller's models
    *
    * @remarks
-   * For every active model, returns its registry-aware price: an org row, a cluster default for cluster lineage, or unpriced ($0).
+   * For every active model, returns its registry-aware price: an org row, a cluster default for cluster lineage, or unpriced ($0). Also lists the `auto` routing alias, priced at the per-metric maximum across every model it can be billed as (`resolves_to`): a judge policy's active candidates, or the direct/YAML target plus any reroute target it can fall through to.
    */
   async listEffectivePrices(
     request: operations.ListEffectivePricesRequest,

package/src/sdk/visitors.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { analyticsVisitorsSearch } from "../funcs/analyticsVisitorsSearch.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Visitors extends ClientSDK {
+  /**
+   * Search visitors in a time range
+   *
+   * @remarks
+   * List visitors with matching events in a time range, most recently active first. Each visitor is one distinct_id with the timestamps of its first and last matching event and its event count over the whole range, so for a range that receives no further events the number of visitors across all pages equals the unique_visitors query for the same range and filters. The range includes from and excludes to, and duplicate event IDs are counted once. A page holds up to 100 visitors; pass next_cursor as cursor for the following page until it is null. The first page takes a snapshot from ClickHouse's clock before reading its rows and its cursor carries it, so every page of the sequence, the first included, reads only deliveries received at or before that snapshot and ages events out of retention as of it: a visitor keeps the position, first_seen, last_seen and event_count the sequence started with, no visitor repeats or is skipped, and activity received after the snapshot appears only when paging restarts without a cursor. One window blurs that boundary: ClickHouse stamps a receipt at whole seconds when an insert starts and commits its rows when it finishes, so a delivery stamped in or before the snapshot's second that commits after the first page was read is inside the sequence but missing from the first page; it joins from the next page, where an unlisted visitor it adds or moves ahead of the cursor is skipped and a listed visitor whose winning delivery a lower-hash redelivery moves behind the cursor repeats with revised totals; a listed visitor's totals otherwise stay as listed. A cursor that does not decode, or one from another list, returns 400.
+   */
+  async search(
+    request: operations.AnalyticsVisitorsSearchRequest,
+    options?: RequestOptions,
+  ): Promise<components.AnalyticsVisitorSearchResponse> {
+    return unwrapAsync(analyticsVisitorsSearch(
+      this,
+      request,
+      options,
+    ));
+  }
+}