nowaikit 3.0.0 → 3.1.0

package/dist/tools-manifest.json

@@ -72,6 +72,74 @@
       ]
     }
   },
+  {
+    "name": "create_record",
+    "description": "Create a new record in any ServiceNow table (requires WRITE_ENABLED=true)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table name (e.g., \"incident\", \"sys_user_preference\")"
+        },
+        "fields": {
+          "type": "object",
+          "description": "Key-value pairs for the new record fields"
+        }
+      },
+      "required": [
+        "table",
+        "fields"
+      ]
+    }
+  },
+  {
+    "name": "update_record",
+    "description": "Update an existing record in any ServiceNow table (requires WRITE_ENABLED=true)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table name (e.g., \"incident\", \"sys_user_preference\")"
+        },
+        "sys_id": {
+          "type": "string",
+          "description": "32-character system ID of the record to update"
+        },
+        "fields": {
+          "type": "object",
+          "description": "Key-value pairs of fields to update"
+        }
+      },
+      "required": [
+        "table",
+        "sys_id",
+        "fields"
+      ]
+    }
+  },
+  {
+    "name": "delete_record",
+    "description": "Delete a record from any ServiceNow table (requires WRITE_ENABLED=true)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table name"
+        },
+        "sys_id": {
+          "type": "string",
+          "description": "32-character system ID of the record to delete"
+        }
+      },
+      "required": [
+        "table",
+        "sys_id"
+      ]
+    }
+  },
   {
     "name": "get_user",
     "description": "Look up user details by email or username",
@@ -304,6 +372,72 @@
       "required": []
     }
   },
+  {
+    "name": "create_ci_relationship",
+    "description": "[Write] Create a relationship between two CMDB Configuration Items",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "parent": {
+          "type": "string",
+          "description": "Parent CI sys_id"
+        },
+        "child": {
+          "type": "string",
+          "description": "Child CI sys_id"
+        },
+        "type": {
+          "type": "string",
+          "description": "Relationship type (e.g. \"Runs on::Runs\")"
+        }
+      },
+      "required": [
+        "parent",
+        "child",
+        "type"
+      ]
+    }
+  },
+  {
+    "name": "cmdb_impact_analysis",
+    "description": "Analyze the downstream impact of a Configuration Item change or outage",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "ci_sys_id": {
+          "type": "string",
+          "description": "CI sys_id to analyze"
+        },
+        "depth": {
+          "type": "number",
+          "description": "Relationship depth to traverse (default: 2)"
+        }
+      },
+      "required": [
+        "ci_sys_id"
+      ]
+    }
+  },
+  {
+    "name": "run_discovery_scan",
+    "description": "[Write] Trigger a ServiceNow Discovery scan for network/infrastructure",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "schedule_id": {
+          "type": "string",
+          "description": "Discovery schedule sys_id to run"
+        },
+        "mid_server": {
+          "type": "string",
+          "description": "Optional MID server name"
+        }
+      },
+      "required": [
+        "schedule_id"
+      ]
+    }
+  },
   {
     "name": "create_incident",
     "description": "Create a new incident record (requires WRITE_ENABLED=true)",
@@ -748,6 +882,35 @@
       ]
     }
   },
+  {
+    "name": "schedule_cab_meeting",
+    "description": "[Write] Schedule a Change Advisory Board (CAB) meeting",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "change_id": {
+          "type": "string",
+          "description": "Change request number (CHG...) or sys_id"
+        },
+        "date": {
+          "type": "string",
+          "description": "ISO date for the CAB meeting"
+        },
+        "duration_minutes": {
+          "type": "number",
+          "description": "Meeting duration in minutes"
+        },
+        "attendees": {
+          "type": "string",
+          "description": "Comma-separated group names"
+        }
+      },
+      "required": [
+        "change_id",
+        "date"
+      ]
+    }
+  },
   {
     "name": "get_task",
     "description": "Get details of any task record by number or sys_id",
@@ -940,6 +1103,22 @@
       ]
     }
   },
+  {
+    "name": "retire_knowledge_article",
+    "description": "[Write] Retire a knowledge article (mark as outdated)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "article_id": {
+          "type": "string",
+          "description": "Article number (KB...) or sys_id"
+        }
+      },
+      "required": [
+        "article_id"
+      ]
+    }
+  },
   {
     "name": "list_catalog_items",
     "description": "List available service catalog items",
@@ -1238,6 +1417,74 @@
       "required": []
     }
   },
+  {
+    "name": "create_catalog_variable",
+    "description": "[Write] Add a form variable to a service catalog item",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "cat_item_id": {
+          "type": "string",
+          "description": "Catalog item sys_id"
+        },
+        "name": {
+          "type": "string",
+          "description": "Variable name"
+        },
+        "question_text": {
+          "type": "string",
+          "description": "Label shown to user"
+        },
+        "type": {
+          "type": "string",
+          "description": "Variable type: string/reference/select_box/checkbox/date/date_time/integer/multi_line_text/email"
+        },
+        "order": {
+          "type": "number",
+          "description": "Display order (default: 100)"
+        },
+        "mandatory": {
+          "type": "boolean",
+          "description": "Required field"
+        }
+      },
+      "required": [
+        "cat_item_id",
+        "name",
+        "question_text",
+        "type"
+      ]
+    }
+  },
+  {
+    "name": "create_catalog_ui_policy",
+    "description": "[Write] Create a UI policy for a catalog item form",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "cat_item_id": {
+          "type": "string",
+          "description": "Catalog item sys_id"
+        },
+        "short_description": {
+          "type": "string",
+          "description": "UI policy description"
+        },
+        "conditions": {
+          "type": "string",
+          "description": "Encoded condition query"
+        },
+        "reverse_if_false": {
+          "type": "boolean",
+          "description": "Reverse actions when condition is false"
+        }
+      },
+      "required": [
+        "cat_item_id",
+        "short_description"
+      ]
+    }
+  },
   {
     "name": "list_users",
     "description": "List users with optional search filter",
@@ -1789,6 +2036,82 @@
       "required": []
     }
   },
+  {
+    "name": "create_scheduled_report",
+    "description": "[Write] Schedule a report for recurring email delivery",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "report_id": {
+          "type": "string",
+          "description": "Report sys_id"
+        },
+        "frequency": {
+          "type": "string",
+          "description": "Frequency: daily/weekly/monthly"
+        },
+        "recipients": {
+          "type": "string",
+          "description": "Email addresses"
+        },
+        "day_of_week": {
+          "type": "string",
+          "description": "Day of week (for weekly frequency)"
+        },
+        "day_of_month": {
+          "type": "number",
+          "description": "Day of month (for monthly frequency)"
+        },
+        "format": {
+          "type": "string",
+          "description": "Export format: pdf/csv/xlsx"
+        }
+      },
+      "required": [
+        "report_id",
+        "frequency",
+        "recipients"
+      ]
+    }
+  },
+  {
+    "name": "create_kpi",
+    "description": "[Write] Create a Key Performance Indicator from ServiceNow data",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "KPI name"
+        },
+        "table": {
+          "type": "string",
+          "description": "Source table"
+        },
+        "field": {
+          "type": "string",
+          "description": "Aggregate field"
+        },
+        "aggregate": {
+          "type": "string",
+          "description": "Aggregate function: COUNT/AVG/SUM/MIN/MAX"
+        },
+        "conditions": {
+          "type": "string",
+          "description": "Encoded query filter"
+        },
+        "unit": {
+          "type": "string",
+          "description": "Display unit"
+        }
+      },
+      "required": [
+        "name",
+        "table",
+        "aggregate"
+      ]
+    }
+  },
   {
     "name": "list_atf_suites",
     "description": "List ATF test suites in the instance",
@@ -5501,6 +5824,61 @@
       "required": []
     }
   },
+  {
+    "name": "send_emergency_broadcast",
+    "description": "[Write] Send emergency broadcast notification to users or groups",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "subject": {
+          "type": "string",
+          "description": "Broadcast subject"
+        },
+        "body": {
+          "type": "string",
+          "description": "Message body"
+        },
+        "recipients": {
+          "type": "string",
+          "description": "Comma-separated user/group sys_ids"
+        },
+        "channels": {
+          "type": "string",
+          "description": "Delivery channels: email,sms,push"
+        }
+      },
+      "required": [
+        "subject",
+        "body",
+        "recipients"
+      ]
+    }
+  },
+  {
+    "name": "schedule_notification",
+    "description": "[Write] Schedule a notification for future delivery",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "notification_id": {
+          "type": "string",
+          "description": "Notification rule sys_id"
+        },
+        "schedule": {
+          "type": "string",
+          "description": "Cron expression or ISO date"
+        },
+        "active": {
+          "type": "boolean",
+          "description": "Whether the notification is active"
+        }
+      },
+      "required": [
+        "notification_id",
+        "schedule"
+      ]
+    }
+  },
   {
     "name": "list_pa_indicators",
     "description": "List Performance Analytics (PA) indicators (KPIs) available in the instance",
@@ -6569,6 +6947,49 @@
       "required": []
     }
   },
+  {
+    "name": "track_asset_lifecycle",
+    "description": "Track asset lifecycle events and stage transitions",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "asset_id": {
+          "type": "string",
+          "description": "Asset tag or sys_id"
+        },
+        "new_stage": {
+          "type": "string",
+          "description": "Lifecycle stage: in_stock/in_use/in_maintenance/retired/disposed"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Transition notes"
+        }
+      },
+      "required": [
+        "asset_id",
+        "new_stage"
+      ]
+    }
+  },
+  {
+    "name": "get_license_optimization",
+    "description": "Analyze software license usage and recommend optimizations",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "software_name": {
+          "type": "string",
+          "description": "Optional filter by software name"
+        },
+        "threshold_pct": {
+          "type": "number",
+          "description": "Usage threshold percentage (default: 80)"
+        }
+      },
+      "required": []
+    }
+  },
   {
     "name": "list_devops_pipelines",
     "description": "List DevOps pipeline configurations registered in ServiceNow",
@@ -7848,5 +8269,149 @@
         "table"
       ]
     }
+  },
+  {
+    "name": "fluent_query",
+    "description": "GlideQuery-style fluent query builder. Supports select, where, aggregate (COUNT/AVG/SUM/MIN/MAX), orderBy, limit, and groupBy. Returns records or aggregate results. Example: { table: \"incident\", where: [[\"active\",\"=\",true],[\"priority\",\"<\",3]], select: [\"number\",\"short_description\"], limit: 10 }",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table name (e.g., \"incident\")"
+        },
+        "where": {
+          "type": "array",
+          "description": "Array of conditions: [field, operator, value]. Operators: =, !=, >, >=, <, <=, LIKE, STARTSWITH, CONTAINS, IN, NOT IN, ISEMPTY, ISNOTEMPTY",
+          "items": {
+            "type": "array",
+            "items": {},
+            "minItems": 2,
+            "maxItems": 3
+          }
+        },
+        "orWhere": {
+          "type": "array",
+          "description": "Array of OR conditions (same format as where)",
+          "items": {
+            "type": "array",
+            "items": {},
+            "minItems": 2,
+            "maxItems": 3
+          }
+        },
+        "select": {
+          "type": "array",
+          "description": "Fields to return. Supports dot-walking (e.g., \"caller_id.email\"). If omitted, returns all fields.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "aggregate": {
+          "type": "string",
+          "description": "Aggregate operation: COUNT, AVG, SUM, MIN, MAX",
+          "enum": [
+            "COUNT",
+            "AVG",
+            "SUM",
+            "MIN",
+            "MAX"
+          ]
+        },
+        "aggregateField": {
+          "type": "string",
+          "description": "Field to aggregate on (required for AVG, SUM, MIN, MAX)"
+        },
+        "groupBy": {
+          "type": "string",
+          "description": "Field to group results by (for aggregate queries)"
+        },
+        "orderBy": {
+          "type": "string",
+          "description": "Field to sort by. Prefix with \"-\" for descending."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max records to return (default: 20, max: 200)"
+        },
+        "displayValue": {
+          "type": "boolean",
+          "description": "Return display values instead of internal values (default: false)"
+        }
+      },
+      "required": [
+        "table"
+      ]
+    }
+  },
+  {
+    "name": "batch_request",
+    "description": "Execute multiple ServiceNow REST API operations in a single HTTP call. Reduces round-trips by 50-70%. Each operation specifies method, URL path, and optional body. Max 50 operations per batch.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "operations": {
+          "type": "array",
+          "description": "Array of REST operations to execute",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique operation ID for correlating responses"
+              },
+              "method": {
+                "type": "string",
+                "description": "HTTP method: GET, POST, PATCH, DELETE",
+                "enum": [
+                  "GET",
+                  "POST",
+                  "PATCH",
+                  "DELETE"
+                ]
+              },
+              "url": {
+                "type": "string",
+                "description": "API URL path (e.g., \"/api/now/table/incident?sysparm_limit=5\")"
+              },
+              "body": {
+                "type": "object",
+                "description": "Request body for POST/PATCH operations"
+              }
+            },
+            "required": [
+              "id",
+              "method",
+              "url"
+            ]
+          },
+          "minItems": 1,
+          "maxItems": 50
+        }
+      },
+      "required": [
+        "operations"
+      ]
+    }
+  },
+  {
+    "name": "execute_script",
+    "description": "Execute a server-side script on the ServiceNow instance (Background Script). Supports GlideRecord, GlideQuery, GlideAggregate, and all server-side APIs. Returns the script output. Use for complex queries that cannot be expressed via REST. REQUIRES WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "script": {
+          "type": "string",
+          "description": "Server-side JavaScript to execute. Use gs.print() or gs.info() for output."
+        },
+        "scope": {
+          "type": "string",
+          "description": "Application scope to run in (default: global)"
+        }
+      },
+      "required": [
+        "script"
+      ]
+    }
   }
 ]

package/package.json

@@ -1,9 +1,24 @@
 {
   "name": "nowaikit",
   "mcpName": "io.github.aartiq/nowaikit",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "The Most Comprehensive ServiceNow AI Toolkit — 400+ MCP tools + 26 AI capabilities (scan, review, build, ops, docs) + direct BYOK mode. Integrates with Claude, ChatGPT, Gemini, Cursor, GitHub Copilot and any LLM.",
   "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./sdk": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js"
+    },
+    "./client": {
+      "types": "./dist/servicenow/client.d.ts",
+      "import": "./dist/servicenow/client.js"
+    }
+  },
   "bin": {
     "nowaikit": "dist/cli/index.js"
   },
@@ -19,7 +34,7 @@
     "node": ">=20.0.0"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/extract-tools.mjs",
     "dev": "tsx watch src/server.ts",
     "start": "node dist/server.js",
     "setup": "node dist/cli/index.js setup",
@@ -82,7 +97,9 @@
     "security-audit",
     "technical-debt",
     "direct-mode",
-    "byok"
+    "byok",
+    "sdk",
+    "servicenow-sdk"
   ],
   "author": "aartiq",
   "homepage": "https://github.com/aartiq/nowaikit#readme",
@@ -93,7 +110,7 @@
   "bugs": {
     "url": "https://github.com/aartiq/nowaikit/issues"
   },
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "overrides": {
     "minimatch": "^10.2.2"
   },