nowaikit 2.5.0

package/dist/tools/va.js

@@ -0,0 +1,178 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getVaToolDefinitions() {
+    return [
+        {
+            name: 'create_va_topic',
+            description: 'Create a new Virtual Agent conversation topic. **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Topic name (display name)' },
+                    description: { type: 'string', description: 'What this topic handles' },
+                    category: { type: 'string', description: 'Topic category sys_id' },
+                    active: { type: 'boolean', description: 'Activate immediately (default true)' },
+                    fulfillment_type: { type: 'string', description: 'Fulfillment type: "itsm_integration", "custom", "web_service"' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'update_va_topic',
+            description: 'Update a Virtual Agent topic properties. **[Write]**',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Topic sys_id' },
+                    fields: { type: 'object', description: 'Fields to update (name, description, active, etc.)' },
+                },
+                required: ['sys_id', 'fields'],
+            },
+        },
+        {
+            name: 'get_va_topic',
+            description: 'Get Virtual Agent topic details including intent and trigger phrases',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'Topic sys_id' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'list_va_topics_full',
+            description: 'List all Virtual Agent topics with category and status details',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter to active topics only (default true)' },
+                    category: { type: 'string', description: 'Filter by category name' },
+                    query: { type: 'string', description: 'Additional encoded query' },
+                    limit: { type: 'number', description: 'Max results (default 50)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_va_conversation',
+            description: 'Get conversation history for a Virtual Agent session',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    conversation_id: { type: 'string', description: 'Conversation sys_id or session ID' },
+                    limit: { type: 'number', description: 'Max messages (default 50)' },
+                },
+                required: ['conversation_id'],
+            },
+        },
+        {
+            name: 'list_va_conversations',
+            description: 'List recent Virtual Agent conversations',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    topic_sys_id: { type: 'string', description: 'Filter by topic' },
+                    user_sys_id: { type: 'string', description: 'Filter by user' },
+                    limit: { type: 'number', description: 'Max results (default 25)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_va_categories',
+            description: 'List Virtual Agent topic categories',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    limit: { type: 'number', description: 'Max results (default 25)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeVaToolCall(client, name, args) {
+    switch (name) {
+        case 'create_va_topic': {
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            requireWrite();
+            const payload = {
+                name: args.name,
+                active: args.active !== false,
+            };
+            if (args.description)
+                payload.description = args.description;
+            if (args.category)
+                payload.category = args.category;
+            if (args.fulfillment_type)
+                payload.fulfillment_type = args.fulfillment_type;
+            const result = await client.createRecord('sys_cs_topic', payload);
+            return { action: 'created', name: args.name, ...result };
+        }
+        case 'update_va_topic': {
+            if (!args.sys_id || !args.fields)
+                throw new ServiceNowError('sys_id and fields are required', 'INVALID_REQUEST');
+            requireWrite();
+            const result = await client.updateRecord('sys_cs_topic', args.sys_id, args.fields);
+            return { action: 'updated', sys_id: args.sys_id, ...result };
+        }
+        case 'get_va_topic': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const result = await client.getRecord('sys_cs_topic', args.sys_id);
+            return result;
+        }
+        case 'list_va_topics_full': {
+            let query = args.active !== false ? 'active=true' : '';
+            if (args.category)
+                query = query ? `${query}^category.title=${args.category}` : `category.title=${args.category}`;
+            if (args.query)
+                query = query ? `${query}^${args.query}` : args.query;
+            const resp = await client.queryRecords({
+                table: 'sys_cs_topic',
+                query: query || undefined,
+                limit: args.limit || 50,
+                fields: 'sys_id,name,active,category,description,fulfillment_type,sys_updated_on',
+            });
+            return { count: resp.count, topics: resp.records };
+        }
+        case 'get_va_conversation': {
+            if (!args.conversation_id)
+                throw new ServiceNowError('conversation_id is required', 'INVALID_REQUEST');
+            const resp = await client.queryRecords({
+                table: 'sys_cs_conversation_message',
+                query: `conversation=${args.conversation_id}`,
+                limit: args.limit || 50,
+                fields: 'sys_id,message,speaker,sys_created_on',
+            });
+            return { conversation_id: args.conversation_id, message_count: resp.count, messages: resp.records };
+        }
+        case 'list_va_conversations': {
+            let query = '';
+            if (args.topic_sys_id)
+                query = `topic=${args.topic_sys_id}`;
+            if (args.user_sys_id)
+                query = query ? `${query}^user=${args.user_sys_id}` : `user=${args.user_sys_id}`;
+            const resp = await client.queryRecords({
+                table: 'sys_cs_conversation',
+                query: query || undefined,
+                limit: args.limit || 25,
+                fields: 'sys_id,topic,user,state,sys_created_on,sys_updated_on',
+            });
+            return { count: resp.count, conversations: resp.records };
+        }
+        case 'list_va_categories': {
+            const resp = await client.queryRecords({
+                table: 'sys_cs_category',
+                limit: args.limit || 25,
+                fields: 'sys_id,title,active,description,order',
+            });
+            return { count: resp.count, categories: resp.records };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=va.js.map

package/dist/tools/va.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"va.js","sourceRoot":"","sources":["../../src/tools/va.ts"],"names":[],"mappings":"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"}