@gleanwork/api-client 0.18.0 → 0.18.1

package/src/sdk/client.ts

@@ -7,9 +7,9 @@ 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 { ClientSearch } from "./clientsearch.js";
@@ -44,9 +44,9 @@ export class Client extends ClientSDK {
     return (this._authentication ??= new ClientAuthentication(this._options));
   }
 
-  private _chat?: Chat;
-  get chat(): Chat {
-    return (this._chat ??= new Chat(this._options));
+  private _chat?: ClientChat;
+  get chat(): ClientChat {
+    return (this._chat ??= new ClientChat(this._options));
   }
 
   private _agents?: ClientAgents;

package/src/sdk/clientagents.ts

@@ -4,6 +4,7 @@
  */
 
 import { clientAgentsCreate } from "../funcs/clientAgentsCreate.js";
+import { clientAgentsImport } from "../funcs/clientAgentsImport.js";
 import { clientAgentsList } from "../funcs/clientAgentsList.js";
 import { clientAgentsRetrieve } from "../funcs/clientAgentsRetrieve.js";
 import { clientAgentsRetrieveSchemas } from "../funcs/clientAgentsRetrieveSchemas.js";
@@ -101,6 +102,29 @@ export class ClientAgents extends ClientSDK {
     ));
   }
 
+  /**
+   * Import an agent
+   *
+   * @remarks
+   * Imports an [agent](https://developers.glean.com/agents/agents-api) from its on-disk folder representation (spec.yaml, instructions.md, skills/, subagents/) packaged as a zip, and creates or updates the agent. Inverse of the export flow: the folder-to-schema conversion runs server-side. The bundle must contain only regular files; symlinks are resolved by the caller at packaging time.
+   */
+  async import(
+    importAgentRequest: components.ImportAgentRequest,
+    agentId: string,
+    locale?: string | undefined,
+    timezoneOffset?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<components.ImportAgentResponse> {
+    return unwrapAsync(clientAgentsImport(
+      this,
+      importAgentRequest,
+      agentId,
+      locale,
+      timezoneOffset,
+      options,
+    ));
+  }
+
   /**
    * Search agents
    *

package/src/sdk/clientchat.ts

@@ -0,0 +1,244 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 85f32ab09218
+ */
+
+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 ClientChat 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 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(
+      this,
+      chatRequest,
+      timezoneOffset,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -5,6 +5,7 @@
 
 import { ClientSDK } from "../lib/sdks.js";
 import { Agents } from "./agents.js";
+import { Chat } from "./chat.js";
 import { Client } from "./client.js";
 import { Indexing } from "./indexing.js";
 import { Search } from "./search.js";
@@ -16,6 +17,11 @@ export class Glean extends ClientSDK {
     return (this._agents ??= new Agents(this._options));
   }
 
+  private _chat?: Chat;
+  get chat(): Chat {
+    return (this._chat ??= new Chat(this._options));
+  }
+
   private _skills?: Skills;
   get skills(): Skills {
     return (this._skills ??= new Skills(this._options));

package/src/sdk/search.ts

@@ -3,9 +3,11 @@
  * @generated-id: b88871d87236
  */
 
+import { searchListFilters } from "../funcs/searchListFilters.js";
 import { searchQuery } from "../funcs/searchQuery.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 Search extends ClientSDK {
@@ -13,7 +15,8 @@ export class Search extends ClientSDK {
    * Search
    *
    * @remarks
-   * Execute a search query and retrieve ranked results. This is the data retrieval variant of the search API and returns only results and pagination state.
+   * Search your organization's connected content and return ranked document results with cursor pagination. Use `GET /api/search/filters` to discover datasource identifiers and common filter fields. Built-in filter names are validated; other field names are accepted as custom filters and behavior depends on your Glean configuration and connected sources.
+   * Errors: HTTP 422 `unprocessable_query` returns no `results` or `next_cursor`. See `warnings` on the response for non-blocking issues such as partially available results. Not every query issue produces a warning or error.
    */
   async query(
     request: components.PlatformSearchRequest,
@@ -25,4 +28,24 @@ export class Search extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * List search filters
+   *
+   * @remarks
+   * List datasources and common built-in filter fields visible to the authenticated user. This is a best-effort catalog, not an exhaustive list of every filter search accepts.
+   * Without `query`, returns field metadata only and does not run a search. With a nonblank `query`, provide exactly one `datasources` value to request suggested filter values for that query; no documents are returned and this endpoint does not include warning objects. See `FilterFieldInfo.values` for limitations on suggested values. Rate-limited requests return HTTP 429 with `Retry-After`; temporary backend unavailability returns HTTP 503.
+   */
+  async listFilters(
+    datasources?: Array<string> | undefined,
+    query?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.PlatformSearchFiltersResponse> {
+    return unwrapAsync(searchListFilters(
+      this,
+      datasources,
+      query,
+      options,
+    ));
+  }
 }

package/src/sdk/skills.ts

@@ -5,18 +5,28 @@
 
 import { skillsCreate } from "../funcs/skillsCreate.js";
 import { skillsCreateVersion } from "../funcs/skillsCreateVersion.js";
+import { skillsDelete } from "../funcs/skillsDelete.js";
+import { skillsImport } from "../funcs/skillsImport.js";
 import { skillsList } from "../funcs/skillsList.js";
 import { skillsListVersions } from "../funcs/skillsListVersions.js";
+import {
+  PreviewSourceAcceptEnum,
+  skillsPreviewSource,
+} from "../funcs/skillsPreviewSource.js";
 import { skillsRetrieve } from "../funcs/skillsRetrieve.js";
 import { skillsRetrieveContent } from "../funcs/skillsRetrieveContent.js";
 import { skillsRetrieveVersion } from "../funcs/skillsRetrieveVersion.js";
 import { skillsRetrieveVersionContent } from "../funcs/skillsRetrieveVersionContent.js";
+import { skillsSync } from "../funcs/skillsSync.js";
+import { skillsUpdate } from "../funcs/skillsUpdate.js";
 import { skillsValidate } from "../funcs/skillsValidate.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 { PreviewSourceAcceptEnum } from "../funcs/skillsPreviewSource.js";
+
 export class Skills extends ClientSDK {
   /**
    * Create skill
@@ -71,6 +81,78 @@ export class Skills extends ClientSDK {
     ));
   }
 
+  /**
+   * 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.
+   */
+  async import(
+    request: components.PlatformSkillImportRequest,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillImportResponse> {
+    return unwrapAsync(skillsImport(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * 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.
+   */
+  async previewSource(
+    request: components.PlatformSkillSourcePreviewRequest,
+    options?: RequestOptions & {
+      acceptHeaderOverride?: PreviewSourceAcceptEnum;
+    },
+  ): Promise<operations.PlatformSkillsPreviewSourceResponse> {
+    return unwrapAsync(skillsPreviewSource(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update skill
+   *
+   * @remarks
+   * Update mutable metadata for a skill. V1 supports enabling or disabling a skill without changing its content.
+   */
+  async update(
+    platformSkillUpdateRequest: components.PlatformSkillUpdateRequest,
+    skillId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillUpdateResponse> {
+    return unwrapAsync(skillsUpdate(
+      this,
+      platformSkillUpdateRequest,
+      skillId,
+      options,
+    ));
+  }
+
+  /**
+   * Delete skill
+   *
+   * @remarks
+   * Delete a skill the authenticated caller is allowed to manage. This operation permanently removes all versions of the skill.
+   */
+  async delete(
+    skillId: string,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(skillsDelete(
+      this,
+      skillId,
+      options,
+    ));
+  }
+
   /**
    * Retrieve skill
    *
@@ -105,6 +187,23 @@ export class Skills extends ClientSDK {
     ));
   }
 
+  /**
+   * 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.
+   */
+  async sync(
+    skillId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillSyncResponse> {
+    return unwrapAsync(skillsSync(
+      this,
+      skillId,
+      options,
+    ));
+  }
+
   /**
    * Create skill version
    *

package/src/sdk/tools.ts

@@ -5,6 +5,7 @@
 
 import { clientToolsAuthorizeActionPack } from "../funcs/clientToolsAuthorizeActionPack.js";
 import { clientToolsAuthorizeToolServer } from "../funcs/clientToolsAuthorizeToolServer.js";
+import { clientToolsGetToolServerTools } from "../funcs/clientToolsGetToolServerTools.js";
 import { clientToolsList } from "../funcs/clientToolsList.js";
 import { clientToolsRetrieveActionPackAuthStatus } from "../funcs/clientToolsRetrieveActionPackAuthStatus.js";
 import { clientToolsRetrieveToolServerAuthStatus } from "../funcs/clientToolsRetrieveToolServerAuthStatus.js";
@@ -134,4 +135,31 @@ export class Tools extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Get tool definitions from a tool server.
+   *
+   * @remarks
+   * Returns the name, description and JSON input schema for the named tools on the
+   * specified tool server. Works for both action packs and MCP servers.
+   *
+   * `toolNames` is required. Names that do not exist on the server are returned in
+   * `notFound` rather than failing the request, so a single bad name does not force
+   * callers into one-at-a-time retries. Matching is case-insensitive and treats `-`
+   * and `_` as equivalent.
+   *
+   * Native tools are not served; `serverId=native` returns 404.
+   */
+  async getToolServerTools(
+    serverId: string,
+    toolNames: Array<string>,
+    options?: RequestOptions,
+  ): Promise<components.ToolDefinitionsResponse> {
+    return unwrapAsync(clientToolsGetToolServerTools(
+      this,
+      serverId,
+      toolNames,
+      options,
+    ));
+  }
 }

package/dist/commonjs/models/components/platformskillvalidationwarning.d.ts

@@ -1,17 +0,0 @@
-import * as z from "zod/v3";
-import { Result as SafeParseResult } from "../../types/fp.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-export type PlatformSkillValidationWarning = {
-    /**
-     * Stable warning code.
-     */
-    code: string;
-    /**
-     * Human-readable warning message.
-     */
-    message: string;
-};
-/** @internal */
-export declare const PlatformSkillValidationWarning$inboundSchema: z.ZodType<PlatformSkillValidationWarning, z.ZodTypeDef, unknown>;
-export declare function platformSkillValidationWarningFromJSON(jsonString: string): SafeParseResult<PlatformSkillValidationWarning, SDKValidationError>;
-//# sourceMappingURL=platformskillvalidationwarning.d.ts.map

package/dist/esm/models/components/platformskillvalidationwarning.d.ts

@@ -1,17 +0,0 @@
-import * as z from "zod/v3";
-import { Result as SafeParseResult } from "../../types/fp.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-export type PlatformSkillValidationWarning = {
-    /**
-     * Stable warning code.
-     */
-    code: string;
-    /**
-     * Human-readable warning message.
-     */
-    message: string;
-};
-/** @internal */
-export declare const PlatformSkillValidationWarning$inboundSchema: z.ZodType<PlatformSkillValidationWarning, z.ZodTypeDef, unknown>;
-export declare function platformSkillValidationWarningFromJSON(jsonString: string): SafeParseResult<PlatformSkillValidationWarning, SDKValidationError>;
-//# sourceMappingURL=platformskillvalidationwarning.d.ts.map

package/dist/esm/models/components/platformskillvalidationwarning.js

@@ -1,15 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 9f6d3a564161
- */
-import * as z from "zod/v3";
-import { safeParse } from "../../lib/schemas.js";
-/** @internal */
-export const PlatformSkillValidationWarning$inboundSchema = z.object({
-    code: z.string(),
-    message: z.string(),
-});
-export function platformSkillValidationWarningFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => PlatformSkillValidationWarning$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'PlatformSkillValidationWarning' from JSON`);
-}
-//# sourceMappingURL=platformskillvalidationwarning.js.map