@transcend-io/mcp-server-assessment 1.0.0 → 2.0.1

package/dist/{graphql-CVDHC_6x.mjs → graphql-D1ksNLBL.mjs}

@@ -1,4 +1,4 @@
-import { OffsetPaginationSchema, TranscendGraphQLBase, createListResult, createToolResult, defineTool, derivePageInfo, z } from "@transcend-io/mcp-server-base";
+import { OffsetPaginationSchema, TranscendGraphQLBase, assertOffsetInRange, createListResult, createToolResult, defineTool, derivePageInfo, describeNoMatches, z } from "@transcend-io/mcp-server-base";
 import { AssessmentFormStatus, AssessmentFormTemplateStatus, ScopeName } from "@transcend-io/privacy-types";
 //#region src/tools/assessments_add_section.ts
 const AddSectionSchema = z.object({
@@ -100,7 +100,7 @@ async function resolveTemplateToGroupId(graphql, templateId) {
 const CreateAssessmentSchema = z.object({
 	title: z.string().describe("Title of the assessment"),
 	assessmentGroupId: z.string().optional().describe("ID of the assessment group to create the assessment in (preferred). Use assessments_list_groups to find available groups."),
-	templateId: z.string().optional().describe("ID of the assessment template. If assessmentGroupId is not provided, the first group using this template will be used."),
+	templateId: z.string().optional().describe("Fallback for when no group is known. Lands the assessment in whichever group happens to be first among those built from this template, so never use it when the user named a group."),
 	assigneeIds: z.array(z.string()).optional().describe("Array of user IDs to assign the assessment to")
 });
 function createAssessmentsCreateTool(clients) {
@@ -108,7 +108,7 @@ function createAssessmentsCreateTool(clients) {
 	const { dashboardUrl } = clients;
 	return defineTool({
 		name: "assessments_create",
-		description: "Create a new privacy assessment within an assessment group. Assessment groups are linked to templates. You can provide either an assessmentGroupId directly, or a templateId to auto-resolve the first matching group. Use assessments_list_groups to find available groups. Surface the returned `url` verbatim; never build assessment URLs from IDs.",
+		description: "Create a new privacy assessment inside an assessment group. Prefer assessmentGroupId, resolved by name through assessments_list_groups. templateId is a fallback that lands in whichever group happens to be first among those built from that template, so never use it when the user named a particular group. Surface the returned `url` verbatim; never build assessment URLs from IDs.",
 		category: "Assessments",
 		readOnly: false,
 		annotations: {
@@ -303,13 +303,52 @@ function createAssessmentsGetTool(clients) {
 //#endregion
 //#region src/tools/assessments_list.ts
 const AssessmentStatusEnum = z.nativeEnum(AssessmentFormStatus);
-const ListAssessmentsSchema = z.object({ status: AssessmentStatusEnum.optional().describe("Filter by assessment status") }).merge(OffsetPaginationSchema);
+/**
+* Accepts a bare date or a full timestamp, since the GraphQL `Date` scalar
+* takes both and callers phrase deadlines either way.
+*/
+const isoDate = (field) => z.string().regex(/^\d{4}-\d{2}-\d{2}([T ].*)?$/, { message: `${field} must be an ISO 8601 date, e.g. 2026-01-31 or 2026-01-31T00:00:00Z` }).optional();
+/**
+* An optional list filter that rejects `[]`.
+*
+* Empty arrays are dropped during filter assembly, so a caller that resolved a
+* lookup to nothing and passed the result through would have its filter read as
+* "no filter given" and get back every assessment in the organization — the
+* widest possible answer to a query that should have matched none.
+*/
+const idList = (description) => z.array(z.string()).min(1, { message: "Pass at least one value, or omit the filter entirely." }).optional().describe(description);
+/** Caller-facing sort names mapped onto `AssessmentFormRawOrderField`. */
+const SORT_FIELDS = {
+	title: "title",
+	status: "statusRank",
+	submittedAt: "submittedAt"
+};
+const ListAssessmentsSchema = z.object({
+	statuses: z.array(AssessmentStatusEnum).min(1, { message: "Pass at least one status, or omit the filter entirely." }).optional().describe("Lifecycle statuses to include. Omit for every status."),
+	text: z.string().optional().describe("Free-text match on the assessment title"),
+	ids: idList("Specific assessment form IDs to fetch"),
+	assigneeIds: idList("Transcend user IDs the form is assigned to. Resolve names with `admin_list_users`."),
+	reviewerIds: idList("Transcend user IDs reviewing the form. Resolve names with `admin_list_users`."),
+	externalAssigneeEmails: idList("Email addresses of external (vendor) assignees"),
+	assessmentGroupIds: idList("Groups the forms belong to; see `assessments_list_groups`"),
+	createdAfter: isoDate("createdAfter").describe("Only forms created strictly after this date"),
+	createdBefore: isoDate("createdBefore").describe("Only forms created on or before this date"),
+	dueAfter: isoDate("dueAfter").describe("Only forms due strictly after this date"),
+	dueBefore: isoDate("dueBefore").describe("Only forms due on or before this date. Use for overdue."),
+	sortBy: z.enum([
+		"title",
+		"status",
+		"submittedAt"
+	], { message: "sortBy must be one of: title, status, submittedAt" }).optional().describe("Column to sort on; the API offers no creation-date sort. Omit for its default order."),
+	sortDirection: z.enum(["ASC", "DESC"], { message: "sortDirection must be ASC or DESC" }).optional().default("ASC").describe("Sort direction. Only applied alongside `sortBy`."),
+	includeDetails: z.boolean().optional().default(false).describe("Also return assignees, reviewers, due/updated/submitted dates and lock state.")
+}).merge(OffsetPaginationSchema);
 function createAssessmentsListTool(clients) {
 	const graphql = clients.graphql;
 	const { dashboardUrl } = clients;
 	return defineTool({
 		name: "assessments_list",
-		description: "List all privacy assessments in your organization. Supports filtering by status. Surface the `url` on each row verbatim; never build assessment URLs from IDs.",
+		description: "List all assessments in your organization. Surface the `url` on each row verbatim; never build assessment URLs from IDs.",
 		category: "Assessments",
 		readOnly: true,
 		annotations: {
@@ -318,34 +357,94 @@ function createAssessmentsListTool(clients) {
 			idempotentHint: true
 		},
 		zodSchema: ListAssessmentsSchema,
-		handler: async ({ status, limit, offset }) => {
+		handler: async ({ statuses, text, ids, assigneeIds, reviewerIds, externalAssigneeEmails, assessmentGroupIds, createdAfter, createdBefore, dueAfter, dueBefore, sortBy, sortDirection, includeDetails, limit, offset }) => {
+			const filterBy = {
+				...statuses?.length && { statuses },
+				...text && { text },
+				...ids?.length && { ids },
+				...assigneeIds?.length && { assigneeIds },
+				...reviewerIds?.length && { reviewerIds },
+				...externalAssigneeEmails?.length && { externalAssigneeEmails },
+				...assessmentGroupIds?.length && { assessmentGroupIds },
+				...createdAfter && { createdAtAfter: createdAfter },
+				...createdBefore && { createdAtBefore: createdBefore },
+				...dueAfter && { dueDateAfter: dueAfter },
+				...dueBefore && { dueDateBefore: dueBefore }
+			};
+			const appliedFilters = Object.entries({
+				statuses: statuses?.length,
+				text,
+				ids: ids?.length,
+				assigneeIds: assigneeIds?.length,
+				reviewerIds: reviewerIds?.length,
+				externalAssigneeEmails: externalAssigneeEmails?.length,
+				assessmentGroupIds: assessmentGroupIds?.length,
+				createdAfter,
+				createdBefore,
+				dueAfter,
+				dueBefore
+			}).filter(([, value]) => Boolean(value)).map(([name]) => name);
 			const result = await graphql.listAssessments({
 				first: limit,
 				offset,
-				filterBy: status ? { statuses: [status] } : void 0
+				filterBy,
+				includeDetails,
+				...sortBy && {
+					sortField: SORT_FIELDS[sortBy],
+					sortDirection
+				}
+			});
+			const totalCount = result.totalCount ?? 0;
+			assertOffsetInRange({
+				subject: "assessment",
+				offset,
+				totalCount,
+				appliedFilters
 			});
-			return createListResult(result.nodes.map((node) => ({
+			const nodesWithLinks = result.nodes.map((node) => ({
 				...node,
 				...buildAssessmentLinks({
 					dashboardUrl,
 					assessmentFormId: node.id
 				})
-			})), {
-				totalCount: result.totalCount,
-				hasNextPage: result.pageInfo?.hasNextPage
+			}));
+			return createListResult(nodesWithLinks, {
+				totalCount,
+				hasNextPage: result.pageInfo?.hasNextPage,
+				paginationNote: describeOutcome({
+					returned: nodesWithLinks.length,
+					totalCount,
+					offset,
+					limit,
+					appliedFilters
+				})
 			});
 		}
 	});
 }
+/**
+* Tells the caller which of three situations it is in: nothing matched, more
+* pages remain, or this is everything. Without this an empty `data` array reads
+* the same as a filter typo, and the agent reports "no assessments" to the user.
+*/
+function describeOutcome({ returned, totalCount, offset, limit, appliedFilters }) {
+	if (totalCount === 0) return describeNoMatches("assessments", appliedFilters);
+	if (offset + returned < totalCount) return `Showing ${returned} of ${totalCount} matches. Fetch the next page with offset ${offset + limit}.`;
+	return offset === 0 ? `Showing all ${returned} match${returned === 1 ? "" : "es"}. No further pages.` : `Showing the last ${returned} of ${totalCount} matches. No further pages.`;
+}
 //#endregion
 //#region src/tools/assessments_list_groups.ts
-const ListGroupsSchema = OffsetPaginationSchema;
+const ListGroupsSchema = OffsetPaginationSchema.extend({
+	text: z.string().optional().describe("Free-text match on the group title and description"),
+	ids: z.array(z.string()).min(1, { message: "Pass at least one group ID, or omit the filter entirely." }).optional().describe("Specific group IDs, e.g. the `assessmentGroupId` on an `assessments_list` row"),
+	templateIds: z.array(z.string()).min(1, { message: "Pass at least one template ID, or omit the filter entirely." }).optional().describe("Groups built from these templates; see `assessments_list_templates`")
+});
 function createAssessmentsListGroupsTool(clients) {
 	const graphql = clients.graphql;
 	const { dashboardUrl } = clients;
 	return defineTool({
 		name: "assessments_list_groups",
-		description: "List all assessment groups. Groups are containers for assessments and are linked to templates. Use this to find the right group ID for creating assessments. Surface the `groupUrl` on each row verbatim.",
+		description: "List all assessment groups. Groups are containers for assessments and are linked to templates. Use this to find the right group ID for creating assessments. To reach the template behind a form, pass its `assessmentGroupId` as `ids` and read `assessmentFormTemplate`. Surface the `groupUrl` on each row verbatim.",
 		category: "Assessments",
 		readOnly: true,
 		annotations: {
@@ -354,29 +453,52 @@ function createAssessmentsListGroupsTool(clients) {
 			idempotentHint: true
 		},
 		zodSchema: ListGroupsSchema,
-		handler: async ({ limit, offset }) => {
+		handler: async ({ limit, offset, text, ids, templateIds }) => {
 			const result = await graphql.listAssessmentGroups({
 				first: limit,
-				offset
+				offset,
+				filterBy: {
+					...text && { text },
+					...ids?.length && { ids },
+					...templateIds?.length && { templateIds }
+				}
 			});
-			return createListResult(result.nodes.map((node) => ({
+			const nodesWithLinks = result.nodes.map((node) => ({
 				...node,
 				groupUrl: buildAssessmentGroupUrl(dashboardUrl, node.id)
-			})), {
+			}));
+			const appliedFilters = Object.entries({
+				text,
+				ids: ids?.length,
+				templateIds: templateIds?.length
+			}).filter(([, value]) => Boolean(value)).map(([name]) => name);
+			const totalCount = result.totalCount ?? 0;
+			assertOffsetInRange({
+				subject: "assessment group",
+				offset,
+				totalCount,
+				appliedFilters
+			});
+			return createListResult(nodesWithLinks, {
 				totalCount: result.totalCount,
-				hasNextPage: result.pageInfo?.hasNextPage
+				hasNextPage: result.pageInfo?.hasNextPage,
+				...totalCount === 0 && { paginationNote: describeNoMatches("assessment groups", appliedFilters) }
 			});
 		}
 	});
 }
 //#endregion
 //#region src/tools/assessments_list_templates.ts
-const ListTemplatesSchema = OffsetPaginationSchema;
+const ListTemplatesSchema = OffsetPaginationSchema.extend({
+	text: z.string().optional().describe("Free-text match on the template title and description"),
+	ids: z.array(z.string()).min(1, { message: "Pass at least one template ID, or omit the filter entirely." }).optional().describe("Specific template IDs to fetch"),
+	statuses: z.array(z.enum(["DRAFT", "PUBLISHED"])).min(1, { message: "Pass at least one status, or omit the filter entirely." }).optional().describe("Publication statuses to include. Omit for both.")
+});
 function createAssessmentsListTemplatesTool(clients) {
 	const graphql = clients.graphql;
 	return defineTool({
 		name: "assessments_list_templates",
-		description: "List the blank assessment templates available to build new assessments from.",
+		description: "List the blank assessment templates. Only `PUBLISHED` ones can build new assessments.",
 		category: "Assessments",
 		readOnly: true,
 		annotations: {
@@ -385,14 +507,32 @@ function createAssessmentsListTemplatesTool(clients) {
 			idempotentHint: true
 		},
 		zodSchema: ListTemplatesSchema,
-		handler: async ({ limit, offset }) => {
+		handler: async ({ limit, offset, text, ids, statuses }) => {
 			const result = await graphql.listAssessmentTemplates({
 				first: limit,
-				offset
+				offset,
+				filterBy: {
+					...text && { text },
+					...ids?.length && { ids },
+					...statuses?.length && { statuses }
+				}
+			});
+			const appliedFilters = Object.entries({
+				text,
+				ids: ids?.length,
+				statuses: statuses?.length
+			}).filter(([, value]) => Boolean(value)).map(([name]) => name);
+			const totalCount = result.totalCount ?? 0;
+			assertOffsetInRange({
+				subject: "template",
+				offset,
+				totalCount,
+				appliedFilters
 			});
 			return createListResult(result.nodes, {
 				totalCount: result.totalCount,
-				hasNextPage: result.pageInfo?.hasNextPage
+				hasNextPage: result.pageInfo?.hasNextPage,
+				...totalCount === 0 && { paginationNote: describeNoMatches("templates", appliedFilters) }
 			});
 		}
 	});
@@ -401,9 +541,9 @@ function createAssessmentsListTemplatesTool(clients) {
 //#region src/tools/assessments_prefill.ts
 const PrefillSchema = z.object({
 	title: z.string().describe("Title for the new assessment form"),
-	templateId: z.string().optional().describe("Template ID to create the form from. Will auto-resolve to the first matching assessment group."),
-	assessmentGroupId: z.string().optional().describe("Assessment group ID (alternative to templateId)"),
-	answers: z.record(z.string(), z.union([z.string(), z.array(z.string())])).describe("Map of answers keyed by question title or referenceId. Values should be strings for text/single-select, or arrays of strings for multi-select."),
+	templateId: z.string().optional().describe("Fallback for when no group is known. Lands the form in whichever group happens to be first among those built from this template, so never use it when the user named a group."),
+	assessmentGroupId: z.string().optional().describe("Group to create the form in (preferred). Resolve by name with `assessments_list_groups`."),
+	answers: z.record(z.string(), z.union([z.string(), z.array(z.string())])).describe("Map of answers keyed by question title or referenceId, both of which come from assessments_export_template on the template you are creating from. A string for text and single-select, an array for multi-select. Select answers must match the option text exactly."),
 	assigneeIds: z.array(z.string()).optional().describe("Internal user IDs to assign the form to (optional)"),
 	assigneeEmails: z.array(z.string()).optional().describe("External email addresses to assign the form to (optional)"),
 	reviewerIds: z.array(z.string()).optional().describe("User IDs to set as reviewers (optional)"),
@@ -413,7 +553,7 @@ function createAssessmentsPrefillTool(clients) {
 	const graphql = clients.graphql;
 	return defineTool({
 		name: "assessments_prefill",
-		description: "Convenience tool: Create a new assessment form, AI-prefill all the answers, and assign it to a reviewer. Combines: create form → get questions → answer each question → assign reviewers → optionally submit for review. Provide answers as a map of {questionTitle: answer} or {referenceId: answer}. For SINGLE_SELECT/MULTI_SELECT, the answer should match the exact text of the answer option(s). For text questions, provide the free-text answer string. For multi-select, provide an array of answer option values.",
+		description: "Create an assessment form, fill in the answers you supply, and assign it for review in one call. Combines: create form → read its questions → answer each → assign reviewers → optionally submit. The answers are yours to provide; nothing is generated for you.",
 		category: "Assessments",
 		readOnly: false,
 		annotations: {
@@ -711,7 +851,7 @@ const ASSESSMENT_OAUTH_SCOPES = [
 //#endregion
 //#region src/__generated__/gql.ts
 const documents = {
-	"\n  query AssessmentsList($first: Int, $offset: Int, $filterBy: AssessmentFormFiltersInput) {\n    assessmentForms(first: $first, offset: $offset, filterBy: $filterBy) {\n      nodes {\n        id\n        title\n        status\n        createdAt\n        assessmentGroup {\n          id\n        }\n      }\n      totalCount\n    }\n  }\n": {
+	"\n  query AssessmentsList(\n    $first: Int\n    $offset: Int\n    $filterBy: AssessmentFormFiltersInput\n    $orderBy: [AssessmentFormRawOrder!]\n    $includeDetails: Boolean!\n  ) {\n    assessmentForms(first: $first, offset: $offset, filterBy: $filterBy, orderBy: $orderBy) {\n      nodes {\n        id\n        title\n        status\n        createdAt\n        assessmentGroup {\n          id\n          title\n        }\n        dueDate @include(if: $includeDetails)\n        updatedAt @include(if: $includeDetails)\n        submittedAt @include(if: $includeDetails)\n        isArchived @include(if: $includeDetails)\n        isLocked @include(if: $includeDetails)\n        assignees @include(if: $includeDetails) {\n          id\n          name\n          email\n        }\n        reviewers @include(if: $includeDetails) {\n          id\n          name\n          email\n        }\n        externalAssignees @include(if: $includeDetails) {\n          id\n          email\n        }\n      }\n      totalCount\n    }\n  }\n": {
 		"kind": "Document",
 		"definitions": [{
 			"kind": "OperationDefinition",
@@ -771,6 +911,49 @@ const documents = {
 							"value": "AssessmentFormFiltersInput"
 						}
 					}
+				},
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "orderBy"
+						}
+					},
+					"type": {
+						"kind": "ListType",
+						"type": {
+							"kind": "NonNullType",
+							"type": {
+								"kind": "NamedType",
+								"name": {
+									"kind": "Name",
+									"value": "AssessmentFormRawOrder"
+								}
+							}
+						}
+					}
+				},
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "includeDetails"
+						}
+					},
+					"type": {
+						"kind": "NonNullType",
+						"type": {
+							"kind": "NamedType",
+							"name": {
+								"kind": "Name",
+								"value": "Boolean"
+							}
+						}
+					}
 				}
 			],
 			"selectionSet": {
@@ -823,6 +1006,20 @@ const documents = {
 									"value": "filterBy"
 								}
 							}
+						},
+						{
+							"kind": "Argument",
+							"name": {
+								"kind": "Name",
+								"value": "orderBy"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "orderBy"
+								}
+							}
 						}
 					],
 					"selectionSet": {
@@ -878,6 +1075,304 @@ const documents = {
 													"kind": "Name",
 													"value": "id"
 												}
+											}, {
+												"kind": "Field",
+												"name": {
+													"kind": "Name",
+													"value": "title"
+												}
+											}]
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "dueDate"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}]
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "updatedAt"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}]
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "submittedAt"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}]
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "isArchived"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}]
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "isLocked"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}]
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "assignees"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}],
+										"selectionSet": {
+											"kind": "SelectionSet",
+											"selections": [
+												{
+													"kind": "Field",
+													"name": {
+														"kind": "Name",
+														"value": "id"
+													}
+												},
+												{
+													"kind": "Field",
+													"name": {
+														"kind": "Name",
+														"value": "name"
+													}
+												},
+												{
+													"kind": "Field",
+													"name": {
+														"kind": "Name",
+														"value": "email"
+													}
+												}
+											]
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "reviewers"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}],
+										"selectionSet": {
+											"kind": "SelectionSet",
+											"selections": [
+												{
+													"kind": "Field",
+													"name": {
+														"kind": "Name",
+														"value": "id"
+													}
+												},
+												{
+													"kind": "Field",
+													"name": {
+														"kind": "Name",
+														"value": "name"
+													}
+												},
+												{
+													"kind": "Field",
+													"name": {
+														"kind": "Name",
+														"value": "email"
+													}
+												}
+											]
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "externalAssignees"
+										},
+										"directives": [{
+											"kind": "Directive",
+											"name": {
+												"kind": "Name",
+												"value": "include"
+											},
+											"arguments": [{
+												"kind": "Argument",
+												"name": {
+													"kind": "Name",
+													"value": "if"
+												},
+												"value": {
+													"kind": "Variable",
+													"name": {
+														"kind": "Name",
+														"value": "includeDetails"
+													}
+												}
+											}]
+										}],
+										"selectionSet": {
+											"kind": "SelectionSet",
+											"selections": [{
+												"kind": "Field",
+												"name": {
+													"kind": "Name",
+													"value": "id"
+												}
+											}, {
+												"kind": "Field",
+												"name": {
+													"kind": "Name",
+													"value": "email"
+												}
 											}]
 										}
 									}
@@ -1413,7 +1908,7 @@ const documents = {
 			}
 		}]
 	},
-	"\n  query AssessmentsListGroups($first: Int, $offset: Int) {\n    assessmentGroups(first: $first, offset: $offset) {\n      nodes {\n        id\n        title\n        assessmentFormTemplate {\n          id\n          title\n        }\n      }\n      totalCount\n    }\n  }\n": {
+	"\n  query AssessmentsListGroups($first: Int, $offset: Int, $filterBy: AssessmentGroupFiltersInput) {\n    assessmentGroups(first: $first, offset: $offset, filterBy: $filterBy) {\n      nodes {\n        id\n        title\n        description\n        assessmentFormTemplate {\n          id\n          title\n        }\n      }\n      totalCount\n    }\n  }\n": {
 		"kind": "Document",
 		"definitions": [{
 			"kind": "OperationDefinition",
@@ -1422,39 +1917,59 @@ const documents = {
 				"kind": "Name",
 				"value": "AssessmentsListGroups"
 			},
-			"variableDefinitions": [{
-				"kind": "VariableDefinition",
-				"variable": {
-					"kind": "Variable",
-					"name": {
-						"kind": "Name",
-						"value": "first"
+			"variableDefinitions": [
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "first"
+						}
+					},
+					"type": {
+						"kind": "NamedType",
+						"name": {
+							"kind": "Name",
+							"value": "Int"
+						}
 					}
 				},
-				"type": {
-					"kind": "NamedType",
-					"name": {
-						"kind": "Name",
-						"value": "Int"
-					}
-				}
-			}, {
-				"kind": "VariableDefinition",
-				"variable": {
-					"kind": "Variable",
-					"name": {
-						"kind": "Name",
-						"value": "offset"
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "offset"
+						}
+					},
+					"type": {
+						"kind": "NamedType",
+						"name": {
+							"kind": "Name",
+							"value": "Int"
+						}
 					}
 				},
-				"type": {
-					"kind": "NamedType",
-					"name": {
-						"kind": "Name",
-						"value": "Int"
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "filterBy"
+						}
+					},
+					"type": {
+						"kind": "NamedType",
+						"name": {
+							"kind": "Name",
+							"value": "AssessmentGroupFiltersInput"
+						}
 					}
 				}
-			}],
+			],
 			"selectionSet": {
 				"kind": "SelectionSet",
 				"selections": [{
@@ -1463,33 +1978,50 @@ const documents = {
 						"kind": "Name",
 						"value": "assessmentGroups"
 					},
-					"arguments": [{
-						"kind": "Argument",
-						"name": {
-							"kind": "Name",
-							"value": "first"
-						},
-						"value": {
-							"kind": "Variable",
+					"arguments": [
+						{
+							"kind": "Argument",
 							"name": {
 								"kind": "Name",
 								"value": "first"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "first"
+								}
 							}
-						}
-					}, {
-						"kind": "Argument",
-						"name": {
-							"kind": "Name",
-							"value": "offset"
 						},
-						"value": {
-							"kind": "Variable",
+						{
+							"kind": "Argument",
 							"name": {
 								"kind": "Name",
 								"value": "offset"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "offset"
+								}
+							}
+						},
+						{
+							"kind": "Argument",
+							"name": {
+								"kind": "Name",
+								"value": "filterBy"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "filterBy"
+								}
 							}
 						}
-					}],
+					],
 					"selectionSet": {
 						"kind": "SelectionSet",
 						"selections": [{
@@ -1515,6 +2047,13 @@ const documents = {
 											"value": "title"
 										}
 									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "description"
+										}
+									},
 									{
 										"kind": "Field",
 										"name": {
@@ -1860,7 +2399,7 @@ const documents = {
 			}
 		}]
 	},
-	"\n  query AssessmentsListTemplates($first: Int, $offset: Int) {\n    assessmentFormTemplates(first: $first, offset: $offset) {\n      nodes {\n        id\n        title\n        description\n      }\n      totalCount\n    }\n  }\n": {
+	"\n  query AssessmentsListTemplates(\n    $first: Int\n    $offset: Int\n    $filterBy: AssessmentFormTemplateFiltersInput\n  ) {\n    assessmentFormTemplates(first: $first, offset: $offset, filterBy: $filterBy) {\n      nodes {\n        id\n        title\n        description\n        status\n        source\n        isArchived\n        createdAt\n        updatedAt\n      }\n      totalCount\n    }\n  }\n": {
 		"kind": "Document",
 		"definitions": [{
 			"kind": "OperationDefinition",
@@ -1869,39 +2408,59 @@ const documents = {
 				"kind": "Name",
 				"value": "AssessmentsListTemplates"
 			},
-			"variableDefinitions": [{
-				"kind": "VariableDefinition",
-				"variable": {
-					"kind": "Variable",
-					"name": {
-						"kind": "Name",
-						"value": "first"
+			"variableDefinitions": [
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "first"
+						}
+					},
+					"type": {
+						"kind": "NamedType",
+						"name": {
+							"kind": "Name",
+							"value": "Int"
+						}
 					}
 				},
-				"type": {
-					"kind": "NamedType",
-					"name": {
-						"kind": "Name",
-						"value": "Int"
-					}
-				}
-			}, {
-				"kind": "VariableDefinition",
-				"variable": {
-					"kind": "Variable",
-					"name": {
-						"kind": "Name",
-						"value": "offset"
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "offset"
+						}
+					},
+					"type": {
+						"kind": "NamedType",
+						"name": {
+							"kind": "Name",
+							"value": "Int"
+						}
 					}
 				},
-				"type": {
-					"kind": "NamedType",
-					"name": {
-						"kind": "Name",
-						"value": "Int"
+				{
+					"kind": "VariableDefinition",
+					"variable": {
+						"kind": "Variable",
+						"name": {
+							"kind": "Name",
+							"value": "filterBy"
+						}
+					},
+					"type": {
+						"kind": "NamedType",
+						"name": {
+							"kind": "Name",
+							"value": "AssessmentFormTemplateFiltersInput"
+						}
 					}
 				}
-			}],
+			],
 			"selectionSet": {
 				"kind": "SelectionSet",
 				"selections": [{
@@ -1910,33 +2469,50 @@ const documents = {
 						"kind": "Name",
 						"value": "assessmentFormTemplates"
 					},
-					"arguments": [{
-						"kind": "Argument",
-						"name": {
-							"kind": "Name",
-							"value": "first"
-						},
-						"value": {
-							"kind": "Variable",
+					"arguments": [
+						{
+							"kind": "Argument",
 							"name": {
 								"kind": "Name",
 								"value": "first"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "first"
+								}
 							}
-						}
-					}, {
-						"kind": "Argument",
-						"name": {
-							"kind": "Name",
-							"value": "offset"
 						},
-						"value": {
-							"kind": "Variable",
+						{
+							"kind": "Argument",
 							"name": {
 								"kind": "Name",
 								"value": "offset"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "offset"
+								}
+							}
+						},
+						{
+							"kind": "Argument",
+							"name": {
+								"kind": "Name",
+								"value": "filterBy"
+							},
+							"value": {
+								"kind": "Variable",
+								"name": {
+									"kind": "Name",
+									"value": "filterBy"
+								}
 							}
 						}
-					}],
+					],
 					"selectionSet": {
 						"kind": "SelectionSet",
 						"selections": [{
@@ -1968,6 +2544,41 @@ const documents = {
 											"kind": "Name",
 											"value": "description"
 										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "status"
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "source"
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "isArchived"
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "createdAt"
+										}
+									},
+									{
+										"kind": "Field",
+										"name": {
+											"kind": "Name",
+											"value": "updatedAt"
+										}
 									}
 								]
 							}
@@ -2821,9 +3432,24 @@ function normalizeQuestion(q) {
 		...q.displayLogic && { displayLogic: q.displayLogic }
 	};
 }
+/**
+* Assessment index. `AssessmentFormsPayload` exposes `totalCount` but no
+* `pageInfo`, so paging is offset-based and `hasNextPage` has to be derived
+* from `offset + nodes.length < totalCount`.
+*
+* The people, dates and lock state behind `@include(if: $includeDetails)`
+* roughly triple the bytes per row, so a caller who only wants titles and
+* statuses does not pay for them.
+*/
 const ListAssessmentsDoc = graphql(`
-  query AssessmentsList($first: Int, $offset: Int, $filterBy: AssessmentFormFiltersInput) {
-    assessmentForms(first: $first, offset: $offset, filterBy: $filterBy) {
+  query AssessmentsList(
+    $first: Int
+    $offset: Int
+    $filterBy: AssessmentFormFiltersInput
+    $orderBy: [AssessmentFormRawOrder!]
+    $includeDetails: Boolean!
+  ) {
+    assessmentForms(first: $first, offset: $offset, filterBy: $filterBy, orderBy: $orderBy) {
       nodes {
         id
         title
@@ -2831,6 +3457,26 @@ const ListAssessmentsDoc = graphql(`
         createdAt
         assessmentGroup {
           id
+          title
+        }
+        dueDate @include(if: $includeDetails)
+        updatedAt @include(if: $includeDetails)
+        submittedAt @include(if: $includeDetails)
+        isArchived @include(if: $includeDetails)
+        isLocked @include(if: $includeDetails)
+        assignees @include(if: $includeDetails) {
+          id
+          name
+          email
+        }
+        reviewers @include(if: $includeDetails) {
+          id
+          name
+          email
+        }
+        externalAssignees @include(if: $includeDetails) {
+          id
+          email
         }
       }
       totalCount
@@ -2904,11 +3550,12 @@ const UpdateAssessmentFormAssigneesDoc = graphql(`
   }
 `);
 const ListAssessmentGroupsDoc = graphql(`
-  query AssessmentsListGroups($first: Int, $offset: Int) {
-    assessmentGroups(first: $first, offset: $offset) {
+  query AssessmentsListGroups($first: Int, $offset: Int, $filterBy: AssessmentGroupFiltersInput) {
+    assessmentGroups(first: $first, offset: $offset, filterBy: $filterBy) {
       nodes {
         id
         title
+        description
         assessmentFormTemplate {
           id
           title
@@ -2958,12 +3605,21 @@ const UpdateAssessmentFormDoc = graphql(`
   }
 `);
 const ListAssessmentTemplatesDoc = graphql(`
-  query AssessmentsListTemplates($first: Int, $offset: Int) {
-    assessmentFormTemplates(first: $first, offset: $offset) {
+  query AssessmentsListTemplates(
+    $first: Int
+    $offset: Int
+    $filterBy: AssessmentFormTemplateFiltersInput
+  ) {
+    assessmentFormTemplates(first: $first, offset: $offset, filterBy: $filterBy) {
       nodes {
         id
         title
         description
+        status
+        source
+        isArchived
+        createdAt
+        updatedAt
       }
       totalCount
     }
@@ -3072,27 +3728,64 @@ const GetAssessmentFormTemplateDoc = graphql(`
   }
 `);
 var AssessmentsMixin = class extends TranscendGraphQLBase {
+	/**
+	* Page the assessment index. `first`/`offset` map straight onto the query;
+	* `hasNextPage` is derived because the payload carries no `pageInfo`.
+	*
+	* `includeDetails` gates the assignee, reviewer, date and lock fields so the
+	* cheap listing stays cheap.
+	*/
 	async listAssessments(options) {
+		const first = Math.min(options?.first ?? 50, 100);
 		const offset = options?.offset ?? 0;
-		const data = await this.makeRequest(ListAssessmentsDoc, {
-			first: Math.min(options?.first ?? 50, 100),
+		const filterBy = options?.filterBy;
+		const includeDetails = options?.includeDetails ?? false;
+		const { nodes, totalCount } = (await this.makeRequest(ListAssessmentsDoc, {
+			first,
 			offset,
-			filterBy: options?.filterBy?.statuses ? { statuses: options.filterBy.statuses } : null
-		});
+			includeDetails,
+			filterBy: filterBy && Object.keys(filterBy).length > 0 ? filterBy : null,
+			orderBy: options?.sortField ? [{
+				field: options.sortField,
+				direction: options.sortDirection ?? "ASC"
+			}] : null
+		})).assessmentForms;
 		return {
-			nodes: data.assessmentForms.nodes.map((node) => ({
+			nodes: nodes.map((node) => ({
 				id: node.id,
 				title: node.title,
 				status: node.status,
 				createdAt: node.createdAt,
-				assessmentGroupId: node.assessmentGroup?.id
+				assessmentGroupId: node.assessmentGroup?.id,
+				assessmentGroupTitle: node.assessmentGroup?.title,
+				...includeDetails && {
+					dueDate: node.dueDate ?? null,
+					updatedAt: node.updatedAt ?? void 0,
+					submittedAt: node.submittedAt ?? void 0,
+					isArchived: node.isArchived,
+					isLocked: node.isLocked,
+					assignees: node.assignees?.map((user) => ({
+						id: user.id,
+						name: user.name,
+						email: user.email
+					})),
+					reviewers: node.reviewers?.map((user) => ({
+						id: user.id,
+						name: user.name,
+						email: user.email
+					})),
+					externalAssignees: node.externalAssignees?.map((assignee) => ({
+						id: assignee.id,
+						email: assignee.email
+					}))
+				}
 			})),
 			pageInfo: derivePageInfo({
 				offset,
-				nodeCount: data.assessmentForms.nodes.length,
-				totalCount: data.assessmentForms.totalCount
+				nodeCount: nodes.length,
+				totalCount
 			}),
-			totalCount: data.assessmentForms.totalCount
+			totalCount
 		};
 	}
 	async getAssessment(id) {
@@ -3141,16 +3834,24 @@ var AssessmentsMixin = class extends TranscendGraphQLBase {
 	async updateAssessmentFormAssignees(input) {
 		return (await this.makeRequest(UpdateAssessmentFormAssigneesDoc, { input })).updateAssessmentFormAssignees.assessmentForm;
 	}
+	/**
+	* Page the group index. Like `assessmentForms`, `AssessmentGroupsPayload`
+	* carries no `pageInfo`, so `hasNextPage` is derived from the offset.
+	*/
 	async listAssessmentGroups(options) {
+		const first = Math.min(options?.first ?? 50, 100);
 		const offset = options?.offset ?? 0;
-		const data = await this.makeRequest(ListAssessmentGroupsDoc, {
-			first: Math.min(options?.first ?? 50, 100),
-			offset
-		});
+		const filterBy = options?.filterBy;
+		const { nodes, totalCount } = (await this.makeRequest(ListAssessmentGroupsDoc, {
+			first,
+			offset,
+			filterBy: filterBy && Object.keys(filterBy).length > 0 ? filterBy : null
+		})).assessmentGroups;
 		return {
-			nodes: data.assessmentGroups.nodes.map((node) => ({
+			nodes: nodes.map((node) => ({
 				id: node.id,
 				title: node.title,
+				description: node.description,
 				assessmentFormTemplate: node.assessmentFormTemplate ? {
 					id: node.assessmentFormTemplate.id,
 					title: node.assessmentFormTemplate.title
@@ -3158,10 +3859,10 @@ var AssessmentsMixin = class extends TranscendGraphQLBase {
 			})),
 			pageInfo: derivePageInfo({
 				offset,
-				nodeCount: data.assessmentGroups.nodes.length,
-				totalCount: data.assessmentGroups.totalCount
+				nodeCount: nodes.length,
+				totalCount
 			}),
-			totalCount: data.assessmentGroups.totalCount
+			totalCount
 		};
 	}
 	async createAssessmentGroup(input) {
@@ -3196,27 +3897,36 @@ var AssessmentsMixin = class extends TranscendGraphQLBase {
 			assessmentGroupId: form.assessmentGroup?.id
 		};
 	}
+	/**
+	* Page the template index. Same derived `hasNextPage` as the other assessment
+	* lists, since `AssessmentFormTemplatesPayload` carries no `pageInfo`.
+	*/
 	async listAssessmentTemplates(options) {
+		const first = Math.min(options?.first ?? 50, 100);
 		const offset = options?.offset ?? 0;
-		const data = await this.makeRequest(ListAssessmentTemplatesDoc, {
-			first: Math.min(options?.first ?? 50, 100),
-			offset
-		});
+		const filterBy = options?.filterBy;
+		const { nodes, totalCount } = (await this.makeRequest(ListAssessmentTemplatesDoc, {
+			first,
+			offset,
+			filterBy: filterBy && Object.keys(filterBy).length > 0 ? filterBy : null
+		})).assessmentFormTemplates;
 		return {
-			nodes: data.assessmentFormTemplates.nodes.map((t) => ({
+			nodes: nodes.map((t) => ({
 				id: t.id,
 				title: t.title,
 				description: t.description ?? void 0,
-				version: "1.0.0",
-				isActive: true,
-				createdAt: (/* @__PURE__ */ new Date()).toISOString()
+				status: t.status,
+				source: t.source,
+				isArchived: t.isArchived,
+				createdAt: t.createdAt,
+				updatedAt: t.updatedAt
 			})),
 			pageInfo: derivePageInfo({
 				offset,
-				nodeCount: data.assessmentFormTemplates.nodes.length,
-				totalCount: data.assessmentFormTemplates.totalCount
+				nodeCount: nodes.length,
+				totalCount
 			}),
-			totalCount: data.assessmentFormTemplates.totalCount
+			totalCount
 		};
 	}
 	async submitAssessmentForReview(input) {
@@ -3300,4 +4010,4 @@ var AssessmentsMixin = class extends TranscendGraphQLBase {
 //#endregion
 export { buildAssessmentGroupUrl as _, UpdateAssessmentSchema as a, AnswerQuestionValueSchema as b, ListTemplatesSchema as c, ListAssessmentsSchema as d, GetAssessmentSchema as f, CreateAssessmentSchema as g, CreateGroupSchema as h, UpdateAssigneesSchema as i, ListGroupsSchema as l, CreateTemplateSchema as m, ASSESSMENT_OAUTH_SCOPES as n, SubmitResponseSchema as o, ExportTemplateSchema as p, getAssessmentTools as r, PrefillSchema as s, AssessmentsMixin as t, AssessmentStatusEnum as u, buildAssessmentLinks as v, AddSectionSchema as x, AnswerQuestionSchema as y };
 
-//# sourceMappingURL=graphql-CVDHC_6x.mjs.map
+//# sourceMappingURL=graphql-D1ksNLBL.mjs.map