nowaikit 2.5.0

package/dist/utils/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class ServiceNowError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,OAAO;gBAFxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B"}

package/dist/utils/errors.js

@@ -0,0 +1,11 @@
+export class ServiceNowError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'ServiceNowError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG/B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/utils/logging.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, error?: unknown): void;
+};
+//# sourceMappingURL=logging.d.ts.map

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;mBACF,MAAM,SAAS,OAAO,GAAG,IAAI;kBAG9B,MAAM,SAAS,OAAO,GAAG,IAAI;kBAG7B,MAAM,SAAS,OAAO,GAAG,IAAI;mBAG5B,MAAM,UAAU,OAAO,GAAG,IAAI;CAG9C,CAAC"}

package/dist/utils/logging.js

@@ -0,0 +1,15 @@
+export const logger = {
+    debug(message, data) {
+        console.error(`[DEBUG] ${message}`, data || '');
+    },
+    info(message, data) {
+        console.error(`[INFO] ${message}`, data || '');
+    },
+    warn(message, data) {
+        console.error(`[WARN] ${message}`, data || '');
+    },
+    error(message, error) {
+        console.error(`[ERROR] ${message}`, error || '');
+    },
+};
+//# sourceMappingURL=logging.js.map

package/dist/utils/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,KAAe;QACpC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;CACF,CAAC"}

package/dist/utils/permissions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Permission tier utilities for NowAIKit tools.
+ *
+ * Tier 0 – Always available (all read tools)
+ * Tier 1 – WRITE_ENABLED=true (standard ITSM writes)
+ * Tier 2 – WRITE_ENABLED=true + CMDB_WRITE_ENABLED=true (CI create/update)
+ * Tier 3 – WRITE_ENABLED=true + SCRIPTING_ENABLED=true (scripts/changesets)
+ * Tier AI – NOW_ASSIST_ENABLED=true (generative AI tools)
+ * Tier ATF – ATF_ENABLED=true (test execution)
+ */
+export declare function requireWrite(): void;
+export declare function requireCmdbWrite(): void;
+export declare function requireScripting(): void;
+export declare function requireNowAssist(): void;
+export declare function requireAtf(): void;
+export declare function isWriteEnabled(): boolean;
+export declare function isCmdbWriteEnabled(): boolean;
+export declare function isScriptingEnabled(): boolean;
+export declare function isNowAssistEnabled(): boolean;
+export declare function isAtfEnabled(): boolean;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/utils/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/utils/permissions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAOjC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/utils/permissions.js

@@ -0,0 +1,54 @@
+import { ServiceNowError } from './errors.js';
+/**
+ * Permission tier utilities for NowAIKit tools.
+ *
+ * Tier 0 – Always available (all read tools)
+ * Tier 1 – WRITE_ENABLED=true (standard ITSM writes)
+ * Tier 2 – WRITE_ENABLED=true + CMDB_WRITE_ENABLED=true (CI create/update)
+ * Tier 3 – WRITE_ENABLED=true + SCRIPTING_ENABLED=true (scripts/changesets)
+ * Tier AI – NOW_ASSIST_ENABLED=true (generative AI tools)
+ * Tier ATF – ATF_ENABLED=true (test execution)
+ */
+export function requireWrite() {
+    if (process.env.WRITE_ENABLED !== 'true') {
+        throw new ServiceNowError('Write operations are disabled. Set WRITE_ENABLED=true to enable.', 'WRITE_NOT_ENABLED');
+    }
+}
+export function requireCmdbWrite() {
+    requireWrite();
+    if (process.env.CMDB_WRITE_ENABLED !== 'true') {
+        throw new ServiceNowError('CMDB write operations are disabled. Set WRITE_ENABLED=true and CMDB_WRITE_ENABLED=true to enable.', 'CMDB_WRITE_NOT_ENABLED');
+    }
+}
+export function requireScripting() {
+    requireWrite();
+    if (process.env.SCRIPTING_ENABLED !== 'true') {
+        throw new ServiceNowError('Scripting operations are disabled. Set WRITE_ENABLED=true and SCRIPTING_ENABLED=true to enable.', 'SCRIPTING_NOT_ENABLED');
+    }
+}
+export function requireNowAssist() {
+    if (process.env.NOW_ASSIST_ENABLED !== 'true') {
+        throw new ServiceNowError('Now Assist / AI features are disabled. Set NOW_ASSIST_ENABLED=true to enable.', 'NOW_ASSIST_NOT_ENABLED');
+    }
+}
+export function requireAtf() {
+    if (process.env.ATF_ENABLED !== 'true') {
+        throw new ServiceNowError('ATF test execution is disabled. Set ATF_ENABLED=true to enable.', 'ATF_NOT_ENABLED');
+    }
+}
+export function isWriteEnabled() {
+    return process.env.WRITE_ENABLED === 'true';
+}
+export function isCmdbWriteEnabled() {
+    return process.env.WRITE_ENABLED === 'true' && process.env.CMDB_WRITE_ENABLED === 'true';
+}
+export function isScriptingEnabled() {
+    return process.env.WRITE_ENABLED === 'true' && process.env.SCRIPTING_ENABLED === 'true';
+}
+export function isNowAssistEnabled() {
+    return process.env.NOW_ASSIST_ENABLED === 'true';
+}
+export function isAtfEnabled() {
+    return process.env.ATF_ENABLED === 'true';
+}
+//# sourceMappingURL=permissions.js.map

package/dist/utils/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/utils/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;GASG;AAEH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QACzC,MAAM,IAAI,eAAe,CACvB,kEAAkE,EAClE,mBAAmB,CACpB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,YAAY,EAAE,CAAC;IACf,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;QAC9C,MAAM,IAAI,eAAe,CACvB,mGAAmG,EACnG,wBAAwB,CACzB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,YAAY,EAAE,CAAC;IACf,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,eAAe,CACvB,iGAAiG,EACjG,uBAAuB,CACxB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;QAC9C,MAAM,IAAI,eAAe,CACvB,+EAA+E,EAC/E,wBAAwB,CACzB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QACvC,MAAM,IAAI,eAAe,CACvB,iEAAiE,EACjE,iBAAiB,CAClB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC;AAC5C,CAAC"}

package/instances.example.json

@@ -0,0 +1,71 @@
+{
+  "_comment": [
+    "Copy this file to instances.json and fill in your credentials.",
+    "Set SN_INSTANCES_CONFIG=./instances.json in your environment or .env file.",
+    "IMPORTANT: Add instances.json to .gitignore — it contains secrets.",
+    "",
+    "Supports three use cases:",
+    "  1. Single organisation: dev / staging / prod environments",
+    "  2. Multi-customer / MSP: one entry per customer tenant",
+    "  3. Mixed: both your own environments and customer instances",
+    "",
+    "Query a specific instance by passing instance=<name> to any tool,",
+    "or use switch_instance to change the active instance for the session.",
+    "Example (AI prompt): 'Get all P1 incidents from prod instance'",
+    "Example (AI prompt): 'Switch to customer_acme and list open changes'"
+  ],
+
+  "default_instance": "dev",
+
+  "instances": {
+
+    "dev": {
+      "instance_url": "https://your-company-dev.service-now.com",
+      "auth_method": "basic",
+      "username": "admin",
+      "password": "YOUR_DEV_PASSWORD",
+      "_comment": "Personal Developer Instance (PDI) or sandbox — safe to enable writes"
+    },
+
+    "staging": {
+      "instance_url": "https://your-company-stg.service-now.com",
+      "auth_method": "oauth",
+      "client_id": "YOUR_STAGING_CLIENT_ID",
+      "client_secret": "YOUR_STAGING_CLIENT_SECRET",
+      "username": "svc_mcp_staging",
+      "password": "YOUR_STAGING_SVC_PASSWORD",
+      "_comment": "Pre-prod validation — OAuth recommended"
+    },
+
+    "prod": {
+      "instance_url": "https://your-company.service-now.com",
+      "auth_method": "oauth",
+      "client_id": "YOUR_PROD_CLIENT_ID",
+      "client_secret": "YOUR_PROD_CLIENT_SECRET",
+      "username": "svc_mcp_prod",
+      "password": "YOUR_PROD_SVC_PASSWORD",
+      "_comment": "Production — use a dedicated read-only service account; only enable WRITE_ENABLED for deliberate changes"
+    },
+
+    "customer_acme": {
+      "instance_url": "https://acmecorp.service-now.com",
+      "auth_method": "oauth",
+      "client_id": "ACME_CLIENT_ID",
+      "client_secret": "ACME_CLIENT_SECRET",
+      "username": "svc_consultant",
+      "password": "ACME_SVC_PASSWORD",
+      "_comment": "MSP/Consultant use case — customer Acme Corp tenant"
+    },
+
+    "customer_globex": {
+      "instance_url": "https://globex.service-now.com",
+      "auth_method": "oauth",
+      "client_id": "GLOBEX_CLIENT_ID",
+      "client_secret": "GLOBEX_CLIENT_SECRET",
+      "username": "svc_consultant",
+      "password": "GLOBEX_SVC_PASSWORD",
+      "_comment": "MSP/Consultant use case — customer Globex tenant"
+    }
+
+  }
+}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "nowaikit",
+  "version": "2.5.0",
+  "description": "The Most Comprehensive ServiceNow AI Toolkit — 400+ MCP tools across all modules. Integrates with Claude, ChatGPT, Gemini, Cursor, GitHub Copilot and any LLM.",
+  "main": "dist/server.js",
+  "bin": {
+    "nowaikit": "dist/cli/index.js"
+  },
+  "type": "module",
+  "files": [
+    "dist/",
+    "desktop/serve.js",
+    "desktop/renderer/dist/",
+    "instances.example.json",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/server.ts",
+    "start": "node dist/server.js",
+    "setup": "node dist/cli/index.js setup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [
+    "servicenow",
+    "servicenow-mcp",
+    "servicenow-mcp-server",
+    "servicenow-ai",
+    "servicenow-agent",
+    "servicenow-automation",
+    "servicenow-developer-tools",
+    "servicenow-tools",
+    "servicenow-claude",
+    "servicenow-chatgpt",
+    "servicenow-integration",
+    "servicenow-api",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "nowaikit",
+    "itsm",
+    "itom",
+    "hrsd",
+    "csm",
+    "secops",
+    "grc",
+    "cmdb",
+    "now-assist",
+    "atf",
+    "flow-designer",
+    "service-portal",
+    "performance-analytics",
+    "service-catalog",
+    "app-studio",
+    "scoped-app",
+    "ai",
+    "ai-agent",
+    "llm",
+    "autonomous-agent",
+    "multi-agent",
+    "claude",
+    "anthropic",
+    "openai",
+    "gemini",
+    "cursor",
+    "copilot",
+    "typescript",
+    "automation",
+    "agentic"
+  ],
+  "author": "aartiq",
+  "homepage": "https://github.com/aartiq/nowaikit#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aartiq/nowaikit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aartiq/nowaikit/issues"
+  },
+  "license": "MIT",
+  "overrides": {
+    "minimatch": "^10.2.2"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "dotenv": "^16.4.5",
+    "ora": "^9.3.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.33",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^9.39.3",
+    "globals": "^17.3.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  }
+}