@credal/actions 0.2.229 → 0.2.230

package/dist/actions/autogen/templates.js

@@ -4447,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: {
@@ -4462,24 +4462,93 @@ export const zendeskListZendeskTicketsDefinition = {
             },
             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",
             },
         },
     },
@@ -4488,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: {
@@ -4674,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: {
@@ -4692,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

@@ -1611,11 +1611,44 @@ export const zendeskListZendeskTicketsParamsSchema = z.object({
         .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("Filter tickets by status (new, open, pending, hold, solved, closed)").optional(),
+    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"),
@@ -1686,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/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/listTickets.js

@@ -1,9 +1,10 @@
 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);
@@ -12,22 +13,31 @@ const listZendeskTickets = async ({ params, authParams, }) => {
         throw new Error(MISSING_AUTH_TOKEN);
     }
     const zendeskBaseUrl = getZendeskBaseUrl({ subdomain });
-    const apiEndpoint = new URL("/api/v2/tickets.json", zendeskBaseUrl);
+    const apiEndpoint = new URL("/api/v2/search.json", zendeskBaseUrl);
     const axiosClient = createAxiosClientWithRetries({ timeout: 10000, retryCount: 4 });
-    // Add query parameters for filtering
-    apiEndpoint.searchParams.set("created_after", formattedDate);
-    if (status) {
-        apiEndpoint.searchParams.set("status", status);
-    }
+    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: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${authToken}`,
-        },
+        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/searchZendeskTicketsByQuery.js

@@ -1,9 +1,10 @@
 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 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);
     }
@@ -18,20 +19,27 @@ const searchZendeskTicketsByQuery = async ({ params, authParams, }) => {
         .trim();
     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: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${authToken}`,
-        },
+        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/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/package.json

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