@meetkai/mka1 0.54.39 → 0.54.41

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.54.39",
+    currentVersion: "0.54.41",
   },
 });
 

package/src/mcp-server/server.ts

@@ -440,7 +440,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.54.39",
+    version: "0.54.41",
   });
 
   const client = new SDKCore({

package/src/mcp-server/tools/analyticsKeysCreate.ts

@@ -12,7 +12,9 @@ const args = {
 
 export const tool$analyticsKeysCreate: ToolDefinition<typeof args> = {
   name: "analytics-keys-create",
-  description: `Create a capture key and return its secret once`,
+  description: `Create a capture key and return its secret once
+
+Create a key that can send events to this project. Save the key from this response; its secret is only returned once. Capture keys cannot read analytics or manage projects.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await analyticsKeysCreate(

package/src/mcp-server/tools/analyticsProjectsArchive.ts

@@ -12,7 +12,9 @@ const args = {
 
 export const tool$analyticsProjectsArchive: ToolDefinition<typeof args> = {
   name: "analytics-projects-archive",
-  description: `Archive an analytics project`,
+  description: `Archive an analytics project
+
+Stop new captures and queries for this project. Previously accepted events continue processing. Archiving does not delete stored events.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await analyticsProjectsArchive(

package/src/mcp-server/tools/analyticsProjectsUpdate.ts

@@ -12,7 +12,9 @@ const args = {
 
 export const tool$analyticsProjectsUpdate: ToolDefinition<typeof args> = {
   name: "analytics-projects-update",
-  description: `Rename an active analytics project`,
+  description: `Rename an active analytics project
+
+Rename an active project. Project ownership cannot be changed.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await analyticsProjectsUpdate(

package/src/mcp-server/tools/analyticsQuery.ts

@@ -12,7 +12,9 @@ const args = {
 
 export const tool$analyticsQuery: ToolDefinition<typeof args> = {
   name: "analytics-query",
-  description: `Query event counts or unique visitors`,
+  description: `Query event counts or unique visitors
+
+Count events or unique visitors in a time range. Optionally filter by event name or properties, group by one property, and split results into UTC time buckets. The range includes from and excludes to. Duplicate event IDs are counted once.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await analyticsQuery(

package/src/models/components/analyticscapturekey.ts

@@ -13,6 +13,9 @@ export type AnalyticsCaptureKey = {
   projectId: string;
   name: string;
   prefix: string;
+  /**
+   * When the capture key was created, in UTC.
+   */
   createdAt: Date;
   revokedAt: Date | null;
 };

package/src/models/components/analyticscapturerequest.ts

@@ -15,6 +15,9 @@ import {
 } from "./analyticsevent.js";
 
 export type AnalyticsCaptureRequest = {
+  /**
+   * Unique identifier for this batch. Reuse it with the same events when retrying. Reusing it with different events returns 409.
+   */
   idempotencyKey: string;
   events: Array<AnalyticsEvent>;
 };

package/src/models/components/analyticscreatedcapturekey.ts

@@ -13,6 +13,9 @@ export type AnalyticsCreatedCaptureKey = {
   projectId: string;
   name: string;
   prefix: string;
+  /**
+   * When the capture key was created, in UTC.
+   */
   createdAt: Date;
   revokedAt: Date | null;
   /**

package/src/models/components/analyticsevent.ts

@@ -11,10 +11,25 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 export type Properties = string | number | boolean;
 
 export type AnalyticsEvent = {
+  /**
+   * Unique ID for this event. Reuse it when retrying the same event.
+   */
   eventId: string;
+  /**
+   * Name of the action you are tracking.
+   */
   eventName: string;
+  /**
+   * When the event occurred. Use an ISO 8601 timestamp with Z for UTC or an offset such as -07:00. Send current timestamps for new events.
+   */
   timestamp: Date;
+  /**
+   * Your identifier for the visitor. Unique visitor queries count distinct values of this field.
+   */
   distinctId: string;
+  /**
+   * Up to 100 event properties. Values can be strings, numbers, booleans, or null. Nested objects and arrays are not supported.
+   */
   properties: { [k: string]: string | number | boolean | null };
 };
 

package/src/models/components/analyticsproject.ts

@@ -13,7 +13,13 @@ export type AnalyticsProject = {
   orgId: string;
   teamId: string | null;
   name: string;
+  /**
+   * When the project was created, in UTC.
+   */
   createdAt: Date;
+  /**
+   * When the project was last updated, in UTC.
+   */
   updatedAt: Date;
   archivedAt: Date | null;
 };

package/src/models/components/analyticsqueryrequest.ts

@@ -9,21 +9,36 @@ import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
+/**
+ * count counts events. unique_visitors counts distinct values of distinct_id. Both deduplicate event IDs first.
+ */
 export const AnalyticsQueryRequestMetric = {
   Count: "count",
   UniqueVisitors: "unique_visitors",
 } as const;
+/**
+ * count counts events. unique_visitors counts distinct values of distinct_id. Both deduplicate event IDs first.
+ */
 export type AnalyticsQueryRequestMetric = ClosedEnum<
   typeof AnalyticsQueryRequestMetric
 >;
 
+/**
+ * Split results into UTC time buckets. Weeks start on Monday. Empty buckets are omitted.
+ */
 export const Bucket = {
   Hour: "hour",
   Day: "day",
   Week: "week",
 } as const;
+/**
+ * Split results into UTC time buckets. Weeks start on Monday. Empty buckets are omitted.
+ */
 export type Bucket = ClosedEnum<typeof Bucket>;
 
+/**
+ * Comparison operator. gt, gte, lt, and lte require a numeric value. exists and not_exists check whether the property is present and do not take a value.
+ */
 export const Op = {
   Eq: "eq",
   Neq: "neq",
@@ -34,24 +49,63 @@ export const Op = {
   Exists: "exists",
   NotExists: "not_exists",
 } as const;
+/**
+ * Comparison operator. gt, gte, lt, and lte require a numeric value. exists and not_exists check whether the property is present and do not take a value.
+ */
 export type Op = ClosedEnum<typeof Op>;
 
+/**
+ * Value to compare. The number 1 differs from the string '1'. Omit for exists and not_exists.
+ */
 export type AnalyticsQueryRequestValue = string | number | boolean;
 
 export type AnalyticsQueryRequestFilters = {
+  /**
+   * Event property to filter. Property names are literal keys, not nested paths.
+   */
   property: string;
+  /**
+   * Comparison operator. gt, gte, lt, and lte require a numeric value. exists and not_exists check whether the property is present and do not take a value.
+   */
   op: Op;
+  /**
+   * Value to compare. The number 1 differs from the string '1'. Omit for exists and not_exists.
+   */
   value?: string | number | boolean | null | undefined;
 };
 
 export type AnalyticsQueryRequest = {
+  /**
+   * count counts events. unique_visitors counts distinct values of distinct_id. Both deduplicate event IDs first.
+   */
   metric: AnalyticsQueryRequestMetric;
+  /**
+   * Start of the time range, inclusive. Use an ISO 8601 timestamp with Z for UTC or an offset such as -07:00. Must be before to.
+   */
   from: Date;
+  /**
+   * End of the time range, exclusive. Use an ISO 8601 timestamp with Z for UTC or an offset such as -07:00. Must be after from.
+   */
   to: Date;
+  /**
+   * Only include events with this exact name. Omit to include all event names.
+   */
   eventName?: string | undefined;
+  /**
+   * Split results into UTC time buckets. Weeks start on Monday. Empty buckets are omitted.
+   */
   bucket?: Bucket | undefined;
+  /**
+   * Group results by one event property. Missing values and null share a group.
+   */
   groupBy?: string | undefined;
+  /**
+   * Property filters combined with AND. An event must match every filter.
+   */
   filters?: Array<AnalyticsQueryRequestFilters> | undefined;
+  /**
+   * Maximum number of result rows, including rows created by time buckets and property groups.
+   */
   limit?: number | undefined;
 };
 

package/src/models/components/sessionrecord.ts

@@ -70,6 +70,8 @@ export type SessionRecord = {
   idleExpiresAt?: Date | null | undefined;
   absoluteExpiresAt?: Date | null | undefined;
   stopReason?: CodingHarnessStopReason | null | undefined;
+  runnerCleanupHoldReason?: string | null | undefined;
+  runnerCleanupHeldAt?: Date | null | undefined;
   lastCheckpointAt?: Date | null | undefined;
   lastCheckpointGeneration?: number | null | undefined;
   sandboxFeatures?: Array<SandboxFeature> | undefined;
@@ -115,6 +117,10 @@ export const SessionRecord$inboundSchema: z.ZodType<
     z.string().datetime({ offset: true }).transform(v => new Date(v)),
   ).optional(),
   stop_reason: z.nullable(CodingHarnessStopReason$inboundSchema).optional(),
+  runner_cleanup_hold_reason: z.nullable(z.string()).optional(),
+  runner_cleanup_held_at: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
   last_checkpoint_at: z.nullable(
     z.string().datetime({ offset: true }).transform(v => new Date(v)),
   ).optional(),
@@ -149,6 +155,8 @@ export const SessionRecord$inboundSchema: z.ZodType<
     "idle_expires_at": "idleExpiresAt",
     "absolute_expires_at": "absoluteExpiresAt",
     "stop_reason": "stopReason",
+    "runner_cleanup_hold_reason": "runnerCleanupHoldReason",
+    "runner_cleanup_held_at": "runnerCleanupHeldAt",
     "last_checkpoint_at": "lastCheckpointAt",
     "last_checkpoint_generation": "lastCheckpointGeneration",
     "sandbox_features": "sandboxFeatures",
@@ -181,6 +189,8 @@ export type SessionRecord$Outbound = {
   idle_expires_at?: string | null | undefined;
   absolute_expires_at?: string | null | undefined;
   stop_reason?: string | null | undefined;
+  runner_cleanup_hold_reason?: string | null | undefined;
+  runner_cleanup_held_at?: string | null | undefined;
   last_checkpoint_at?: string | null | undefined;
   last_checkpoint_generation?: number | null | undefined;
   sandbox_features?: Array<string> | undefined;
@@ -222,6 +232,9 @@ export const SessionRecord$outboundSchema: z.ZodType<
   absoluteExpiresAt: z.nullable(z.date().transform(v => v.toISOString()))
     .optional(),
   stopReason: z.nullable(CodingHarnessStopReason$outboundSchema).optional(),
+  runnerCleanupHoldReason: z.nullable(z.string()).optional(),
+  runnerCleanupHeldAt: z.nullable(z.date().transform(v => v.toISOString()))
+    .optional(),
   lastCheckpointAt: z.nullable(z.date().transform(v => v.toISOString()))
     .optional(),
   lastCheckpointGeneration: z.nullable(z.number().int()).optional(),
@@ -253,6 +266,8 @@ export const SessionRecord$outboundSchema: z.ZodType<
     idleExpiresAt: "idle_expires_at",
     absoluteExpiresAt: "absolute_expires_at",
     stopReason: "stop_reason",
+    runnerCleanupHoldReason: "runner_cleanup_hold_reason",
+    runnerCleanupHeldAt: "runner_cleanup_held_at",
     lastCheckpointAt: "last_checkpoint_at",
     lastCheckpointGeneration: "last_checkpoint_generation",
     sandboxFeatures: "sandbox_features",

package/src/models/operations/analyticskeyscreate.ts

@@ -10,6 +10,9 @@ import * as components from "../components/index.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsKeysCreateRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
   analyticsKeyCreate: components.AnalyticsKeyCreate;
 };

package/src/models/operations/analyticskeyslist.ts

@@ -8,6 +8,9 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsKeysListRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
   limit?: number | undefined;
   after?: string | undefined;

package/src/models/operations/analyticskeysrevoke.ts

@@ -8,6 +8,9 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsKeysRevokeRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
   keyId: string;
 };

package/src/models/operations/analyticsprojectsarchive.ts

@@ -8,6 +8,9 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsProjectsArchiveRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
 };
 

package/src/models/operations/analyticsprojectsget.ts

@@ -8,6 +8,9 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsProjectsGetRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
 };
 

package/src/models/operations/analyticsprojectsupdate.ts

@@ -10,6 +10,9 @@ import * as components from "../components/index.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsProjectsUpdateRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
   analyticsProjectUpdate: components.AnalyticsProjectUpdate;
 };

package/src/models/operations/analyticsquery.ts

@@ -10,6 +10,9 @@ import * as components from "../components/index.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type AnalyticsQueryRequest = {
+  /**
+   * ID of the analytics project.
+   */
   id: string;
   analyticsQueryRequest: components.AnalyticsQueryRequest;
 };

package/src/react-query/analyticsCapture.ts

@@ -49,6 +49,9 @@ export type AnalyticsCaptureMutationError =
 
 /**
  * Durably accept a batch of events
+ *
+ * @remarks
+ * Send a batch of events using the project's X-Analytics-Key header. A 202 response confirms the batch is stored; events become available to queries after background processing. Retry with the same idempotency_key and unchanged events if you do not receive a response.
  */
 export function useAnalyticsCaptureMutation(
   options?: MutationHookOptions<

package/src/react-query/analyticsKeysCreate.ts

@@ -49,6 +49,9 @@ export type AnalyticsKeysCreateMutationError =
 
 /**
  * Create a capture key and return its secret once
+ *
+ * @remarks
+ * Create a key that can send events to this project. Save the key from this response; its secret is only returned once. Capture keys cannot read analytics or manage projects.
  */
 export function useAnalyticsKeysCreateMutation(
   options?: MutationHookOptions<

package/src/react-query/analyticsProjectsArchive.ts

@@ -48,6 +48,9 @@ export type AnalyticsProjectsArchiveMutationError =
 
 /**
  * Archive an analytics project
+ *
+ * @remarks
+ * Stop new captures and queries for this project. Previously accepted events continue processing. Archiving does not delete stored events.
  */
 export function useAnalyticsProjectsArchiveMutation(
   options?: MutationHookOptions<

package/src/react-query/analyticsProjectsUpdate.ts

@@ -48,6 +48,9 @@ export type AnalyticsProjectsUpdateMutationError =
 
 /**
  * Rename an active analytics project
+ *
+ * @remarks
+ * Rename an active project. Project ownership cannot be changed.
  */
 export function useAnalyticsProjectsUpdateMutation(
   options?: MutationHookOptions<

package/src/react-query/analyticsQuery.ts

@@ -48,6 +48,9 @@ export type AnalyticsQueryMutationError =
 
 /**
  * Query event counts or unique visitors
+ *
+ * @remarks
+ * Count events or unique visitors in a time range. Optionally filter by event name or properties, group by one property, and split results into UTC time buckets. The range includes from and excludes to. Duplicate event IDs are counted once.
  */
 export function useAnalyticsQueryMutation(
   options?: MutationHookOptions<

package/src/sdk/analytics.ts

@@ -24,6 +24,9 @@ export class Analytics extends ClientSDK {
 
   /**
    * Durably accept a batch of events
+   *
+   * @remarks
+   * Send a batch of events using the project's X-Analytics-Key header. A 202 response confirms the batch is stored; events become available to queries after background processing. Retry with the same idempotency_key and unchanged events if you do not receive a response.
    */
   async capture(
     security: operations.AnalyticsCaptureSecurity,
@@ -40,6 +43,9 @@ export class Analytics extends ClientSDK {
 
   /**
    * Query event counts or unique visitors
+   *
+   * @remarks
+   * Count events or unique visitors in a time range. Optionally filter by event name or properties, group by one property, and split results into UTC time buckets. The range includes from and excludes to. Duplicate event IDs are counted once.
    */
   async query(
     request: operations.AnalyticsQueryRequest,

package/src/sdk/keys.ts

@@ -13,6 +13,9 @@ import { unwrapAsync } from "../types/fp.js";
 export class Keys extends ClientSDK {
   /**
    * Create a capture key and return its secret once
+   *
+   * @remarks
+   * Create a key that can send events to this project. Save the key from this response; its secret is only returned once. Capture keys cannot read analytics or manage projects.
    */
   async create(
     request: operations.AnalyticsKeysCreateRequest,

package/src/sdk/projects.ts

@@ -57,6 +57,9 @@ export class Projects extends ClientSDK {
 
   /**
    * Rename an active analytics project
+   *
+   * @remarks
+   * Rename an active project. Project ownership cannot be changed.
    */
   async update(
     request: operations.AnalyticsProjectsUpdateRequest,
@@ -71,6 +74,9 @@ export class Projects extends ClientSDK {
 
   /**
    * Archive an analytics project
+   *
+   * @remarks
+   * Stop new captures and queries for this project. Previously accepted events continue processing. Archiving does not delete stored events.
    */
   async archive(
     request: operations.AnalyticsProjectsArchiveRequest,