@gleanwork/api-client 0.16.1 → 0.17.1

package/src/sdk/chat.ts

@@ -3,27 +3,242 @@
  * @generated-id: c56babc22a20
  */
 
-import { chatGetChatFile } from "../funcs/chatGetChatFile.js";
+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 { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Chat extends ClientSDK {
+  /**
+   * Chat
+   *
+   * @remarks
+   * Have a conversation with Glean AI.
+   */
+  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 getChatFile(
+  async retrieveFile(
     fileId: string,
     preview?: boolean | undefined,
     options?: RequestOptions,
   ): Promise<ReadableStream<Uint8Array>> {
-    return unwrapAsync(chatGetChatFile(
+    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(
+      this,
+      chatRequest,
+      timezoneOffset,
+      options,
+    ));
+  }
 }

package/src/sdk/client.ts

@@ -7,19 +7,20 @@ import { ClientSDK } from "../lib/sdks.js";
 import { Activity } from "./activity.js";
 import { Announcements } from "./announcements.js";
 import { Answers } from "./answers.js";
+import { Chat } from "./chat.js";
 import { ClientAgents } from "./clientagents.js";
 import { ClientAuthentication } from "./clientauthentication.js";
-import { ClientChat } from "./clientchat.js";
+import { ClientDatasources } from "./clientdatasources.js";
 import { ClientDocuments } from "./clientdocuments.js";
-import { ClientEntities } from "./cliententities.js";
-import { ClientGovernance } from "./clientgovernance.js";
+import { ClientSearch } from "./clientsearch.js";
 import { ClientShortcuts } from "./clientshortcuts.js";
-import { ClientTools } from "./clienttools.js";
 import { Collections } from "./collections.js";
+import { Entities } from "./entities.js";
+import { Governance } from "./governance.js";
 import { Insights } from "./insights.js";
 import { Messages } from "./messages.js";
 import { Pins } from "./pins.js";
-import { Search } from "./search.js";
+import { Tools } from "./tools.js";
 import { Verification } from "./verification.js";
 
 export class Client extends ClientSDK {
@@ -43,9 +44,9 @@ export class Client extends ClientSDK {
     return (this._authentication ??= new ClientAuthentication(this._options));
   }
 
-  private _chat?: ClientChat;
-  get chat(): ClientChat {
-    return (this._chat ??= new ClientChat(this._options));
+  private _chat?: Chat;
+  get chat(): Chat {
+    return (this._chat ??= new Chat(this._options));
   }
 
   private _agents?: ClientAgents;
@@ -78,14 +79,14 @@ export class Client extends ClientSDK {
     return (this._pins ??= new Pins(this._options));
   }
 
-  private _search?: Search;
-  get search(): Search {
-    return (this._search ??= new Search(this._options));
+  private _search?: ClientSearch;
+  get search(): ClientSearch {
+    return (this._search ??= new ClientSearch(this._options));
   }
 
-  private _entities?: ClientEntities;
-  get entities(): ClientEntities {
-    return (this._entities ??= new ClientEntities(this._options));
+  private _entities?: Entities;
+  get entities(): Entities {
+    return (this._entities ??= new Entities(this._options));
   }
 
   private _shortcuts?: ClientShortcuts;
@@ -98,13 +99,18 @@ export class Client extends ClientSDK {
     return (this._verification ??= new Verification(this._options));
   }
 
-  private _tools?: ClientTools;
-  get tools(): ClientTools {
-    return (this._tools ??= new ClientTools(this._options));
+  private _tools?: Tools;
+  get tools(): Tools {
+    return (this._tools ??= new Tools(this._options));
   }
 
-  private _governance?: ClientGovernance;
-  get governance(): ClientGovernance {
-    return (this._governance ??= new ClientGovernance(this._options));
+  private _governance?: Governance;
+  get governance(): Governance {
+    return (this._governance ??= new Governance(this._options));
+  }
+
+  private _datasources?: ClientDatasources;
+  get datasources(): ClientDatasources {
+    return (this._datasources ??= new ClientDatasources(this._options));
   }
 }

package/src/sdk/clientagents.ts

@@ -3,16 +3,39 @@
  * @generated-id: 7864a10ac52c
  */
 
+import { clientAgentsCreate } from "../funcs/clientAgentsCreate.js";
 import { clientAgentsList } from "../funcs/clientAgentsList.js";
 import { clientAgentsRetrieve } from "../funcs/clientAgentsRetrieve.js";
 import { clientAgentsRetrieveSchemas } from "../funcs/clientAgentsRetrieveSchemas.js";
 import { clientAgentsRun } from "../funcs/clientAgentsRun.js";
 import { clientAgentsRunStream } from "../funcs/clientAgentsRunStream.js";
+import { clientAgentsUpdate } from "../funcs/clientAgentsUpdate.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class ClientAgents extends ClientSDK {
+  /**
+   * Create an agent
+   *
+   * @remarks
+   * Create an agent.
+   */
+  async create(
+    createWorkflowRequest: components.CreateWorkflowRequest,
+    locale?: string | undefined,
+    timezoneOffset?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<components.WorkflowResult> {
+    return unwrapAsync(clientAgentsCreate(
+      this,
+      createWorkflowRequest,
+      locale,
+      timezoneOffset,
+      options,
+    ));
+  }
+
   /**
    * Retrieve an agent
    *
@@ -34,6 +57,29 @@ export class ClientAgents extends ClientSDK {
     ));
   }
 
+  /**
+   * Edit an agent
+   *
+   * @remarks
+   * Creates a draft or publishes an [agent](https://developers.glean.com/agents/agents-api). Use `isDraft=true` to save a draft, or `isDraft=false` (or omit) to publish immediately. Only draft and publish modes are supported.
+   */
+  async update(
+    editWorkflowRequest: components.EditWorkflowRequest,
+    agentId: string,
+    locale?: string | undefined,
+    timezoneOffset?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(clientAgentsUpdate(
+      this,
+      editWorkflowRequest,
+      agentId,
+      locale,
+      timezoneOffset,
+      options,
+    ));
+  }
+
   /**
    * List an agent's schemas
    *

package/src/sdk/clientauthentication.ts

@@ -3,12 +3,34 @@
  * @generated-id: dd653d48dc6a
  */
 
+import { clientAuthenticationCheckDatasourceAuth } from "../funcs/clientAuthenticationCheckDatasourceAuth.js";
 import { clientAuthenticationCreateToken } from "../funcs/clientAuthenticationCreateToken.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class ClientAuthentication extends ClientSDK {
+  /**
+   * Check datasource authorization
+   *
+   * @remarks
+   * Returns all datasource instances that require per-user OAuth authorization
+   * for the authenticated user, along with a transient auth token that can be
+   * appended to auth URLs to complete OAuth flows.
+   *
+   * Clients construct the full OAuth URL by combining the backend base URL,
+   * the `authUrlRelativePath` from each instance, and the transient auth token:
+   * `<backend>/<authUrlRelativePath>?transient_auth_token=<token>`.
+   */
+  async checkDatasourceAuth(
+    options?: RequestOptions,
+  ): Promise<components.CheckDatasourceAuthResponse> {
+    return unwrapAsync(clientAuthenticationCheckDatasourceAuth(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Create authentication token
    *

package/src/sdk/clientdatasources.ts

@@ -0,0 +1,93 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 18ba361f511a
+ */
+
+import { clientDatasourcesRetrieveConfiguration } from "../funcs/clientDatasourcesRetrieveConfiguration.js";
+import { clientDatasourcesRetrieveCredentialStatus } from "../funcs/clientDatasourcesRetrieveCredentialStatus.js";
+import { clientDatasourcesRotateCredentials } from "../funcs/clientDatasourcesRotateCredentials.js";
+import { clientDatasourcesUpdateConfiguration } from "../funcs/clientDatasourcesUpdateConfiguration.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class ClientDatasources extends ClientSDK {
+  /**
+   * Get datasource instance configuration
+   *
+   * @remarks
+   * Gets the greenlisted configuration values for a datasource instance. Returns only configuration keys that are exposed via the public API greenlist.
+   */
+  async retrieveConfiguration(
+    datasourceId: string,
+    instanceId: string,
+    options?: RequestOptions,
+  ): Promise<components.DatasourceConfigurationResponse> {
+    return unwrapAsync(clientDatasourcesRetrieveConfiguration(
+      this,
+      datasourceId,
+      instanceId,
+      options,
+    ));
+  }
+
+  /**
+   * Update datasource instance configuration
+   *
+   * @remarks
+   * Updates the greenlisted configuration values for a datasource instance. Only configuration keys that are exposed via the public API greenlist may be set. Returns the full greenlisted configuration after the update is applied.
+   */
+  async updateConfiguration(
+    updateDatasourceConfigurationRequest:
+      components.UpdateDatasourceConfigurationRequest,
+    datasourceId: string,
+    instanceId: string,
+    options?: RequestOptions,
+  ): Promise<components.DatasourceConfigurationResponse> {
+    return unwrapAsync(clientDatasourcesUpdateConfiguration(
+      this,
+      updateDatasourceConfigurationRequest,
+      datasourceId,
+      instanceId,
+      options,
+    ));
+  }
+
+  /**
+   * Get datasource instance credential status
+   *
+   * @remarks
+   * Returns the current credential status for a datasource instance. Access is limited to callers with the ADMIN scope; the handler enforces this check.
+   */
+  async retrieveCredentialStatus(
+    datasourceInstanceId: string,
+    options?: RequestOptions,
+  ): Promise<components.DatasourceCredentialStatusResponse> {
+    return unwrapAsync(clientDatasourcesRetrieveCredentialStatus(
+      this,
+      datasourceInstanceId,
+      options,
+    ));
+  }
+
+  /**
+   * Rotate datasource instance credentials
+   *
+   * @remarks
+   * Rotates the credentials that a datasource instance uses to connect to its upstream system. Replaces the active credential material with the supplied values and returns the credential status after rotation. Access is limited to callers with the ADMIN scope; the handler enforces this check.
+   * Only keys recognized as credential material for the datasource type may be set in `credentials.values` (e.g. `clientSecret`, `apiToken`, `privateKey`, depending on the configured auth method). Unrecognized keys, or keys that correspond to non-credential configuration, cause a 400; other instance configuration must be updated via PATCH /configure/datasources/{datasourceId}/instances/{instanceId}.
+   */
+  async rotateCredentials(
+    rotateDatasourceCredentialsRequest:
+      components.RotateDatasourceCredentialsRequest,
+    datasourceInstanceId: string,
+    options?: RequestOptions,
+  ): Promise<components.DatasourceCredentialStatusResponse> {
+    return unwrapAsync(clientDatasourcesRotateCredentials(
+      this,
+      rotateDatasourceCredentialsRequest,
+      datasourceInstanceId,
+      options,
+    ));
+  }
+}

package/src/sdk/clientsearch.ts

@@ -0,0 +1,110 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9d303135a965
+ */
+
+import { clientSearchAutocomplete } from "../funcs/clientSearchAutocomplete.js";
+import { clientSearchQuery } from "../funcs/clientSearchQuery.js";
+import { clientSearchQueryAsAdmin } from "../funcs/clientSearchQueryAsAdmin.js";
+import { clientSearchRecommendations } from "../funcs/clientSearchRecommendations.js";
+import { clientSearchRetrieveFeed } from "../funcs/clientSearchRetrieveFeed.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class ClientSearch extends ClientSDK {
+  /**
+   * Search the index (admin)
+   *
+   * @remarks
+   * Retrieves results for search query without respect for permissions. This is available only to privileged users.
+   */
+  async queryAsAdmin(
+    searchRequest: components.SearchRequest,
+    locale?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.SearchResponse> {
+    return unwrapAsync(clientSearchQueryAsAdmin(
+      this,
+      searchRequest,
+      locale,
+      options,
+    ));
+  }
+
+  /**
+   * Autocomplete
+   *
+   * @remarks
+   * Retrieve query suggestions, operators and documents for the given partially typed query.
+   */
+  async autocomplete(
+    autocompleteRequest: components.AutocompleteRequest,
+    locale?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.AutocompleteResponse> {
+    return unwrapAsync(clientSearchAutocomplete(
+      this,
+      autocompleteRequest,
+      locale,
+      options,
+    ));
+  }
+
+  /**
+   * Feed of documents and events
+   *
+   * @remarks
+   * The personalized feed/home includes different types of contents including suggestions, recents, calendar events and many more.
+   */
+  async retrieveFeed(
+    feedRequest: components.FeedRequest,
+    locale?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.FeedResponse> {
+    return unwrapAsync(clientSearchRetrieveFeed(
+      this,
+      feedRequest,
+      locale,
+      options,
+    ));
+  }
+
+  /**
+   * Recommend documents
+   *
+   * @remarks
+   * Retrieve recommended documents for the given URL or Glean Document ID.
+   */
+  async recommendations(
+    recommendationsRequest: components.RecommendationsRequest,
+    locale?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.ResultsResponse | undefined> {
+    return unwrapAsync(clientSearchRecommendations(
+      this,
+      recommendationsRequest,
+      locale,
+      options,
+    ));
+  }
+
+  /**
+   * Search
+   *
+   * @remarks
+   * Retrieve results from the index for the given query and filters.
+   */
+  async query(
+    searchRequest: components.SearchRequest,
+    locale?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.SearchResponse> {
+    return unwrapAsync(clientSearchQuery(
+      this,
+      searchRequest,
+      locale,
+      options,
+    ));
+  }
+}

package/src/sdk/data.ts

@@ -4,6 +4,7 @@
  */
 
 import { ClientSDK } from "../lib/sdks.js";
+import { Findings } from "./findings.js";
 import { Policies } from "./policies.js";
 import { Reports } from "./reports.js";
 
@@ -17,4 +18,9 @@ export class Data extends ClientSDK {
   get reports(): Reports {
     return (this._reports ??= new Reports(this._options));
   }
+
+  private _findings?: Findings;
+  get findings(): Findings {
+    return (this._findings ??= new Findings(this._options));
+  }
 }