@gleanwork/api-client 0.4.4 → 0.5.3

package/src/funcs/clientGovernanceDataReportsCreate.ts

@@ -24,7 +24,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Creates new one-time report.
+ * Creates new one-time report
  *
  * @remarks
  * Creates a new one-time report and executes its batch job.

package/src/funcs/clientGovernanceDataReportsDownload.ts

@@ -25,7 +25,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Downloads violations CSV for report.
+ * Downloads violations CSV for report
  *
  * @remarks
  * Downloads CSV violations report for a specific report id.

package/src/funcs/clientGovernanceDataReportsStatus.ts

@@ -25,7 +25,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Fetches report run status.
+ * Fetches report run status
  *
  * @remarks
  * Fetches the status of the run corresponding to the report-id.

package/src/funcs/clientGovernanceDocumentsVisibilityoverridesCreate.ts

@@ -24,7 +24,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Hide/Un-hide docs.
+ * Hide or unhide docs
  *
  * @remarks
  * Sets the visibility-override state of the documents specified, effectively hiding or un-hiding documents.

package/src/funcs/clientGovernanceDocumentsVisibilityoverridesList.ts

@@ -25,7 +25,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Fetches documents visibility.
+ * Fetches documents visibility
  *
  * @remarks
  * Fetches the visibility override status of the documents passed.

package/src/lib/config.ts

@@ -64,8 +64,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.9.0",
-  sdkVersion: "0.4.4",
+  sdkVersion: "0.5.3",
   genVersion: "2.610.0",
   userAgent:
-    "speakeasy-sdk/typescript 0.4.4 2.610.0 0.9.0 @gleanwork/api-client",
+    "speakeasy-sdk/typescript 0.5.3 2.610.0 0.9.0 @gleanwork/api-client",
 } as const;

package/src/models/components/agent.ts

@@ -12,20 +12,25 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * The agent metadata.
+ * The agent metadata. Currently not implemented.
  */
 export type AgentMetadata = {};
 
 /**
- * Describes which protocol features the agent supports. In addition to the standard capabilities (prefixed with ap.), implementations can declare custom capabilities, named in reverse domain notation (eg. com.example.some.capability).
+ * Describes features that the agent supports. example: {
+ *
+ * @remarks
+ *   "ap.io.messages": true,
+ *   "ap.io.streaming": true
+ * }
  */
 export type AgentCapabilities = {
   /**
-   * Whether the agent supports Messages as input/output/state. If true, the agent uses the `messages` key in threads/runs endpoints.
+   * Whether the agent supports messages as an input. If true, you'll pass `messages` as an input when running the agent.
    */
   apIoMessages?: boolean | undefined;
   /**
-   * Whether the agent supports streaming output.
+   * Whether the agent supports streaming output. If true, you you can stream agent ouput. All agents currently support streaming.
    */
   apIoStreaming?: boolean | undefined;
   additionalProperties?: { [k: string]: any };
@@ -45,11 +50,16 @@ export type Agent = {
    */
   description?: string | undefined;
   /**
-   * The agent metadata.
+   * The agent metadata. Currently not implemented.
    */
   metadata?: AgentMetadata | undefined;
   /**
-   * Describes which protocol features the agent supports. In addition to the standard capabilities (prefixed with ap.), implementations can declare custom capabilities, named in reverse domain notation (eg. com.example.some.capability).
+   * Describes features that the agent supports. example: {
+   *
+   * @remarks
+   *   "ap.io.messages": true,
+   *   "ap.io.streaming": true
+   * }
    */
   capabilities: AgentCapabilities;
 };

package/src/models/components/agentrun.ts

@@ -26,7 +26,7 @@ export type AgentRun = {
   /**
    * The ID of the agent to run.
    */
-  agentId?: string | undefined;
+  agentId: string;
   /**
    * The input to the agent.
    */
@@ -47,7 +47,7 @@ export const AgentRun$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  agent_id: z.string().optional(),
+  agent_id: z.string(),
   input: z.record(z.any()).optional(),
   messages: z.array(Message$inboundSchema).optional(),
   status: AgentExecutionStatus$inboundSchema.optional(),
@@ -59,7 +59,7 @@ export const AgentRun$inboundSchema: z.ZodType<
 
 /** @internal */
 export type AgentRun$Outbound = {
-  agent_id?: string | undefined;
+  agent_id: string;
   input?: { [k: string]: any } | undefined;
   messages?: Array<Message$Outbound> | undefined;
   status?: string | undefined;
@@ -71,7 +71,7 @@ export const AgentRun$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AgentRun
 > = z.object({
-  agentId: z.string().optional(),
+  agentId: z.string(),
   input: z.record(z.any()).optional(),
   messages: z.array(Message$outboundSchema).optional(),
   status: AgentExecutionStatus$outboundSchema.optional(),

package/src/models/components/agentruncreate.ts

@@ -21,7 +21,7 @@ export type AgentRunCreate = {
   /**
    * The ID of the agent to run.
    */
-  agentId?: string | undefined;
+  agentId: string;
   /**
    * The input to the agent.
    */
@@ -38,7 +38,7 @@ export const AgentRunCreate$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  agent_id: z.string().optional(),
+  agent_id: z.string(),
   input: z.record(z.any()).optional(),
   messages: z.array(Message$inboundSchema).optional(),
 }).transform((v) => {
@@ -49,7 +49,7 @@ export const AgentRunCreate$inboundSchema: z.ZodType<
 
 /** @internal */
 export type AgentRunCreate$Outbound = {
-  agent_id?: string | undefined;
+  agent_id: string;
   input?: { [k: string]: any } | undefined;
   messages?: Array<Message$Outbound> | undefined;
 };
@@ -60,7 +60,7 @@ export const AgentRunCreate$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AgentRunCreate
 > = z.object({
-  agentId: z.string().optional(),
+  agentId: z.string(),
   input: z.record(z.any()).optional(),
   messages: z.array(Message$outboundSchema).optional(),
 }).transform((v) => {

package/src/models/components/agentschemas.ts

@@ -9,12 +9,12 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * The schema for the agent input. In JSON Schema format.
+ * The schema for the agent input. In JSON schema format.
  */
 export type InputSchema = {};
 
 /**
- * The schema for the agent output. In JSON Schema format.
+ * The schema for the agent output. In JSON schema format.
  */
 export type OutputSchema = {};
 
@@ -27,11 +27,11 @@ export type AgentSchemas = {
    */
   agentId: string;
   /**
-   * The schema for the agent input. In JSON Schema format.
+   * The schema for the agent input. In JSON schema format.
    */
   inputSchema: InputSchema;
   /**
-   * The schema for the agent output. In JSON Schema format.
+   * The schema for the agent output. In JSON schema format.
    */
   outputSchema: OutputSchema;
 };

package/src/models/components/chatrequest.ts

@@ -24,6 +24,12 @@ import {
   ChatRestrictionFilters$Outbound,
   ChatRestrictionFilters$outboundSchema,
 } from "./chatrestrictionfilters.js";
+import {
+  SessionInfo,
+  SessionInfo$inboundSchema,
+  SessionInfo$Outbound,
+  SessionInfo$outboundSchema,
+} from "./sessioninfo.js";
 
 export type ChatRequest = {
   /**
@@ -48,6 +54,7 @@ export type ChatRequest = {
    * Timeout in milliseconds for the request. A `408` error will be returned if handling the request takes longer.
    */
   timeoutMillis?: number | undefined;
+  sessionInfo?: SessionInfo | undefined;
   /**
    * The ID of the application this request originates from, used to determine the configuration of underlying chat processes. This should correspond to the ID set during admin setup. If not specified, the default chat experience will be used.
    */
@@ -71,6 +78,7 @@ export const ChatRequest$inboundSchema: z.ZodType<
   inclusions: ChatRestrictionFilters$inboundSchema.optional(),
   exclusions: ChatRestrictionFilters$inboundSchema.optional(),
   timeoutMillis: z.number().int().optional(),
+  sessionInfo: SessionInfo$inboundSchema.optional(),
   applicationId: z.string().optional(),
   stream: z.boolean().optional(),
 });
@@ -84,6 +92,7 @@ export type ChatRequest$Outbound = {
   inclusions?: ChatRestrictionFilters$Outbound | undefined;
   exclusions?: ChatRestrictionFilters$Outbound | undefined;
   timeoutMillis?: number | undefined;
+  sessionInfo?: SessionInfo$Outbound | undefined;
   applicationId?: string | undefined;
   stream?: boolean | undefined;
 };
@@ -101,6 +110,7 @@ export const ChatRequest$outboundSchema: z.ZodType<
   inclusions: ChatRestrictionFilters$outboundSchema.optional(),
   exclusions: ChatRestrictionFilters$outboundSchema.optional(),
   timeoutMillis: z.number().int().optional(),
+  sessionInfo: SessionInfo$outboundSchema.optional(),
   applicationId: z.string().optional(),
   stream: z.boolean().optional(),
 });

package/src/models/components/searchagentsrequest.ts

@@ -9,7 +9,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type SearchAgentsRequest = {
   /**
-   * Filters on the name of the agent. If empty, acts as no filter.
+   * Filters on the name of the agent. The keyword search is case-insensitive. If search string is ommited or empty, acts as no filter.
    */
   name?: string | undefined;
 };

package/src/models/components/workflow.ts

@@ -20,6 +20,10 @@ import {
 } from "./person.js";
 
 export type Workflow = {
+  /**
+   * The name of the workflow.
+   */
+  name?: string | undefined;
   author?: Person | undefined;
   /**
    * Server Unix timestamp of the creation time.
@@ -31,10 +35,6 @@ export type Workflow = {
   lastUpdateTimestamp?: number | undefined;
   lastUpdatedBy?: Person | undefined;
   permissions?: ObjectPermissions | undefined;
-  /**
-   * The name of the workflow.
-   */
-  name?: string | undefined;
   /**
    * The ID of the workflow.
    */
@@ -47,23 +47,23 @@ export const Workflow$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  name: z.string().optional(),
   author: Person$inboundSchema.optional(),
   createTimestamp: z.number().int().optional(),
   lastUpdateTimestamp: z.number().int().optional(),
   lastUpdatedBy: Person$inboundSchema.optional(),
   permissions: ObjectPermissions$inboundSchema.optional(),
-  name: z.string().optional(),
   id: z.string().optional(),
 });
 
 /** @internal */
 export type Workflow$Outbound = {
+  name?: string | undefined;
   author?: Person$Outbound | undefined;
   createTimestamp?: number | undefined;
   lastUpdateTimestamp?: number | undefined;
   lastUpdatedBy?: Person$Outbound | undefined;
   permissions?: ObjectPermissions$Outbound | undefined;
-  name?: string | undefined;
   id?: string | undefined;
 };
 
@@ -73,12 +73,12 @@ export const Workflow$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Workflow
 > = z.object({
+  name: z.string().optional(),
   author: Person$outboundSchema.optional(),
   createTimestamp: z.number().int().optional(),
   lastUpdateTimestamp: z.number().int().optional(),
   lastUpdatedBy: Person$outboundSchema.optional(),
   permissions: ObjectPermissions$outboundSchema.optional(),
-  name: z.string().optional(),
   id: z.string().optional(),
 });
 

package/src/react-query/clientAgentsList.ts

@@ -24,10 +24,10 @@ export type ClientAgentsListMutationVariables = {
 export type ClientAgentsListMutationData = components.SearchAgentsResponse;
 
 /**
- * Search Agents
+ * Search agents
  *
  * @remarks
- * List Agents available in this service. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/POST/agents/search). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+ * Search for [agents](https://developers.glean.com/agents/agents-api) by agent name.
  */
 export function useClientAgentsListMutation(
   options?: MutationHookOptions<

package/src/react-query/clientAgentsRetrieve.ts

@@ -28,10 +28,10 @@ import {
 export type ClientAgentsRetrieveQueryData = components.Agent;
 
 /**
- * Get Agent
+ * Retrieve an agent
  *
  * @remarks
- * Get an agent by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+ * Returns details of an [agent](https://developers.glean.com/agents/agents-api) created in the Agent Builder.
  */
 export function useClientAgentsRetrieve(
   agentId: string,
@@ -51,10 +51,10 @@ export function useClientAgentsRetrieve(
 }
 
 /**
- * Get Agent
+ * Retrieve an agent
  *
  * @remarks
- * Get an agent by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+ * Returns details of an [agent](https://developers.glean.com/agents/agents-api) created in the Agent Builder.
  */
 export function useClientAgentsRetrieveSuspense(
   agentId: string,

package/src/react-query/clientAgentsRetrieveSchemas.ts

@@ -28,10 +28,10 @@ import {
 export type ClientAgentsRetrieveSchemasQueryData = components.AgentSchemas;
 
 /**
- * Get Agent Schemas
+ * List an agent's schemas
  *
  * @remarks
- * Get an agent's schemas by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}/schemas). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+ * 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.
  */
 export function useClientAgentsRetrieveSchemas(
   agentId: string,
@@ -51,10 +51,10 @@ export function useClientAgentsRetrieveSchemas(
 }
 
 /**
- * Get Agent Schemas
+ * List an agent's schemas
  *
  * @remarks
- * Get an agent's schemas by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}/schemas). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+ * 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.
  */
 export function useClientAgentsRetrieveSchemasSuspense(
   agentId: string,

package/src/react-query/clientAgentsRun.ts

@@ -24,10 +24,10 @@ export type ClientAgentsRunMutationVariables = {
 export type ClientAgentsRunMutationData = components.AgentRunWaitResponse;
 
 /**
- * Create Run, Wait for Output
+ * Create an [agent](https://developers.glean.com/agents/agents-api) run and wait for the response
  *
  * @remarks
- * Creates and triggers a run of an agent. Waits for final output and then returns it. This endpoint implements the LangChain Agent Protocol, specifically part of the Runs stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/runs/POST/runs/wait). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol. Note that running agents that reference third party platform write actions is unsupported as it requires user confirmation.
+ * Executes an agent run and returns the final response.
  */
 export function useClientAgentsRunMutation(
   options?: MutationHookOptions<

package/src/react-query/clientAgentsRunStream.ts

@@ -24,10 +24,10 @@ export type ClientAgentsRunStreamMutationVariables = {
 export type ClientAgentsRunStreamMutationData = string;
 
 /**
- * Create Run, Stream Output
+ * Create an agent run and stream the response
  *
  * @remarks
- * Creates and triggers a run of an agent. Streams the output in SSE format. This endpoint implements the LangChain Agent Protocol, specifically part of the Runs stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/runs/POST/runs/stream). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol. Note that running agents that reference third party platform write actions is unsupported as it requires user confirmation.
+ * Executes an [agent](https://developers.glean.com/agents/agents-api) run and returns the result as a stream of server-sent events (SSE).
  */
 export function useClientAgentsRunStreamMutation(
   options?: MutationHookOptions<

package/src/react-query/clientGovernanceDataPoliciesCreate.ts

@@ -25,7 +25,7 @@ export type ClientGovernanceDataPoliciesCreateMutationData =
   components.CreateDlpReportResponse;
 
 /**
- * Creates new policy.
+ * Creates new policy
  *
  * @remarks
  * Creates a new policy with specified specifications and returns its id.

package/src/react-query/clientGovernanceDataPoliciesDownload.ts

@@ -27,7 +27,7 @@ import {
 export type ClientGovernanceDataPoliciesDownloadQueryData = string;
 
 /**
- * Downloads violations CSV for policy.
+ * Downloads violations CSV for policy
  *
  * @remarks
  * Downloads CSV violations report for a specific policy id. This does not support continuous policies.
@@ -48,7 +48,7 @@ export function useClientGovernanceDataPoliciesDownload(
 }
 
 /**
- * Downloads violations CSV for policy.
+ * Downloads violations CSV for policy
  *
  * @remarks
  * Downloads CSV violations report for a specific policy id. This does not support continuous policies.

package/src/react-query/clientGovernanceDataPoliciesList.ts

@@ -29,7 +29,7 @@ export type ClientGovernanceDataPoliciesListQueryData =
   components.ListDlpReportsResponse;
 
 /**
- * Lists policies.
+ * Lists policies
  *
  * @remarks
  * Lists policies with filtering.
@@ -52,7 +52,7 @@ export function useClientGovernanceDataPoliciesList(
 }
 
 /**
- * Lists policies.
+ * Lists policies
  *
  * @remarks
  * Lists policies with filtering.

package/src/react-query/clientGovernanceDataPoliciesRetrieve.ts

@@ -29,7 +29,7 @@ export type ClientGovernanceDataPoliciesRetrieveQueryData =
   components.GetDlpReportResponse;
 
 /**
- * Gets specified Policy.
+ * Gets specified policy
  *
  * @remarks
  * Fetches the specified policy version, or the latest if no version is provided.
@@ -52,7 +52,7 @@ export function useClientGovernanceDataPoliciesRetrieve(
 }
 
 /**
- * Gets specified Policy.
+ * Gets specified policy
  *
  * @remarks
  * Fetches the specified policy version, or the latest if no version is provided.

package/src/react-query/clientGovernanceDataPoliciesUpdate.ts

@@ -26,7 +26,7 @@ export type ClientGovernanceDataPoliciesUpdateMutationData =
   components.UpdateDlpReportResponse;
 
 /**
- * Updates an existing policy.
+ * Updates an existing policy
  *
  * @remarks
  * Updates an existing policy.

package/src/react-query/clientGovernanceDataReportsCreate.ts

@@ -25,7 +25,7 @@ export type ClientGovernanceDataReportsCreateMutationData =
   components.UpdateDlpConfigResponse;
 
 /**
- * Creates new one-time report.
+ * Creates new one-time report
  *
  * @remarks
  * Creates a new one-time report and executes its batch job.

package/src/react-query/clientGovernanceDataReportsDownload.ts

@@ -27,7 +27,7 @@ import {
 export type ClientGovernanceDataReportsDownloadQueryData = string;
 
 /**
- * Downloads violations CSV for report.
+ * Downloads violations CSV for report
  *
  * @remarks
  * Downloads CSV violations report for a specific report id.
@@ -48,7 +48,7 @@ export function useClientGovernanceDataReportsDownload(
 }
 
 /**
- * Downloads violations CSV for report.
+ * Downloads violations CSV for report
  *
  * @remarks
  * Downloads CSV violations report for a specific report id.

package/src/react-query/clientGovernanceDataReportsStatus.ts

@@ -29,7 +29,7 @@ export type ClientGovernanceDataReportsStatusQueryData =
   components.ReportStatusResponse;
 
 /**
- * Fetches report run status.
+ * Fetches report run status
  *
  * @remarks
  * Fetches the status of the run corresponding to the report-id.
@@ -50,7 +50,7 @@ export function useClientGovernanceDataReportsStatus(
 }
 
 /**
- * Fetches report run status.
+ * Fetches report run status
  *
  * @remarks
  * Fetches the status of the run corresponding to the report-id.

package/src/react-query/clientGovernanceDocumentsVisibilityoverridesCreate.ts

@@ -26,7 +26,7 @@ export type ClientGovernanceDocumentsVisibilityoverridesCreateMutationData =
   components.UpdateDocumentVisibilityOverridesResponse;
 
 /**
- * Hide/Un-hide docs.
+ * Hide or unhide docs
  *
  * @remarks
  * Sets the visibility-override state of the documents specified, effectively hiding or un-hiding documents.

package/src/react-query/clientGovernanceDocumentsVisibilityoverridesList.ts

@@ -29,7 +29,7 @@ export type ClientGovernanceDocumentsVisibilityoverridesListQueryData =
   components.GetDocumentVisibilityOverridesResponse;
 
 /**
- * Fetches documents visibility.
+ * Fetches documents visibility
  *
  * @remarks
  * Fetches the visibility override status of the documents passed.
@@ -55,7 +55,7 @@ export function useClientGovernanceDocumentsVisibilityoverridesList(
 }
 
 /**
- * Fetches documents visibility.
+ * Fetches documents visibility
  *
  * @remarks
  * Fetches the visibility override status of the documents passed.

package/src/sdk/agents.ts

@@ -13,10 +13,10 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class Agents extends ClientSDK {
   /**
-   * Get Agent
+   * Retrieve an agent
    *
    * @remarks
-   * Get an agent by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+   * Returns details of an [agent](https://developers.glean.com/agents/agents-api) created in the Agent Builder.
    */
   async retrieve(
     agentId: string,
@@ -32,10 +32,10 @@ export class Agents extends ClientSDK {
   }
 
   /**
-   * Get Agent Schemas
+   * List an agent's schemas
    *
    * @remarks
-   * Get an agent's schemas by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}/schemas). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+   * 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.
    */
   async retrieveSchemas(
     agentId: string,
@@ -51,10 +51,10 @@ export class Agents extends ClientSDK {
   }
 
   /**
-   * Search Agents
+   * Search agents
    *
    * @remarks
-   * List Agents available in this service. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/POST/agents/search). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+   * Search for [agents](https://developers.glean.com/agents/agents-api) by agent name.
    */
   async list(
     request: components.SearchAgentsRequest,
@@ -68,10 +68,10 @@ export class Agents extends ClientSDK {
   }
 
   /**
-   * Create Run, Stream Output
+   * Create an agent run and stream the response
    *
    * @remarks
-   * Creates and triggers a run of an agent. Streams the output in SSE format. This endpoint implements the LangChain Agent Protocol, specifically part of the Runs stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/runs/POST/runs/stream). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol. Note that running agents that reference third party platform write actions is unsupported as it requires user confirmation.
+   * Executes an [agent](https://developers.glean.com/agents/agents-api) run and returns the result as a stream of server-sent events (SSE).
    */
   async runStream(
     request: components.AgentRunCreate,
@@ -85,10 +85,10 @@ export class Agents extends ClientSDK {
   }
 
   /**
-   * Create Run, Wait for Output
+   * Create an [agent](https://developers.glean.com/agents/agents-api) run and wait for the response
    *
    * @remarks
-   * Creates and triggers a run of an agent. Waits for final output and then returns it. This endpoint implements the LangChain Agent Protocol, specifically part of the Runs stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/runs/POST/runs/wait). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol. Note that running agents that reference third party platform write actions is unsupported as it requires user confirmation.
+   * Executes an agent run and returns the final response.
    */
   async run(
     request: components.AgentRunCreate,