@gleanwork/api-client 0.18.0 → 0.18.1

package/src/react-query/skillsImport.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b58d55335ec3
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GleanCore } from "../core.js";
+import { skillsImport } from "../funcs/skillsImport.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { GleanBaseError } from "../models/errors/gleanbaseerror.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 { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useGleanContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type SkillsImportMutationVariables = {
+  request: components.PlatformSkillImportRequest;
+  options?: RequestOptions;
+};
+
+export type SkillsImportMutationData = components.PlatformSkillImportResponse;
+
+export type SkillsImportMutationError =
+  | errors.PlatformProblemDetailError
+  | GleanBaseError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Import skills from GitHub
+ *
+ * @remarks
+ * Import one or more skills selected from a GitHub source preview. Each source URL is fetched and persisted as an independent skill with source provenance. This operation does not create a durable source resource. The import is atomic: if any source cannot be fetched, validated, or persisted, no skills are created.
+ */
+export function useSkillsImportMutation(
+  options?: MutationHookOptions<
+    SkillsImportMutationData,
+    SkillsImportMutationError,
+    SkillsImportMutationVariables
+  >,
+): UseMutationResult<
+  SkillsImportMutationData,
+  SkillsImportMutationError,
+  SkillsImportMutationVariables
+> {
+  const client = useGleanContext();
+  return useMutation({
+    ...buildSkillsImportMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeySkillsImport(): MutationKey {
+  return ["@gleanwork/api-client", "skills", "import"];
+}
+
+export function buildSkillsImportMutation(
+  client$: GleanCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: SkillsImportMutationVariables,
+  ) => Promise<SkillsImportMutationData>;
+} {
+  return {
+    mutationKey: mutationKeySkillsImport(),
+    mutationFn: function skillsImportMutationFn({
+      request,
+      options,
+    }): Promise<SkillsImportMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(skillsImport(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/skillsPreviewSource.ts

@@ -0,0 +1,120 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d4697aa80a2e
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GleanCore } from "../core.js";
+import {
+  PreviewSourceAcceptEnum,
+  skillsPreviewSource,
+} from "../funcs/skillsPreviewSource.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { GleanBaseError } from "../models/errors/gleanbaseerror.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 { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useGleanContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export { PreviewSourceAcceptEnum } from "../funcs/skillsPreviewSource.js";
+
+export type SkillsPreviewSourceMutationVariables = {
+  request: components.PlatformSkillSourcePreviewRequest;
+  options?: RequestOptions & { acceptHeaderOverride?: PreviewSourceAcceptEnum };
+};
+
+export type SkillsPreviewSourceMutationData =
+  operations.PlatformSkillsPreviewSourceResponse;
+
+export type SkillsPreviewSourceMutationError =
+  | errors.PlatformProblemDetailError
+  | GleanBaseError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Preview a GitHub skill source
+ *
+ * @remarks
+ * Inspect a GitHub URL without persisting a source or any discovered skills. Set stream to true to receive repository scan progress as server-sent events; otherwise the response contains the completed preview.
+ */
+export function useSkillsPreviewSourceMutation(
+  options?: MutationHookOptions<
+    SkillsPreviewSourceMutationData,
+    SkillsPreviewSourceMutationError,
+    SkillsPreviewSourceMutationVariables
+  >,
+): UseMutationResult<
+  SkillsPreviewSourceMutationData,
+  SkillsPreviewSourceMutationError,
+  SkillsPreviewSourceMutationVariables
+> {
+  const client = useGleanContext();
+  return useMutation({
+    ...buildSkillsPreviewSourceMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeySkillsPreviewSource(): MutationKey {
+  return ["@gleanwork/api-client", "skills", "previewSource"];
+}
+
+export function buildSkillsPreviewSourceMutation(
+  client$: GleanCore,
+  hookOptions?: RequestOptions & {
+    acceptHeaderOverride?: PreviewSourceAcceptEnum;
+  },
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: SkillsPreviewSourceMutationVariables,
+  ) => Promise<SkillsPreviewSourceMutationData>;
+} {
+  return {
+    mutationKey: mutationKeySkillsPreviewSource(),
+    mutationFn: function skillsPreviewSourceMutationFn({
+      request,
+      options,
+    }): Promise<SkillsPreviewSourceMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(skillsPreviewSource(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/skillsSync.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c5d5816caa2b
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GleanCore } from "../core.js";
+import { skillsSync } from "../funcs/skillsSync.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { GleanBaseError } from "../models/errors/gleanbaseerror.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 { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useGleanContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type SkillsSyncMutationVariables = {
+  skillId: string;
+  options?: RequestOptions;
+};
+
+export type SkillsSyncMutationData = components.PlatformSkillSyncResponse;
+
+export type SkillsSyncMutationError =
+  | errors.PlatformProblemDetailError
+  | GleanBaseError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Sync a GitHub-imported skill
+ *
+ * @remarks
+ * Refresh one GitHub-imported skill from its stored source URL. If the skill content has changed, this operation creates a new skill version. If the skill is no longer present upstream, the stored skill is left unchanged and must be deleted explicitly.
+ */
+export function useSkillsSyncMutation(
+  options?: MutationHookOptions<
+    SkillsSyncMutationData,
+    SkillsSyncMutationError,
+    SkillsSyncMutationVariables
+  >,
+): UseMutationResult<
+  SkillsSyncMutationData,
+  SkillsSyncMutationError,
+  SkillsSyncMutationVariables
+> {
+  const client = useGleanContext();
+  return useMutation({
+    ...buildSkillsSyncMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeySkillsSync(): MutationKey {
+  return ["@gleanwork/api-client", "skills", "sync"];
+}
+
+export function buildSkillsSyncMutation(
+  client$: GleanCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: SkillsSyncMutationVariables,
+  ) => Promise<SkillsSyncMutationData>;
+} {
+  return {
+    mutationKey: mutationKeySkillsSync(),
+    mutationFn: function skillsSyncMutationFn({
+      skillId,
+      options,
+    }): Promise<SkillsSyncMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(skillsSync(
+        client$,
+        skillId,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/skillsUpdate.ts

@@ -0,0 +1,114 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e62e124a1043
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GleanCore } from "../core.js";
+import { skillsUpdate } from "../funcs/skillsUpdate.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { GleanBaseError } from "../models/errors/gleanbaseerror.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 { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useGleanContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type SkillsUpdateMutationVariables = {
+  platformSkillUpdateRequest: components.PlatformSkillUpdateRequest;
+  skillId: string;
+  options?: RequestOptions;
+};
+
+export type SkillsUpdateMutationData = components.PlatformSkillUpdateResponse;
+
+export type SkillsUpdateMutationError =
+  | errors.PlatformProblemDetailError
+  | GleanBaseError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Update skill
+ *
+ * @remarks
+ * Update mutable metadata for a skill. V1 supports enabling or disabling a skill without changing its content.
+ */
+export function useSkillsUpdateMutation(
+  options?: MutationHookOptions<
+    SkillsUpdateMutationData,
+    SkillsUpdateMutationError,
+    SkillsUpdateMutationVariables
+  >,
+): UseMutationResult<
+  SkillsUpdateMutationData,
+  SkillsUpdateMutationError,
+  SkillsUpdateMutationVariables
+> {
+  const client = useGleanContext();
+  return useMutation({
+    ...buildSkillsUpdateMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeySkillsUpdate(): MutationKey {
+  return ["@gleanwork/api-client", "skills", "update"];
+}
+
+export function buildSkillsUpdateMutation(
+  client$: GleanCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: SkillsUpdateMutationVariables,
+  ) => Promise<SkillsUpdateMutationData>;
+} {
+  return {
+    mutationKey: mutationKeySkillsUpdate(),
+    mutationFn: function skillsUpdateMutationFn({
+      platformSkillUpdateRequest,
+      skillId,
+      options,
+    }): Promise<SkillsUpdateMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(skillsUpdate(
+        client$,
+        platformSkillUpdateRequest,
+        skillId,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/sdk/chat.ts

@@ -3,241 +3,28 @@
  * @generated-id: c56babc22a20
  */
 
-import { clientChatCreate } from "../funcs/clientChatCreate.js";
-import { clientChatCreateStream } from "../funcs/clientChatCreateStream.js";
-import { clientChatDelete } from "../funcs/clientChatDelete.js";
-import { clientChatDeleteAll } from "../funcs/clientChatDeleteAll.js";
-import { clientChatDeleteFiles } from "../funcs/clientChatDeleteFiles.js";
-import { clientChatList } from "../funcs/clientChatList.js";
-import { clientChatRetrieve } from "../funcs/clientChatRetrieve.js";
-import { clientChatRetrieveApplication } from "../funcs/clientChatRetrieveApplication.js";
-import { clientChatRetrieveFile } from "../funcs/clientChatRetrieveFile.js";
-import { clientChatRetrieveFiles } from "../funcs/clientChatRetrieveFiles.js";
-import { clientChatUploadFiles } from "../funcs/clientChatUploadFiles.js";
+import { chatCreate, CreateAcceptEnum } from "../funcs/chatCreate.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 { CreateAcceptEnum } from "../funcs/chatCreate.js";
+
 export class Chat extends ClientSDK {
   /**
-   * Chat
+   * Create a chat response
    *
    * @remarks
-   * Have a conversation with Glean AI.
+   * Run an assistant turn. Set `stream` to true to receive server-sent events; otherwise the response is a typed JSON response object.
    */
   async create(
-    chatRequest: components.ChatRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<components.ChatResponse> {
-    return unwrapAsync(clientChatCreate(
-      this,
-      chatRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Deletes all saved Chats owned by a user
-   *
-   * @remarks
-   * Deletes all saved Chats a user has had and all their contained conversational content.
-   */
-  async deleteAll(
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(clientChatDeleteAll(
-      this,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Deletes saved Chats
-   *
-   * @remarks
-   * Deletes saved Chats and all their contained conversational content.
-   */
-  async delete(
-    deleteChatsRequest: components.DeleteChatsRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(clientChatDelete(
-      this,
-      deleteChatsRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Retrieves a Chat
-   *
-   * @remarks
-   * Retrieves the chat history between Glean Assistant and the user for a given Chat.
-   */
-  async retrieve(
-    getChatRequest: components.GetChatRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<components.GetChatResponse> {
-    return unwrapAsync(clientChatRetrieve(
-      this,
-      getChatRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Retrieves all saved Chats
-   *
-   * @remarks
-   * Retrieves all the saved Chats between Glean Assistant and the user. The returned Chats contain only metadata and no conversational content.
-   */
-  async list(
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<components.ListChatsResponse> {
-    return unwrapAsync(clientChatList(
-      this,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Gets the metadata for a custom Chat application
-   *
-   * @remarks
-   * Gets the Chat application details for the specified application ID.
-   */
-  async retrieveApplication(
-    getChatApplicationRequest: components.GetChatApplicationRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<components.GetChatApplicationResponse> {
-    return unwrapAsync(clientChatRetrieveApplication(
-      this,
-      getChatApplicationRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Upload files for Chat
-   *
-   * @remarks
-   * Upload files for Chat.
-   */
-  async uploadFiles(
-    uploadChatFilesRequest: components.UploadChatFilesRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<components.UploadChatFilesResponse> {
-    return unwrapAsync(clientChatUploadFiles(
-      this,
-      uploadChatFilesRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Get files uploaded by a user for Chat
-   *
-   * @remarks
-   * Get files uploaded by a user for Chat.
-   */
-  async retrieveFiles(
-    getChatFilesRequest: components.GetChatFilesRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<components.GetChatFilesResponse> {
-    return unwrapAsync(clientChatRetrieveFiles(
-      this,
-      getChatFilesRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Delete files uploaded by a user for chat
-   *
-   * @remarks
-   * Delete files uploaded by a user for Chat.
-   */
-  async deleteFiles(
-    deleteChatFilesRequest: components.DeleteChatFilesRequest,
-    locale?: string | undefined,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(clientChatDeleteFiles(
-      this,
-      deleteChatFilesRequest,
-      locale,
-      timezoneOffset,
-      options,
-    ));
-  }
-
-  /**
-   * Download a chat file
-   *
-   * @remarks
-   * Download the raw content of a file generated or uploaded during a chat session (for example, an image produced by the assistant). Returns the file bytes with a Content-Type header matching the file's MIME type.
-   */
-  async retrieveFile(
-    fileId: string,
-    preview?: boolean | undefined,
-    options?: RequestOptions,
-  ): Promise<ReadableStream<Uint8Array>> {
-    return unwrapAsync(clientChatRetrieveFile(
-      this,
-      fileId,
-      preview,
-      options,
-    ));
-  }
-
-  /**
-   * Chat
-   *
-   * @remarks
-   * Have a conversation with Glean AI.
-   */
-  async createStream(
-    chatRequest: components.ChatRequest,
-    timezoneOffset?: number | undefined,
-    options?: RequestOptions,
-  ): Promise<string> {
-    return unwrapAsync(clientChatCreateStream(
+    request: components.PlatformChatCreateRequest,
+    options?: RequestOptions & { acceptHeaderOverride?: CreateAcceptEnum },
+  ): Promise<operations.PlatformChatCreateResponse> {
+    return unwrapAsync(chatCreate(
       this,
-      chatRequest,
-      timezoneOffset,
+      request,
       options,
     ));
   }