@credal/actions 0.2.228 → 0.2.230

package/dist/actions/autogen/templates.js

@@ -4418,7 +4418,8 @@ export const zendeskCreateZendeskTicketDefinition = {
             },
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
             groupId: {
@@ -4446,7 +4447,7 @@ export const zendeskCreateZendeskTicketDefinition = {
 };
 export const zendeskListZendeskTicketsDefinition = {
     displayName: "List Zendesk tickets",
-    description: "List tickets in Zendesk from the past 3 months",
+    description: "List compact ticket discovery records from Zendesk from the past 3 months. Use getTicketDetails to investigate selected tickets.",
     scopes: [],
     tags: [],
     parameters: {
@@ -4455,29 +4456,99 @@ export const zendeskListZendeskTicketsDefinition = {
         properties: {
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
             status: {
                 type: "string",
+                enum: ["new", "open", "pending", "hold", "solved", "closed"],
                 description: "Filter tickets by status (new, open, pending, hold, solved, closed)",
             },
+            limit: {
+                type: "integer",
+                minimum: 1,
+                maximum: 50,
+                description: "Number of compact ticket records to return per page (optional, defaults to 20, maximum 50)",
+            },
+            page: {
+                type: "integer",
+                minimum: 1,
+                description: "Offset page number to retrieve (optional, defaults to 1). Pass next_page from a previous response to continue.",
+            },
         },
     },
     output: {
         type: "object",
-        required: ["tickets", "count"],
+        required: ["tickets", "count", "returned_count", "has_more"],
         properties: {
             tickets: {
                 type: "array",
-                description: "List of tickets",
+                description: "Small ticket records for choosing which IDs to fetch with getTicketDetails",
                 items: {
                     type: "object",
+                    required: ["id", "description_excerpt", "description_truncated"],
+                    properties: {
+                        id: {
+                            type: "integer",
+                            description: "Zendesk ticket ID",
+                        },
+                        subject: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket subject",
+                        },
+                        status: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket status category",
+                        },
+                        type: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket type such as question, incident, problem, or task",
+                        },
+                        priority: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket priority",
+                        },
+                        created_at: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket creation timestamp",
+                        },
+                        updated_at: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket update timestamp",
+                        },
+                        description_excerpt: {
+                            type: "string",
+                            description: "Up to the first 1,000 characters of the ticket description",
+                        },
+                        description_truncated: {
+                            type: "boolean",
+                            description: "Whether the full ticket description is longer than description_excerpt",
+                        },
+                    },
                 },
             },
             count: {
                 type: "number",
-                description: "Number of tickets found",
+                description: "Total number of tickets reported by Zendesk for the list query",
+            },
+            returned_count: {
+                type: "number",
+                description: "Number of compact ticket records returned in this response",
+            },
+            has_more: {
+                type: "boolean",
+                description: "Whether another page of tickets is available",
+            },
+            next_page: {
+                type: "integer",
+                description: "Page number to pass on the next call when has_more is true",
             },
         },
     },
@@ -4486,7 +4557,7 @@ export const zendeskListZendeskTicketsDefinition = {
 };
 export const zendeskGetTicketDetailsDefinition = {
     displayName: "Get ticket details",
-    description: "Get details of a ticket in Zendesk",
+    description: "Get the full ticket object for a selected Zendesk ticket.",
     scopes: [],
     tags: [],
     parameters: {
@@ -4499,7 +4570,8 @@ export const zendeskGetTicketDetailsDefinition = {
             },
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
         },
@@ -4532,7 +4604,8 @@ export const zendeskUpdateTicketStatusDefinition = {
             },
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
             status: {
@@ -4559,7 +4632,8 @@ export const zendeskAddCommentToTicketDefinition = {
             },
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
             body: {
@@ -4604,7 +4678,8 @@ export const zendeskAssignTicketDefinition = {
             },
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
             assigneeEmail: {
@@ -4627,7 +4702,8 @@ export const zendeskSearchZendeskByQueryDefinition = {
         properties: {
             subdomain: {
                 type: "string",
-                description: "The subdomain of the Zendesk account",
+                pattern: "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$",
+                description: "The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix",
                 tags: ["recommend-predefined"],
             },
             query: {
@@ -4667,7 +4743,7 @@ export const zendeskSearchZendeskByQueryDefinition = {
 };
 export const zendeskSearchZendeskTicketsByQueryDefinition = {
     displayName: "Search Zendesk tickets with a query",
-    description: "Search Zendesk tickets by query with flexible filtering options. Only returns tickets, never any other type of Zendesk resource.",
+    description: "Search compact Zendesk ticket discovery records with flexible filtering options. Only returns tickets. Use getTicketDetails to investigate selected tickets.",
     scopes: [],
     tags: [],
     parameters: {
@@ -4685,25 +4761,89 @@ export const zendeskSearchZendeskTicketsByQueryDefinition = {
                 description: 'Search query string that can include filters like status, priority, tags, assignee, etc. Examples - status:open, priority:high, tags:bug, assignee:user@example.com, or combination like "status:open priority:high". The search is always restricted to tickets, so any type filter in the query is ignored.',
             },
             limit: {
-                type: "number",
-                description: "Maximum number of tickets to return (optional, defaults to 100)",
+                type: "integer",
+                minimum: 1,
+                maximum: 50,
+                description: "Number of compact ticket records to return per page (optional, defaults to 20, maximum 50)",
+            },
+            page: {
+                type: "integer",
+                minimum: 1,
+                description: "Offset page number to retrieve (optional, defaults to 1). Pass next_page from a previous response to continue.",
             },
         },
     },
     output: {
         type: "object",
-        required: ["results", "count"],
+        required: ["results", "count", "returned_count", "has_more"],
         properties: {
             results: {
                 type: "array",
-                description: "List of tickets matching the query",
+                description: "Small ticket records for choosing which IDs to fetch with getTicketDetails",
                 items: {
                     type: "object",
+                    required: ["id", "description_excerpt", "description_truncated"],
+                    properties: {
+                        id: {
+                            type: "integer",
+                            description: "Zendesk ticket ID",
+                        },
+                        subject: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket subject",
+                        },
+                        status: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket status category",
+                        },
+                        type: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket type such as question, incident, problem, or task",
+                        },
+                        priority: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket priority",
+                        },
+                        created_at: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket creation timestamp",
+                        },
+                        updated_at: {
+                            type: "string",
+                            nullable: true,
+                            description: "Ticket update timestamp",
+                        },
+                        description_excerpt: {
+                            type: "string",
+                            description: "Up to the first 1,000 characters of the ticket description",
+                        },
+                        description_truncated: {
+                            type: "boolean",
+                            description: "Whether the full ticket description is longer than description_excerpt",
+                        },
+                    },
                 },
             },
             count: {
                 type: "number",
-                description: "Number of tickets found",
+                description: "Total number of matching tickets reported by Zendesk",
+            },
+            returned_count: {
+                type: "number",
+                description: "Number of compact ticket records returned in this response",
+            },
+            has_more: {
+                type: "boolean",
+                description: "Whether another page of matching tickets is available",
+            },
+            next_page: {
+                type: "integer",
+                description: "Page number to pass on the next call when has_more is true",
             },
         },
     },

package/dist/actions/autogen/types.d.ts

@@ -4520,24 +4520,89 @@ export type zendeskCreateZendeskTicketOutputType = z.infer<typeof zendeskCreateZ
 export type zendeskCreateZendeskTicketFunction = ActionFunction<zendeskCreateZendeskTicketParamsType, AuthParamsType, zendeskCreateZendeskTicketOutputType>;
 export declare const zendeskListZendeskTicketsParamsSchema: z.ZodObject<{
     subdomain: z.ZodString;
-    status: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["new", "open", "pending", "hold", "solved", "closed"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     subdomain: string;
-    status?: string | undefined;
+    status?: "new" | "open" | "pending" | "hold" | "solved" | "closed" | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
 }, {
     subdomain: string;
-    status?: string | undefined;
+    status?: "new" | "open" | "pending" | "hold" | "solved" | "closed" | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
 }>;
 export type zendeskListZendeskTicketsParamsType = z.infer<typeof zendeskListZendeskTicketsParamsSchema>;
 export declare const zendeskListZendeskTicketsOutputSchema: z.ZodObject<{
-    tickets: z.ZodArray<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>, "many">;
+    tickets: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description_excerpt: z.ZodString;
+        description_truncated: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }, {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }>, "many">;
     count: z.ZodNumber;
+    returned_count: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_page: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     count: number;
-    tickets: z.objectOutputType<{}, z.ZodAny, "strip">[];
+    tickets: {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }[];
+    returned_count: number;
+    has_more: boolean;
+    next_page?: number | undefined;
 }, {
     count: number;
-    tickets: z.objectInputType<{}, z.ZodAny, "strip">[];
+    tickets: {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }[];
+    returned_count: number;
+    has_more: boolean;
+    next_page?: number | undefined;
 }>;
 export type zendeskListZendeskTicketsOutputType = z.infer<typeof zendeskListZendeskTicketsOutputSchema>;
 export type zendeskListZendeskTicketsFunction = ActionFunction<zendeskListZendeskTicketsParamsType, AuthParamsType, zendeskListZendeskTicketsOutputType>;
@@ -4661,25 +4726,87 @@ export declare const zendeskSearchZendeskTicketsByQueryParamsSchema: z.ZodObject
     subdomain: z.ZodString;
     query: z.ZodString;
     limit: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
     subdomain: string;
     limit?: number | undefined;
+    page?: number | undefined;
 }, {
     query: string;
     subdomain: string;
     limit?: number | undefined;
+    page?: number | undefined;
 }>;
 export type zendeskSearchZendeskTicketsByQueryParamsType = z.infer<typeof zendeskSearchZendeskTicketsByQueryParamsSchema>;
 export declare const zendeskSearchZendeskTicketsByQueryOutputSchema: z.ZodObject<{
-    results: z.ZodArray<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>, "many">;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description_excerpt: z.ZodString;
+        description_truncated: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }, {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }>, "many">;
     count: z.ZodNumber;
+    returned_count: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    next_page: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    results: z.objectOutputType<{}, z.ZodAny, "strip">[];
+    results: {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }[];
     count: number;
+    returned_count: number;
+    has_more: boolean;
+    next_page?: number | undefined;
 }, {
-    results: z.objectInputType<{}, z.ZodAny, "strip">[];
+    results: {
+        id: number;
+        description_excerpt: string;
+        description_truncated: boolean;
+        type?: string | null | undefined;
+        status?: string | null | undefined;
+        created_at?: string | null | undefined;
+        subject?: string | null | undefined;
+        priority?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }[];
     count: number;
+    returned_count: number;
+    has_more: boolean;
+    next_page?: number | undefined;
 }>;
 export type zendeskSearchZendeskTicketsByQueryOutputType = z.infer<typeof zendeskSearchZendeskTicketsByQueryOutputSchema>;
 export type zendeskSearchZendeskTicketsByQueryFunction = ActionFunction<zendeskSearchZendeskTicketsByQueryParamsType, AuthParamsType, zendeskSearchZendeskTicketsByQueryOutputType>;
@@ -10273,21 +10400,21 @@ export declare const githubListCommitsParamsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     repositoryOwner: string;
     repositoryName: string;
+    page?: number | undefined;
     branch?: string | undefined;
     author?: string | undefined;
     since?: string | undefined;
     until?: string | undefined;
     perPage?: number | undefined;
-    page?: number | undefined;
 }, {
     repositoryOwner: string;
     repositoryName: string;
+    page?: number | undefined;
     branch?: string | undefined;
     author?: string | undefined;
     since?: string | undefined;
     until?: string | undefined;
     perPage?: number | undefined;
-    page?: number | undefined;
 }>;
 export type githubListCommitsParamsType = z.infer<typeof githubListCommitsParamsSchema>;
 export declare const githubListCommitsOutputSchema: z.ZodObject<{

package/dist/actions/autogen/types.js

@@ -1596,7 +1596,10 @@ export const bingGetTopNSearchResultUrlsOutputSchema = z.object({
 export const zendeskCreateZendeskTicketParamsSchema = z.object({
     subject: z.string().describe("The subject of the ticket"),
     body: z.string().describe("The body of the ticket").optional(),
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
     groupId: z.coerce.number().describe("The ID of the group to assign the ticket to").optional(),
 });
 export const zendeskCreateZendeskTicketOutputSchema = z.object({
@@ -1604,23 +1607,65 @@ export const zendeskCreateZendeskTicketOutputSchema = z.object({
     ticketUrl: z.string().describe("The URL of the ticket created").optional(),
 });
 export const zendeskListZendeskTicketsParamsSchema = z.object({
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
-    status: z.string().describe("Filter tickets by status (new, open, pending, hold, solved, closed)").optional(),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
+    status: z
+        .enum(["new", "open", "pending", "hold", "solved", "closed"])
+        .describe("Filter tickets by status (new, open, pending, hold, solved, closed)")
+        .optional(),
+    limit: z.coerce
+        .number()
+        .int()
+        .gte(1)
+        .lte(50)
+        .describe("Number of compact ticket records to return per page (optional, defaults to 20, maximum 50)")
+        .optional(),
+    page: z.coerce
+        .number()
+        .int()
+        .gte(1)
+        .describe("Offset page number to retrieve (optional, defaults to 1). Pass next_page from a previous response to continue.")
+        .optional(),
 });
 export const zendeskListZendeskTicketsOutputSchema = z.object({
-    tickets: z.array(z.object({}).catchall(z.any())).describe("List of tickets"),
-    count: z.coerce.number().describe("Number of tickets found"),
+    tickets: z
+        .array(z.object({
+        id: z.coerce.number().int().describe("Zendesk ticket ID"),
+        subject: z.string().nullable().describe("Ticket subject").optional(),
+        status: z.string().nullable().describe("Ticket status category").optional(),
+        type: z.string().nullable().describe("Ticket type such as question, incident, problem, or task").optional(),
+        priority: z.string().nullable().describe("Ticket priority").optional(),
+        created_at: z.string().nullable().describe("Ticket creation timestamp").optional(),
+        updated_at: z.string().nullable().describe("Ticket update timestamp").optional(),
+        description_excerpt: z.string().describe("Up to the first 1,000 characters of the ticket description"),
+        description_truncated: z
+            .boolean()
+            .describe("Whether the full ticket description is longer than description_excerpt"),
+    }))
+        .describe("Small ticket records for choosing which IDs to fetch with getTicketDetails"),
+    count: z.coerce.number().describe("Total number of tickets reported by Zendesk for the list query"),
+    returned_count: z.coerce.number().describe("Number of compact ticket records returned in this response"),
+    has_more: z.boolean().describe("Whether another page of tickets is available"),
+    next_page: z.coerce.number().int().describe("Page number to pass on the next call when has_more is true").optional(),
 });
 export const zendeskGetTicketDetailsParamsSchema = z.object({
     ticketId: z.string().describe("The ID of the ticket"),
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
 });
 export const zendeskGetTicketDetailsOutputSchema = z.object({
     ticket: z.object({}).catchall(z.any()).describe("The details of the ticket"),
 });
 export const zendeskUpdateTicketStatusParamsSchema = z.object({
     ticketId: z.string().describe("The ID of the ticket to update"),
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
     status: z
         .string()
         .describe('The state of the ticket. If your account has activated custom ticket statuses, this is the ticket\'s status category. Allowed values are "new", "open", "pending", "hold", "solved", or "closed".'),
@@ -1628,7 +1673,10 @@ export const zendeskUpdateTicketStatusParamsSchema = z.object({
 export const zendeskUpdateTicketStatusOutputSchema = z.void();
 export const zendeskAddCommentToTicketParamsSchema = z.object({
     ticketId: z.string().describe("The ID of the ticket to update"),
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
     body: z.string().describe("The body of the comment"),
     public: z.boolean().describe("Whether the comment should be public (defaults to true)").optional(),
 });
@@ -1638,12 +1686,18 @@ export const zendeskAddCommentToTicketOutputSchema = z.object({
 });
 export const zendeskAssignTicketParamsSchema = z.object({
     ticketId: z.string().describe("The ID of the ticket to update"),
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
     assigneeEmail: z.string().describe("The email address of the agent to assign the ticket to"),
 });
 export const zendeskAssignTicketOutputSchema = z.void();
 export const zendeskSearchZendeskByQueryParamsSchema = z.object({
-    subdomain: z.string().describe("The subdomain of the Zendesk account"),
+    subdomain: z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"))
+        .describe("The hostname-label subdomain of the Zendesk account, without a protocol, path, or .zendesk.com suffix"),
     query: z
         .string()
         .describe('Search query string that can include filters like status, priority, tags, assignee, etc. Examples - status:open, priority:high, tags:bug, assignee:user@example.com, or combination like "status:open priority:high"'),
@@ -1665,11 +1719,40 @@ export const zendeskSearchZendeskTicketsByQueryParamsSchema = z.object({
     query: z
         .string()
         .describe('Search query string that can include filters like status, priority, tags, assignee, etc. Examples - status:open, priority:high, tags:bug, assignee:user@example.com, or combination like "status:open priority:high". The search is always restricted to tickets, so any type filter in the query is ignored.'),
-    limit: z.coerce.number().describe("Maximum number of tickets to return (optional, defaults to 100)").optional(),
+    limit: z.coerce
+        .number()
+        .int()
+        .gte(1)
+        .lte(50)
+        .describe("Number of compact ticket records to return per page (optional, defaults to 20, maximum 50)")
+        .optional(),
+    page: z.coerce
+        .number()
+        .int()
+        .gte(1)
+        .describe("Offset page number to retrieve (optional, defaults to 1). Pass next_page from a previous response to continue.")
+        .optional(),
 });
 export const zendeskSearchZendeskTicketsByQueryOutputSchema = z.object({
-    results: z.array(z.object({}).catchall(z.any())).describe("List of tickets matching the query"),
-    count: z.coerce.number().describe("Number of tickets found"),
+    results: z
+        .array(z.object({
+        id: z.coerce.number().int().describe("Zendesk ticket ID"),
+        subject: z.string().nullable().describe("Ticket subject").optional(),
+        status: z.string().nullable().describe("Ticket status category").optional(),
+        type: z.string().nullable().describe("Ticket type such as question, incident, problem, or task").optional(),
+        priority: z.string().nullable().describe("Ticket priority").optional(),
+        created_at: z.string().nullable().describe("Ticket creation timestamp").optional(),
+        updated_at: z.string().nullable().describe("Ticket update timestamp").optional(),
+        description_excerpt: z.string().describe("Up to the first 1,000 characters of the ticket description"),
+        description_truncated: z
+            .boolean()
+            .describe("Whether the full ticket description is longer than description_excerpt"),
+    }))
+        .describe("Small ticket records for choosing which IDs to fetch with getTicketDetails"),
+    count: z.coerce.number().describe("Total number of matching tickets reported by Zendesk"),
+    returned_count: z.coerce.number().describe("Number of compact ticket records returned in this response"),
+    has_more: z.boolean().describe("Whether another page of matching tickets is available"),
+    next_page: z.coerce.number().int().describe("Page number to pass on the next call when has_more is true").optional(),
 });
 export const linkedinCreateShareLinkedinPostUrlParamsSchema = z.object({
     text: z.string().describe("The text for the linkedin post").optional(),

package/dist/actions/providers/zendesk/addCommentToTicket.js

@@ -1,16 +1,18 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const addCommentToTicket = async ({ params, authParams, }) => {
     const { authToken } = authParams;
     const { subdomain, ticketId, body, public: isPublic } = params;
-    const url = `https://${subdomain}.zendesk.com/api/v2/tickets/${ticketId}.json`;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL(`/api/v2/tickets/${ticketId}.json`, zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 20000, retryCount: 5 });
     try {
         await axiosClient.request({
-            url: url,
+            url: apiEndpoint.toString(),
             method: "PUT",
             headers: {
                 "Content-Type": "application/json",
@@ -27,7 +29,7 @@ const addCommentToTicket = async ({ params, authParams, }) => {
         });
         return {
             success: true,
-            ticketUrl: `https://${subdomain}.zendesk.com/agent/tickets/${ticketId}`,
+            ticketUrl: new URL(`/agent/tickets/${ticketId}`, zendeskBaseUrl).toString(),
         };
     }
     catch (error) {

package/dist/actions/providers/zendesk/assignTicket.js

@@ -1,15 +1,17 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const updateTicketStatus = async ({ params, authParams, }) => {
     const { authToken } = authParams;
     const { subdomain, ticketId, assigneeEmail } = params;
-    const url = `https://${subdomain}.zendesk.com/api/v2/tickets/${ticketId}.json`;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL(`/api/v2/tickets/${ticketId}.json`, zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
     await axiosClient.request({
-        url: url,
+        url: apiEndpoint.toString(),
         method: "PUT",
         headers: {
             "Content-Type": "application/json",

package/dist/actions/providers/zendesk/createZendeskTicket.js

@@ -1,9 +1,14 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const createZendeskTicket = async ({ params, authParams, }) => {
     const { authToken } = authParams;
     const { subdomain, subject, body, groupId } = params;
-    const url = `https://${subdomain}.zendesk.com/api/v2/tickets.json`;
+    if (!authToken) {
+        throw new Error(MISSING_AUTH_TOKEN);
+    }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL("/api/v2/tickets.json", zendeskBaseUrl);
     const payload = {
         ticket: {
             subject,
@@ -13,11 +18,8 @@ const createZendeskTicket = async ({ params, authParams, }) => {
             group_id: groupId,
         },
     };
-    if (!authToken) {
-        throw new Error(MISSING_AUTH_TOKEN);
-    }
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
-    const response = await axiosClient.post(url, payload, {
+    const response = await axiosClient.post(apiEndpoint.toString(), payload, {
         headers: {
             "Content-Type": "application/json",
             Authorization: `Bearer ${authToken}`,
@@ -25,7 +27,7 @@ const createZendeskTicket = async ({ params, authParams, }) => {
     });
     return {
         ticketId: response.data.ticket.id,
-        ticketUrl: `https://${subdomain}.zendesk.com/requests/${response.data.ticket.id}`,
+        ticketUrl: new URL(`/requests/${response.data.ticket.id}`, zendeskBaseUrl).toString(),
     };
 };
 export default createZendeskTicket;

package/dist/actions/providers/zendesk/getTicketComments.d.ts

@@ -0,0 +1,3 @@
+import type { zendeskGetTicketCommentsFunction } from "../../autogen/types.js";
+declare const getTicketComments: zendeskGetTicketCommentsFunction;
+export default getTicketComments;

package/dist/actions/providers/zendesk/getTicketComments.js

@@ -0,0 +1,80 @@
+import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
+import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
+const getTicketComments = async ({ params, authParams, }) => {
+    const { authToken } = authParams;
+    const { subdomain, ticketId, limit = 10, cursor, sortOrder = "asc", maxBodyCharacters = 5000 } = params;
+    if (!authToken) {
+        throw new Error(MISSING_AUTH_TOKEN);
+    }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL(`/api/v2/tickets/${encodeURIComponent(ticketId)}/comments.json`, zendeskBaseUrl);
+    apiEndpoint.searchParams.set("page[size]", limit.toString());
+    apiEndpoint.searchParams.set("sort", sortOrder === "desc" ? "-created_at" : "created_at");
+    if (cursor) {
+        apiEndpoint.searchParams.set("page[after]", cursor);
+    }
+    const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
+    const response = await axiosClient.get(apiEndpoint.toString(), {
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${authToken}`,
+        },
+    });
+    const rawComments = Array.isArray(response.data.comments) ? response.data.comments : [];
+    const comments = rawComments.flatMap(comment => {
+        if (!isRecord(comment) || typeof comment.id !== "number") {
+            return [];
+        }
+        const rawComment = comment;
+        const fullBody = typeof rawComment.plain_body === "string"
+            ? rawComment.plain_body
+            : typeof rawComment.body === "string"
+                ? rawComment.body
+                : "";
+        const channel = isRecord(rawComment.via) && typeof rawComment.via.channel === "string" ? rawComment.via.channel : undefined;
+        const attachments = compactAttachments(rawComment.attachments);
+        return [
+            {
+                id: comment.id,
+                author_id: typeof rawComment.author_id === "number" ? rawComment.author_id : null,
+                created_at: typeof rawComment.created_at === "string" ? rawComment.created_at : null,
+                public: rawComment.public === true,
+                type: typeof rawComment.type === "string" ? rawComment.type : null,
+                body: fullBody.slice(0, maxBodyCharacters),
+                body_truncated: fullBody.length > maxBodyCharacters,
+                ...(channel ? { via: { channel } } : {}),
+                ...(attachments.length > 0 ? { attachments } : {}),
+            },
+        ];
+    });
+    const hasMore = response.data.meta?.has_more === true;
+    const afterCursor = response.data.meta?.after_cursor;
+    return {
+        comments,
+        returned_count: comments.length,
+        has_more: hasMore,
+        ...(hasMore && typeof afterCursor === "string" ? { next_cursor: afterCursor } : {}),
+    };
+};
+function compactAttachments(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap(attachment => {
+        if (!isRecord(attachment))
+            return [];
+        return [
+            {
+                ...(typeof attachment.id === "number" ? { id: attachment.id } : {}),
+                ...(typeof attachment.file_name === "string" ? { file_name: attachment.file_name } : {}),
+                ...(typeof attachment.content_type === "string" ? { content_type: attachment.content_type } : {}),
+                ...(typeof attachment.size === "number" ? { size: attachment.size } : {}),
+                ...(typeof attachment.content_url === "string" ? { content_url: attachment.content_url } : {}),
+            },
+        ];
+    });
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export default getTicketComments;

package/dist/actions/providers/zendesk/getTicketDetails.js

@@ -1,15 +1,17 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const getZendeskTicketDetails = async ({ params, authParams, }) => {
     const { authToken } = authParams;
     const { subdomain, ticketId } = params;
-    const url = `https://${subdomain}.zendesk.com/api/v2/tickets/${ticketId}.json`;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL(`/api/v2/tickets/${ticketId}.json`, zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
     const response = await axiosClient.request({
-        url: url,
+        url: apiEndpoint.toString(),
         method: "GET",
         headers: {
             "Content-Type": "application/json",

package/dist/actions/providers/zendesk/listTickets.js

@@ -1,33 +1,43 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { compactZendeskTickets, isZendeskTicketSearchResult } from "./utils/compactTicket.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const listZendeskTickets = async ({ params, authParams, }) => {
     const { authToken } = authParams;
-    const { subdomain, status } = params;
+    const { subdomain, status, limit = 20, page = 1 } = params;
     // Calculate date 3 months ago from now
     const threeMonthsAgo = new Date();
     threeMonthsAgo.setMonth(threeMonthsAgo.getMonth() - 3);
     const formattedDate = threeMonthsAgo.toISOString().split("T")[0];
-    // Endpoint for getting tickets
-    const url = `https://${subdomain}.zendesk.com/api/v2/tickets.json`;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL("/api/v2/search.json", zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
-    // Add query parameters for filtering
-    const queryParams = new URLSearchParams();
-    queryParams.append("created_after", formattedDate);
-    if (status) {
-        queryParams.append("status", status);
-    }
-    const response = await axiosClient.get(`${url}?${queryParams.toString()}`, {
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${authToken}`,
-        },
+    const query = [`type:ticket`, `created>${formattedDate}`, ...(status ? [`status:${status}`] : [])].join(" ");
+    apiEndpoint.searchParams.set("query", query);
+    apiEndpoint.searchParams.set("per_page", limit.toString());
+    apiEndpoint.searchParams.set("page", page.toString());
+    const headers = {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${authToken}`,
+    };
+    const response = await axiosClient.get(apiEndpoint.toString(), {
+        headers,
     });
+    const rawTickets = Array.isArray(response.data.results)
+        ? response.data.results.filter(isZendeskTicketSearchResult)
+        : [];
+    const tickets = compactZendeskTickets(rawTickets);
+    const count = typeof response.data.count === "number" ? response.data.count : rawTickets.length;
+    const hasMore = typeof response.data.next_page === "string" && response.data.next_page.length > 0;
     return {
-        tickets: response.data.tickets,
-        count: response.data.count,
+        tickets,
+        count,
+        returned_count: tickets.length,
+        has_more: hasMore,
+        ...(hasMore ? { next_page: page + 1 } : {}),
     };
 };
 export default listZendeskTickets;

package/dist/actions/providers/zendesk/searchZendeskByQuery.js

@@ -1,19 +1,19 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const searchZendeskByQuery = async ({ params, authParams, }) => {
     const { authToken } = authParams;
     const { subdomain, query, objectType = "ticket", limit = 100 } = params;
-    // Endpoint for searching Zendesk objects
-    const url = `https://${subdomain}.zendesk.com/api/v2/search.json`;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL("/api/v2/search.json", zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
     // Build search query parameters
-    const queryParams = new URLSearchParams();
-    queryParams.append("query", `type:${objectType} ${query}`);
-    queryParams.append("per_page", limit.toString());
-    const response = await axiosClient.get(`${url}?${queryParams.toString()}`, {
+    apiEndpoint.searchParams.set("query", `type:${objectType} ${query}`);
+    apiEndpoint.searchParams.set("per_page", limit.toString());
+    const response = await axiosClient.get(apiEndpoint.toString(), {
         headers: {
             "Content-Type": "application/json",
             Authorization: `Bearer ${authToken}`,

package/dist/actions/providers/zendesk/searchZendeskTicketsByQuery.js

@@ -1,16 +1,15 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
-const ZENDESK_SUBDOMAIN_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;
+import { compactZendeskTickets, isZendeskTicketSearchResult } from "./utils/compactTicket.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const searchZendeskTicketsByQuery = async ({ params, authParams, }) => {
     const { authToken } = authParams;
-    const { subdomain, query, limit = 100 } = params;
+    const { subdomain, query, limit = 20, page = 1 } = params;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
-    if (!ZENDESK_SUBDOMAIN_PATTERN.test(subdomain)) {
-        throw new Error("Invalid Zendesk subdomain");
-    }
-    const url = new URL(`https://${subdomain}.zendesk.com/api/v2/search.json`);
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL("/api/v2/search.json", zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
     // Strip any type: filters from the incoming query so it can't target other resource types,
     // then force the search to tickets only
@@ -18,22 +17,29 @@ const searchZendeskTicketsByQuery = async ({ params, authParams, }) => {
         .replace(/\btype:\S+/gi, "")
         .replace(/\s+/g, " ")
         .trim();
-    url.searchParams.set("query", `type:ticket ${sanitizedQuery}`.trim());
-    url.searchParams.set("per_page", limit.toString());
-    const response = await axiosClient.get(url.toString(), {
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${authToken}`,
-        },
+    apiEndpoint.searchParams.set("query", `type:ticket ${sanitizedQuery}`.trim());
+    apiEndpoint.searchParams.set("per_page", limit.toString());
+    apiEndpoint.searchParams.set("page", page.toString());
+    const headers = {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${authToken}`,
+    };
+    const response = await axiosClient.get(apiEndpoint.toString(), {
+        headers,
     });
     // Defense in depth: only return results Zendesk marks as tickets
-    const results = Array.isArray(response.data.results)
-        ? response.data.results.filter((result) => result.result_type === "ticket")
+    const rawResults = Array.isArray(response.data.results)
+        ? response.data.results.filter(isZendeskTicketSearchResult)
         : [];
-    const count = typeof response.data.count === "number" ? response.data.count : results.length;
+    const results = compactZendeskTickets(rawResults);
+    const count = typeof response.data.count === "number" ? response.data.count : rawResults.length;
+    const hasMore = typeof response.data.next_page === "string" && response.data.next_page.length > 0;
     return {
         results,
         count,
+        returned_count: results.length,
+        has_more: hasMore,
+        ...(hasMore ? { next_page: page + 1 } : {}),
     };
 };
 export default searchZendeskTicketsByQuery;

package/dist/actions/providers/zendesk/updateTicketStatus.js

@@ -1,15 +1,17 @@
 import { createAxiosClientWithRetries } from "../../util/axiosClient.js";
 import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { getZendeskBaseUrl } from "./utils/getZendeskBaseUrl.js";
 const updateTicketStatus = async ({ params, authParams, }) => {
     const { authToken } = authParams;
     const { subdomain, ticketId, status } = params;
-    const url = `https://${subdomain}.zendesk.com/api/v2/tickets/${ticketId}.json`;
     if (!authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
+    const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
+    const apiEndpoint = new URL(`/api/v2/tickets/${ticketId}.json`, zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
     await axiosClient.request({
-        url: url,
+        url: apiEndpoint.toString(),
         method: "PUT",
         headers: {
             "Content-Type": "application/json",

package/dist/actions/providers/zendesk/utils/compactTicket.d.ts

@@ -0,0 +1,22 @@
+import type { zendeskListZendeskTicketsOutputType } from "../../../autogen/types.js";
+type CompactTicket = zendeskListZendeskTicketsOutputType["tickets"][number];
+export interface ZendeskTicketSearchResult {
+    id: number;
+    result_type: "ticket";
+    subject?: string | null;
+    status?: string | null;
+    type?: string | null;
+    priority?: string | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+    description?: string | null;
+}
+/**
+ * Narrows an unknown Zendesk Search API result to the ticket fields used for discovery.
+ */
+export declare function isZendeskTicketSearchResult(value: unknown): value is ZendeskTicketSearchResult;
+/**
+ * Projects Zendesk tickets into small records for choosing which IDs to fetch with getTicketDetails.
+ */
+export declare function compactZendeskTickets(tickets: ZendeskTicketSearchResult[]): CompactTicket[];
+export {};

package/dist/actions/providers/zendesk/utils/compactTicket.js

@@ -0,0 +1,40 @@
+const DESCRIPTION_EXCERPT_CHARACTERS = 1000;
+/**
+ * Narrows an unknown Zendesk Search API result to the ticket fields used for discovery.
+ */
+export function isZendeskTicketSearchResult(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const result = value;
+    return (typeof result.id === "number" &&
+        result.result_type === "ticket" &&
+        isOptionalNullableString(result.subject) &&
+        isOptionalNullableString(result.status) &&
+        isOptionalNullableString(result.type) &&
+        isOptionalNullableString(result.priority) &&
+        isOptionalNullableString(result.created_at) &&
+        isOptionalNullableString(result.updated_at) &&
+        isOptionalNullableString(result.description));
+}
+/**
+ * Projects Zendesk tickets into small records for choosing which IDs to fetch with getTicketDetails.
+ */
+export function compactZendeskTickets(tickets) {
+    return tickets.map(ticket => {
+        const description = ticket.description ?? "";
+        return {
+            id: ticket.id,
+            subject: ticket.subject ?? null,
+            status: ticket.status ?? null,
+            type: ticket.type ?? null,
+            priority: ticket.priority ?? null,
+            created_at: ticket.created_at ?? null,
+            updated_at: ticket.updated_at ?? null,
+            description_excerpt: description.slice(0, DESCRIPTION_EXCERPT_CHARACTERS),
+            description_truncated: description.length > DESCRIPTION_EXCERPT_CHARACTERS,
+        };
+    });
+}
+function isOptionalNullableString(value) {
+    return value === undefined || value === null || typeof value === "string";
+}

package/dist/actions/providers/zendesk/utils/getZendeskBaseUrl.d.ts

@@ -0,0 +1,3 @@
+export declare const getZendeskBaseUrl: ({ subdomain }: {
+    subdomain: string;
+}) => URL;

package/dist/actions/providers/zendesk/utils/getZendeskBaseUrl.js

@@ -0,0 +1,7 @@
+const ZENDESK_SUBDOMAIN_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;
+export const getZendeskBaseUrl = ({ subdomain }) => {
+    if (!ZENDESK_SUBDOMAIN_PATTERN.test(subdomain)) {
+        throw new Error("Invalid Zendesk subdomain");
+    }
+    return new URL(`https://${subdomain}.zendesk.com/`);
+};

package/dist/actions/providers/zendesk/utils/validateSubdomain.d.ts

@@ -0,0 +1 @@
+export declare const validateZendeskSubdomain: (subdomain: string) => void;

package/dist/actions/providers/zendesk/utils/validateSubdomain.js

@@ -0,0 +1,6 @@
+const ZENDESK_SUBDOMAIN_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;
+export const validateZendeskSubdomain = (subdomain) => {
+    if (!ZENDESK_SUBDOMAIN_PATTERN.test(subdomain)) {
+        throw new Error("Invalid Zendesk subdomain");
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@credal/actions",
-  "version": "0.2.228",
+  "version": "0.2.230",
   "type": "module",
   "description": "AI Actions by Credal AI",
   "sideEffects": false,