nowaikit 3.0.0 → 4.0.0

package/dist/tools/now-assist-skills.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Now Assist Skills management tools — create, list, get, and test Now Assist skills.
+ * All tools require NOW_ASSIST_ENABLED=true (Tier AI).
+ * Write tools additionally require WRITE_ENABLED=true (Tier 1).
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getNowAssistSkillsToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            input_schema: {
+                type: string;
+                description: string;
+            };
+            output_schema: {
+                type: string;
+                description: string;
+            };
+            prompt_template: {
+                type: string;
+                description: string;
+            };
+            model: {
+                type: string;
+                description: string;
+            };
+            active?: undefined;
+            limit?: undefined;
+            query?: undefined;
+            sys_id?: undefined;
+            skill_sys_id?: undefined;
+            test_input?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            active: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            input_schema?: undefined;
+            output_schema?: undefined;
+            prompt_template?: undefined;
+            model?: undefined;
+            sys_id?: undefined;
+            skill_sys_id?: undefined;
+            test_input?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            sys_id: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            input_schema?: undefined;
+            output_schema?: undefined;
+            prompt_template?: undefined;
+            model?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            query?: undefined;
+            skill_sys_id?: undefined;
+            test_input?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            skill_sys_id: {
+                type: string;
+                description: string;
+            };
+            test_input: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            input_schema?: undefined;
+            output_schema?: undefined;
+            prompt_template?: undefined;
+            model?: undefined;
+            active?: undefined;
+            limit?: undefined;
+            query?: undefined;
+            sys_id?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function executeNowAssistSkillsToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=now-assist-skills.d.ts.map

package/dist/tools/now-assist-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now-assist-skills.d.ts","sourceRoot":"","sources":["../../src/tools/now-assist-skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuDhD;AAMD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA8Dd"}

package/dist/tools/now-assist-skills.js

@@ -0,0 +1,128 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireNowAssist, requireWrite } from '../utils/permissions.js';
+export function getNowAssistSkillsToolDefinitions() {
+    return [
+        {
+            name: 'create_now_assist_skill',
+            description: 'Create a Now Assist skill definition (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Skill name' },
+                    description: { type: 'string', description: 'Skill description' },
+                    input_schema: { type: 'string', description: 'JSON schema string defining the skill input' },
+                    output_schema: { type: 'string', description: 'JSON schema string defining the skill output' },
+                    prompt_template: { type: 'string', description: 'Prompt template for the skill' },
+                    model: { type: 'string', description: 'Optional model identifier to use for this skill' },
+                },
+                required: ['name', 'description', 'input_schema', 'output_schema', 'prompt_template'],
+            },
+        },
+        {
+            name: 'list_now_assist_skills',
+            description: 'List Now Assist skill definitions (requires NOW_ASSIST_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    active: { type: 'boolean', description: 'Filter by active status' },
+                    limit: { type: 'number', description: 'Max records to return (default 25)' },
+                    query: { type: 'string', description: 'Additional encoded query string' },
+                },
+                required: [],
+            },
+        },
+        {
+            name: 'get_now_assist_skill',
+            description: 'Get a single Now Assist skill definition by sys_id (requires NOW_ASSIST_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sys_id: { type: 'string', description: 'System ID of the skill' },
+                },
+                required: ['sys_id'],
+            },
+        },
+        {
+            name: 'test_now_assist_skill',
+            description: 'Invoke a Now Assist skill with test input to verify behavior (requires NOW_ASSIST_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    skill_sys_id: { type: 'string', description: 'System ID of the skill to test' },
+                    test_input: { type: 'object', description: 'Test input payload to send to the skill' },
+                },
+                required: ['skill_sys_id', 'test_input'],
+            },
+        },
+    ];
+}
+const SKILL_TOOL_NAMES = new Set([
+    'create_now_assist_skill', 'list_now_assist_skills', 'get_now_assist_skill', 'test_now_assist_skill',
+]);
+export async function executeNowAssistSkillsToolCall(client, name, args) {
+    if (!SKILL_TOOL_NAMES.has(name))
+        return null;
+    requireNowAssist();
+    switch (name) {
+        case 'create_now_assist_skill': {
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            if (!args.description)
+                throw new ServiceNowError('description is required', 'INVALID_REQUEST');
+            if (!args.input_schema)
+                throw new ServiceNowError('input_schema is required', 'INVALID_REQUEST');
+            if (!args.output_schema)
+                throw new ServiceNowError('output_schema is required', 'INVALID_REQUEST');
+            if (!args.prompt_template)
+                throw new ServiceNowError('prompt_template is required', 'INVALID_REQUEST');
+            const data = {
+                name: args.name,
+                description: args.description,
+                input_schema: args.input_schema,
+                output_schema: args.output_schema,
+                prompt_template: args.prompt_template,
+                active: true,
+            };
+            if (args.model)
+                data.model = args.model;
+            const record = await client.createRecord('sn_now_assist_skill', data);
+            return { message: 'Now Assist skill created', skill: record };
+        }
+        case 'list_now_assist_skills': {
+            const parts = [];
+            if (args.active !== undefined)
+                parts.push(`active=${args.active}`);
+            if (args.query)
+                parts.push(args.query);
+            const query = parts.length > 0 ? parts.join('^') : undefined;
+            const resp = await client.queryRecords({
+                table: 'sn_now_assist_skill',
+                query,
+                limit: args.limit || 25,
+                fields: 'sys_id,name,description,active,model,sys_updated_on',
+            });
+            return { count: resp.count, skills: resp.records };
+        }
+        case 'get_now_assist_skill': {
+            if (!args.sys_id)
+                throw new ServiceNowError('sys_id is required', 'INVALID_REQUEST');
+            const record = await client.getRecord('sn_now_assist_skill', args.sys_id);
+            return { skill: record };
+        }
+        case 'test_now_assist_skill': {
+            if (!args.skill_sys_id)
+                throw new ServiceNowError('skill_sys_id is required', 'INVALID_REQUEST');
+            if (!args.test_input)
+                throw new ServiceNowError('test_input is required', 'INVALID_REQUEST');
+            const result = await client.callNowAssist('/api/sn_assist/skill/invoke', {
+                skill: args.skill_sys_id,
+                input: args.test_input,
+            });
+            return { skill_sys_id: args.skill_sys_id, test_input: args.test_input, result };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=now-assist-skills.js.map

package/dist/tools/now-assist-skills.js.map

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

package/dist/tools/orchestration.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Orchestration tools — create, list, and execute multi-step playbooks.
+ * Playbooks chain tool calls with conditional logic and error handling.
+ * Requires NOW_ASSIST_ENABLED (Tier AI). Write tools also require WRITE_ENABLED.
+ */
+import type { ServiceNowClient } from '../servicenow/client.js';
+export declare function getOrchestrationToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            steps: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        tool_name: {
+                            type: string;
+                            description: string;
+                        };
+                        args_template: {
+                            type: string;
+                            description: string;
+                        };
+                        condition: {
+                            type: string;
+                            description: string;
+                        };
+                        on_error: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            playbook?: undefined;
+            context?: undefined;
+            dry_run?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            playbook: {
+                type: string;
+                description: string;
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    steps: {
+                        type: string;
+                        items: {
+                            type: string;
+                            properties: {
+                                tool_name: {
+                                    type: string;
+                                };
+                                args_template: {
+                                    type: string;
+                                };
+                                condition: {
+                                    type: string;
+                                };
+                                on_error: {
+                                    type: string;
+                                    enum: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    };
+                };
+                required: string[];
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            dry_run: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            steps?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+            };
+            name?: undefined;
+            description?: undefined;
+            steps?: undefined;
+            playbook?: undefined;
+            context?: undefined;
+            dry_run?: undefined;
+        };
+        required: never[];
+    };
+})[];
+export declare function executeOrchestrationToolCall(client: ServiceNowClient, name: string, args: Record<string, any>): Promise<any>;
+//# sourceMappingURL=orchestration.d.ts.map

package/dist/tools/orchestration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../src/tools/orchestration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAoBhE,wBAAgB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0E9C;AA6GD,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAyJd"}