@credal/actions 0.2.221 → 0.2.223

package/dist/actions/autogen/types.js

@@ -37,6 +37,7 @@ export var ProviderName;
     ProviderName["LINEAR"] = "linear";
     ProviderName["HUBSPOT"] = "hubspot";
     ProviderName["SMARTSHEET"] = "smartsheet";
+    ProviderName["SERVICENOW"] = "servicenow";
     ProviderName["BOXUSER"] = "boxUser";
 })(ProviderName || (ProviderName = {}));
 export var ActionName;
@@ -183,6 +184,11 @@ export var ActionName;
     ActionName["GETSHEETROWS"] = "getSheetRows";
     ActionName["ADDROWTOSHEET"] = "addRowToSheet";
     ActionName["UPDATEROW"] = "updateRow";
+    ActionName["GETRECORDSBYQUERY"] = "getRecordsByQuery";
+    ActionName["GETINCIDENTS"] = "getIncidents";
+    ActionName["GETCHANGEREQUESTS"] = "getChangeRequests";
+    ActionName["GETSCTASKS"] = "getSCTasks";
+    ActionName["GETVIPTICKETS"] = "getVIPTickets";
 })(ActionName || (ActionName = {}));
 export const AuthParamsSchema = z.object({
     authToken: z.string().optional(),
@@ -2413,6 +2419,10 @@ export const googleOauthScheduleCalendarMeetingParamsSchema = z.object({
         .string()
         .describe("The time zone for the meeting, IANA Time Zone identifier (e.g., 'America/New_York')")
         .optional(),
+    transparency: z
+        .enum(["opaque", "transparent"])
+        .describe('Opaque is the default value, and it blocks time on the calendar. This is equivalent to setting "Show me as" to "Busy" in the UI. Transparent means the event does not block time on the calendar. This is equivalent to setting "Show me as" to "Available" in the UI.')
+        .optional(),
     recurrence: z
         .object({
         frequency: z.enum(["DAILY", "WEEKLY", "MONTHLY", "YEARLY"]).describe("How often the meeting repeats").optional(),
@@ -2558,6 +2568,10 @@ export const googleOauthUpdateCalendarEventParamsSchema = z.object({
             .string()
             .describe("The time zone for the event, IANA Time Zone identifier (e.g., 'America/New_York')")
             .optional(),
+        transparency: z
+            .enum(["opaque", "transparent"])
+            .describe('Opaque is the default value, and it blocks time on the calendar. This is equivalent to setting "Show me as" to "Busy" in the UI. Transparent means the event does not block time on the calendar.')
+            .optional(),
     })
         .describe("The fields to update on the event")
         .optional(),
@@ -2592,6 +2606,10 @@ export const googleOauthEditAGoogleCalendarEventParamsSchema = z.object({
         .string()
         .describe("The time zone for the event, IANA Time Zone identifier (e.g., 'America/New_York')")
         .optional(),
+    transparency: z
+        .enum(["opaque", "transparent"])
+        .describe('Opaque is the default value, and it blocks time on the calendar. This is equivalent to setting "Show me as" to "Busy" in the UI. Transparent means the event does not block time on the calendar.')
+        .optional(),
 });
 export const googleOauthEditAGoogleCalendarEventOutputSchema = z.object({
     success: z.boolean().describe("Whether the event was edited successfully"),
@@ -5540,3 +5558,221 @@ export const smartsheetUpdateRowOutputSchema = z.object({
     error: z.string().describe("Error message if the operation failed").optional(),
     rowId: z.string().describe("The ID of the updated row").optional(),
 });
+export const servicenowGetRecordsByQueryParamsSchema = z.object({
+    tableName: z
+        .string()
+        .describe("The ServiceNow table to query (e.g. incident, change_request, sc_request, sys_user, kb_knowledge)"),
+    query: z
+        .string()
+        .describe('ServiceNow encoded query string (sysparm_query) — NOT SQL, JQL, or natural language. Conditions are joined with ^ for AND and ^OR for OR, with no spaces around the ^. Format examples: field=value, field!=value, field>value, fieldLIKEvalue, fieldISEMPTY. Sort with ^ORDERBY<field> (ascending) or ^ORDERBYDESC<field> (descending). Example: "active=true^priority=1^ORDERBYDESCsys_created_on" means active records with priority 1, sorted by most recently created first. If omitted, records are returned unfiltered up to the limit.\n')
+        .optional(),
+    fields: z
+        .array(z.string())
+        .describe("Field names to return for each record (sysparm_fields). All fields are returned if omitted.")
+        .optional(),
+    limit: z.coerce.number().describe("Maximum number of records to return (defaults to 25)").optional(),
+    offset: z.coerce.number().describe("Number of records to skip, for pagination (defaults to 0)").optional(),
+    includeDisplayValues: z
+        .boolean()
+        .describe('If false (default), each field is returned as a plain scalar value (e.g. active: true, priority: "1"). If true, every field is instead returned as an object {value: "<raw value>", display_value: "<human-readable value>"} — useful for reference fields like assigned_to, where value is a sys_id and display_value is the user\'s name.\n')
+        .optional(),
+});
+export const servicenowGetRecordsByQueryOutputSchema = z.object({
+    success: z.boolean().describe("Whether the query was successful"),
+    records: z.array(z.object({}).catchall(z.any())).describe("The records matching the query").optional(),
+    error: z.string().describe("Error message if the query failed").optional(),
+});
+export const servicenowGetIncidentsParamsSchema = z.object({
+    query: z
+        .string()
+        .describe('Optional additional ServiceNow encoded query (sysparm_query) ANDed onto the base incident lookup — NOT SQL, JQL, or natural language. Conditions are joined with ^ for AND and ^OR for OR, with no spaces around the ^. Example: "priority=1^state!=7" for open, priority-1 incidents. Leave empty to return all incidents up to the limit.\n')
+        .optional(),
+    additionalFields: z
+        .array(z.string())
+        .describe('Extra ServiceNow field technical names to fetch for instance-specific/custom fields not covered by the standard output (e.g. a custom "Program Office" field). Values are returned per record under extraFields, keyed by the field name given here.\n')
+        .optional(),
+    limit: z.coerce.number().describe("Maximum number of incidents to return (defaults to 25)").optional(),
+    offset: z.coerce.number().describe("Number of records to skip, for pagination (defaults to 0)").optional(),
+});
+export const servicenowGetIncidentsOutputSchema = z.object({
+    success: z.boolean().describe("Whether the query was successful"),
+    records: z
+        .array(z.object({
+        number: z.string().describe("The incident ticket number (e.g. INC0010023)").optional(),
+        caller: z.string().describe("The name of the person who reported the incident").optional(),
+        assignee: z.string().describe("The name of the person assigned to the incident").optional(),
+        assignmentGroup: z.string().describe("The name of the group assigned to the incident").optional(),
+        shortDescription: z.string().describe("The short description of the incident").optional(),
+        description: z.string().describe("The full description of the incident").optional(),
+        state: z.string().describe("The current state of the incident").optional(),
+        incidentState: z
+            .string()
+            .describe("The current incident-specific state (legacy field on some instances; may be absent)")
+            .optional(),
+        priority: z.string().describe("The priority of the incident").optional(),
+        impact: z.string().describe("The impact of the incident").optional(),
+        urgency: z.string().describe("The urgency of the incident").optional(),
+        openedAt: z.string().describe("The date and time the incident was opened").optional(),
+        updatedAt: z.string().describe("The date and time the incident was last updated").optional(),
+        closedAt: z
+            .string()
+            .describe("The date and time the incident was closed or completed, if applicable")
+            .optional(),
+        workNotes: z.string().describe("Internal work notes on the incident").optional(),
+        comments: z.string().describe("Additional (customer-visible) comments on the incident").optional(),
+        timeToClosureMinutes: z.coerce
+            .number()
+            .describe("Minutes elapsed from opening to final closure, calculated from openedAt and closedAt")
+            .optional(),
+        extraFields: z
+            .object({})
+            .catchall(z.any())
+            .describe("Values for any fields requested via the additionalFields parameter, keyed by field name")
+            .optional(),
+    }))
+        .describe("The incident records matching the query")
+        .optional(),
+    error: z.string().describe("Error message if the query failed").optional(),
+});
+export const servicenowGetChangeRequestsParamsSchema = z.object({
+    query: z
+        .string()
+        .describe('Optional additional ServiceNow encoded query (sysparm_query) ANDed onto the base change request lookup — NOT SQL, JQL, or natural language. Conditions are joined with ^ for AND and ^OR for OR, with no spaces around the ^. Example: "priority=1^state!=3" for open, priority-1 change requests. Leave empty to return all change requests up to the limit.\n')
+        .optional(),
+    additionalFields: z
+        .array(z.string())
+        .describe('Extra ServiceNow field technical names to fetch for instance-specific/custom fields not covered by the standard output (e.g. a custom "Program Office" field). Values are returned per record under extraFields, keyed by the field name given here.\n')
+        .optional(),
+    limit: z.coerce.number().describe("Maximum number of change requests to return (defaults to 25)").optional(),
+    offset: z.coerce.number().describe("Number of records to skip, for pagination (defaults to 0)").optional(),
+});
+export const servicenowGetChangeRequestsOutputSchema = z.object({
+    success: z.boolean().describe("Whether the query was successful"),
+    records: z
+        .array(z.object({
+        number: z.string().describe("The change request number (e.g. CHG0010023)").optional(),
+        requestor: z.string().describe("The name of the person who requested the change").optional(),
+        assignee: z.string().describe("The name of the person assigned to the change request").optional(),
+        assignmentGroup: z.string().describe("The name of the group assigned to the change request").optional(),
+        shortDescription: z.string().describe("The short description of the change request").optional(),
+        description: z.string().describe("The full description of the change request").optional(),
+        state: z.string().describe("The current state of the change request").optional(),
+        priority: z.string().describe("The priority of the change request").optional(),
+        impact: z.string().describe("The impact of the change request").optional(),
+        urgency: z.string().describe("The urgency of the change request").optional(),
+        openedAt: z.string().describe("The date and time the change request was opened").optional(),
+        updatedAt: z.string().describe("The date and time the change request was last updated").optional(),
+        closedAt: z
+            .string()
+            .describe("The date and time the change request was closed or completed, if applicable")
+            .optional(),
+        workNotes: z.string().describe("Internal work notes on the change request").optional(),
+        comments: z.string().describe("Additional (customer-visible) comments on the change request").optional(),
+        timeToClosureMinutes: z.coerce
+            .number()
+            .describe("Minutes elapsed from opening to final closure, calculated from openedAt and closedAt")
+            .optional(),
+        extraFields: z
+            .object({})
+            .catchall(z.any())
+            .describe("Values for any fields requested via the additionalFields parameter, keyed by field name")
+            .optional(),
+    }))
+        .describe("The change request records matching the query")
+        .optional(),
+    error: z.string().describe("Error message if the query failed").optional(),
+});
+export const servicenowGetSCTasksParamsSchema = z.object({
+    query: z
+        .string()
+        .describe('Optional additional ServiceNow encoded query (sysparm_query) ANDed onto the base SCTASK lookup — NOT SQL, JQL, or natural language. Conditions are joined with ^ for AND and ^OR for OR, with no spaces around the ^. Example: "priority=1^state!=3" for open, priority-1 SCTASKs. Leave empty to return all SCTASKs up to the limit.\n')
+        .optional(),
+    additionalFields: z
+        .array(z.string())
+        .describe('Extra ServiceNow field technical names to fetch for instance-specific/custom fields not covered by the standard output (e.g. a custom "Program Office" field). Values are returned per record under extraFields, keyed by the field name given here.\n')
+        .optional(),
+    limit: z.coerce.number().describe("Maximum number of SCTASKs to return (defaults to 25)").optional(),
+    offset: z.coerce.number().describe("Number of records to skip, for pagination (defaults to 0)").optional(),
+});
+export const servicenowGetSCTasksOutputSchema = z.object({
+    success: z.boolean().describe("Whether the query was successful"),
+    records: z
+        .array(z.object({
+        number: z.string().describe("The SCTASK ticket number (e.g. SCTASK0010023)").optional(),
+        ritmNumber: z
+            .string()
+            .describe("The number of the parent Requested Item (RITM) this SCTASK belongs to")
+            .optional(),
+        assignee: z.string().describe("The name of the person assigned to the SCTASK").optional(),
+        assignmentGroup: z.string().describe("The name of the group assigned to the SCTASK").optional(),
+        shortDescription: z.string().describe("The short description of the SCTASK").optional(),
+        description: z.string().describe("The full description of the SCTASK").optional(),
+        state: z.string().describe("The current state of the SCTASK").optional(),
+        priority: z.string().describe("The priority of the SCTASK").optional(),
+        openedAt: z.string().describe("The date and time the SCTASK was opened").optional(),
+        updatedAt: z.string().describe("The date and time the SCTASK was last updated").optional(),
+        closedAt: z.string().describe("The date and time the SCTASK was closed or completed, if applicable").optional(),
+        workNotes: z.string().describe("Internal work notes on the SCTASK").optional(),
+        comments: z.string().describe("Additional (customer-visible) comments on the SCTASK").optional(),
+        timeToClosureMinutes: z.coerce
+            .number()
+            .describe("Minutes elapsed from opening to final closure, calculated from openedAt and closedAt")
+            .optional(),
+        extraFields: z
+            .object({})
+            .catchall(z.any())
+            .describe("Values for any fields requested via the additionalFields parameter, keyed by field name")
+            .optional(),
+    }))
+        .describe("The SCTASK records matching the query")
+        .optional(),
+    error: z.string().describe("Error message if the query failed").optional(),
+});
+export const servicenowGetVIPTicketsParamsSchema = z.object({
+    ticketType: z.enum(["incident", "sc_task"]).describe("Which kind of ticket to look up VIP records for"),
+    query: z
+        .string()
+        .describe('Optional additional ServiceNow encoded query (sysparm_query) ANDed onto the base VIP lookup — NOT SQL, JQL, or natural language. Conditions are joined with ^ for AND and ^OR for OR, with no spaces around the ^. Example: "priority=1" to further narrow to priority-1 VIP tickets. Leave empty to return all VIP tickets of the given type up to the limit.\n')
+        .optional(),
+    additionalFields: z
+        .array(z.string())
+        .describe('Extra ServiceNow field technical names to fetch for instance-specific/custom fields not covered by the standard output (e.g. a custom "Program Office" field). Values are returned per record under extraFields, keyed by the field name given here.\n')
+        .optional(),
+    limit: z.coerce.number().describe("Maximum number of VIP tickets to return (defaults to 25)").optional(),
+    offset: z.coerce.number().describe("Number of records to skip, for pagination (defaults to 0)").optional(),
+});
+export const servicenowGetVIPTicketsOutputSchema = z.object({
+    success: z.boolean().describe("Whether the query was successful"),
+    records: z
+        .array(z.object({
+        ticketType: z.string().describe("Whether this record is an incident or a SCTASK").optional(),
+        number: z.string().describe("The ticket number").optional(),
+        ritmNumber: z
+            .string()
+            .describe("The number of the parent Requested Item (RITM), if this is a SCTASK")
+            .optional(),
+        vipUser: z.string().describe("The name of the VIP caller or requester associated with this ticket").optional(),
+        assignee: z.string().describe("The name of the person assigned to the ticket").optional(),
+        assignmentGroup: z.string().describe("The name of the group assigned to the ticket").optional(),
+        shortDescription: z.string().describe("The short description of the ticket").optional(),
+        description: z.string().describe("The full description of the ticket").optional(),
+        state: z.string().describe("The current state of the ticket").optional(),
+        openedAt: z.string().describe("The date and time the ticket was opened").optional(),
+        updatedAt: z.string().describe("The date and time the ticket was last updated").optional(),
+        closedAt: z.string().describe("The date and time the ticket was closed or completed, if applicable").optional(),
+        workNotes: z.string().describe("Internal work notes on the ticket").optional(),
+        comments: z.string().describe("Additional (customer-visible) comments on the ticket").optional(),
+        timeToClosureMinutes: z.coerce
+            .number()
+            .describe("Minutes elapsed from opening to final closure, calculated from openedAt and closedAt")
+            .optional(),
+        extraFields: z
+            .object({})
+            .catchall(z.any())
+            .describe("Values for any fields requested via the additionalFields parameter, keyed by field name")
+            .optional(),
+    }))
+        .describe("The VIP ticket records matching the query")
+        .optional(),
+    error: z.string().describe("Error message if the query failed").optional(),
+});

package/dist/actions/providers/google-oauth/editAGoogleCalendarEvent.js

@@ -5,7 +5,7 @@ const editAGoogleCalendarEvent = async ({ params, authParams, }) => {
     if (!authParams.authToken) {
         return { success: false, error: MISSING_AUTH_TOKEN, eventId: "", eventUrl: "", eventDayOfWeek: "" };
     }
-    const { calendarId, eventId, title, description, start, end, location, attendees, status, organizer, timeZone } = params;
+    const { calendarId, eventId, title, description, start, end, location, attendees, status, organizer, timeZone, transparency, } = params;
     const url = `https://www.googleapis.com/calendar/v3/calendars/${encodeURIComponent(calendarId)}/events/${encodeURIComponent(eventId)}`;
     const body = {};
     if (title !== undefined)
@@ -32,6 +32,8 @@ const editAGoogleCalendarEvent = async ({ params, authParams, }) => {
         body.status = status;
     if (organizer !== undefined)
         body.organizer = organizer;
+    if (transparency !== undefined)
+        body.transparency = transparency;
     try {
         const res = await axiosClient.patch(url, body, {
             headers: {

package/dist/actions/providers/google-oauth/scheduleCalendarMeeting.js

@@ -18,10 +18,17 @@ function generateRecurrenceRule(recurrence) {
         const year = date.getUTCFullYear();
         const month = String(date.getUTCMonth() + 1).padStart(2, "0");
         const day = String(date.getUTCDate()).padStart(2, "0");
-        const hour = String(date.getUTCHours()).padStart(2, "0");
-        const minute = String(date.getUTCMinutes()).padStart(2, "0");
-        const second = String(date.getUTCSeconds()).padStart(2, "0");
-        rrule += `;UNTIL=${year}${month}${day}T${hour}${minute}${second}Z`; // trufflehog:ignore
+        // Use date-only format for UNTIL when BYDAY is specified (day-based recurrence)
+        // This is required by Google Calendar API for WEEKLY+BYDAY recurrences
+        if (recurrence.byDay && recurrence.byDay.length > 0) {
+            rrule += `;UNTIL=${year}${month}${day}`;
+        }
+        else {
+            const hour = String(date.getUTCHours()).padStart(2, "0");
+            const minute = String(date.getUTCMinutes()).padStart(2, "0");
+            const second = String(date.getUTCSeconds()).padStart(2, "0");
+            rrule += `;UNTIL=${year}${month}${day}T${hour}${minute}${second}Z`; // trufflehog:ignore
+        }
     }
     if (recurrence.byDay && recurrence.byDay.length > 0) {
         rrule += `;BYDAY=${recurrence.byDay.join(",")}`;
@@ -39,7 +46,7 @@ const scheduleCalendarMeeting = async ({ params, authParams, }) => {
     if (!authParams.authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
-    const { calendarId, name, start, end, description, attendees, useGoogleMeet, timeZone, recurrence } = params;
+    const { calendarId, name, start, end, description, attendees, useGoogleMeet, timeZone, recurrence, transparency } = params;
     // https://developers.google.com/calendar/api/v3/reference/events/insert
     let createEventApiUrl = `https://www.googleapis.com/calendar/v3/calendars/${encodeURIComponent(calendarId)}/events`;
     const data = {
@@ -81,6 +88,10 @@ const scheduleCalendarMeeting = async ({ params, authParams, }) => {
             };
         }
     }
+    // Add transparency if specified
+    if (transparency !== undefined) {
+        data.transparency = transparency;
+    }
     try {
         const response = await axiosClient.post(createEventApiUrl, data, {
             headers: {

package/dist/actions/providers/google-oauth/updateCalendarEvent.js

@@ -32,6 +32,8 @@ const updateCalendarEvent = async ({ params, authParams, }) => {
             body.status = updates.status;
         if (updates.organizer != undefined)
             body.organizer = updates.organizer;
+        if (updates.transparency != undefined)
+            body.transparency = updates.transparency;
     }
     try {
         const res = await axiosClient.patch(url, body, {

package/dist/actions/providers/servicenow/getChangeRequests.d.ts

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

package/dist/actions/providers/servicenow/getChangeRequests.js

@@ -0,0 +1,56 @@
+import { computeTimeToClosureMinutes, extractAdditionalFields, queryServiceNowTable } from "./utils/tableQuery.js";
+const CHANGE_REQUEST_FIELDS = [
+    "number",
+    "short_description",
+    "description",
+    "state",
+    "priority",
+    "impact",
+    "urgency",
+    "requested_by",
+    "assigned_to",
+    "assignment_group",
+    "opened_at",
+    "sys_updated_on",
+    "closed_at",
+    "work_notes",
+    "comments",
+];
+const getChangeRequests = async ({ params, authParams, }) => {
+    const { query, additionalFields, limit, offset } = params;
+    const result = await queryServiceNowTable({
+        authParams,
+        tableName: "change_request",
+        fields: CHANGE_REQUEST_FIELDS,
+        filter: query,
+        additionalFields,
+        limit,
+        offset,
+    });
+    if ("error" in result) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        records: result.records.map(record => ({
+            number: record.number,
+            requestor: record.requested_by,
+            assignee: record.assigned_to,
+            assignmentGroup: record.assignment_group,
+            shortDescription: record.short_description,
+            description: record.description,
+            state: record.state,
+            priority: record.priority,
+            impact: record.impact,
+            urgency: record.urgency,
+            openedAt: record.opened_at,
+            updatedAt: record.sys_updated_on,
+            closedAt: record.closed_at,
+            workNotes: record.work_notes,
+            comments: record.comments,
+            timeToClosureMinutes: computeTimeToClosureMinutes(record.opened_at, record.closed_at),
+            extraFields: extractAdditionalFields(record, additionalFields),
+        })),
+    };
+};
+export default getChangeRequests;

package/dist/actions/providers/servicenow/getIncidents.d.ts

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

package/dist/actions/providers/servicenow/getIncidents.js

@@ -0,0 +1,58 @@
+import { computeTimeToClosureMinutes, extractAdditionalFields, queryServiceNowTable } from "./utils/tableQuery.js";
+const INCIDENT_FIELDS = [
+    "number",
+    "short_description",
+    "description",
+    "state",
+    "incident_state",
+    "priority",
+    "impact",
+    "urgency",
+    "caller_id",
+    "assigned_to",
+    "assignment_group",
+    "opened_at",
+    "sys_updated_on",
+    "closed_at",
+    "work_notes",
+    "comments",
+];
+const getIncidents = async ({ params, authParams, }) => {
+    const { query, additionalFields, limit, offset } = params;
+    const result = await queryServiceNowTable({
+        authParams,
+        tableName: "incident",
+        fields: INCIDENT_FIELDS,
+        filter: query,
+        additionalFields,
+        limit,
+        offset,
+    });
+    if ("error" in result) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        records: result.records.map(record => ({
+            number: record.number,
+            caller: record.caller_id,
+            assignee: record.assigned_to,
+            assignmentGroup: record.assignment_group,
+            shortDescription: record.short_description,
+            description: record.description,
+            state: record.state,
+            incidentState: record.incident_state,
+            priority: record.priority,
+            impact: record.impact,
+            urgency: record.urgency,
+            openedAt: record.opened_at,
+            updatedAt: record.sys_updated_on,
+            closedAt: record.closed_at,
+            workNotes: record.work_notes,
+            comments: record.comments,
+            timeToClosureMinutes: computeTimeToClosureMinutes(record.opened_at, record.closed_at),
+            extraFields: extractAdditionalFields(record, additionalFields),
+        })),
+    };
+};
+export default getIncidents;

package/dist/actions/providers/servicenow/getRecordsByQuery.d.ts

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

package/dist/actions/providers/servicenow/getRecordsByQuery.js

@@ -0,0 +1,42 @@
+import { ApiError, axiosClient } from "../../util/axiosClient.js";
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 10000;
+const getRecordsByQuery = async ({ params, authParams, }) => {
+    const { authToken, baseUrl } = authParams;
+    const { tableName, query, fields, limit = DEFAULT_LIMIT, offset = 0, includeDisplayValues = false } = params;
+    if (!authToken || !baseUrl) {
+        return { success: false, error: "authToken and baseUrl are required for the ServiceNow API" };
+    }
+    const cappedLimit = Math.min(limit, MAX_LIMIT);
+    const queryParams = new URLSearchParams();
+    queryParams.append("sysparm_limit", cappedLimit.toString());
+    queryParams.append("sysparm_offset", offset.toString());
+    // "all" nests each field as {value, display_value}; "false" keeps fields as plain scalars
+    queryParams.append("sysparm_display_value", includeDisplayValues ? "all" : "false");
+    queryParams.append("sysparm_exclude_reference_link", "true");
+    if (query) {
+        queryParams.append("sysparm_query", query);
+    }
+    if (fields && fields.length > 0) {
+        queryParams.append("sysparm_fields", fields.join(","));
+    }
+    const url = `${baseUrl.replace(/\/+$/, "")}/api/now/table/${encodeURIComponent(tableName)}?${queryParams.toString()}`;
+    try {
+        const response = await axiosClient.get(url, {
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${authToken}`,
+            },
+        });
+        const result = response.data.result;
+        return { success: true, records: Array.isArray(result) ? result : [] };
+    }
+    catch (error) {
+        console.error("Error querying ServiceNow records:", error);
+        return {
+            success: false,
+            error: error instanceof ApiError ? error.message : "An unknown error occurred",
+        };
+    }
+};
+export default getRecordsByQuery;

package/dist/actions/providers/servicenow/getSCTasks.d.ts

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

package/dist/actions/providers/servicenow/getSCTasks.js

@@ -0,0 +1,53 @@
+import { computeTimeToClosureMinutes, extractAdditionalFields, queryServiceNowTable } from "./utils/tableQuery.js";
+const SC_TASK_FIELDS = [
+    "number",
+    "request_item",
+    "short_description",
+    "description",
+    "state",
+    "priority",
+    "assigned_to",
+    "assignment_group",
+    "opened_at",
+    "sys_updated_on",
+    "closed_at",
+    "work_notes",
+    "comments",
+];
+const getSCTasks = async ({ params, authParams, }) => {
+    const { query, additionalFields, limit, offset } = params;
+    const result = await queryServiceNowTable({
+        authParams,
+        tableName: "sc_task",
+        fields: SC_TASK_FIELDS,
+        filter: query,
+        additionalFields,
+        limit,
+        offset,
+    });
+    if ("error" in result) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        records: result.records.map(record => ({
+            number: record.number,
+            // request_item's display value is the parent Requested Item's number (e.g. RITM0010023)
+            ritmNumber: record.request_item,
+            assignee: record.assigned_to,
+            assignmentGroup: record.assignment_group,
+            shortDescription: record.short_description,
+            description: record.description,
+            state: record.state,
+            priority: record.priority,
+            openedAt: record.opened_at,
+            updatedAt: record.sys_updated_on,
+            closedAt: record.closed_at,
+            workNotes: record.work_notes,
+            comments: record.comments,
+            timeToClosureMinutes: computeTimeToClosureMinutes(record.opened_at, record.closed_at),
+            extraFields: extractAdditionalFields(record, additionalFields),
+        })),
+    };
+};
+export default getSCTasks;

package/dist/actions/providers/servicenow/getVIPTickets.d.ts

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

package/dist/actions/providers/servicenow/getVIPTickets.js

@@ -0,0 +1,61 @@
+import { computeTimeToClosureMinutes, extractAdditionalFields, queryServiceNowTable, } from "./utils/tableQuery.js";
+const SHARED_FIELDS = [
+    "number",
+    "assigned_to",
+    "assignment_group",
+    "short_description",
+    "description",
+    "state",
+    "opened_at",
+    "sys_updated_on",
+    "closed_at",
+    "work_notes",
+    "comments",
+];
+// vip is a standard (non-custom) boolean field on sys_user used to flag VIP users.
+const INCIDENT_VIP_FIELDS = [...SHARED_FIELDS, "caller_id"];
+const INCIDENT_VIP_BASE_FILTER = "caller_id.vip=true";
+const SC_TASK_VIP_FIELDS = [...SHARED_FIELDS, "request_item", "request_item.requested_for"];
+const SC_TASK_VIP_BASE_FILTER = "request_item.requested_for.vip=true";
+function mapRecord(record, ticketType, additionalFields) {
+    return {
+        ticketType,
+        number: record.number,
+        ritmNumber: ticketType === "sc_task" ? record.request_item : undefined,
+        vipUser: ticketType === "incident" ? record.caller_id : record["request_item.requested_for"],
+        assignee: record.assigned_to,
+        assignmentGroup: record.assignment_group,
+        shortDescription: record.short_description,
+        description: record.description,
+        state: record.state,
+        openedAt: record.opened_at,
+        updatedAt: record.sys_updated_on,
+        closedAt: record.closed_at,
+        workNotes: record.work_notes,
+        comments: record.comments,
+        timeToClosureMinutes: computeTimeToClosureMinutes(record.opened_at, record.closed_at),
+        extraFields: extractAdditionalFields(record, additionalFields),
+    };
+}
+const getVIPTickets = async ({ params, authParams, }) => {
+    const { ticketType, query, additionalFields, limit, offset } = params;
+    const isIncident = ticketType === "incident";
+    const result = await queryServiceNowTable({
+        authParams,
+        tableName: isIncident ? "incident" : "sc_task",
+        fields: isIncident ? INCIDENT_VIP_FIELDS : SC_TASK_VIP_FIELDS,
+        baseFilter: isIncident ? INCIDENT_VIP_BASE_FILTER : SC_TASK_VIP_BASE_FILTER,
+        filter: query,
+        additionalFields,
+        limit,
+        offset,
+    });
+    if ("error" in result) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        records: result.records.map(record => mapRecord(record, ticketType, additionalFields)),
+    };
+};
+export default getVIPTickets;