@gleanwork/api-client 0.18.0 → 0.18.1

package/src/funcs/agentsCreateRun.ts

@@ -47,6 +47,7 @@ export function agentsCreateRun(
 ): APIPromise<
   Result<
     operations.PlatformAgentsCreateRunResponse,
+    | errors.PlatformUnauthorizedAgentToolsProblemError
     | errors.PlatformProblemDetailError
     | GleanBaseError
     | ResponseValidationError
@@ -75,6 +76,7 @@ async function $do(
   [
     Result<
       operations.PlatformAgentsCreateRunResponse,
+      | errors.PlatformUnauthorizedAgentToolsProblemError
       | errors.PlatformProblemDetailError
       | GleanBaseError
       | ResponseValidationError
@@ -173,6 +175,7 @@ async function $do(
 
   const [result] = await M.match<
     operations.PlatformAgentsCreateRunResponse,
+    | errors.PlatformUnauthorizedAgentToolsProblemError
     | errors.PlatformProblemDetailError
     | GleanBaseError
     | ResponseValidationError
@@ -187,6 +190,11 @@ async function $do(
     M.text(200, operations.PlatformAgentsCreateRunResponse$inboundSchema, {
       ctype: "text/event-stream",
     }),
+    M.jsonErr(
+      422,
+      errors.PlatformUnauthorizedAgentToolsProblemError$inboundSchema,
+      { ctype: "application/problem+json" },
+    ),
     M.jsonErr(
       [400, 401, 403, 404, 408, 409, 413, 429],
       errors.PlatformProblemDetailError$inboundSchema,

package/src/funcs/chatCreate.ts

@@ -0,0 +1,189 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0de40a91fd44
+ */
+
+import { GleanCore } from "../core.js";
+import { encodeJSON } 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 * 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 { Result } from "../types/fp.js";
+
+export enum CreateAcceptEnum {
+  applicationJson = "application/json",
+  textEventStream = "text/event-stream",
+}
+
+/**
+ * Create a chat response
+ *
+ * @remarks
+ * Run an assistant turn. Set `stream` to true to receive server-sent events; otherwise the response is a typed JSON response object.
+ */
+export function chatCreate(
+  client: GleanCore,
+  request: components.PlatformChatCreateRequest,
+  options?: RequestOptions & { acceptHeaderOverride?: CreateAcceptEnum },
+): APIPromise<
+  Result<
+    operations.PlatformChatCreateResponse,
+    | errors.PlatformProblemDetailError
+    | GleanBaseError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: GleanCore,
+  request: components.PlatformChatCreateRequest,
+  options?: RequestOptions & { acceptHeaderOverride?: CreateAcceptEnum },
+): Promise<
+  [
+    Result<
+      operations.PlatformChatCreateResponse,
+      | errors.PlatformProblemDetailError
+      | GleanBaseError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => components.PlatformChatCreateRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/api/chat")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: options?.acceptHeaderOverride
+      || "application/json;q=1, text/event-stream;q=0",
+  }));
+
+  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: "platform-chat-create",
+    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,
+    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<
+    operations.PlatformChatCreateResponse,
+    | errors.PlatformProblemDetailError
+    | GleanBaseError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.PlatformChatCreateResponse$inboundSchema),
+    M.text(200, operations.PlatformChatCreateResponse$inboundSchema, {
+      ctype: "text/event-stream",
+    }),
+    M.jsonErr(
+      [400, 401, 403, 404, 408, 413, 422, 429],
+      errors.PlatformProblemDetailError$inboundSchema,
+      { ctype: "application/problem+json" },
+    ),
+    M.jsonErr([500, 503], errors.PlatformProblemDetailError$inboundSchema, {
+      ctype: "application/problem+json",
+    }),
+    M.fail("4XX"),
+    M.fail("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/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 }];
   }