@pipedream/jira_service_desk 0.3.0 → 2.0.0

package/actions/create-comment-on-request/create-comment-on-request.mjs

@@ -4,7 +4,7 @@ export default {
   key: "jira_service_desk-create-comment-on-request",
   name: "Create Comment on Request",
   description: "Create a comment on a customer request. [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-comment-post)",
-  version: "0.0.3",
+  version: "0.1.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -23,9 +23,6 @@ export default {
       propDefinition: [
         jiraServiceDesk,
         "requestId",
-        ({ cloudId }) => ({
-          cloudId,
-        }),
       ],
     },
     body: {

package/actions/create-request/create-request.mjs

@@ -1,11 +1,21 @@
+// x-pd-ai: optimized
+import { ConfigurationError } from "@pipedream/platform";
 import jiraServiceDesk from "../../jira_service_desk.app.mjs";
+import constants from "../../common/constants.mjs";
 
 export default {
   key: "jira_service_desk-create-request",
   name: "Create Request",
   description:
-    "Creates a new customer request. [See the documentation](https://docs.atlassian.com/jira-servicedesk/REST/3.6.2/#servicedeskapi/request-createCustomerRequest)",
-  version: "0.1.2",
+    "Creates a customer request (ticket) in a Jira Service Management service desk."
+    + " This is the single tool for creating any kind of ticket (incident, service request, access request, hardware request, and so on)."
+    + " The kind of ticket is decided by `requestTypeId`, not by the wording of the summary, so always pick the request type deliberately."
+    + " Use **List Sites** to get `cloudId`, **List Service Desks** to get `serviceDeskId`, and **List Request Types** to choose the `requestTypeId` whose name and description match the user's intent."
+    + " Call **List Request Type Fields** to see which fields that request type requires; pass anything beyond summary and description in `additionalFieldValues`, keyed by Jira field ID."
+    + " Worked example: on service desk `1`, request type `4` (\"Onboard new employees\") requires `summary` and also accepts a `duedate`, so call with Summary `Joseph Wilson starts on September 1`, Description `Needs a laptop and an email account`, and Additional Field Values `{ \"duedate\": \"2026-09-01\" }`."
+    + " Returns the created request including its `issueKey` and `issueId`."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-post)",
+  version: "1.0.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -24,95 +34,130 @@ export default {
       propDefinition: [
         jiraServiceDesk,
         "serviceDeskId",
-        ({ cloudId }) => ({
-          cloudId,
-        }),
       ],
+      description: "The service desk to raise the request in. Use **List Service Desks** to find valid IDs (e.g. `1`).",
     },
     requestTypeId: {
       propDefinition: [
         jiraServiceDesk,
         "requestTypeId",
-        ({
-          cloudId, serviceDeskId,
-        }) => ({
-          cloudId,
-          serviceDeskId,
-        }),
       ],
-      reloadProps: true,
+      description: "The request type that determines what kind of ticket this is. Use **List Request Types** to see the types this service desk offers and pick the one matching the user's intent (e.g. `8` for \"Report a system problem\").",
+    },
+    summary: {
+      type: "string",
+      label: "Summary",
+      description: "One-line title of the request, e.g. `Laptop won't boot after the latest update`. Required by virtually every request type.",
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "Body of the request, as plain text.",
+      optional: true,
+    },
+    additionalFieldValues: {
+      type: "object",
+      label: "Additional Field Values",
+      description:
+        "Any other fields the chosen request type requires or accepts, as a JSON object of Jira field ID to value, e.g. `{ \"duedate\": \"2026-09-01\", \"customfield_10052\": \"Laptop\" }`."
+        + " Run **List Request Type Fields** for the exact `fieldId`s, which are required, and their schemas."
+        + " Values that parse as JSON are converted (`[\"a\",\"b\"]` becomes a list, `5` becomes a number); to keep a numeric-looking value a string, wrap it in quotes (`\"\\\"123\\\"\"`)."
+        + " Keys `summary` and `description` given here override the props above.",
+      optional: true,
     },
     requestParticipants: {
       type: "string[]",
       label: "Request Participants",
-      description:
-        "Not available to users who only have the Service Desk Customer permission or if the feature is turned off for customers..",
+      description: "Atlassian account IDs to add as participants, e.g. `[\"5b10a2844c20165700ede21g\"]`. Not available to users who only have the Service Desk Customer permission, or if the feature is turned off for customers.",
       optional: true,
     },
     raiseOnBehalfOf: {
       type: "string",
       label: "Raise On Behalf Of",
-      description:
-        "Not available to users who only have the Service Desk Customer permission.",
+      description: "Atlassian account ID of the customer to raise this request for, e.g. `5b10a2844c20165700ede21g`. Not available to users who only have the Service Desk Customer permission.",
+      optional: true,
+    },
+    form: {
+      type: "object",
+      label: "Form",
+      description: "Answers to the form attached to the request type, as `{ \"answers\": { \"<questionId>\": { \"text\": \"...\" } } }`. Omit any Jira field from `additionalFieldValues` when it is linked to a form answer here. For answers in ADF, also set `isAdfRequest` to `true`.",
+      optional: true,
+    },
+    isAdfRequest: {
+      type: "boolean",
+      label: "Is ADF Request",
+      description: "Set to `true` to send rich-text fields (such as `description`) as Atlassian Document Format objects rather than plain text. Leave unset to send plain strings. When `true`, do not use the Description prop, which only sends plain text: pass the ADF object as a JSON string under the `description` key of `additionalFieldValues` instead. Marked experimental by Atlassian.",
+      optional: true,
+    },
+    channel: {
+      type: "string",
+      label: "Channel",
+      description: "Extra information about the channel the request came in on. Marked experimental by Atlassian.",
       optional: true,
     },
-  },
-  async additionalProps() {
-    const {
-      cloudId, serviceDeskId, requestTypeId,
-    } = this;
-    const types = await this.jiraServiceDesk.getRequestTypeFields({
-      cloudId,
-      serviceDeskId,
-      requestTypeId,
-    });
-
-    return Object.fromEntries(
-      types.map((field) => [
-        field.fieldId,
-        {
-          type: "string",
-          label: `Field: "${field.name}"`,
-          description: `[See the documentation](https://docs.atlassian.com/jira-servicedesk/REST/3.6.2/#fieldformats) for info on specific fields. If the provided value is not a string, it will be parsed as JSON.${field.description
-            ? `
-\\
-Field description: "${field.description}"`
-            : ""}${field.jiraSchema
-            ? `
-  \\
-  Field schema: \`${JSON.stringify(field.jiraSchema)}\``
-            : ""}`,
-          optional: !field.required,
-        },
-      ]),
-    );
   },
   async run({ $ }) {
     const {
-      // eslint-disable-next-line no-unused-vars
       jiraServiceDesk,
       cloudId,
       serviceDeskId,
       requestTypeId,
+      summary,
+      description,
+      additionalFieldValues,
       requestParticipants,
       raiseOnBehalfOf,
-      ...requestFieldValues
+      form,
+      isAdfRequest,
+      channel,
     } = this;
 
-    Object.entries(requestFieldValues).forEach(([
-      key,
-      value,
-    ]) => {
+    let extraFields = additionalFieldValues;
+    if (typeof extraFields === "string") {
       try {
-        const parsedValue = JSON.parse(value);
-        requestFieldValues[key] = parsedValue;
+        extraFields = JSON.parse(extraFields);
+      } catch (error) {
+        throw new ConfigurationError(`Additional Field Values is not valid JSON: ${error.message}`);
       }
-      catch (err) {
-        // ignore non-serializable values
-      }
-    });
+    }
+    if (extraFields != null && (typeof extraFields !== "object" || Array.isArray(extraFields))) {
+      throw new ConfigurationError("Additional Field Values must be a JSON object of Jira field ID to value (not a list or a single value).");
+    }
 
-    const response = await this.jiraServiceDesk.createCustomerRequest({
+    // Object props arrive from the UI with string values; parse the ones that carry
+    // non-string Jira field types (arrays, objects, numbers) and leave the rest as text.
+    const parsedExtraFields = Object.fromEntries(
+      Object.entries(extraFields ?? {}).map(([
+        fieldId,
+        value,
+      ]) => {
+        if (typeof value !== "string") {
+          return [
+            fieldId,
+            value,
+          ];
+        }
+        try {
+          return [
+            fieldId,
+            JSON.parse(value),
+          ];
+        } catch {
+          return [
+            fieldId,
+            value,
+          ];
+        }
+      }),
+    );
+
+    const requestFieldValues = {
+      [constants.REQUEST_FIELD.SUMMARY]: summary,
+      [constants.REQUEST_FIELD.DESCRIPTION]: description,
+      ...parsedExtraFields,
+    };
+
+    const response = await jiraServiceDesk.createCustomerRequest({
       $,
       cloudId,
       data: {
@@ -121,9 +166,13 @@ Field description: "${field.description}"`
         requestFieldValues,
         requestParticipants,
         raiseOnBehalfOf,
+        form,
+        isAdfRequest,
+        channel,
       },
     });
-    $.export("$summary", "Successfully created request");
+
+    $.export("$summary", `Successfully created request ${response.issueKey}`);
     return response;
   },
 };

package/actions/get-current-user/get-current-user.mjs

@@ -8,7 +8,7 @@ export default {
     + " Use this to identify who is logged in, or to filter requests by the current user's `account_id`."
     + " No `cloudId` required — this uses the Atlassian Identity API directly."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/)",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-request/get-request.mjs

@@ -4,12 +4,13 @@ export default {
   key: "jira_service_desk-get-request",
   name: "Get Request",
   description:
-    "Fetches the full details of a Jira Service Desk request including its field values and complete comment thread in a single response."
+    "Fetches the full details of a Jira Service Desk request including its field values and comment thread in a single response."
+    + " Comments are paginated automatically up to `maxResults`; the summary says so when the thread was truncated."
     + " Use this to summarize a ticket without needing follow-up calls."
     + " Use **List Sites** first to obtain the required `cloudId`."
     + " Use **List My Requests** to find the `issueKey` of a request (e.g. `IT-42`)."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-get)",
-  version: "0.0.1",
+  version: "0.2.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -30,11 +31,21 @@ export default {
         "issueIdOrKey",
       ],
     },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+      label: "Max Comments",
+      description: "Maximum number of comments to return across all pages (1-1000).",
+    },
   },
   async run({ $ }) {
     const [
       request,
-      comments,
+      {
+        results: comments, hasMore,
+      },
     ] = await Promise.all([
       this.app.getRequest({
         $,
@@ -45,16 +56,20 @@ export default {
         $,
         cloudId: this.cloudId,
         issueIdOrKey: this.issueIdOrKey,
+        maxResults: this.maxResults,
       }),
     ]);
 
     const summary = request.requestFieldValues?.find?.(({ fieldId }) => fieldId === "summary")?.value
       || this.issueIdOrKey;
 
-    $.export("$summary", `Request ${request.issueKey}: ${summary} (${comments?.length ?? 0} comment(s))`);
+    $.export("$summary", `Request ${request.issueKey}: ${summary} (${comments.length}${hasMore
+      ? "+"
+      : ""} comment(s))`);
     return {
       ...request,
       comments,
+      commentsTruncated: hasMore,
     };
   },
 };

package/actions/get-request-status/get-request-status.mjs

@@ -4,12 +4,14 @@ export default {
   key: "jira_service_desk-get-request-status",
   name: "Get Request Status",
   description:
-    "Returns the status history of a Jira Service Desk request — the current status plus all previous states with timestamps."
+    "Returns the status history of a Jira Service Desk request: the current status plus previous states with timestamps."
+    + " The history is paginated automatically up to `maxResults`."
+    + " Returns `{ statuses, truncated }`, newest first, where `truncated` is `true` when more entries remained unfetched."
     + " Use this to understand how a request has progressed through the workflow."
     + " Use **List Sites** first to obtain the required `cloudId`."
     + " Use **List My Requests** to find the `issueKey` (e.g. `IT-42`)."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-status-get)",
-  version: "0.0.1",
+  version: "1.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -30,15 +32,31 @@ export default {
         "issueIdOrKey",
       ],
     },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+      label: "Max Entries",
+      description: "Maximum number of status history entries to return across all pages (1-1000).",
+    },
   },
   async run({ $ }) {
-    const statuses = await this.app.getRequestStatus({
+    const {
+      results: statuses, hasMore,
+    } = await this.app.getRequestStatus({
       $,
       cloudId: this.cloudId,
       issueIdOrKey: this.issueIdOrKey,
+      maxResults: this.maxResults,
     });
     const current = statuses?.[0]?.status || "unknown";
-    $.export("$summary", `Status history for ${this.issueIdOrKey}: current status is "${current}" (${statuses?.length ?? 0} entries)`);
-    return statuses;
+    $.export("$summary", `Status history for ${this.issueIdOrKey}: current status is "${current}" (${statuses.length}${hasMore
+      ? "+"
+      : ""} entries)`);
+    return {
+      statuses,
+      truncated: hasMore,
+    };
   },
 };

package/actions/list-cloud-id-options/list-cloud-id-options.mjs

@@ -3,8 +3,8 @@ import jira_service_desk from "../../jira_service_desk.app.mjs";
 export default {
   key: "jira_service_desk-list-cloud-id-options",
   name: "List Cloud ID Options",
-  description: "Retrieves available options for the Cloud ID field.",
-  version: "0.0.2",
+  description: "Lists the Atlassian sites you can raise requests on, as `{label, value}` options, to discover the `cloudId` every other Jira Service Desk tool needs. Takes no input beyond the account. Example: returns `[{ \"label\": \"acme\", \"value\": \"822faf0d-5427-420e-9016-999d3dc76918\" }]`. Use **List Sites** instead if you want the full site records. [See the documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#3-1-get-the-cloudid-for-your-site)",
+  version: "0.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -15,8 +15,17 @@ export default {
     jira_service_desk,
   },
   async run({ $ }) {
-    const options = await jira_service_desk.propDefinitions.cloudId.options
-      .call(this.jira_service_desk);
+    const sites = await this.jira_service_desk.getSites({
+      $,
+    });
+    const options = sites
+      ?.filter?.(({ scopes }) => scopes?.includes("write:servicedesk-request"))
+      ?.map?.(({
+        id, name,
+      }) => ({
+        label: name,
+        value: id,
+      })) ?? [];
     $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
       ? ""
       : "s"}`);

package/actions/list-my-requests/list-my-requests.mjs

@@ -6,12 +6,14 @@ export default {
   description:
     "Lists Jira Service Desk requests owned or participated in by the current user."
     + " Defaults to open requests owned by the current user."
+    + " Results are paginated automatically up to `maxResults`."
+    + " Returns `{ requests, truncated }`, where `truncated` is `true` when more requests remained unfetched."
     + " Use **List Sites** first to obtain the required `cloudId`."
     + " Each result includes `issueKey`, `issueId`, and request field values (summary, status)."
     + " `requestStatus`: `OPEN_REQUESTS` (default), `CLOSED_REQUESTS`, or `ALL_REQUESTS`."
     + " `requestOwnership`: `OWNED_REQUESTS` (default) or `PARTICIPATED_REQUESTS`."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-get)",
-  version: "0.0.1",
+  version: "1.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -53,16 +55,31 @@ export default {
       ],
       optional: true,
     },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+      description: "Maximum number of requests to return across all pages (1-1000).",
+    },
   },
   async run({ $ }) {
-    const requests = await this.app.listMyRequests({
+    const {
+      results: requests, hasMore,
+    } = await this.app.listMyRequests({
       $,
       cloudId: this.cloudId,
       serviceDeskId: this.serviceDeskId,
       requestStatus: this.requestStatus,
       requestOwnership: this.requestOwnership,
+      maxResults: this.maxResults,
     });
-    $.export("$summary", `Found ${requests?.length ?? 0} request(s)`);
-    return requests;
+    $.export("$summary", `Found ${requests.length} request(s)${hasMore
+      ? ", truncated at Max Results; raise it to fetch more"
+      : ""}`);
+    return {
+      requests,
+      truncated: hasMore,
+    };
   },
 };

package/actions/list-request-transitions/list-request-transitions.mjs

@@ -4,12 +4,14 @@ export default {
   key: "jira_service_desk-list-request-transitions",
   name: "List Request Transitions",
   description:
-    "Lists the available workflow transitions for a Jira Service Desk request — returns each transition's `id` and `name`."
-    + " **Call this before `Transition Request`** to obtain valid `transitionId` values."
+    "Lists the available workflow transitions for a Jira Service Desk request, returning each transition's `id` and `name`."
+    + " Transitions are paginated automatically up to `maxResults`."
+    + " Returns `{ transitions, truncated }`, where `truncated` is `true` when more transitions remained unfetched."
+    + " Call this before **Transition Request** to obtain valid `transitionId` values."
     + " Use **List Sites** first to obtain the required `cloudId`."
     + " Use **List My Requests** or **Get Request** to find the `issueKey` (e.g. `IT-42`)."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-transition-get)",
-  version: "0.0.1",
+  version: "1.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -30,14 +32,30 @@ export default {
         "issueIdOrKey",
       ],
     },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+      label: "Max Transitions",
+      description: "Maximum number of transitions to return across all pages (1-1000).",
+    },
   },
   async run({ $ }) {
-    const transitions = await this.app.getRequestTransitions({
+    const {
+      results: transitions, hasMore,
+    } = await this.app.getRequestTransitions({
       $,
       cloudId: this.cloudId,
       issueIdOrKey: this.issueIdOrKey,
+      maxResults: this.maxResults,
     });
-    $.export("$summary", `Found ${transitions?.length ?? 0} available transition(s) for ${this.issueIdOrKey}`);
-    return transitions;
+    $.export("$summary", `Found ${transitions.length}${hasMore
+      ? "+"
+      : ""} available transition(s) for ${this.issueIdOrKey}`);
+    return {
+      transitions,
+      truncated: hasMore,
+    };
   },
 };

package/actions/list-request-type-fields/list-request-type-fields.mjs

@@ -0,0 +1,87 @@
+// x-pd-ai: optimized
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-list-request-type-fields",
+  name: "List Request Type Fields",
+  description:
+    "Lists the fields a given request type accepts, so you can build the `additionalFieldValues` argument for **Create Request** in a single pass."
+    + " Each entry gives the `fieldId` to use as the key, whether it is `required`, its `jiraSchema` (the value format), and any `validValues` for select-style fields."
+    + " Use **List Sites** for `cloudId`, **List Service Desks** for `serviceDeskId`, and **List Request Types** for `requestTypeId`."
+    + " Example: request type `4` (\"Onboard new employees\") on service desk `1` returns a required `summary` plus optional `duedate` (`jiraSchema.type` `date`, so pass `\"2026-09-01\"`), `description`, and `attachment`."
+    + " Also returns `canRaiseOnBehalfOf` and `canAddRequestParticipants`, which tell you whether the `raiseOnBehalfOf` and `requestParticipants` arguments of **Create Request** are usable with this account."
+    + " Hidden fields are only visible to service desk administrators."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-requesttypeid-field-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    serviceDeskId: {
+      propDefinition: [
+        app,
+        "serviceDeskId",
+      ],
+      description: "The service desk the request type belongs to. Use **List Service Desks** to find valid IDs (e.g. `1`).",
+    },
+    requestTypeId: {
+      propDefinition: [
+        app,
+        "requestTypeId",
+      ],
+      description: "The request type whose fields to list. Use **List Request Types** to find valid IDs (e.g. `4`).",
+    },
+    expand: {
+      propDefinition: [
+        app,
+        "expand",
+      ],
+      description: "Extra data to include. Pass `[\"hiddenFields\"]` to also return fields hidden on the request type, which only a service desk administrator can see. `hiddenFields` is the only value this endpoint accepts.",
+    },
+  },
+  async run({ $ }) {
+    const {
+      requestTypeFields, canRaiseOnBehalfOf, canAddRequestParticipants,
+    } = await this.app.getRequestTypeCreateMeta({
+      $,
+      cloudId: this.cloudId,
+      serviceDeskId: this.serviceDeskId,
+      requestTypeId: this.requestTypeId,
+      params: {
+        expand: this.expand,
+      },
+    });
+
+    const fields = requestTypeFields?.map?.(({
+      fieldId, name, description, required, jiraSchema, validValues, defaultValues, visible,
+    }) => ({
+      fieldId,
+      name,
+      description,
+      required,
+      jiraSchema,
+      validValues,
+      defaultValues,
+      visible,
+    })) ?? [];
+
+    $.export("$summary", `Found ${fields.length} field${fields.length === 1
+      ? ""
+      : "s"}`);
+    return {
+      requestTypeFields: fields,
+      canRaiseOnBehalfOf,
+      canAddRequestParticipants,
+    };
+  },
+};

package/actions/list-request-types/list-request-types.mjs

@@ -0,0 +1,124 @@
+// x-pd-ai: optimized
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-list-request-types",
+  name: "List Request Types",
+  description:
+    "Lists the customer request types a service desk offers, with the `id`, `name`, and `description` of each."
+    + " Call this before **Create Request** to choose the `requestTypeId` that matches what the user is asking for: the request type, not the summary wording, decides what kind of ticket gets created."
+    + " Names vary by desk, so match on meaning rather than assuming a type called \"Incident\" exists (an IT desk may instead offer \"Report a system problem\")."
+    + " Use **List Sites** for `cloudId` and **List Service Desks** for `serviceDeskId`."
+    + " Results are paginated automatically up to `maxResults`."
+    + " Returns `{ requestTypes, truncated }`, where `truncated` is `true` when more types remained unfetched."
+    + " Example: service desk `1` returns entries such as `{ \"id\": \"8\", \"name\": \"Report a system problem\", \"description\": \"Let us know if something isn't working properly\", \"canCreateRequest\": true }`."
+    + " Types with `canCreateRequest: false` cannot be used to raise a request."
+    + " Then call **List Request Type Fields** to see what the chosen type requires."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    serviceDeskId: {
+      propDefinition: [
+        app,
+        "serviceDeskId",
+      ],
+      description: "The service desk whose request types to list. Use **List Service Desks** to find valid IDs (e.g. `1`).",
+    },
+    searchQuery: {
+      type: "string",
+      label: "Search Query",
+      description: "Filter results to request types matching this text, e.g. `hardware`. Omit to return every type the desk offers.",
+      optional: true,
+    },
+    groupId: {
+      type: "integer",
+      label: "Group ID",
+      description: "Filter results to a single request type group. Group IDs appear as `groupIds` on the request types returned by this action.",
+      optional: true,
+    },
+    restrictionStatus: {
+      type: "string",
+      label: "Restriction Status",
+      description: "Filter by whether the request type is open to all customers or restricted.",
+      options: [
+        "open",
+        "restricted",
+      ],
+      optional: true,
+    },
+    includeHiddenRequestTypesInSearch: {
+      type: "boolean",
+      label: "Include Hidden Request Types In Search",
+      description: "Whether to include hidden request types. Only applies together with `searchQuery`.",
+      optional: true,
+    },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+    },
+    expand: {
+      propDefinition: [
+        app,
+        "expand",
+      ],
+      description: "Extra data to include on each request type. Pass `[\"field\"]` to return the type's fields inline, which saves a follow-up **List Request Type Fields** call. `field` is the only value this endpoint accepts.",
+    },
+  },
+  async run({ $ }) {
+    const {
+      results, hasMore,
+    } = await this.app.getRequestTypes({
+      $,
+      cloudId: this.cloudId,
+      serviceDeskId: this.serviceDeskId,
+      maxResults: this.maxResults,
+      params: {
+        searchQuery: this.searchQuery,
+        groupId: this.groupId,
+        restrictionStatus: this.restrictionStatus,
+        includeHiddenRequestTypesInSearch: this.includeHiddenRequestTypesInSearch,
+        expand: this.expand,
+      },
+    });
+
+    const requestTypes = results.map(({
+      id, name, description, helpText, issueTypeId, serviceDeskId, groupIds, canCreateRequest,
+      fields,
+    }) => ({
+      id,
+      name,
+      description,
+      helpText,
+      issueTypeId,
+      serviceDeskId,
+      groupIds,
+      canCreateRequest,
+      fields,
+    }));
+
+    $.export("$summary", `Found ${requestTypes.length} request type${requestTypes.length === 1
+      ? ""
+      : "s"}${hasMore
+      ? ", truncated at Max Results; raise it to fetch more"
+      : ""}`);
+    return {
+      requestTypes,
+      truncated: hasMore,
+    };
+  },
+};

package/actions/list-service-desks/list-service-desks.mjs

@@ -0,0 +1,66 @@
+// x-pd-ai: optimized
+import app from "../../jira_service_desk.app.mjs";
+
+export default {
+  key: "jira_service_desk-list-service-desks",
+  name: "List Service Desks",
+  description:
+    "Lists every service desk on an Atlassian site, with the `id` and project details of each."
+    + " Call this to discover the `serviceDeskId` required by **Create Request**, **List Request Types**, and **List My Requests** when you only know a project name or key."
+    + " Use **List Sites** first to obtain the required `cloudId`."
+    + " Results are paginated automatically up to `maxResults`."
+    + " Returns `{ serviceDesks, truncated }`, where `truncated` is `true` when more desks remained unfetched."
+    + " Example: a site with one desk returns `{ \"serviceDesks\": [{ \"id\": \"1\", \"projectName\": \"Support\", \"projectKey\": \"SUP\" }], \"truncated\": false }`."
+    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    cloudId: {
+      propDefinition: [
+        app,
+        "cloudId",
+      ],
+    },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const {
+      results, hasMore,
+    } = await this.app.getServiceDesks({
+      $,
+      cloudId: this.cloudId,
+      maxResults: this.maxResults,
+    });
+
+    const serviceDesks = results.map(({
+      id, projectId, projectName, projectKey, projectTypeKey,
+    }) => ({
+      id,
+      projectId,
+      projectName,
+      projectKey,
+      projectTypeKey,
+    }));
+
+    $.export("$summary", `Found ${serviceDesks.length} service desk${serviceDesks.length === 1
+      ? ""
+      : "s"}${hasMore
+      ? ", truncated at Max Results; raise it to fetch more"
+      : ""}`);
+    return {
+      serviceDesks,
+      truncated: hasMore,
+    };
+  },
+};

package/actions/list-sites/list-sites.mjs

@@ -8,7 +8,7 @@ export default {
     + " **Call this tool first** to obtain the `cloudId` (returned as `id`) required by every other Jira Service Desk tool."
     + " Each site includes its `id` (cloudId), `name`, and `url`."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#3-1-get-the-cloudid-for-your-site)",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/transition-request/transition-request.mjs

@@ -10,7 +10,7 @@ export default {
     + " Use **List My Requests** or **Get Request** to find the `issueKey` (e.g. `IT-42`)."
     + " Optionally include a comment to explain the transition."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-transition-post)",
-  version: "0.0.1",
+  version: "0.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -34,7 +34,7 @@ export default {
     transitionId: {
       type: "string",
       label: "Transition ID",
-      description: "The ID of the transition to perform. Use **List Request Transitions** to retrieve available transition IDs and names.",
+      description: "The ID of the transition to perform. Use **List Request Transitions** to retrieve available transition IDs and names (in its `transitions` array).",
     },
     additionalComment: {
       type: "string",

package/actions/update-issue-fields/update-issue-fields.mjs

@@ -11,7 +11,7 @@ export default {
     + " `fields` is a JSON object of field name-value pairs."
     + " Example: `{\"summary\": \"Updated title\", \"priority\": {\"name\": \"High\"}}`."
     + " [See the documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put)",
-  version: "0.0.1",
+  version: "0.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,

package/common/constants.mjs

@@ -0,0 +1,26 @@
+// Jira Service Management caps the page size of each paginated `servicedeskapi`
+// resource server-side, and the cap differs per resource (verified live:
+// `/request` clamps to 100, `/request/{id}/comment` clamps to 50). Atlassian
+// documents the cap as an implementation detail that may change, so `_paginate`
+// requests this page size and then keys off the returned `isLastPage` and
+// `size` rather than assuming the page it asked for is the page it got.
+// https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/#pagination
+const PAGE_SIZE = 100;
+
+// Ceiling on how many items a single action run will collect across pages.
+const MAX_RESULTS_DEFAULT = 100;
+const MAX_RESULTS_MIN = 1;
+const MAX_RESULTS_MAX = 1000;
+
+const REQUEST_FIELD = {
+  SUMMARY: "summary",
+  DESCRIPTION: "description",
+};
+
+export default {
+  PAGE_SIZE,
+  MAX_RESULTS_DEFAULT,
+  MAX_RESULTS_MIN,
+  MAX_RESULTS_MAX,
+  REQUEST_FIELD,
+};

package/jira_service_desk.app.mjs

@@ -1,4 +1,6 @@
+// x-pd-ai: optimized
 import { axios } from "@pipedream/platform";
+import constants from "./common/constants.mjs";
 
 export default {
   type: "app",
@@ -7,75 +9,42 @@ export default {
     cloudId: {
       type: "string",
       label: "Cloud ID",
-      description: "Select a site, or provide a custom ID.",
-      async options() {
-        const sites = await this.getSites();
-        return sites?.filter?.(({ scopes }) => scopes?.includes("write:servicedesk-request")).map(({
-          id, name,
-        }) => ({
-          label: name,
-          value: id,
-        }));
-      },
+      description: "The Atlassian site (cloud) ID, e.g. `822faf0d-5427-420e-9016-999d3dc76918`. Run **List Sites** to get the `id` of every site you can access.",
     },
     serviceDeskId: {
       type: "string",
       label: "Service Desk ID",
-      description: "Select a service desk, or provide a custom ID.",
-      async options({ cloudId }) {
-        const desks = await this.getServiceDesks({
-          cloudId,
-        });
-        return desks?.map?.(({
-          id, projectName,
-        }) => ({
-          label: projectName,
-          value: id,
-        }));
-      },
+      description: "The numeric ID of the service desk, e.g. `1`. Run **List Service Desks** to find it from a project name or key.",
     },
     requestId: {
       type: "string",
       label: "Request ID",
-      description: "Select a request, or provide a custom ID.",
-      async options({ cloudId }) {
-        const requests = await this.getCustomerRequests({
-          cloudId,
-        });
-        return requests?.map?.(({
-          issueId, issueKey, requestFieldValues,
-        }) => {
-          const summary = requestFieldValues?.find?.(({ fieldId }) => fieldId === "summary")?.value;
-          return ({
-            label: `(${issueKey}) ${summary}`,
-            value: issueId,
-          });
-        });
-      },
+      description: "The `issueId` of the customer request, e.g. `10288`. Run **List My Requests** to find it.",
     },
     requestTypeId: {
       type: "string",
       label: "Request Type ID",
-      description: "Select a request type, or provide a custom ID.",
-      async options({
-        cloudId, serviceDeskId,
-      }) {
-        const types = await this.getRequestTypes({
-          cloudId,
-          serviceDeskId,
-        });
-        return types?.map?.(({
-          id, name,
-        }) => ({
-          label: name,
-          value: id,
-        }));
-      },
+      description: "The numeric ID of the request type, e.g. `4`. Run **List Request Types** to see what a service desk offers and pick the type matching the user's intent.",
     },
     issueIdOrKey: {
       type: "string",
       label: "Issue ID or Key",
-      description: "The ID or key of the Jira Service Desk request (e.g. `IT-42` or `10001`). Use **List My Requests** to find the `issueKey` of a request.",
+      description: "The ID or key of the Jira Service Desk request (e.g. `IT-42` or `10001`). Use **List My Requests** to find the `issueKey` of a request (in its `requests` array).",
+    },
+    maxResults: {
+      type: "integer",
+      label: "Max Results",
+      description: `Maximum number of items to return across all pages (${constants.MAX_RESULTS_MIN}-${constants.MAX_RESULTS_MAX}).`,
+      optional: true,
+      default: constants.MAX_RESULTS_DEFAULT,
+      min: constants.MAX_RESULTS_MIN,
+      max: constants.MAX_RESULTS_MAX,
+    },
+    expand: {
+      type: "string[]",
+      label: "Expand",
+      description: "Additional data to include in the response, as a list of expansion names (e.g. `[\"field\"]`). Valid values differ per endpoint and are listed in the `_expands` property of that endpoint's response. Unrecognised names are ignored silently rather than rejected.",
+      optional: true,
     },
   },
   methods: {
@@ -94,40 +63,97 @@ export default {
         },
       });
     },
+    /**
+     * Walks a paginated `servicedeskapi` collection until the API reports
+     * `isLastPage`, or until `maxResults` items have been collected.
+     *
+     * @returns {Promise<{ results: object[], hasMore: boolean }>} the collected
+     * items and whether the API still had more to give when collection stopped.
+     */
+    async _paginate({
+      $, path, params, maxResults = constants.MAX_RESULTS_DEFAULT,
+    }) {
+      const results = [];
+      let start = 0;
+      let isLastPage = false;
+
+      while (results.length < maxResults) {
+        const response = await this._makeRequest({
+          $,
+          path,
+          params: {
+            ...params,
+            start,
+            limit: Math.min(maxResults - results.length, constants.PAGE_SIZE),
+          },
+        });
+
+        const values = response?.values;
+        if (!values?.length) {
+          isLastPage = true;
+          break;
+        }
+
+        results.push(...values);
+        isLastPage = Boolean(response.isLastPage);
+        if (isLastPage) {
+          break;
+        }
+
+        // The API may cap a page below the requested `limit`, so advance by what
+        // was actually returned instead of by the requested page size.
+        start += response.size || values.length;
+      }
+
+      return {
+        results: results.slice(0, maxResults),
+        hasMore: !isLastPage || results.length > maxResults,
+      };
+    },
     async getSites({ $ } = {}) {
       return this._makeRequest({
         $,
         path: "/oauth/token/accessible-resources",
       });
     },
-    async getServiceDesks({ cloudId }) {
-      const response = await this._makeRequest({
+    async getServiceDesks({
+      $, cloudId, maxResults,
+    }) {
+      const { results } = await this._paginate({
+        $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/servicedesk`,
+        maxResults,
       });
-      return response.values;
+      return results;
     },
     async getRequestTypes({
-      $, cloudId, serviceDeskId,
+      $, cloudId, serviceDeskId, params, maxResults,
     }) {
-      const response = await this._makeRequest({
+      const { results } = await this._paginate({
         $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/servicedesk/${serviceDeskId}/requesttype`,
+        params,
+        maxResults,
       });
-      return response.values;
+      return results;
     },
-    async getRequestTypeFields({
-      cloudId, serviceDeskId, requestTypeId,
+    async getRequestTypeCreateMeta({
+      $, cloudId, serviceDeskId, requestTypeId, params,
     }) {
-      const response = await this._makeRequest({
+      return this._makeRequest({
+        $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/servicedesk/${serviceDeskId}/requesttype/${requestTypeId}/field`,
+        params,
       });
-      return response.requestTypeFields;
     },
-    async getCustomerRequests({ cloudId }) {
-      const response = await this._makeRequest({
+    async getCustomerRequests({
+      $, cloudId,
+    }) {
+      const { results } = await this._paginate({
+        $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/request`,
       });
-      return response.values;
+      return results;
     },
     async createCustomerRequest({
       cloudId, ...opts
@@ -154,19 +180,21 @@ export default {
       });
     },
     async listMyRequests({
-      $, cloudId, serviceDeskId, requestStatus, requestOwnership,
+      $, cloudId, serviceDeskId, requestStatus, requestOwnership, maxResults,
     }) {
       const params = {
         requestStatus: requestStatus || "OPEN_REQUESTS",
         requestOwnership: requestOwnership || "OWNED_REQUESTS",
       };
-      if (serviceDeskId) params.serviceDeskId = serviceDeskId;
-      const response = await this._makeRequest({
+      if (serviceDeskId) {
+        params.serviceDeskId = serviceDeskId;
+      }
+      return this._paginate({
         $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/request`,
         params,
+        maxResults,
       });
-      return response.values;
     },
     async getRequest({
       $, cloudId, issueIdOrKey,
@@ -177,31 +205,31 @@ export default {
       });
     },
     async getRequestComments({
-      $, cloudId, issueIdOrKey,
+      $, cloudId, issueIdOrKey, maxResults,
     }) {
-      const response = await this._makeRequest({
+      return this._paginate({
         $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/comment`,
+        maxResults,
       });
-      return response.values;
     },
     async getRequestStatus({
-      $, cloudId, issueIdOrKey,
+      $, cloudId, issueIdOrKey, maxResults,
     }) {
-      const response = await this._makeRequest({
+      return this._paginate({
         $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/status`,
+        maxResults,
       });
-      return response.values;
     },
     async getRequestTransitions({
-      $, cloudId, issueIdOrKey,
+      $, cloudId, issueIdOrKey, maxResults,
     }) {
-      const response = await this._makeRequest({
+      return this._paginate({
         $,
         path: `/ex/jira/${cloudId}/rest/servicedeskapi/request/${issueIdOrKey}/transition`,
+        maxResults,
       });
-      return response.values;
     },
     async transitionRequest({
       cloudId, issueIdOrKey, ...opts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/jira_service_desk",
-  "version": "0.3.0",
+  "version": "2.0.0",
   "description": "Pipedream Jira Service Desk Components",
   "main": "jira_service_desk.app.mjs",
   "keywords": [

package/sources/new-request-created/new-request-created.mjs

@@ -6,7 +6,7 @@ export default {
   name: "New Request Created",
   description:
     "Emit new event when a customer request is created. [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/#api-rest-servicedeskapi-request-get)",
-  version: "0.0.2",
+  version: "0.1.0",
   type: "source",
   dedupe: "unique",
   methods: {

package/sources/request-status-updated/request-status-updated.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Request Status Updated",
   description:
     "Emit new event when a customer request is updated. [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/#api-rest-servicedeskapi-request-get)",
-  version: "0.0.2",
+  version: "0.1.0",
   type: "source",
   dedupe: "unique",
   methods: {

package/actions/create-incident/create-incident.mjs

@@ -1,107 +0,0 @@
-import app from "../../jira_service_desk.app.mjs";
-
-export default {
-  key: "jira_service_desk-create-incident",
-  name: "Create Incident",
-  description:
-    "Creates a new incident request in a Jira Service Desk."
-    + " Auto-discovers the best-matching request type (prefers types named 'incident' or 'problem') and, if `serviceDeskId` is omitted, auto-discovers it from the user's existing requests."
-    + " Use **List Sites** first to obtain the required `cloudId`."
-    + " `serviceDeskId` is optional — if not provided, the tool calls **List My Requests** to discover it automatically."
-    + " Returns the new request including its `issueKey` and `issueId`."
-    + " [See the documentation](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-post)",
-  version: "0.0.1",
-  type: "action",
-  annotations: {
-    destructiveHint: false,
-    openWorldHint: true,
-    readOnlyHint: false,
-  },
-  props: {
-    app,
-    cloudId: {
-      propDefinition: [
-        app,
-        "cloudId",
-      ],
-    },
-    serviceDeskId: {
-      type: "string",
-      label: "Service Desk ID",
-      description: "The numeric ID of the service desk (e.g. `2`). If omitted, the tool auto-discovers it from your existing requests. You can also find it in your Jira Service Management project settings.",
-      optional: true,
-    },
-    summary: {
-      type: "string",
-      label: "Summary",
-      description: "The title/summary of the incident.",
-    },
-    description: {
-      type: "string",
-      label: "Description",
-      description: "A detailed description of the incident.",
-    },
-  },
-  async run({ $ }) {
-    // Auto-discover serviceDeskId if not provided — extract from existing requests
-    let serviceDeskId = this.serviceDeskId;
-    if (!serviceDeskId) {
-      const existingRequests = await this.app.listMyRequests({
-        $,
-        cloudId: this.cloudId,
-      });
-      if (!existingRequests?.length) {
-        throw new Error("No existing requests found to auto-discover serviceDeskId. Please provide serviceDeskId explicitly.");
-      }
-      const uniqueIds = [
-        ...new Set(existingRequests.map((r) => r.serviceDeskId)),
-      ];
-      if (uniqueIds.length > 1) {
-        throw new Error(
-          `Multiple service desks found (${uniqueIds.join(", ")}). Please provide serviceDeskId explicitly.`,
-        );
-      }
-      serviceDeskId = uniqueIds[0];
-    }
-
-    // Auto-discover the best-matching request type for an incident.
-    // Prefers types named "incident" or "problem"; falls back to first available.
-    const requestTypes = await this.app.getRequestTypes({
-      $,
-      cloudId: this.cloudId,
-      serviceDeskId,
-    });
-
-    if (!requestTypes?.length) {
-      throw new Error(`No request types found in service desk ${serviceDeskId}.`);
-    }
-
-    const INCIDENT_KEYWORDS = [
-      "incident",
-      "problem",
-      "system problem",
-      "issue",
-    ];
-
-    const incidentType = requestTypes.find(({ name }) =>
-      INCIDENT_KEYWORDS.some((kw) => name?.toLowerCase().includes(kw))) || requestTypes[0];
-
-    const requestFieldValues = {
-      summary: this.summary,
-      description: this.description,
-    };
-
-    const response = await this.app.createCustomerRequest({
-      $,
-      cloudId: this.cloudId,
-      data: {
-        serviceDeskId,
-        requestTypeId: incidentType.id,
-        requestFieldValues,
-      },
-    });
-
-    $.export("$summary", `Created ${incidentType.name} ${response.issueKey}: ${this.summary}`);
-    return response;
-  },
-};