@meetkai/mka1 0.54.104 → 0.54.105

package/src/models/operations/cancelagentrun.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type CancelAgentRunRequest = {
+  agentId: string;
+  runId: string;
+  /**
+   * Optional external end-user identifier forwarded by the API gateway.
+   */
+  xOnBehalfOf?: string | undefined;
+};
+
+/** @internal */
+export const CancelAgentRunRequest$inboundSchema: z.ZodType<
+  CancelAgentRunRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  agent_id: z.string(),
+  run_id: z.string(),
+  "X-On-Behalf-Of": z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "agent_id": "agentId",
+    "run_id": "runId",
+    "X-On-Behalf-Of": "xOnBehalfOf",
+  });
+});
+/** @internal */
+export type CancelAgentRunRequest$Outbound = {
+  agent_id: string;
+  run_id: string;
+  "X-On-Behalf-Of"?: string | undefined;
+};
+
+/** @internal */
+export const CancelAgentRunRequest$outboundSchema: z.ZodType<
+  CancelAgentRunRequest$Outbound,
+  z.ZodTypeDef,
+  CancelAgentRunRequest
+> = z.object({
+  agentId: z.string(),
+  runId: z.string(),
+  xOnBehalfOf: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    agentId: "agent_id",
+    runId: "run_id",
+    xOnBehalfOf: "X-On-Behalf-Of",
+  });
+});
+
+export function cancelAgentRunRequestToJSON(
+  cancelAgentRunRequest: CancelAgentRunRequest,
+): string {
+  return JSON.stringify(
+    CancelAgentRunRequest$outboundSchema.parse(cancelAgentRunRequest),
+  );
+}
+export function cancelAgentRunRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<CancelAgentRunRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CancelAgentRunRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CancelAgentRunRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -22,6 +22,7 @@ export * from "./appendagentevaltrials.js";
 export * from "./archivefeatureflag.js";
 export * from "./batchgetcompletionfeedback.js";
 export * from "./batchgetresponsefeedback.js";
+export * from "./cancelagentrun.js";
 export * from "./cancelbatch.js";
 export * from "./cancelevalrun.js";
 export * from "./cancelfinetuningjob.js";

package/src/react-query/agentRunsCancelAgentRun.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentRunsCancelAgentRun } from "../funcs/agentRunsCancelAgentRun.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 AgentRunsCancelAgentRunMutationVariables = {
+  request: operations.CancelAgentRunRequest;
+  options?: RequestOptions;
+};
+
+export type AgentRunsCancelAgentRunMutationData = components.AgentRun;
+
+export type AgentRunsCancelAgentRunMutationError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Cancel a saved-agent run
+ *
+ * @remarks
+ * Cancels a queued run locally before dispatch, or forwards cancellation to its linked gateway response. Locally failed linked runs with an active or missing gateway snapshot are checked upstream before cancellation; genuine terminal work is never relabelled cancelled. Fresh incomplete gateway snapshots are presented as incomplete on subsequent reads while preserving the connector error and completion timestamp, even if cancel returns 409. Repeated cancellation is idempotent. Returns 409 if submission has no linked response yet or a genuine terminal outcome already won. Uses the run's organization, team and delegated-user mutation scope; operator read access does not grant cancellation access. API-key callers also need write:responses for linked cancellation and read:responses to inspect locally failed runs or reconcile a completion race.
+ */
+export function useAgentRunsCancelAgentRunMutation(
+  options?: MutationHookOptions<
+    AgentRunsCancelAgentRunMutationData,
+    AgentRunsCancelAgentRunMutationError,
+    AgentRunsCancelAgentRunMutationVariables
+  >,
+): UseMutationResult<
+  AgentRunsCancelAgentRunMutationData,
+  AgentRunsCancelAgentRunMutationError,
+  AgentRunsCancelAgentRunMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentRunsCancelAgentRunMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentRunsCancelAgentRun(): MutationKey {
+  return ["@meetkai/mka1", "Agent Runs", "cancelAgentRun"];
+}
+
+export function buildAgentRunsCancelAgentRunMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentRunsCancelAgentRunMutationVariables,
+  ) => Promise<AgentRunsCancelAgentRunMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentRunsCancelAgentRun(),
+    mutationFn: function agentRunsCancelAgentRunMutationFn({
+      request,
+      options,
+    }): Promise<AgentRunsCancelAgentRunMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentRunsCancelAgentRun(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -11,6 +11,7 @@ export * from "./agentConnectorsDeleteAgentConnector.js";
 export * from "./agentConnectorsGetAgentConnector.js";
 export * from "./agentConnectorsListAgentConnectors.js";
 export * from "./agentConnectorsSetupWhatsAppAppWebhook.js";
+export * from "./agentRunsCancelAgentRun.js";
 export * from "./agentRunsCreateAgentRun.js";
 export * from "./agentRunsDecideAgentRunMcpApproval.js";
 export * from "./agentRunsGetAgentRun.js";

package/src/sdk/agentruns.ts

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { agentRunsCancelAgentRun } from "../funcs/agentRunsCancelAgentRun.js";
 import { agentRunsCreateAgentRun } from "../funcs/agentRunsCreateAgentRun.js";
 import { agentRunsDecideAgentRunMcpApproval } from "../funcs/agentRunsDecideAgentRunMcpApproval.js";
 import { agentRunsGetAgentRun } from "../funcs/agentRunsGetAgentRun.js";
@@ -62,6 +63,23 @@ export class AgentRuns extends ClientSDK {
     ));
   }
 
+  /**
+   * Cancel a saved-agent run
+   *
+   * @remarks
+   * Cancels a queued run locally before dispatch, or forwards cancellation to its linked gateway response. Locally failed linked runs with an active or missing gateway snapshot are checked upstream before cancellation; genuine terminal work is never relabelled cancelled. Fresh incomplete gateway snapshots are presented as incomplete on subsequent reads while preserving the connector error and completion timestamp, even if cancel returns 409. Repeated cancellation is idempotent. Returns 409 if submission has no linked response yet or a genuine terminal outcome already won. Uses the run's organization, team and delegated-user mutation scope; operator read access does not grant cancellation access. API-key callers also need write:responses for linked cancellation and read:responses to inspect locally failed runs or reconcile a completion race.
+   */
+  async cancelAgentRun(
+    request: operations.CancelAgentRunRequest,
+    options?: RequestOptions,
+  ): Promise<components.AgentRun> {
+    return unwrapAsync(agentRunsCancelAgentRun(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Wake a sleeping agent run
    *