@gleanwork/api-client 0.17.3 → 0.18.1

package/src/funcs/clientAgentsImport.ts

@@ -0,0 +1,257 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3499fb328556
+ */
+
+import { GleanCore } from "../core.js";
+import {
+  appendForm,
+  encodeFormQuery,
+  encodeSimple,
+  normalizeBlob,
+} from "../lib/encodings.js";
+import {
+  bytesToBlob,
+  getContentTypeFromFileName,
+  readableStreamToArrayBuffer,
+} from "../lib/files.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.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 * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { isBlobLike } from "../types/blobs.js";
+import { Result } from "../types/fp.js";
+import { isReadableStream } from "../types/streams.js";
+
+/**
+ * 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.
+ */
+export function clientAgentsImport(
+  client: GleanCore,
+  importAgentRequest: components.ImportAgentRequest,
+  agentId: string,
+  locale?: string | undefined,
+  timezoneOffset?: number | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.ImportAgentResponse,
+    | errors.ErrorResponse
+    | GleanBaseError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    importAgentRequest,
+    agentId,
+    locale,
+    timezoneOffset,
+    options,
+  ));
+}
+
+async function $do(
+  client: GleanCore,
+  importAgentRequest: components.ImportAgentRequest,
+  agentId: string,
+  locale?: string | undefined,
+  timezoneOffset?: number | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.ImportAgentResponse,
+      | errors.ErrorResponse
+      | GleanBaseError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.ImportAgentRequest = {
+    importAgentRequest: importAgentRequest,
+    agent_id: agentId,
+    locale: locale,
+    timezoneOffset: timezoneOffset,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) => operations.ImportAgentRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = new FormData();
+
+  if (isBlobLike(payload.ImportAgentRequest.bundle)) {
+    const file = payload.ImportAgentRequest.bundle;
+    const blob = await normalizeBlob(file);
+    const name = "name" in file ? (file.name as string) : undefined;
+    appendForm(body, "bundle", blob, name);
+  } else if (isReadableStream(payload.ImportAgentRequest.bundle.content)) {
+    const buffer = await readableStreamToArrayBuffer(
+      payload.ImportAgentRequest.bundle.content,
+    );
+    const contentType =
+      getContentTypeFromFileName(payload.ImportAgentRequest.bundle.fileName)
+      || "application/octet-stream";
+    appendForm(
+      body,
+      "bundle",
+      bytesToBlob(buffer, contentType),
+      payload.ImportAgentRequest.bundle.fileName,
+    );
+  } else {
+    const contentType =
+      getContentTypeFromFileName(payload.ImportAgentRequest.bundle.fileName)
+      || "application/octet-stream";
+    appendForm(
+      body,
+      "bundle",
+      bytesToBlob(payload.ImportAgentRequest.bundle.content, contentType),
+      payload.ImportAgentRequest.bundle.fileName,
+    );
+  }
+  if (payload.ImportAgentRequest.commitMessage !== undefined) {
+    appendForm(body, "commitMessage", payload.ImportAgentRequest.commitMessage);
+  }
+  if (payload.ImportAgentRequest.gitAuthorId !== undefined) {
+    appendForm(body, "gitAuthorId", payload.ImportAgentRequest.gitAuthorId);
+  }
+  if (payload.ImportAgentRequest.gitCommitSha !== undefined) {
+    appendForm(body, "gitCommitSha", payload.ImportAgentRequest.gitCommitSha);
+  }
+  if (payload.ImportAgentRequest.isDraft !== undefined) {
+    appendForm(body, "isDraft", payload.ImportAgentRequest.isDraft);
+  }
+  if (payload.ImportAgentRequest.syncMode !== undefined) {
+    appendForm(body, "syncMode", payload.ImportAgentRequest.syncMode);
+  }
+
+  const pathParams = {
+    agent_id: encodeSimple("agent_id", payload.agent_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/rest/api/v1/agents/{agent_id}/import")(pathParams);
+
+  const query = encodeFormQuery({
+    "locale": payload.locale,
+    "timezoneOffset": payload.timezoneOffset,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiToken);
+  const securityInput = secConfig == null ? {} : { apiToken: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "importAgent",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiToken,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.ImportAgentResponse,
+    | errors.ErrorResponse
+    | GleanBaseError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.ImportAgentResponse$inboundSchema),
+    M.jsonErr(404, errors.ErrorResponse$inboundSchema),
+    M.fail([400, 401, 403, "4XX"]),
+    M.fail([500, "5XX"]),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/clientAgentsRun.ts

@@ -21,6 +21,7 @@ import {
   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 { APICall, APIPromise } from "../types/async.js";
@@ -39,6 +40,7 @@ export function clientAgentsRun(
 ): APIPromise<
   Result<
     components.AgentRunWaitResponse,
+    | errors.UnauthorizedAgentToolsError
     | GleanBaseError
     | ResponseValidationError
     | ConnectionError
@@ -64,6 +66,7 @@ async function $do(
   [
     Result<
       components.AgentRunWaitResponse,
+      | errors.UnauthorizedAgentToolsError
       | GleanBaseError
       | ResponseValidationError
       | ConnectionError
@@ -140,8 +143,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     components.AgentRunWaitResponse,
+    | errors.UnauthorizedAgentToolsError
     | GleanBaseError
     | ResponseValidationError
     | ConnectionError
@@ -152,9 +160,10 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, components.AgentRunWaitResponse$inboundSchema),
-    M.fail([400, 403, 404, 409, 422, "4XX"]),
+    M.jsonErr(422, errors.UnauthorizedAgentToolsError$inboundSchema),
+    M.fail([400, 403, 404, 409, "4XX"]),
     M.fail([500, "5XX"]),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/clientAgentsRunStream.ts

@@ -42,6 +42,7 @@ export function clientAgentsRunStream(
   Result<
     string,
     | errors.ErrorResponse
+    | errors.UnauthorizedAgentToolsError
     | GleanBaseError
     | ResponseValidationError
     | ConnectionError
@@ -68,6 +69,7 @@ async function $do(
     Result<
       string,
       | errors.ErrorResponse
+      | errors.UnauthorizedAgentToolsError
       | GleanBaseError
       | ResponseValidationError
       | ConnectionError
@@ -151,6 +153,7 @@ async function $do(
   const [result] = await M.match<
     string,
     | errors.ErrorResponse
+    | errors.UnauthorizedAgentToolsError
     | GleanBaseError
     | ResponseValidationError
     | ConnectionError
@@ -161,7 +164,8 @@ async function $do(
     | SDKValidationError
   >(
     M.text(200, z.string(), { ctype: "text/event-stream" }),
-    M.jsonErr([404, 409, 422], errors.ErrorResponse$inboundSchema),
+    M.jsonErr([404, 409], errors.ErrorResponse$inboundSchema),
+    M.jsonErr(422, errors.UnauthorizedAgentToolsError$inboundSchema),
     M.fail([400, 403, "4XX"]),
     M.fail([500, "5XX"]),
   )(response, req, { extraFields: responseFields });

package/src/funcs/clientChatRetrieve.ts

@@ -21,6 +21,7 @@ import {
   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 * as operations from "../models/operations/index.js";
@@ -42,6 +43,7 @@ export function clientChatRetrieve(
 ): APIPromise<
   Result<
     components.GetChatResponse,
+    | errors.AccessRequestPermissionDeniedResponseError
     | GleanBaseError
     | ResponseValidationError
     | ConnectionError
@@ -71,6 +73,7 @@ async function $do(
   [
     Result<
       components.GetChatResponse,
+      | errors.AccessRequestPermissionDeniedResponseError
       | GleanBaseError
       | ResponseValidationError
       | ConnectionError
@@ -159,8 +162,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     components.GetChatResponse,
+    | errors.AccessRequestPermissionDeniedResponseError
     | GleanBaseError
     | ResponseValidationError
     | ConnectionError
@@ -171,9 +179,13 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, components.GetChatResponse$inboundSchema),
-    M.fail([400, 401, 403, 429, "4XX"]),
+    M.jsonErr(
+      403,
+      errors.AccessRequestPermissionDeniedResponseError$inboundSchema,
+    ),
+    M.fail([400, 401, 429, "4XX"]),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/clientToolsGetToolServerTools.ts

@@ -0,0 +1,192 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0cafc7bf1212
+ */
+
+import { GleanCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.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 { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * 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.
+ */
+export function clientToolsGetToolServerTools(
+  client: GleanCore,
+  serverId: string,
+  toolNames: Array<string>,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.ToolDefinitionsResponse,
+    | GleanBaseError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    serverId,
+    toolNames,
+    options,
+  ));
+}
+
+async function $do(
+  client: GleanCore,
+  serverId: string,
+  toolNames: Array<string>,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.ToolDefinitionsResponse,
+      | GleanBaseError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.GetToolServerToolsRequest = {
+    serverId: serverId,
+    toolNames: toolNames,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) => operations.GetToolServerToolsRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    serverId: encodeSimple("serverId", payload.serverId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/rest/api/v1/tool-servers/{serverId}/tools")(
+    pathParams,
+  );
+
+  const query = encodeFormQuery({
+    "toolNames": payload.toolNames,
+  }, { explode: false });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiToken);
+  const securityInput = secConfig == null ? {} : { apiToken: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getToolServerTools",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiToken,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    components.ToolDefinitionsResponse,
+    | GleanBaseError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.ToolDefinitionsResponse$inboundSchema),
+    M.fail([400, 401, 404, 429, "4XX"]),
+    M.fail([503, "5XX"]),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/indexingDatasourceStatus.ts

@@ -107,7 +107,7 @@ async function $do(
   );
 
   const headers = new Headers(compactMap({
-    Accept: "application/json; charset=UTF-8",
+    Accept: "application/json",
   }));
 
   const secConfig = await extractSecurity(client._options.apiToken);
@@ -167,9 +167,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, components.DebugDatasourceStatusResponse$inboundSchema, {
-      ctype: "application/json; charset=UTF-8",
-    }),
+    M.json(200, components.DebugDatasourceStatusResponse$inboundSchema),
     M.fail([400, 401, "4XX"]),
     M.fail("5XX"),
   )(response, req);