@gleanwork/api-client 0.18.1 → 0.19.1

package/src/react-query/triggersUpdate.ts

@@ -0,0 +1,114 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 42511c6970b3
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GleanCore } from "../core.js";
+import { triggersUpdate } from "../funcs/triggersUpdate.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 TriggersUpdateMutationVariables = {
+  platformTriggerUpdateRequest: components.PlatformTriggerUpdateRequest;
+  triggerId: string;
+  options?: RequestOptions;
+};
+
+export type TriggersUpdateMutationData = components.PlatformTriggerGetResponse;
+
+export type TriggersUpdateMutationError =
+  | errors.PlatformProblemDetailError
+  | GleanBaseError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Update trigger
+ *
+ * @remarks
+ * Update a trigger.
+ */
+export function useTriggersUpdateMutation(
+  options?: MutationHookOptions<
+    TriggersUpdateMutationData,
+    TriggersUpdateMutationError,
+    TriggersUpdateMutationVariables
+  >,
+): UseMutationResult<
+  TriggersUpdateMutationData,
+  TriggersUpdateMutationError,
+  TriggersUpdateMutationVariables
+> {
+  const client = useGleanContext();
+  return useMutation({
+    ...buildTriggersUpdateMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyTriggersUpdate(): MutationKey {
+  return ["@gleanwork/api-client", "triggers", "update"];
+}
+
+export function buildTriggersUpdateMutation(
+  client$: GleanCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: TriggersUpdateMutationVariables,
+  ) => Promise<TriggersUpdateMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyTriggersUpdate(),
+    mutationFn: function triggersUpdateMutationFn({
+      platformTriggerUpdateRequest,
+      triggerId,
+      options,
+    }): Promise<TriggersUpdateMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(triggersUpdate(
+        client$,
+        platformTriggerUpdateRequest,
+        triggerId,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/sdk/clientagents.ts

@@ -42,6 +42,8 @@ export class ClientAgents extends ClientSDK {
    *
    * @remarks
    * Returns details of an [agent](https://developers.glean.com/agents/agents-api) created in the Agent Builder.
+   *
+   * @deprecated method: Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use GET /api/agents/{agent_id} instead..
    */
   async retrieve(
     agentId: string,
@@ -86,6 +88,8 @@ export class ClientAgents extends ClientSDK {
    *
    * @remarks
    * Return [agent](https://developers.glean.com/agents/agents-api)'s input and output schemas. You can use these schemas to detect changes to an agent's input or output structure.
+   *
+   * @deprecated method: Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use GET /api/agents/{agent_id}/schemas instead..
    */
   async retrieveSchemas(
     agentId: string,
@@ -130,6 +134,8 @@ export class ClientAgents extends ClientSDK {
    *
    * @remarks
    * Search for [agents](https://developers.glean.com/agents/agents-api) by agent name.
+   *
+   * @deprecated method: Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use POST /api/agents/search instead..
    */
   async list(
     request: components.SearchAgentsRequest,
@@ -147,6 +153,8 @@ export class ClientAgents extends ClientSDK {
    *
    * @remarks
    * Executes an [agent](https://developers.glean.com/agents/agents-api) run and returns the result as a stream of server-sent events (SSE). **Note**: If the agent uses an input form trigger, all form fields (including optional fields) must be included in the `input` object.
+   *
+   * @deprecated method: Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use POST /api/agents/{agent_id}/runs with stream=true instead..
    */
   async runStream(
     request: components.AgentRunCreate,
@@ -164,6 +172,8 @@ export class ClientAgents extends ClientSDK {
    *
    * @remarks
    * Executes an [agent](https://developers.glean.com/agents/agents-api) run and returns the final response. **Note**: If the agent uses an input form trigger, all form fields (including optional fields) must be included in the `input` object.
+   *
+   * @deprecated method: Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use POST /api/agents/{agent_id}/runs instead..
    */
   async run(
     request: components.AgentRunCreate,

package/src/sdk/sdk.ts

@@ -10,6 +10,7 @@ import { Client } from "./client.js";
 import { Indexing } from "./indexing.js";
 import { Search } from "./search.js";
 import { Skills } from "./skills.js";
+import { Triggers } from "./triggers.js";
 
 export class Glean extends ClientSDK {
   private _agents?: Agents;
@@ -32,6 +33,11 @@ export class Glean extends ClientSDK {
     return (this._search ??= new Search(this._options));
   }
 
+  private _triggers?: Triggers;
+  get triggers(): Triggers {
+    return (this._triggers ??= new Triggers(this._options));
+  }
+
   private _client?: Client;
   get client(): Client {
     return (this._client ??= new Client(this._options));

package/src/sdk/skills.ts

@@ -65,16 +65,16 @@ export class Skills extends ClientSDK {
   }
 
   /**
-   * Validate skill bundle
+   * Import skills from GitHub
    *
    * @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.
+   * 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 validate(
-    request: components.PlatformSkillValidationRequest,
+  async import(
+    request: components.PlatformSkillImportRequest,
     options?: RequestOptions,
-  ): Promise<components.PlatformSkillValidationResponse> {
-    return unwrapAsync(skillsValidate(
+  ): Promise<components.PlatformSkillImportResponse> {
+    return unwrapAsync(skillsImport(
       this,
       request,
       options,
@@ -82,16 +82,16 @@ export class Skills extends ClientSDK {
   }
 
   /**
-   * Import skills from GitHub
+   * Validate skill bundle
    *
    * @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.
+   * 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 import(
-    request: components.PlatformSkillImportRequest,
+  async validate(
+    request: components.PlatformSkillValidationRequest,
     options?: RequestOptions,
-  ): Promise<components.PlatformSkillImportResponse> {
-    return unwrapAsync(skillsImport(
+  ): Promise<components.PlatformSkillValidationResponse> {
+    return unwrapAsync(skillsValidate(
       this,
       request,
       options,

package/src/sdk/tools.ts

@@ -141,14 +141,15 @@ export class Tools extends ClientSDK {
    *
    * @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.
+   * specified tool server. Works for Glean's built-in tools, tool 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.
+   * Use `serverId=native` for Glean's built-in tools.
    */
   async getToolServerTools(
     serverId: string,

package/src/sdk/triggers.ts

@@ -0,0 +1,210 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2b0bc3f627a3
+ */
+
+import { triggersCreate } from "../funcs/triggersCreate.js";
+import { triggersDelete } from "../funcs/triggersDelete.js";
+import { triggersGet } from "../funcs/triggersGet.js";
+import { triggersGetPreset } from "../funcs/triggersGetPreset.js";
+import { triggersList } from "../funcs/triggersList.js";
+import { triggersListPresetInputValues } from "../funcs/triggersListPresetInputValues.js";
+import { triggersListPresets } from "../funcs/triggersListPresets.js";
+import { triggersSearchEvents } from "../funcs/triggersSearchEvents.js";
+import { triggersSearchPresetEvents } from "../funcs/triggersSearchPresetEvents.js";
+import { triggersUpdate } from "../funcs/triggersUpdate.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Triggers extends ClientSDK {
+  /**
+   * Create trigger
+   *
+   * @remarks
+   * Create a trigger from a preset and return it with its signing secret.
+   */
+  async create(
+    request: components.PlatformTriggerCreateRequest,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerCreateResponse> {
+    return unwrapAsync(triggersCreate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List triggers
+   *
+   * @remarks
+   * List triggers owned by the authenticated caller.
+   */
+  async list(
+    pageSize?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerListResponse> {
+    return unwrapAsync(triggersList(
+      this,
+      pageSize,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Get trigger
+   *
+   * @remarks
+   * Retrieve a trigger owned by the authenticated caller.
+   */
+  async get(
+    triggerId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerGetResponse> {
+    return unwrapAsync(triggersGet(
+      this,
+      triggerId,
+      options,
+    ));
+  }
+
+  /**
+   * Update trigger
+   *
+   * @remarks
+   * Update a trigger.
+   */
+  async update(
+    platformTriggerUpdateRequest: components.PlatformTriggerUpdateRequest,
+    triggerId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerGetResponse> {
+    return unwrapAsync(triggersUpdate(
+      this,
+      platformTriggerUpdateRequest,
+      triggerId,
+      options,
+    ));
+  }
+
+  /**
+   * Delete trigger
+   *
+   * @remarks
+   * Delete a trigger.
+   */
+  async delete(
+    triggerId: string,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(triggersDelete(
+      this,
+      triggerId,
+      options,
+    ));
+  }
+
+  /**
+   * Search events for a trigger
+   *
+   * @remarks
+   * Search recent content events an existing trigger matches. Read-only — no webhook delivery is made. Covers the last seven days.
+   */
+  async searchEvents(
+    triggerId: string,
+    platformTriggerEventSearchRequest?:
+      | components.PlatformTriggerEventSearchRequest
+      | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerEventSearchResponse> {
+    return unwrapAsync(triggersSearchEvents(
+      this,
+      triggerId,
+      platformTriggerEventSearchRequest,
+      options,
+    ));
+  }
+
+  /**
+   * List trigger presets
+   *
+   * @remarks
+   * List the trigger presets available to the caller. A preset is a curated content-trigger template (e.g. a new Jira ticket) which is passed when creating a trigger.
+   */
+  async listPresets(
+    datasource?: string | undefined,
+    pageSize?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerPresetListResponse> {
+    return unwrapAsync(triggersListPresets(
+      this,
+      datasource,
+      pageSize,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Get trigger preset
+   *
+   * @remarks
+   * Retrieve a single trigger preset by id.
+   */
+  async getPreset(
+    presetId: string,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerPresetGetResponse> {
+    return unwrapAsync(triggersGetPreset(
+      this,
+      presetId,
+      options,
+    ));
+  }
+
+  /**
+   * Search trigger preset input values
+   *
+   * @remarks
+   * Return up to 300 selectable values for a single picklist input on a preset. Results are intended for typeahead selection and are not cursor-paginated. When `is_truncated` is true, refine `query` to narrow the result set.
+   */
+  async listPresetInputValues(
+    presetId: string,
+    field: string,
+    query?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerPresetInputValueListResponse> {
+    return unwrapAsync(triggersListPresetInputValues(
+      this,
+      presetId,
+      field,
+      query,
+      options,
+    ));
+  }
+
+  /**
+   * Search events for a trigger preset
+   *
+   * @remarks
+   * Search recent content events an unsaved trigger built from this preset would match, to preview it before creating the trigger. Read-only — no trigger is created and no webhook delivery is made. Covers the last seven days.
+   */
+  async searchPresetEvents(
+    presetId: string,
+    platformTriggerPresetEventSearchRequest?:
+      | components.PlatformTriggerPresetEventSearchRequest
+      | undefined,
+    options?: RequestOptions,
+  ): Promise<components.PlatformTriggerEventSearchResponse> {
+    return unwrapAsync(triggersSearchPresetEvents(
+      this,
+      presetId,
+      platformTriggerPresetEventSearchRequest,
+      options,
+    ));
+  }
+}