@gleanwork/api-client 0.17.3 → 0.18.1

package/src/sdk/sdk.ts

@@ -5,9 +5,11 @@
 
 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";
+import { Skills } from "./skills.js";
 
 export class Glean extends ClientSDK {
   private _agents?: Agents;
@@ -15,6 +17,16 @@ 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));
+  }
+
   private _search?: Search;
   get search(): Search {
     return (this._search ??= new Search(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

@@ -0,0 +1,285 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 847667a72f83
+ */
+
+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
+   *
+   * @remarks
+   * Create a skill from an uploaded SKILL.md, .zip, or .skill bundle. If the authenticated user already has a skill with the same name, the existing skill is superseded with a new version.
+   */
+  async create(
+    request: components.PlatformSkillCreateRequest,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillCreateResponse> {
+    return unwrapAsync(skillsCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List skills
+   *
+   * @remarks
+   * List skills available to the authenticated user.
+   */
+  async list(
+    pageSize?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillsListResponse> {
+    return unwrapAsync(skillsList(
+      this,
+      pageSize,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Validate skill bundle
+   *
+   * @remarks
+   * Validate a skill bundle without persisting it. Accepts a SKILL.md, .zip, or .skill upload and returns parsed metadata plus the normalized file layout.
+   */
+  async validate(
+    request: components.PlatformSkillValidationRequest,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillValidationResponse> {
+    return unwrapAsync(skillsValidate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * 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
+   *
+   * @remarks
+   * Retrieve metadata for a skill available to the authenticated user.
+   */
+  async retrieve(
+    skillId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillGetResponse> {
+    return unwrapAsync(skillsRetrieve(
+      this,
+      skillId,
+      options,
+    ));
+  }
+
+  /**
+   * Download skill content
+   *
+   * @remarks
+   * Download the latest installable bundle for a skill available to the authenticated user.
+   */
+  async retrieveContent(
+    skillId: string,
+    options?: RequestOptions,
+  ): Promise<operations.PlatformSkillsGetContentResponse> {
+    return unwrapAsync(skillsRetrieveContent(
+      this,
+      skillId,
+      options,
+    ));
+  }
+
+  /**
+   * 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
+   *
+   * @remarks
+   * Create a new immutable version for an existing caller-managed skill from an uploaded SKILL.md, .zip, or .skill bundle.
+   */
+  async createVersion(
+    platformSkillVersionCreateRequest:
+      components.PlatformSkillVersionCreateRequest,
+    skillId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillVersionCreateResponse> {
+    return unwrapAsync(skillsCreateVersion(
+      this,
+      platformSkillVersionCreateRequest,
+      skillId,
+      options,
+    ));
+  }
+
+  /**
+   * List skill versions
+   *
+   * @remarks
+   * List versions for a skill available to the authenticated user.
+   */
+  async listVersions(
+    skillId: string,
+    pageSize?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillVersionsListResponse> {
+    return unwrapAsync(skillsListVersions(
+      this,
+      skillId,
+      pageSize,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve skill version
+   *
+   * @remarks
+   * Retrieve metadata for a skill version available to the authenticated user.
+   */
+  async retrieveVersion(
+    skillId: string,
+    version: number,
+    options?: RequestOptions,
+  ): Promise<components.PlatformSkillVersionGetResponse> {
+    return unwrapAsync(skillsRetrieveVersion(
+      this,
+      skillId,
+      version,
+      options,
+    ));
+  }
+
+  /**
+   * Download skill version content
+   *
+   * @remarks
+   * Download the installable bundle for a skill version available to the authenticated user.
+   */
+  async retrieveVersionContent(
+    skillId: string,
+    version: number,
+    options?: RequestOptions,
+  ): Promise<operations.PlatformSkillsGetVersionContentResponse> {
+    return unwrapAsync(skillsRetrieveVersionContent(
+      this,
+      skillId,
+      version,
+      options,
+    ));
+  }
+}

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,
+    ));
+  }
 }