Merging pull request #18881

* Fix Zoho Desk search-ticket and add list-tickets with comprehensive props

This commit addresses issue #18798 by adding comprehensive prop definitions
to the Zoho Desk integration, enabling AI to properly configure ticket
search and listing with all available API parameters.

Changes:
- Added new propDefinitions to zoho_desk.app.mjs:
  * ticketPriority: Dynamic options from organization fields
  * assigneeId: Dynamic options from agents list
  * channel: Dynamic options from organization fields
  * ticketSortBy: Static sort options (createdTime, modifiedTime, dueDate, relevance)
  * from: Pagination offset parameter
  * limit: Results limit parameter (max 50)

- Added streaming methods for better pagination:
  * getTicketsStream(): Stream paginated ticket lists
  * searchTicketsStream(): Stream paginated search results

- Enhanced search-ticket action (v0.0.7):
  * Added departmentId filter
  * Added status filter
  * Added priority filter
  * Added assigneeId filter
  * Added channel filter
  * Added sortBy parameter
  * Added from/limit pagination
  * Added maxResults parameter
  * Implemented streaming for large result sets

- Created new list-tickets action (v0.0.1):
  * Full filtering by department, status, priority, assignee, channel, contact
  * Sorting options
  * Pagination support
  * Include parameter for related resources
  * Streaming support for large datasets

All changes verified against Zoho Desk API documentation:
- Search Tickets: https://desk.zoho.com/DeskAPIDocument#Search_SearchTickets
- List Tickets: https://desk.zoho.com/DeskAPIDocument#Tickets_Listalltickets

Fixes #18798

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Add comprehensive props to all Zoho Desk ticket and contact actions

Extended all Zoho Desk actions with complete prop definitions to enable
AI assistants and users to leverage the full capabilities of the Zoho Desk API.

App file (zoho_desk.app.mjs) enhancements:
- Added accountId propDefinition with dynamic options from accounts
- Added productId propDefinition for product association
- Added category propDefinition for ticket categorization
- Added subCategory propDefinition for sub-categorization
- Added classification propDefinition with dynamic options
- Added dueDate propDefinition for deadline management

Ticket actions enhancements:

create-ticket (v0.0.6 → v0.0.7):
- Added status, priority, assigneeId, channel props (using propDefinitions)
- Added classification, category, subCategory props
- Added dueDate for deadline tracking
- Added email and phone contact fields
- Added productId for product association
- Updated to conditionally include optional fields

update-ticket (v0.0.6 → v0.0.7):
- Made subject optional (was required)
- Added status, priority, assigneeId props
- Added departmentId, contactId, channel props
- Added classification, category, subCategory props
- Added dueDate and productId props
- Updated to conditionally include optional fields
- Now supports updating any ticket field

Contact actions enhancements:

create-contact (v0.0.6 → v0.0.7):
- Added accountId prop using dynamic propDefinition
- Added title prop for job title
- Added description prop for contact notes
- Updated to conditionally include optional fields

update-contact (v0.0.6 → v0.0.7):
- Made lastName optional (was required)
- Added accountId, title, description props
- Updated to conditionally include optional fields
- Now supports updating any contact field

Email reply action fix:

send-email-reply (v0.0.6 → v0.0.7):
- Replaced hardcoded static status options with dynamic ticketStatus propDefinition
- Renamed ticketStatus prop to status for consistency
- Updated to conditionally include optional fields
- Now uses organization-specific status values

All changes verified against Zoho Desk API documentation and tested for syntax errors.

Related to #18798

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* versions

* Refactor ticket streaming methods for reusability

* updates per QA

* remove debug

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Michelle Bergeron <michelle.bergeron@gmail.com>

Author: 3 people

components/zoho_desk/actions/add-ticket-attachment/add-ticket-attachment.mjs

@@ -7,7 +7,7 @@ export default {
   name: "Add Ticket Attachment",
   description: "Attaches a file to a ticket. [See the docs here](https://desk.zoho.com/DeskAPIDocument#TicketAttachments#TicketAttachments_CreateTicketattachment)",
   type: "action",
-  version: "0.1.5",
+  version: "0.1.6",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/add-ticket-comment/add-ticket-comment.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Add Ticket Comment",
   description: "Adds a comment to a ticket. [See the docs here](https://desk.zoho.com/DeskAPIDocument#TicketsComments#TicketsComments_Createticketcomment)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/create-account/create-account.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Create Account",
   description: "Creates an account in your help desk portal. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Accounts#Accounts_CreateAccount)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/create-contact/create-contact.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Create Contact",
   description: "Creates a contact in your help desk portal. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Contacts#Contacts_CreateContact)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -48,6 +48,27 @@ export default {
       description: "Mobile number of the contact",
       optional: true,
     },
+    accountId: {
+      propDefinition: [
+        zohoDesk,
+        "accountId",
+        ({ orgId }) => ({
+          orgId,
+        }),
+      ],
+    },
+    title: {
+      type: "string",
+      label: "Title",
+      description: "Job title of the contact",
+      optional: true,
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "Description about the contact",
+      optional: true,
+    },
   },
   async run({ $ }) {
     const {
@@ -57,19 +78,29 @@ export default {
       email,
       phone,
       mobile,
+      accountId,
+      title,
+      description,
     } = this;
 
+    const data = {
+      lastName,
+    };
+
+    // Add optional fields
+    if (firstName) data.firstName = firstName;
+    if (email) data.email = email;
+    if (phone) data.phone = phone;
+    if (mobile) data.mobile = mobile;
+    if (accountId) data.accountId = accountId;
+    if (title) data.title = title;
+    if (description) data.description = description;
+
     const response = await this.zohoDesk.createContact({
       headers: {
         orgId,
       },
-      data: {
-        lastName,
-        firstName,
-        email,
-        phone,
-        mobile,
-      },
+      data,
     });
 
     $.export("$summary", `Successfully created a new contact with ID ${response.id}`);

components/zoho_desk/actions/create-ticket/create-ticket.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Create Ticket",
   description: "Creates a ticket in your helpdesk. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Tickets#Tickets_Createaticket)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -48,6 +48,75 @@ export default {
       description: "Description in the ticket",
       optional: true,
     },
+    status: {
+      propDefinition: [
+        zohoDesk,
+        "ticketStatus",
+      ],
+    },
+    priority: {
+      propDefinition: [
+        zohoDesk,
+        "ticketPriority",
+      ],
+    },
+    assigneeId: {
+      propDefinition: [
+        zohoDesk,
+        "assigneeId",
+        ({ orgId }) => ({
+          orgId,
+        }),
+      ],
+    },
+    channel: {
+      propDefinition: [
+        zohoDesk,
+        "channel",
+      ],
+    },
+    classification: {
+      propDefinition: [
+        zohoDesk,
+        "classification",
+      ],
+    },
+    category: {
+      propDefinition: [
+        zohoDesk,
+        "category",
+      ],
+    },
+    subCategory: {
+      propDefinition: [
+        zohoDesk,
+        "subCategory",
+      ],
+    },
+    dueDate: {
+      propDefinition: [
+        zohoDesk,
+        "dueDate",
+      ],
+    },
+    email: {
+      type: "string",
+      label: "Email",
+      description: "Email address for the ticket",
+      optional: true,
+    },
+    phone: {
+      type: "string",
+      label: "Phone",
+      description: "Phone number for the ticket",
+      optional: true,
+    },
+    productId: {
+      propDefinition: [
+        zohoDesk,
+        "productId",
+      ],
+    },
   },
   async run({ $ }) {
     const {
@@ -56,18 +125,44 @@ export default {
       contactId,
       subject,
       description,
+      status,
+      priority,
+      assigneeId,
+      channel,
+      classification,
+      category,
+      subCategory,
+      dueDate,
+      email,
+      phone,
+      productId,
     } = this;
 
+    const data = {
+      departmentId,
+      contactId,
+      subject,
+    };
+
+    // Add optional fields
+    if (description) data.description = description;
+    if (status) data.status = status;
+    if (priority) data.priority = priority;
+    if (assigneeId) data.assigneeId = assigneeId;
+    if (channel) data.channel = channel;
+    if (classification) data.classification = classification;
+    if (category) data.category = category;
+    if (subCategory) data.subCategory = subCategory;
+    if (dueDate) data.dueDate = dueDate;
+    if (email) data.email = email;
+    if (phone) data.phone = phone;
+    if (productId) data.productId = productId;
+
     const response = await this.zohoDesk.createTicket({
       headers: {
         orgId,
       },
-      data: {
-        departmentId,
-        contactId,
-        subject,
-        description,
-      },
+      data,
     });
 
     $.export("$summary", `Successfully created a new ticket with ID ${response.id}`);

components/zoho_desk/actions/find-contact/find-contact.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Find Contact",
   description: "Searches for contacts in your help desk portal. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Search#Search_SearchContacts)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/find-or-create-contact/find-or-create-contact.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Find or Create Contact",
   description: "Finds or create a contact. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Contacts#Contacts_CreateContact)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/get-article/get-article.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Get Article",
   description: "Retrieves the details of a knowledge base article. [See the documentation](https://desk.zoho.com/portal/APIDocument.do#KnowledgeBase_Getarticle)",
   type: "action",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/list-articles/list-articles.mjs

@@ -4,7 +4,7 @@ export default {
   name: "List Articles",
   description: "Lists knowledge base articles for a help center. [See the documentation](https://desk.zoho.com/portal/APIDocument.do#KnowledgeBase#KnowledgeBase_Listarticles)",
   type: "action",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/zoho_desk/actions/list-help-centers/list-help-centers.mjs

@@ -5,7 +5,7 @@ export default {
   name: "List Help Centers",
   description: "Lists the help centers configured in an organization. [See the documentation](https://desk.zoho.com/portal/APIDocument.do#HelpCenters_Listhelpcenters)",
   type: "action",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,