@credal/actions 0.2.222 → 0.2.224

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;

package/dist/actions/providers/servicenow/utils/tableQuery.d.ts

@@ -0,0 +1,22 @@
+import type { AuthParamsType } from "../../../autogen/types.js";
+export declare const DEFAULT_LIMIT = 25;
+export declare const MAX_LIMIT = 10000;
+export type ServiceNowRecord = Record<string, string>;
+export interface QueryServiceNowTableArgs {
+    authParams: AuthParamsType;
+    tableName: string;
+    fields: string[];
+    filter?: string;
+    baseFilter?: string;
+    additionalFields?: string[];
+    limit?: number;
+    offset?: number;
+}
+export type QueryServiceNowTableResult = {
+    records: ServiceNowRecord[];
+} | {
+    error: string;
+};
+export declare function queryServiceNowTable({ authParams, tableName, fields, filter, baseFilter, additionalFields, limit, offset, }: QueryServiceNowTableArgs): Promise<QueryServiceNowTableResult>;
+export declare function computeTimeToClosureMinutes(openedAt?: string, closedAt?: string): number | undefined;
+export declare function extractAdditionalFields(record: ServiceNowRecord, additionalFields?: string[]): Record<string, string> | undefined;

package/dist/actions/providers/servicenow/utils/tableQuery.js

@@ -0,0 +1,62 @@
+import { ApiError, axiosClient } from "../../../util/axiosClient.js";
+export const DEFAULT_LIMIT = 25;
+export const MAX_LIMIT = 10000;
+// Uses sysparm_display_value=true so choice fields (e.g. state, priority) and reference fields
+// (e.g. assigned_to, request_item) come back as plain human-readable strings rather than nested
+// {value, display_value} objects.
+export async function queryServiceNowTable({ authParams, tableName, fields, filter, baseFilter, additionalFields, limit = DEFAULT_LIMIT, offset = 0, }) {
+    const { authToken, baseUrl } = authParams;
+    if (!authToken || !baseUrl) {
+        return { error: "authToken and baseUrl are required for the ServiceNow API" };
+    }
+    const cappedLimit = Math.min(limit, MAX_LIMIT);
+    const allFields = additionalFields && additionalFields.length > 0 ? [...fields, ...additionalFields] : fields;
+    const combinedFilter = [baseFilter, filter].filter(part => !!part).join("^");
+    const queryParams = new URLSearchParams();
+    queryParams.append("sysparm_limit", cappedLimit.toString());
+    queryParams.append("sysparm_offset", offset.toString());
+    queryParams.append("sysparm_display_value", "true");
+    queryParams.append("sysparm_exclude_reference_link", "true");
+    queryParams.append("sysparm_fields", allFields.join(","));
+    if (combinedFilter) {
+        queryParams.append("sysparm_query", combinedFilter);
+    }
+    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 { records: Array.isArray(result) ? result : [] };
+    }
+    catch (error) {
+        console.error(`Error querying ServiceNow table ${tableName}:`, error);
+        return { error: error instanceof ApiError ? error.message : "An unknown error occurred" };
+    }
+}
+export function computeTimeToClosureMinutes(openedAt, closedAt) {
+    if (!openedAt || !closedAt) {
+        return undefined;
+    }
+    const openedMs = new Date(openedAt).getTime();
+    const closedMs = new Date(closedAt).getTime();
+    if (Number.isNaN(openedMs) || Number.isNaN(closedMs) || closedMs < openedMs) {
+        return undefined;
+    }
+    return Math.round((closedMs - openedMs) / 60000);
+}
+export function extractAdditionalFields(record, additionalFields) {
+    if (!additionalFields || additionalFields.length === 0) {
+        return undefined;
+    }
+    const extra = {};
+    for (const field of additionalFields) {
+        if (record[field] !== undefined) {
+            extra[field] = record[field];
+        }
+    }
+    return extra;
+}

package/package.json

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

package/dist/actions/providers/credal/callCopilot.d.ts

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

package/dist/actions/providers/credal/callCopilot.js

@@ -1,36 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = require("@credal/sdk");
-const callCopilot = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
-    var _b;
-    const requestBody = {
-        agentId: params.agentId,
-        query: params.query,
-        userEmail: params.userEmail,
-    };
-    const baseUrl = (_b = authParams.baseUrl) !== null && _b !== void 0 ? _b : "https://app.credal.ai/api";
-    const client = new sdk_1.CredalClient({ environment: baseUrl, apiKey: authParams.apiKey });
-    const response = yield client.copilots.sendMessage({
-        agentId: requestBody.agentId,
-        message: requestBody.query,
-        userEmail: requestBody.userEmail,
-    });
-    return {
-        response: response.sendChatResult.type === "ai_response_result"
-            ? response.sendChatResult.response.message
-            : "Error getting response",
-        referencedSources: response.sendChatResult.type === "ai_response_result" ? response.sendChatResult.referencedSources : [],
-        sourcesInDataContext: response.sendChatResult.type === "ai_response_result" ? response.sendChatResult.sourcesInDataContext : [],
-        webSearchResults: response.sendChatResult.type === "ai_response_result" ? response.sendChatResult.webSearchResults : [],
-    };
-});
-exports.default = callCopilot;

package/dist/actions/providers/math/index.d.ts

@@ -1 +0,0 @@
-export * as add from "./add";

package/dist/actions/providers/math/index.js

@@ -1,37 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.add = void 0;
-exports.add = __importStar(require("./add"));

package/dist/actions/providers/salesforce/getSalesforceRecordByQuery.d.ts

@@ -1,3 +0,0 @@
-import { salesforceGetSalesforceRecordsByQueryFunction } from "../../autogen/types";
-declare const getSalesforceRecordByQuery: salesforceGetSalesforceRecordsByQueryFunction;
-export default getSalesforceRecordByQuery;

package/dist/actions/providers/salesforce/getSalesforceRecordByQuery.js

@@ -1,43 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const axiosClient_1 = require("../../util/axiosClient");
-const getSalesforceRecordByQuery = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
-    const { authToken, baseUrl } = authParams;
-    const { query, limit } = params;
-    if (!authToken || !baseUrl) {
-        return {
-            success: false,
-            error: "authToken and baseUrl are required for Salesforce API",
-        };
-    }
-    // The API limits the maximum number of records returned to 2000, the limit lets the user set a smaller custom limit
-    const url = `${baseUrl}/services/data/v56.0/query/?q=${encodeURIComponent(query + " LIMIT " + (limit != undefined && limit <= 2000 ? limit : 2000))}`;
-    try {
-        const response = yield axiosClient_1.axiosClient.get(url, {
-            headers: {
-                Authorization: `Bearer ${authToken}`,
-            },
-        });
-        return {
-            success: true,
-            records: response.data,
-        };
-    }
-    catch (error) {
-        console.error("Error retrieving Salesforce record:", error);
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : "An unknown error occurred",
-        };
-    }
-});
-exports.default = getSalesforceRecordByQuery;

package/dist/actions/providers/slack/index.d.ts

@@ -1 +0,0 @@
-export * as listConversations from "./listConversations";

package/dist/actions/providers/slack/index.js

@@ -1,37 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listConversations = void 0;
-exports.listConversations = __importStar(require("./listConversations"));

package/dist/actions/providers/slack/listConversations.d.ts

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

package/dist/actions/providers/slack/listConversations.js

@@ -1,41 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const web_api_1 = require("@slack/web-api");
-const helpers_1 = require("./helpers");
-const slackListConversations = (_a) => __awaiter(void 0, [_a], void 0, function* ({ authParams, }) {
-    const client = new web_api_1.WebClient(authParams.authToken);
-    try {
-        const allChannels = yield (0, helpers_1.getSlackChannels)(client);
-        const filteredChannels = [];
-        for (const channel of allChannels) {
-            if (channel.name && channel.topic && channel.topic.value && channel.purpose && channel.purpose.value) {
-                const purpose = channel.purpose.value;
-                const topic = channel.topic.value;
-                const name = channel.name;
-                filteredChannels.push(Object.assign(Object.assign({}, channel), { purpose, topic, name }));
-            }
-        }
-        return {
-            channels: filteredChannels,
-        };
-    }
-    catch (error) {
-        if (error instanceof Error) {
-            // Enhance error with more context
-            throw new Error(`Failed to list Slack conversations: ${error.message}`);
-        }
-        else {
-            throw error;
-        }
-    }
-});
-exports.default = slackListConversations;