@meetkai/mka1 0.54.93 → 0.54.95

package/src/react-query/agentsListFunctionTools.ts

@@ -0,0 +1,144 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.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 { useSDKContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  AgentsListFunctionToolsQueryData,
+  buildAgentsListFunctionToolsQuery,
+  prefetchAgentsListFunctionTools,
+  queryKeyAgentsListFunctionTools,
+} from "./agentsListFunctionTools.core.js";
+export {
+  type AgentsListFunctionToolsQueryData,
+  buildAgentsListFunctionToolsQuery,
+  prefetchAgentsListFunctionTools,
+  queryKeyAgentsListFunctionTools,
+};
+
+export type AgentsListFunctionToolsQueryError =
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List reusable function tools
+ */
+export function useAgentsListFunctionTools(
+  request: operations.ListFunctionToolsRequest,
+  options?: QueryHookOptions<
+    AgentsListFunctionToolsQueryData,
+    AgentsListFunctionToolsQueryError
+  >,
+): UseQueryResult<
+  AgentsListFunctionToolsQueryData,
+  AgentsListFunctionToolsQueryError
+> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildAgentsListFunctionToolsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List reusable function tools
+ */
+export function useAgentsListFunctionToolsSuspense(
+  request: operations.ListFunctionToolsRequest,
+  options?: SuspenseQueryHookOptions<
+    AgentsListFunctionToolsQueryData,
+    AgentsListFunctionToolsQueryError
+  >,
+): UseSuspenseQueryResult<
+  AgentsListFunctionToolsQueryData,
+  AgentsListFunctionToolsQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildAgentsListFunctionToolsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setAgentsListFunctionToolsData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      after?: string | undefined;
+      limit?: number | undefined;
+      order?: operations.ListFunctionToolsQueryParamOrder | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: AgentsListFunctionToolsQueryData,
+): AgentsListFunctionToolsQueryData | undefined {
+  const key = queryKeyAgentsListFunctionTools(...queryKeyBase);
+
+  return client.setQueryData<AgentsListFunctionToolsQueryData>(key, data);
+}
+
+export function invalidateAgentsListFunctionTools(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      after?: string | undefined;
+      limit?: number | undefined;
+      order?: operations.ListFunctionToolsQueryParamOrder | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "Agents", "listFunctionTools", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllAgentsListFunctionTools(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "Agents", "listFunctionTools"],
+  });
+}

package/src/react-query/agentsRestoreAgent.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 { agentsRestoreAgent } from "../funcs/agentsRestoreAgent.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 AgentsRestoreAgentMutationVariables = {
+  request: operations.RestoreAgentRequest;
+  options?: RequestOptions;
+};
+
+export type AgentsRestoreAgentMutationData = components.Agent;
+
+export type AgentsRestoreAgentMutationError =
+  | errors.ErrorEnvelope
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Restore a soft-deleted agent
+ *
+ * @remarks
+ * Restores the original configuration and history before retention_expires_at. Requires write:agents in the original mutation tenancy. Schedules remain paused.
+ */
+export function useAgentsRestoreAgentMutation(
+  options?: MutationHookOptions<
+    AgentsRestoreAgentMutationData,
+    AgentsRestoreAgentMutationError,
+    AgentsRestoreAgentMutationVariables
+  >,
+): UseMutationResult<
+  AgentsRestoreAgentMutationData,
+  AgentsRestoreAgentMutationError,
+  AgentsRestoreAgentMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentsRestoreAgentMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentsRestoreAgent(): MutationKey {
+  return ["@meetkai/mka1", "Agents", "restoreAgent"];
+}
+
+export function buildAgentsRestoreAgentMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentsRestoreAgentMutationVariables,
+  ) => Promise<AgentsRestoreAgentMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentsRestoreAgent(),
+    mutationFn: function agentsRestoreAgentMutationFn({
+      request,
+      options,
+    }): Promise<AgentsRestoreAgentMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentsRestoreAgent(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/agentsUpdateFunctionTool.ts

@@ -0,0 +1,109 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { agentsUpdateFunctionTool } from "../funcs/agentsUpdateFunctionTool.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 { 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 AgentsUpdateFunctionToolMutationVariables = {
+  request: operations.UpdateFunctionToolRequest;
+  options?: RequestOptions;
+};
+
+export type AgentsUpdateFunctionToolMutationData = components.FunctionTool;
+
+export type AgentsUpdateFunctionToolMutationError =
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Replace a reusable function definition
+ *
+ * @remarks
+ * Updates apply to every attached agent on its next run. Existing run snapshots are immutable.
+ */
+export function useAgentsUpdateFunctionToolMutation(
+  options?: MutationHookOptions<
+    AgentsUpdateFunctionToolMutationData,
+    AgentsUpdateFunctionToolMutationError,
+    AgentsUpdateFunctionToolMutationVariables
+  >,
+): UseMutationResult<
+  AgentsUpdateFunctionToolMutationData,
+  AgentsUpdateFunctionToolMutationError,
+  AgentsUpdateFunctionToolMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildAgentsUpdateFunctionToolMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyAgentsUpdateFunctionTool(): MutationKey {
+  return ["@meetkai/mka1", "Agents", "updateFunctionTool"];
+}
+
+export function buildAgentsUpdateFunctionToolMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: AgentsUpdateFunctionToolMutationVariables,
+  ) => Promise<AgentsUpdateFunctionToolMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyAgentsUpdateFunctionTool(),
+    mutationFn: function agentsUpdateFunctionToolMutationFn({
+      request,
+      options,
+    }): Promise<AgentsUpdateFunctionToolMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(agentsUpdateFunctionTool(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/index.ts

@@ -25,10 +25,16 @@ export * from "./agentSchedulesPauseAgentSchedule.js";
 export * from "./agentSchedulesResumeAgentSchedule.js";
 export * from "./agentSchedulesUpdateAgentSchedule.js";
 export * from "./agentsCreateAgent.js";
+export * from "./agentsCreateFunctionTool.js";
 export * from "./agentsDeleteAgent.js";
+export * from "./agentsDeleteFunctionTool.js";
 export * from "./agentsGetAgent.js";
+export * from "./agentsGetFunctionTool.js";
 export * from "./agentsListAgents.js";
+export * from "./agentsListFunctionTools.js";
+export * from "./agentsRestoreAgent.js";
 export * from "./agentsUpdateAgent.js";
+export * from "./agentsUpdateFunctionTool.js";
 export * from "./agentVersionsGetAgentVersion.js";
 export * from "./agentVersionsListAgentVersions.js";
 export * from "./agentVersionsRollbackAgentVersion.js";

package/src/sdk/agents.ts

@@ -3,16 +3,98 @@
  */
 
 import { agentsCreateAgent } from "../funcs/agentsCreateAgent.js";
+import { agentsCreateFunctionTool } from "../funcs/agentsCreateFunctionTool.js";
 import { agentsDeleteAgent } from "../funcs/agentsDeleteAgent.js";
+import { agentsDeleteFunctionTool } from "../funcs/agentsDeleteFunctionTool.js";
 import { agentsGetAgent } from "../funcs/agentsGetAgent.js";
+import { agentsGetFunctionTool } from "../funcs/agentsGetFunctionTool.js";
 import { agentsListAgents } from "../funcs/agentsListAgents.js";
+import { agentsListFunctionTools } from "../funcs/agentsListFunctionTools.js";
+import { agentsRestoreAgent } from "../funcs/agentsRestoreAgent.js";
 import { agentsUpdateAgent } from "../funcs/agentsUpdateAgent.js";
+import { agentsUpdateFunctionTool } from "../funcs/agentsUpdateFunctionTool.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 Agents extends ClientSDK {
+  /**
+   * List reusable function tools
+   */
+  async listFunctionTools(
+    request: operations.ListFunctionToolsRequest,
+    options?: RequestOptions,
+  ): Promise<components.FunctionToolList> {
+    return unwrapAsync(agentsListFunctionTools(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create a reusable function tool
+   */
+  async createFunctionTool(
+    request: operations.CreateFunctionToolRequest,
+    options?: RequestOptions,
+  ): Promise<components.FunctionTool> {
+    return unwrapAsync(agentsCreateFunctionTool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a reusable function tool
+   */
+  async getFunctionTool(
+    request: operations.GetFunctionToolRequest,
+    options?: RequestOptions,
+  ): Promise<components.FunctionTool> {
+    return unwrapAsync(agentsGetFunctionTool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Replace a reusable function definition
+   *
+   * @remarks
+   * Updates apply to every attached agent on its next run. Existing run snapshots are immutable.
+   */
+  async updateFunctionTool(
+    request: operations.UpdateFunctionToolRequest,
+    options?: RequestOptions,
+  ): Promise<components.FunctionTool> {
+    return unwrapAsync(agentsUpdateFunctionTool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a reusable function tool
+   *
+   * @remarks
+   * Attached agents fail until the unavailable reference is removed. Existing run snapshots remain usable.
+   */
+  async deleteFunctionTool(
+    request: operations.DeleteFunctionToolRequest,
+    options?: RequestOptions,
+  ): Promise<operations.DeleteFunctionToolResponseBody> {
+    return unwrapAsync(agentsDeleteFunctionTool(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * List agents
    */
@@ -70,7 +152,10 @@ export class Agents extends ClientSDK {
   }
 
   /**
-   * Delete an agent
+   * Soft-delete an agent
+   *
+   * @remarks
+   * Preserves configuration versions and run history for audit. The restore deadline is pinned using AGENT_RETENTION_DAYS at deletion.
    */
   async deleteAgent(
     request: operations.DeleteAgentRequest,
@@ -82,4 +167,21 @@ export class Agents extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Restore a soft-deleted agent
+   *
+   * @remarks
+   * Restores the original configuration and history before retention_expires_at. Requires write:agents in the original mutation tenancy. Schedules remain paused.
+   */
+  async restoreAgent(
+    request: operations.RestoreAgentRequest,
+    options?: RequestOptions,
+  ): Promise<components.Agent> {
+    return unwrapAsync(agentsRestoreAgent(
+      this,
+      request,
+      options,
+    ));
+  }
 }