@gleanwork/api-client 0.14.18 → 0.15.0

package/src/sdk/entities.ts

@@ -3,47 +3,34 @@
  * @generated-id: 71997b5f9b62
  */
 
-import { clientEntitiesList } from "../funcs/clientEntitiesList.js";
-import { clientEntitiesReadPeople } from "../funcs/clientEntitiesReadPeople.js";
+import {
+  entitiesGetPersonPhoto,
+  GetPersonPhotoAcceptEnum,
+} from "../funcs/entitiesGetPersonPhoto.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 Entities extends ClientSDK {
-  /**
-   * List entities
-   *
-   * @remarks
-   * List some set of details for all entities that fit the given criteria and return in the requested order. Does not support negation in filters, assumes relation type EQUALS. There is a limit of 10000 entities that can be retrieved via this endpoint, except when using FULL_DIRECTORY request type for people entities.
-   */
-  async list(
-    listEntitiesRequest: components.ListEntitiesRequest,
-    locale?: string | undefined,
-    options?: RequestOptions,
-  ): Promise<components.ListEntitiesResponse> {
-    return unwrapAsync(clientEntitiesList(
-      this,
-      listEntitiesRequest,
-      locale,
-      options,
-    ));
-  }
+export { GetPersonPhotoAcceptEnum } from "../funcs/entitiesGetPersonPhoto.js";
 
+export class Entities extends ClientSDK {
   /**
-   * Read people
+   * Get person photo
    *
    * @remarks
-   * Read people details for the given IDs.
+   * Returns the profile photo bytes for a person whose photo is stored in Glean (crawled from an identity source or user-uploaded via admin console). Photos hosted externally (e.g. Slack CDN) are not served by this endpoint; callers should follow the photoUrl from /people or /listentities directly. Responses include a Cache-Control header (max-age=3600) to reduce redundant fetches.
    */
-  async readPeople(
-    peopleRequest: components.PeopleRequest,
-    locale?: string | undefined,
-    options?: RequestOptions,
-  ): Promise<components.PeopleResponse> {
-    return unwrapAsync(clientEntitiesReadPeople(
+  async getPersonPhoto(
+    personId: string,
+    ds?: string | undefined,
+    options?: RequestOptions & {
+      acceptHeaderOverride?: GetPersonPhotoAcceptEnum;
+    },
+  ): Promise<operations.GetPersonPhotoResponse> {
+    return unwrapAsync(entitiesGetPersonPhoto(
       this,
-      peopleRequest,
-      locale,
+      personId,
+      ds,
       options,
     ));
   }

package/src/sdk/indexing.ts

@@ -4,6 +4,7 @@
  */
 
 import { ClientSDK } from "../lib/sdks.js";
+import { CustomMetadata } from "./custommetadata.js";
 import { Datasource } from "./datasource.js";
 import { IndexingAuthentication } from "./indexingauthentication.js";
 import { IndexingDatasources } from "./indexingdatasources.js";
@@ -47,4 +48,9 @@ export class Indexing extends ClientSDK {
   get shortcuts(): IndexingShortcuts {
     return (this._shortcuts ??= new IndexingShortcuts(this._options));
   }
+
+  private _customMetadata?: CustomMetadata;
+  get customMetadata(): CustomMetadata {
+    return (this._customMetadata ??= new CustomMetadata(this._options));
+  }
 }

package/src/sdk/sdk.ts

@@ -4,11 +4,16 @@
  */
 
 import { ClientSDK } from "../lib/sdks.js";
+import { Agents } from "./agents.js";
 import { Authentication } from "./authentication.js";
+import { Chat } from "./chat.js";
 import { Client } from "./client.js";
 import { Datasources } from "./datasources.js";
+import { Entities } from "./entities.js";
 import { Governance } from "./governance.js";
 import { Indexing } from "./indexing.js";
+import { Tools } from "./tools.js";
+import { Troubleshooting } from "./troubleshooting.js";
 
 export class Glean extends ClientSDK {
   private _client?: Client;
@@ -21,11 +26,36 @@ export class Glean extends ClientSDK {
     return (this._authentication ??= new Authentication(this._options));
   }
 
+  private _chat?: Chat;
+  get chat(): Chat {
+    return (this._chat ??= new Chat(this._options));
+  }
+
+  private _agents?: Agents;
+  get agents(): Agents {
+    return (this._agents ??= new Agents(this._options));
+  }
+
+  private _entities?: Entities;
+  get entities(): Entities {
+    return (this._entities ??= new Entities(this._options));
+  }
+
+  private _tools?: Tools;
+  get tools(): Tools {
+    return (this._tools ??= new Tools(this._options));
+  }
+
   private _indexing?: Indexing;
   get indexing(): Indexing {
     return (this._indexing ??= new Indexing(this._options));
   }
 
+  private _troubleshooting?: Troubleshooting;
+  get troubleshooting(): Troubleshooting {
+    return (this._troubleshooting ??= new Troubleshooting(this._options));
+  }
+
   private _governance?: Governance;
   get governance(): Governance {
     return (this._governance ??= new Governance(this._options));

package/src/sdk/tools.ts

@@ -3,43 +3,53 @@
  * @generated-id: f997ccdd9dd9
  */
 
-import { clientToolsList } from "../funcs/clientToolsList.js";
-import { clientToolsRun } from "../funcs/clientToolsRun.js";
+import { toolsAuthorizeActionPack } from "../funcs/toolsAuthorizeActionPack.js";
+import { toolsGetActionPackAuthStatus } from "../funcs/toolsGetActionPackAuthStatus.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Tools extends ClientSDK {
   /**
-   * List available tools
+   * Get end-user authentication status for an action pack.
    *
    * @remarks
-   * Returns a filtered set of available tools based on optional tool name parameters. If no filters are provided, all available tools are returned.
+   * Reports whether the calling user is already authenticated against the third-party
+   * tool backing the specified action pack. Intended for headless / server-driven clients
+   * that render an "Authorize" prompt when the user has not yet consented to the tool.
    */
-  async list(
-    toolNames?: Array<string> | undefined,
+  async getActionPackAuthStatus(
+    actionPackId: string,
     options?: RequestOptions,
-  ): Promise<components.ToolsListResponse> {
-    return unwrapAsync(clientToolsList(
+  ): Promise<components.ActionPackAuthStatusResponse> {
+    return unwrapAsync(toolsGetActionPackAuthStatus(
       this,
-      toolNames,
+      actionPackId,
       options,
     ));
   }
 
   /**
-   * Execute the specified tool
+   * Start the OAuth authorization flow for an action pack.
    *
    * @remarks
-   * Execute the specified tool with provided parameters
+   * Starts the third-party OAuth flow for the specified action pack and returns the
+   * redirect URL that the client should navigate the end user to. After the OAuth
+   * callback completes, the user's browser is redirected back to `returnUrl` with a
+   * status query parameter (`?glean_action_auth=success|error&actionPackId=...`).
+   *
+   * `returnUrl` must match the tenant's configured return URL allowlist; otherwise the
+   * request is rejected with 400.
    */
-  async run(
-    request: components.ToolsCallRequest,
+  async authorizeActionPack(
+    authorizeActionPackRequest: components.AuthorizeActionPackRequest,
+    actionPackId: string,
     options?: RequestOptions,
-  ): Promise<components.ToolsCallResponse> {
-    return unwrapAsync(clientToolsRun(
+  ): Promise<components.AuthorizeActionPackResponse> {
+    return unwrapAsync(toolsAuthorizeActionPack(
       this,
-      request,
+      authorizeActionPackRequest,
+      actionPackId,
       options,
     ));
   }

package/src/sdk/troubleshooting.ts

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 075ef996822a
+ */
+
+import { troubleshootingPostApiIndexV1DebugDatasourceDocumentEvents } from "../funcs/troubleshootingPostApiIndexV1DebugDatasourceDocumentEvents.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Troubleshooting extends ClientSDK {
+  /**
+   * Beta: Get document lifecycle events
+   *
+   * @remarks
+   * Retrieves lifecycle events for a specific document including upload time, index times and deletions. Rate limited to 1 request per minute per datasource. Currently in beta, might undergo breaking changes without prior notice.
+   */
+  async postApiIndexV1DebugDatasourceDocumentEvents(
+    debugDocumentLifecycleRequest: components.DebugDocumentLifecycleRequest,
+    datasource: string,
+    options?: RequestOptions,
+  ): Promise<components.DebugDocumentLifecycleResponse> {
+    return unwrapAsync(
+      troubleshootingPostApiIndexV1DebugDatasourceDocumentEvents(
+        this,
+        debugDocumentLifecycleRequest,
+        datasource,
+        options,
+      ),
+    );
+  }
+}

package/src/types/async.ts

@@ -22,16 +22,17 @@ export type APICall =
 
 export class APIPromise<T> implements Promise<T> {
   readonly #promise: Promise<[T, APICall]>;
-  readonly #unwrapped: Promise<T>;
+  #unwrapped: Promise<T> | null;
 
   readonly [Symbol.toStringTag] = "APIPromise";
 
   constructor(p: [T, APICall] | Promise<[T, APICall]>) {
     this.#promise = p instanceof Promise ? p : Promise.resolve(p);
-    this.#unwrapped =
-      p instanceof Promise
-        ? this.#promise.then(([value]) => value)
-        : Promise.resolve(p[0]);
+    this.#unwrapped = p instanceof Promise ? null : Promise.resolve(p[0]);
+  }
+
+  #getUnwrapped(): Promise<T> {
+    return (this.#unwrapped ??= this.#promise.then(([value]) => value));
   }
 
   then<TResult1 = T, TResult2 = never>(
@@ -56,11 +57,11 @@ export class APIPromise<T> implements Promise<T> {
       | null
       | undefined,
   ): Promise<T | TResult> {
-    return this.#unwrapped.catch(onrejected);
+    return this.#getUnwrapped().catch(onrejected);
   }
 
   finally(onfinally?: (() => void) | null | undefined): Promise<T> {
-    return this.#unwrapped.finally(onfinally);
+    return this.#getUnwrapped().finally(onfinally);
   }
 
   $inspect(): Promise<[T, APICall]> {