@gleanwork/api-client 0.10.1 → 0.10.5

package/src/models/components/agentsinsightsv2request.ts

@@ -0,0 +1,86 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Period,
+  Period$inboundSchema,
+  Period$Outbound,
+  Period$outboundSchema,
+} from "./period.js";
+
+export type AgentsInsightsV2Request = {
+  /**
+   * IDs of the Agents for which Insights should be returned. An empty array signifies all.
+   */
+  agentIds?: Array<string> | undefined;
+  /**
+   * Departments for which Insights are requested.
+   */
+  departments?: Array<string> | undefined;
+  dayRange?: Period | undefined;
+};
+
+/** @internal */
+export const AgentsInsightsV2Request$inboundSchema: z.ZodType<
+  AgentsInsightsV2Request,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  agentIds: z.array(z.string()).optional(),
+  departments: z.array(z.string()).optional(),
+  dayRange: Period$inboundSchema.optional(),
+});
+
+/** @internal */
+export type AgentsInsightsV2Request$Outbound = {
+  agentIds?: Array<string> | undefined;
+  departments?: Array<string> | undefined;
+  dayRange?: Period$Outbound | undefined;
+};
+
+/** @internal */
+export const AgentsInsightsV2Request$outboundSchema: z.ZodType<
+  AgentsInsightsV2Request$Outbound,
+  z.ZodTypeDef,
+  AgentsInsightsV2Request
+> = z.object({
+  agentIds: z.array(z.string()).optional(),
+  departments: z.array(z.string()).optional(),
+  dayRange: Period$outboundSchema.optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AgentsInsightsV2Request$ {
+  /** @deprecated use `AgentsInsightsV2Request$inboundSchema` instead. */
+  export const inboundSchema = AgentsInsightsV2Request$inboundSchema;
+  /** @deprecated use `AgentsInsightsV2Request$outboundSchema` instead. */
+  export const outboundSchema = AgentsInsightsV2Request$outboundSchema;
+  /** @deprecated use `AgentsInsightsV2Request$Outbound` instead. */
+  export type Outbound = AgentsInsightsV2Request$Outbound;
+}
+
+export function agentsInsightsV2RequestToJSON(
+  agentsInsightsV2Request: AgentsInsightsV2Request,
+): string {
+  return JSON.stringify(
+    AgentsInsightsV2Request$outboundSchema.parse(agentsInsightsV2Request),
+  );
+}
+
+export function agentsInsightsV2RequestFromJSON(
+  jsonString: string,
+): SafeParseResult<AgentsInsightsV2Request, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AgentsInsightsV2Request$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AgentsInsightsV2Request' from JSON`,
+  );
+}

package/src/models/components/digestsection.ts

@@ -35,6 +35,13 @@ export type DigestSection = {
    * Name of the channel (applicable for CHANNEL type sections). Used to display in the frontend.
    */
   channelName?: string | undefined;
+  /**
+   * Channel visibility/type for CHANNEL sections. For Slack this is typically one of
+   *
+   * @remarks
+   * PublicChannel, PrivateChannel. Omit if not applicable or unknown.
+   */
+  channelType?: string | undefined;
   /**
    * Instance identifier for the channel or workspace. Used for constructing channel URLs to display in the frontend.
    */
@@ -59,6 +66,7 @@ export const DigestSection$inboundSchema: z.ZodType<
   type: SectionType$inboundSchema,
   displayName: z.string().optional(),
   channelName: z.string().optional(),
+  channelType: z.string().optional(),
   instanceId: z.string().optional(),
   url: z.string().optional(),
   updates: z.array(DigestUpdate$inboundSchema),
@@ -70,6 +78,7 @@ export type DigestSection$Outbound = {
   type: string;
   displayName?: string | undefined;
   channelName?: string | undefined;
+  channelType?: string | undefined;
   instanceId?: string | undefined;
   url?: string | undefined;
   updates: Array<DigestUpdate$Outbound>;
@@ -85,6 +94,7 @@ export const DigestSection$outboundSchema: z.ZodType<
   type: SectionType$outboundSchema,
   displayName: z.string().optional(),
   channelName: z.string().optional(),
+  channelType: z.string().optional(),
   instanceId: z.string().optional(),
   url: z.string().optional(),
   updates: z.array(DigestUpdate$outboundSchema),

package/src/models/components/index.ts

@@ -16,6 +16,7 @@ export * from "./agentrun.js";
 export * from "./agentruncreate.js";
 export * from "./agentrunwaitresponse.js";
 export * from "./agentschemas.js";
+export * from "./agentsinsightsv2request.js";
 export * from "./aiappactioncounts.js";
 export * from "./aiappsinsightsresponse.js";
 export * from "./aiinsightsresponse.js";
@@ -253,6 +254,8 @@ export * from "./indexuserrequest.js";
 export * from "./inputoptions.js";
 export * from "./insightsagentsrequestoptions.js";
 export * from "./insightsaiapprequestoptions.js";
+export * from "./insightsassistantrequest.js";
+export * from "./insightsoverviewrequest.js";
 export * from "./insightsrequest.js";
 export * from "./insightsresponse.js";
 export * from "./invalidoperatorvalueerror.js";

package/src/models/components/insightsassistantrequest.ts

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Period,
+  Period$inboundSchema,
+  Period$Outbound,
+  Period$outboundSchema,
+} from "./period.js";
+
+export type InsightsAssistantRequest = {
+  /**
+   * Departments for which Insights are requested.
+   */
+  departments?: Array<string> | undefined;
+  dayRange?: Period | undefined;
+};
+
+/** @internal */
+export const InsightsAssistantRequest$inboundSchema: z.ZodType<
+  InsightsAssistantRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  departments: z.array(z.string()).optional(),
+  dayRange: Period$inboundSchema.optional(),
+});
+
+/** @internal */
+export type InsightsAssistantRequest$Outbound = {
+  departments?: Array<string> | undefined;
+  dayRange?: Period$Outbound | undefined;
+};
+
+/** @internal */
+export const InsightsAssistantRequest$outboundSchema: z.ZodType<
+  InsightsAssistantRequest$Outbound,
+  z.ZodTypeDef,
+  InsightsAssistantRequest
+> = z.object({
+  departments: z.array(z.string()).optional(),
+  dayRange: Period$outboundSchema.optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace InsightsAssistantRequest$ {
+  /** @deprecated use `InsightsAssistantRequest$inboundSchema` instead. */
+  export const inboundSchema = InsightsAssistantRequest$inboundSchema;
+  /** @deprecated use `InsightsAssistantRequest$outboundSchema` instead. */
+  export const outboundSchema = InsightsAssistantRequest$outboundSchema;
+  /** @deprecated use `InsightsAssistantRequest$Outbound` instead. */
+  export type Outbound = InsightsAssistantRequest$Outbound;
+}
+
+export function insightsAssistantRequestToJSON(
+  insightsAssistantRequest: InsightsAssistantRequest,
+): string {
+  return JSON.stringify(
+    InsightsAssistantRequest$outboundSchema.parse(insightsAssistantRequest),
+  );
+}
+
+export function insightsAssistantRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<InsightsAssistantRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => InsightsAssistantRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InsightsAssistantRequest' from JSON`,
+  );
+}

package/src/models/components/insightsoverviewrequest.ts

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Period,
+  Period$inboundSchema,
+  Period$Outbound,
+  Period$outboundSchema,
+} from "./period.js";
+
+export type InsightsOverviewRequest = {
+  /**
+   * Departments for which Insights are requested.
+   */
+  departments?: Array<string> | undefined;
+  dayRange?: Period | undefined;
+};
+
+/** @internal */
+export const InsightsOverviewRequest$inboundSchema: z.ZodType<
+  InsightsOverviewRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  departments: z.array(z.string()).optional(),
+  dayRange: Period$inboundSchema.optional(),
+});
+
+/** @internal */
+export type InsightsOverviewRequest$Outbound = {
+  departments?: Array<string> | undefined;
+  dayRange?: Period$Outbound | undefined;
+};
+
+/** @internal */
+export const InsightsOverviewRequest$outboundSchema: z.ZodType<
+  InsightsOverviewRequest$Outbound,
+  z.ZodTypeDef,
+  InsightsOverviewRequest
+> = z.object({
+  departments: z.array(z.string()).optional(),
+  dayRange: Period$outboundSchema.optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace InsightsOverviewRequest$ {
+  /** @deprecated use `InsightsOverviewRequest$inboundSchema` instead. */
+  export const inboundSchema = InsightsOverviewRequest$inboundSchema;
+  /** @deprecated use `InsightsOverviewRequest$outboundSchema` instead. */
+  export const outboundSchema = InsightsOverviewRequest$outboundSchema;
+  /** @deprecated use `InsightsOverviewRequest$Outbound` instead. */
+  export type Outbound = InsightsOverviewRequest$Outbound;
+}
+
+export function insightsOverviewRequestToJSON(
+  insightsOverviewRequest: InsightsOverviewRequest,
+): string {
+  return JSON.stringify(
+    InsightsOverviewRequest$outboundSchema.parse(insightsOverviewRequest),
+  );
+}
+
+export function insightsOverviewRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<InsightsOverviewRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => InsightsOverviewRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InsightsOverviewRequest' from JSON`,
+  );
+}

package/src/models/components/insightsrequest.ts

@@ -7,6 +7,12 @@ import { safeParse } from "../../lib/schemas.js";
 import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AgentsInsightsV2Request,
+  AgentsInsightsV2Request$inboundSchema,
+  AgentsInsightsV2Request$Outbound,
+  AgentsInsightsV2Request$outboundSchema,
+} from "./agentsinsightsv2request.js";
 import {
   InsightsAgentsRequestOptions,
   InsightsAgentsRequestOptions$inboundSchema,
@@ -19,6 +25,18 @@ import {
   InsightsAiAppRequestOptions$Outbound,
   InsightsAiAppRequestOptions$outboundSchema,
 } from "./insightsaiapprequestoptions.js";
+import {
+  InsightsAssistantRequest,
+  InsightsAssistantRequest$inboundSchema,
+  InsightsAssistantRequest$Outbound,
+  InsightsAssistantRequest$outboundSchema,
+} from "./insightsassistantrequest.js";
+import {
+  InsightsOverviewRequest,
+  InsightsOverviewRequest$inboundSchema,
+  InsightsOverviewRequest$Outbound,
+  InsightsOverviewRequest$outboundSchema,
+} from "./insightsoverviewrequest.js";
 import {
   Period,
   Period$inboundSchema,
@@ -28,6 +46,9 @@ import {
 
 export const InsightsRequestCategory = {
   Agents: "AGENTS",
+  AgentUsers: "AGENT_USERS",
+  TopAgents: "TOP_AGENTS",
+  AgentsUsageByDepartment: "AGENTS_USAGE_BY_DEPARTMENT",
   Ai: "AI",
   AiApps: "AI_APPS",
   Announcements: "ANNOUNCEMENTS",
@@ -52,12 +73,23 @@ export const AssistantActivityType = {
 export type AssistantActivityType = ClosedEnum<typeof AssistantActivityType>;
 
 export type InsightsRequest = {
+  overviewRequest?: InsightsOverviewRequest | undefined;
+  assistantRequest?: InsightsAssistantRequest | undefined;
+  agentsRequest?: AgentsInsightsV2Request | undefined;
+  /**
+   * If true, suppresses the generation of per-user Insights in the response. Default is false.
+   */
+  disablePerUserInsights?: boolean | undefined;
   /**
    * Categories of data requested. Request can include single or multiple types.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
-  categories: Array<InsightsRequestCategory>;
+  categories?: Array<InsightsRequestCategory> | undefined;
   /**
    * Departments that the data is requested for. If this is empty, corresponds to whole company.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   departments?: Array<string> | undefined;
   dayRange?: Period | undefined;
@@ -65,12 +97,10 @@ export type InsightsRequest = {
   agentsRequestOptions?: InsightsAgentsRequestOptions | undefined;
   /**
    * Types of activity that should count in the definition of an Assistant Active User. Affects only insights for AI category.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   assistantActivityTypes?: Array<AssistantActivityType> | undefined;
-  /**
-   * If true, suppresses the generation of per-user Insights in the response. Default is false.
-   */
-  disablePerUserInsights?: boolean | undefined;
 };
 
 /** @internal */
@@ -121,25 +151,31 @@ export const InsightsRequest$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  categories: z.array(InsightsRequestCategory$inboundSchema),
+  overviewRequest: InsightsOverviewRequest$inboundSchema.optional(),
+  assistantRequest: InsightsAssistantRequest$inboundSchema.optional(),
+  agentsRequest: AgentsInsightsV2Request$inboundSchema.optional(),
+  disablePerUserInsights: z.boolean().optional(),
+  categories: z.array(InsightsRequestCategory$inboundSchema).optional(),
   departments: z.array(z.string()).optional(),
   dayRange: Period$inboundSchema.optional(),
   aiAppRequestOptions: InsightsAiAppRequestOptions$inboundSchema.optional(),
   agentsRequestOptions: InsightsAgentsRequestOptions$inboundSchema.optional(),
   assistantActivityTypes: z.array(AssistantActivityType$inboundSchema)
     .optional(),
-  disablePerUserInsights: z.boolean().optional(),
 });
 
 /** @internal */
 export type InsightsRequest$Outbound = {
-  categories: Array<string>;
+  overviewRequest?: InsightsOverviewRequest$Outbound | undefined;
+  assistantRequest?: InsightsAssistantRequest$Outbound | undefined;
+  agentsRequest?: AgentsInsightsV2Request$Outbound | undefined;
+  disablePerUserInsights?: boolean | undefined;
+  categories?: Array<string> | undefined;
   departments?: Array<string> | undefined;
   dayRange?: Period$Outbound | undefined;
   aiAppRequestOptions?: InsightsAiAppRequestOptions$Outbound | undefined;
   agentsRequestOptions?: InsightsAgentsRequestOptions$Outbound | undefined;
   assistantActivityTypes?: Array<string> | undefined;
-  disablePerUserInsights?: boolean | undefined;
 };
 
 /** @internal */
@@ -148,14 +184,17 @@ export const InsightsRequest$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   InsightsRequest
 > = z.object({
-  categories: z.array(InsightsRequestCategory$outboundSchema),
+  overviewRequest: InsightsOverviewRequest$outboundSchema.optional(),
+  assistantRequest: InsightsAssistantRequest$outboundSchema.optional(),
+  agentsRequest: AgentsInsightsV2Request$outboundSchema.optional(),
+  disablePerUserInsights: z.boolean().optional(),
+  categories: z.array(InsightsRequestCategory$outboundSchema).optional(),
   departments: z.array(z.string()).optional(),
   dayRange: Period$outboundSchema.optional(),
   aiAppRequestOptions: InsightsAiAppRequestOptions$outboundSchema.optional(),
   agentsRequestOptions: InsightsAgentsRequestOptions$outboundSchema.optional(),
   assistantActivityTypes: z.array(AssistantActivityType$outboundSchema)
     .optional(),
-  disablePerUserInsights: z.boolean().optional(),
 });
 
 /**

package/src/react-query/clientInsightsRetrieve.ts

@@ -24,10 +24,10 @@ export type ClientInsightsRetrieveMutationVariables = {
 export type ClientInsightsRetrieveMutationData = components.InsightsResponse;
 
 /**
- * Read insights
+ * Get insights
  *
  * @remarks
- * Reads the aggregate information for each user, query, and content.
+ * Gets the aggregate usage insights data displayed in the Insights Dashboards.
  */
 export function useClientInsightsRetrieveMutation(
   options?: MutationHookOptions<

package/src/sdk/insights.ts

@@ -9,10 +9,10 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class Insights extends ClientSDK {
   /**
-   * Read insights
+   * Get insights
    *
    * @remarks
-   * Reads the aggregate information for each user, query, and content.
+   * Gets the aggregate usage insights data displayed in the Insights Dashboards.
    */
   async retrieve(
     request: components.InsightsRequest,