nowaikit 4.11.0 → 4.12.0

package/dist/tools/survey.js

@@ -0,0 +1,118 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireWrite } from '../utils/permissions.js';
+export function getSurveyToolDefinitions() {
+    return [
+        {
+            name: 'create_survey',
+            description: 'Create a survey/assessment definition (asmt_metric_type). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Survey name' },
+                    description: { type: 'string', description: 'Survey description' },
+                    type: { type: 'string', description: 'Metric type (e.g. "survey")' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'send_survey',
+            description: 'Issue a survey/assessment instance to a user (asmt_assessment_instance). Requires WRITE_ENABLED=true',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    metric_type: { type: 'string', description: 'sys_id of the survey definition (asmt_metric_type)' },
+                    user: { type: 'string', description: 'Recipient user sys_id' },
+                    trigger_id: { type: 'string', description: 'Source record sys_id (e.g. the closed incident)' },
+                    trigger_table: { type: 'string', description: 'Source table name' },
+                    fields: { type: 'object', description: 'Additional field values' },
+                },
+                required: ['metric_type', 'user'],
+            },
+        },
+        {
+            name: 'get_survey_results',
+            description: 'Get responses/scores for a survey instance or definition (asmt_assessment_instance_question)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    instance: { type: 'string', description: 'sys_id of a specific assessment instance' },
+                    metric_type: { type: 'string', description: 'sys_id of the survey definition (aggregate across instances)' },
+                    limit: { type: 'number', description: 'Max question rows (default 100)' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'list_assessments',
+            description: 'List survey/assessment instances (asmt_assessment_instance) by state or user',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    state: { type: 'string', description: 'Instance state (e.g. "ready", "complete")' },
+                    user: { type: 'string', description: 'Recipient user sys_id' },
+                    metric_type: { type: 'string', description: 'Survey definition sys_id' },
+                    limit: { type: 'number', description: 'Max records (default 50)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+export async function executeSurveyToolCall(client, name, args) {
+    switch (name) {
+        case 'create_survey': {
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            const payload = { name: args.name, ...(args.fields ?? {}) };
+            if (args.description)
+                payload.description = args.description;
+            if (args.type)
+                payload.type = args.type;
+            const result = await client.createRecord('asmt_metric_type', payload);
+            return { ...result, summary: `Created survey "${args.name}"` };
+        }
+        case 'send_survey': {
+            requireWrite();
+            if (!args.metric_type || !args.user)
+                throw new ServiceNowError('metric_type and user are required', 'INVALID_REQUEST');
+            const payload = { metric_type: args.metric_type, user: args.user, state: 'ready', ...(args.fields ?? {}) };
+            if (args.trigger_id)
+                payload.trigger_id = args.trigger_id;
+            if (args.trigger_table)
+                payload.trigger_table = args.trigger_table;
+            const result = await client.createRecord('asmt_assessment_instance', payload);
+            return { ...result, summary: `Issued survey ${args.metric_type} to ${args.user}` };
+        }
+        case 'get_survey_results': {
+            let query = '';
+            if (args.instance)
+                query = `instance=${args.instance}`;
+            else if (args.metric_type)
+                query = `instance.metric_type=${args.metric_type}`;
+            else
+                throw new ServiceNowError('instance or metric_type is required', 'INVALID_REQUEST');
+            return await client.queryRecords({
+                table: 'asmt_assessment_instance_question',
+                query,
+                fields: 'metric,metric.name,value,string_value,instance,instance.state',
+                limit: args.limit ?? 100,
+            });
+        }
+        case 'list_assessments': {
+            const parts = [];
+            if (args.state)
+                parts.push(`state=${args.state}`);
+            if (args.user)
+                parts.push(`user=${args.user}`);
+            if (args.metric_type)
+                parts.push(`metric_type=${args.metric_type}`);
+            return await client.queryRecords({ table: 'asmt_assessment_instance', query: parts.join('^'), limit: args.limit ?? 50 });
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=survey.js.map

package/dist/tools/survey.js.map

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