@aartiq/servicenow-mcp 1.0.0

package/dist/cli/auth.d.ts

@@ -0,0 +1,14 @@
+interface UserToken {
+    instanceUrl: string;
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    snUser: string;
+    snUserSysId: string;
+}
+export declare function authLogin(): Promise<void>;
+export declare function authLogout(instanceUrl?: string): void;
+export declare function authWhoami(): void;
+export declare function getStoredToken(instanceUrl: string): UserToken | undefined;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/cli/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/cli/auth.ts"],"names":[],"mappings":"AAeA,UAAU,SAAS;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AA8BD,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2H/C;AAED,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAgBrD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAYjC;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAGzE"}

package/dist/cli/auth.js

@@ -0,0 +1,179 @@
+/**
+ * `servicenow-mcp auth` subcommands — per-user OAuth / login management.
+ *
+ * login  — opens browser to ServiceNow OAuth consent, stores token
+ * logout — removes stored token
+ * whoami — show which ServiceNow user is currently authenticated
+ */
+import { input, password, select } from '@inquirer/prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { listInstances } from './config-store.js';
+function tokenPath() {
+    const dir = join(homedir(), '.config', 'servicenow-mcp');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    return join(dir, 'tokens.json');
+}
+function loadTokens() {
+    const p = tokenPath();
+    if (!existsSync(p))
+        return { tokens: {} };
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return { tokens: {} };
+    }
+}
+function saveTokens(store) {
+    writeFileSync(tokenPath(), JSON.stringify(store, null, 2), 'utf8');
+}
+function tokenKey(instanceUrl) {
+    return instanceUrl.replace(/https?:\/\//, '').replace(/[^a-z0-9]/gi, '_');
+}
+export async function authLogin() {
+    const instances = listInstances();
+    if (instances.length === 0) {
+        console.log(chalk.yellow('No instances configured. Run `servicenow-mcp setup` first.'));
+        return;
+    }
+    const instanceUrl = instances.length === 1
+        ? instances[0].instanceUrl
+        : await select({
+            message: 'Choose instance to authenticate against:',
+            choices: instances.map(i => ({ name: `${i.name} (${i.instanceUrl})`, value: i.instanceUrl })),
+        });
+    const instance = instances.find(i => i.instanceUrl === instanceUrl);
+    if (!instance)
+        return;
+    console.log('');
+    console.log(chalk.bold('Per-user OAuth login'));
+    console.log(chalk.dim('Your queries will run in your own ServiceNow permission context.'));
+    console.log('');
+    if (instance.authMethod === 'oauth' && instance.clientId) {
+        // OAuth Authorization Code flow — open browser
+        const authUrl = `${instanceUrl}/oauth_auth.do` +
+            `?response_type=code&client_id=${instance.clientId}` +
+            `&redirect_uri=http://localhost:8765/callback`;
+        console.log(chalk.cyan('Open this URL in your browser to authenticate:'));
+        console.log(chalk.underline(authUrl));
+        console.log('');
+        const code = await input({
+            message: 'Paste the authorization code from the redirect URL:',
+        });
+        const spinner = ora('Exchanging authorization code for token…').start();
+        try {
+            const resp = await fetch(`${instanceUrl}/oauth_token.do`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                body: new URLSearchParams({
+                    grant_type: 'authorization_code',
+                    client_id: instance.clientId,
+                    client_secret: instance.clientSecret || '',
+                    code,
+                    redirect_uri: 'http://localhost:8765/callback',
+                }).toString(),
+            });
+            if (!resp.ok) {
+                spinner.fail(chalk.red(`Token exchange failed: ${resp.status} ${resp.statusText}`));
+                return;
+            }
+            const data = await resp.json();
+            // Get the ServiceNow user tied to this token
+            const meResp = await fetch(`${instanceUrl}/api/now/table/sys_user?sysparm_query=sys_idINSTANCEOF&sysparm_limit=1`, {
+                headers: {
+                    Authorization: `Bearer ${data.access_token}`,
+                    Accept: 'application/json',
+                },
+            });
+            const meData = await meResp.json();
+            const snUserSysId = meData.result?.[0]?.sys_id?.value || '';
+            const snUser = meData.result?.[0]?.user_name?.value || 'unknown';
+            const store = loadTokens();
+            store.tokens[tokenKey(instanceUrl)] = {
+                instanceUrl,
+                accessToken: data.access_token,
+                refreshToken: data.refresh_token,
+                expiresAt: Date.now() + data.expires_in * 1000 * 0.9,
+                snUser,
+                snUserSysId,
+            };
+            saveTokens(store);
+            spinner.succeed(chalk.green(`Authenticated as ${snUser} on ${instanceUrl}`));
+        }
+        catch (err) {
+            spinner.fail(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        }
+    }
+    else {
+        // Basic auth per-user: prompt credentials, store them
+        const username = await input({ message: 'Your ServiceNow username:' });
+        const pass = await password({ message: 'Your ServiceNow password:', mask: '•' });
+        const spinner = ora('Verifying credentials…').start();
+        try {
+            const creds = Buffer.from(`${username}:${pass}`).toString('base64');
+            const resp = await fetch(`${instanceUrl}/api/now/table/sys_user?sysparm_query=user_name=${encodeURIComponent(username)}&sysparm_limit=1`, { headers: { Authorization: `Basic ${creds}`, Accept: 'application/json' } });
+            if (!resp.ok) {
+                spinner.fail(chalk.red(`Auth failed: ${resp.status} ${resp.statusText}`));
+                return;
+            }
+            const data = await resp.json();
+            const snUserSysId = data.result?.[0]?.sys_id?.value || '';
+            const store = loadTokens();
+            store.tokens[tokenKey(instanceUrl)] = {
+                instanceUrl,
+                accessToken: creds,
+                refreshToken: '',
+                expiresAt: Date.now() + 365 * 24 * 60 * 60 * 1000, // basic auth doesn't expire
+                snUser: username,
+                snUserSysId,
+            };
+            saveTokens(store);
+            spinner.succeed(chalk.green(`Saved credentials for ${username} on ${instanceUrl}`));
+        }
+        catch (err) {
+            spinner.fail(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        }
+    }
+}
+export function authLogout(instanceUrl) {
+    const store = loadTokens();
+    if (instanceUrl) {
+        const key = tokenKey(instanceUrl);
+        if (store.tokens[key]) {
+            delete store.tokens[key];
+            saveTokens(store);
+            console.log(chalk.green(`Logged out from ${instanceUrl}`));
+        }
+        else {
+            console.log(chalk.yellow(`No token found for ${instanceUrl}`));
+        }
+    }
+    else {
+        store.tokens = {};
+        saveTokens(store);
+        console.log(chalk.green('Logged out from all instances'));
+    }
+}
+export function authWhoami() {
+    const store = loadTokens();
+    const tokens = Object.values(store.tokens);
+    if (tokens.length === 0) {
+        console.log(chalk.dim('Not authenticated. Run `servicenow-mcp auth login`'));
+        return;
+    }
+    for (const t of tokens) {
+        const expired = Date.now() > t.expiresAt;
+        const status = expired ? chalk.red('(expired)') : chalk.green('(active)');
+        console.log(`  ${t.instanceUrl} → ${chalk.bold(t.snUser)} ${status}`);
+    }
+}
+export function getStoredToken(instanceUrl) {
+    const store = loadTokens();
+    return store.tokens[tokenKey(instanceUrl)];
+}
+//# sourceMappingURL=auth.js.map

package/dist/cli/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/cli/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAelD,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAe,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,aAAa,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,QAAQ,CAAC,WAAmB;IACnC,OAAO,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,4DAA4D,CAAC,CAAC,CAAC;QACxF,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC;QACxC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,WAAW;QAC3B,CAAC,CAAC,MAAM,MAAM,CAAS;YACnB,OAAO,EAAE,0CAA0C;YACnD,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;SAC9F,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,QAAQ,CAAC,UAAU,KAAK,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACzD,+CAA+C;QAC/C,MAAM,OAAO,GACX,GAAG,WAAW,gBAAgB;YAC9B,iCAAiC,QAAQ,CAAC,QAAQ,EAAE;YACpD,8CAA8C,CAAC;QAEjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC;YACvB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,GAAG,CAAC,0CAA0C,CAAC,CAAC,KAAK,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,iBAAiB,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;gBAChE,IAAI,EAAE,IAAI,eAAe,CAAC;oBACxB,UAAU,EAAE,oBAAoB;oBAChC,SAAS,EAAE,QAAQ,CAAC,QAAQ;oBAC5B,aAAa,EAAE,QAAQ,CAAC,YAAY,IAAI,EAAE;oBAC1C,IAAI;oBACJ,YAAY,EAAE,gCAAgC;iBAC/C,CAAC,CAAC,QAAQ,EAAE;aACd,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBACpF,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAI3B,CAAC;YAEF,6CAA6C;YAC7C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,wEAAwE,EAAE;gBACjH,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,YAAY,EAAE;oBAC5C,MAAM,EAAE,kBAAkB;iBAC3B;aACF,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAuF,CAAC;YACxH,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,IAAI,SAAS,CAAC;YAEjE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG;gBACpC,WAAW;gBACX,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,YAAY,EAAE,IAAI,CAAC,aAAa;gBAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,GAAG;gBACpD,MAAM;gBACN,WAAW;aACZ,CAAC;YACF,UAAU,CAAC,KAAK,CAAC,CAAC;YAElB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,MAAM,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,sDAAsD;QACtD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAEjF,MAAM,OAAO,GAAG,GAAG,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACpE,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,WAAW,mDAAmD,kBAAkB,CAAC,QAAQ,CAAC,kBAAkB,EAC/G,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAC7E,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAuF,CAAC;YACpH,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YAE1D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG;gBACpC,WAAW;gBACX,WAAW,EAAE,KAAK;gBAClB,YAAY,EAAE,EAAE;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,4BAA4B;gBAC/E,MAAM,EAAE,QAAQ;gBAChB,WAAW;aACZ,CAAC;YACF,UAAU,CAAC,KAAK,CAAC,CAAC;YAElB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,QAAQ,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAoB;IAC7C,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;QAClB,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/cli/config-store.d.ts

@@ -0,0 +1,28 @@
+export interface InstanceConfig {
+    name: string;
+    instanceUrl: string;
+    authMethod: 'basic' | 'oauth';
+    username?: string;
+    password?: string;
+    clientId?: string;
+    clientSecret?: string;
+    authMode?: 'service-account' | 'per-user' | 'impersonation';
+    writeEnabled?: boolean;
+    toolPackage?: string;
+    nowAssistEnabled?: boolean;
+    group?: string;
+    environment?: string;
+    addedAt: string;
+}
+export interface ServicenowMcpConfig {
+    version: number;
+    defaultInstance: string;
+    instances: Record<string, InstanceConfig>;
+}
+export declare function loadConfig(): ServicenowMcpConfig;
+export declare function saveConfig(config: ServicenowMcpConfig): void;
+export declare function addInstance(instance: InstanceConfig): void;
+export declare function listInstances(): InstanceConfig[];
+export declare function getDefaultInstance(): InstanceConfig | undefined;
+export declare function removeInstance(name: string): boolean;
+//# sourceMappingURL=config-store.d.ts.map

package/dist/cli/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/cli/config-store.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,GAAG,UAAU,GAAG,eAAe,CAAC;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAiBD,wBAAgB,UAAU,IAAI,mBAAmB,CAUhD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAG5D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAO1D;AAED,wBAAgB,aAAa,IAAI,cAAc,EAAE,CAGhD;AAED,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,SAAS,CAG/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUpD"}

package/dist/cli/config-store.js

@@ -0,0 +1,64 @@
+/**
+ * Persistent config store for servicenow-mcp CLI.
+ * Stores named instance configs at ~/.config/servicenow-mcp/instances.json
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+function configDir() {
+    return join(homedir(), '.config', 'servicenow-mcp');
+}
+function configPath() {
+    return join(configDir(), 'instances.json');
+}
+function ensureDir() {
+    const dir = configDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function loadConfig() {
+    const path = configPath();
+    if (!existsSync(path)) {
+        return { version: 1, defaultInstance: '', instances: {} };
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return { version: 1, defaultInstance: '', instances: {} };
+    }
+}
+export function saveConfig(config) {
+    ensureDir();
+    writeFileSync(configPath(), JSON.stringify(config, null, 2), 'utf8');
+}
+export function addInstance(instance) {
+    const config = loadConfig();
+    config.instances[instance.name] = instance;
+    if (!config.defaultInstance) {
+        config.defaultInstance = instance.name;
+    }
+    saveConfig(config);
+}
+export function listInstances() {
+    const config = loadConfig();
+    return Object.values(config.instances);
+}
+export function getDefaultInstance() {
+    const config = loadConfig();
+    return config.instances[config.defaultInstance];
+}
+export function removeInstance(name) {
+    const config = loadConfig();
+    if (!config.instances[name])
+        return false;
+    delete config.instances[name];
+    if (config.defaultInstance === name) {
+        const remaining = Object.keys(config.instances);
+        config.defaultInstance = remaining[0] || '';
+    }
+    saveConfig(config);
+    return true;
+}
+//# sourceMappingURL=config-store.js.map

package/dist/cli/config-store.js.map

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

package/dist/cli/detect-clients.d.ts

@@ -0,0 +1,16 @@
+export type WriteMethod = 'json-mcpServers' | 'json-servers' | 'command' | 'env';
+export interface DetectedClient {
+    id: string;
+    name: string;
+    detected: boolean;
+    configPath: string;
+    /** JSON key inside the config that holds the server map */
+    configKey: string;
+    /** How the wizard writes the entry */
+    writeMethod: WriteMethod;
+    requiresRestart: boolean;
+    /** Extra note shown to the user after writing */
+    note?: string;
+}
+export declare function detectClients(): DetectedClient[];
+//# sourceMappingURL=detect-clients.d.ts.map

package/dist/cli/detect-clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-clients.d.ts","sourceRoot":"","sources":["../../src/cli/detect-clients.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAuBD,wBAAgB,aAAa,IAAI,cAAc,EAAE,CA4IhD"}

package/dist/cli/detect-clients.js

@@ -0,0 +1,151 @@
+/**
+ * Auto-detect installed AI clients and their MCP config paths.
+ * Checks app binaries and known config file locations per platform.
+ */
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { execSync } from 'child_process';
+function which(bin) {
+    try {
+        // Use 'where' on Windows, 'which' on Unix
+        const cmd = process.platform === 'win32' ? `where ${bin}` : `which ${bin}`;
+        execSync(cmd, { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function appExists(macPath, winExe, linuxBin) {
+    const p = process.platform;
+    if (p === 'darwin')
+        return existsSync(macPath);
+    if (p === 'win32') {
+        const localAppData = process.env['LOCALAPPDATA'] || '';
+        return existsSync(join(localAppData, winExe));
+    }
+    return which(linuxBin);
+}
+export function detectClients() {
+    const home = homedir();
+    const p = process.platform;
+    const appData = process.env['APPDATA'] || join(home, 'AppData', 'Roaming');
+    const clients = [
+        {
+            id: 'claude-desktop',
+            name: 'Claude Desktop',
+            detected: false,
+            configPath: p === 'win32'
+                ? join(appData, 'Claude', 'claude_desktop_config.json')
+                : p === 'darwin'
+                    ? join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+                    : join(home, '.config', 'Claude', 'claude_desktop_config.json'),
+            configKey: 'mcpServers',
+            writeMethod: 'json-mcpServers',
+            requiresRestart: true,
+            note: 'Restart Claude Desktop to activate.',
+        },
+        {
+            id: 'cursor',
+            name: 'Cursor',
+            detected: false,
+            configPath: p === 'win32'
+                ? join(appData, 'Cursor', 'mcp.json')
+                : join(home, '.cursor', 'mcp.json'),
+            configKey: 'mcpServers',
+            writeMethod: 'json-mcpServers',
+            requiresRestart: true,
+            note: 'Reload Cursor window (Cmd/Ctrl+Shift+P → Reload Window) to activate.',
+        },
+        {
+            id: 'vscode',
+            name: 'VS Code (GitHub Copilot)',
+            detected: false,
+            configPath: join(process.cwd(), '.vscode', 'mcp.json'),
+            configKey: 'servers',
+            writeMethod: 'json-servers',
+            requiresRestart: false,
+            note: 'VS Code reads .vscode/mcp.json from the workspace root. Open the workspace folder in VS Code.',
+        },
+        {
+            id: 'windsurf',
+            name: 'Windsurf',
+            detected: false,
+            configPath: p === 'win32'
+                ? join(appData, 'Codeium', 'windsurf', 'mcp_config.json')
+                : join(home, '.codeium', 'windsurf', 'mcp_config.json'),
+            configKey: 'mcpServers',
+            writeMethod: 'json-mcpServers',
+            requiresRestart: true,
+            note: 'Restart Windsurf to activate.',
+        },
+        {
+            id: 'continue',
+            name: 'Continue.dev',
+            detected: false,
+            configPath: join(home, '.continue', 'config.json'),
+            configKey: 'mcpServers',
+            writeMethod: 'json-mcpServers',
+            requiresRestart: false,
+            note: 'Continue.dev will pick up the change automatically.',
+        },
+        {
+            id: 'claude-code',
+            name: 'Claude Code (CLI)',
+            detected: false,
+            configPath: '',
+            configKey: '',
+            writeMethod: 'command',
+            requiresRestart: false,
+            note: 'The `claude mcp add` command will be run automatically.',
+        },
+        {
+            id: 'dotenv',
+            name: 'Generate .env file only',
+            detected: true,
+            configPath: join(process.cwd(), '.env'),
+            configKey: '',
+            writeMethod: 'env',
+            requiresRestart: false,
+            note: 'Set SERVICENOW_INSTANCE_URL and credentials in the generated .env file.',
+        },
+    ];
+    return clients.map(c => {
+        if (c.id === 'claude-desktop') {
+            return {
+                ...c,
+                detected: existsSync(c.configPath) ||
+                    appExists('/Applications/Claude.app', join('AnthropicClaude', 'claude.exe'), 'claude-desktop'),
+            };
+        }
+        if (c.id === 'cursor') {
+            return {
+                ...c,
+                detected: existsSync(c.configPath) ||
+                    appExists('/Applications/Cursor.app', join('Programs', 'cursor', 'Cursor.exe'), 'cursor'),
+            };
+        }
+        if (c.id === 'vscode') {
+            return {
+                ...c,
+                detected: appExists('/Applications/Visual Studio Code.app', join('Programs', 'Microsoft VS Code', 'Code.exe'), 'code'),
+            };
+        }
+        if (c.id === 'windsurf') {
+            return {
+                ...c,
+                detected: existsSync(c.configPath) ||
+                    appExists('/Applications/Windsurf.app', join('Programs', 'windsurf', 'Windsurf.exe'), 'windsurf'),
+            };
+        }
+        if (c.id === 'continue') {
+            return { ...c, detected: existsSync(c.configPath) };
+        }
+        if (c.id === 'claude-code') {
+            return { ...c, detected: which('claude') };
+        }
+        return c;
+    });
+}
+//# sourceMappingURL=detect-clients.js.map

package/dist/cli/detect-clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-clients.js","sourceRoot":"","sources":["../../src/cli/detect-clients.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAkBzC,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC;QAC3E,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,MAAc,EAAE,QAAgB;IAClE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAE3E,MAAM,OAAO,GAAqB;QAChC;YACE,EAAE,EAAE,gBAAgB;YACpB,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,KAAK;YACf,UAAU,EACR,CAAC,KAAK,OAAO;gBACX,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC;gBACvD,CAAC,CAAC,CAAC,KAAK,QAAQ;oBAChB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC;oBACtF,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC;YACnE,SAAS,EAAE,YAAY;YACvB,WAAW,EAAE,iBAAiB;YAC9B,eAAe,EAAE,IAAI;YACrB,IAAI,EAAE,qCAAqC;SAC5C;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,UAAU,EACR,CAAC,KAAK,OAAO;gBACX,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;YACvC,SAAS,EAAE,YAAY;YACvB,WAAW,EAAE,iBAAiB;YAC9B,eAAe,EAAE,IAAI;YACrB,IAAI,EAAE,sEAAsE;SAC7E;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;YACtD,SAAS,EAAE,SAAS;YACpB,WAAW,EAAE,cAAc;YAC3B,eAAe,EAAE,KAAK;YACtB,IAAI,EAAE,+FAA+F;SACtG;QACD;YACE,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,KAAK;YACf,UAAU,EACR,CAAC,KAAK,OAAO;gBACX,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC;gBACzD,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC;YAC3D,SAAS,EAAE,YAAY;YACvB,WAAW,EAAE,iBAAiB;YAC9B,eAAe,EAAE,IAAI;YACrB,IAAI,EAAE,+BAA+B;SACtC;QACD;YACE,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC;YAClD,SAAS,EAAE,YAAY;YACvB,WAAW,EAAE,iBAAiB;YAC9B,eAAe,EAAE,KAAK;YACtB,IAAI,EAAE,qDAAqD;SAC5D;QACD;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,SAAS;YACtB,eAAe,EAAE,KAAK;YACtB,IAAI,EAAE,yDAAyD;SAChE;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,yBAAyB;YAC/B,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC;YACvC,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,KAAK;YACtB,IAAI,EAAE,yEAAyE;SAChF;KACF,CAAC;IAEF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACrB,IAAI,CAAC,CAAC,EAAE,KAAK,gBAAgB,EAAE,CAAC;YAC9B,OAAO;gBACL,GAAG,CAAC;gBACJ,QAAQ,EACN,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;oBACxB,SAAS,CACP,0BAA0B,EAC1B,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,EACrC,gBAAgB,CACjB;aACJ,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,GAAG,CAAC;gBACJ,QAAQ,EACN,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;oBACxB,SAAS,CACP,0BAA0B,EAC1B,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,EACxC,QAAQ,CACT;aACJ,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,GAAG,CAAC;gBACJ,QAAQ,EAAE,SAAS,CACjB,sCAAsC,EACtC,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE,UAAU,CAAC,EACjD,MAAM,CACP;aACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;YACxB,OAAO;gBACL,GAAG,CAAC;gBACJ,QAAQ,EACN,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;oBACxB,SAAS,CAAC,4BAA4B,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,UAAU,CAAC;aACpG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;YACxB,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,aAAa,EAAE,CAAC;YAC3B,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * servicenow-mcp CLI entry point.
+ *
+ * Commands:
+ *   servicenow-mcp setup [--add]   — interactive setup wizard
+ *   servicenow-mcp auth login      — per-user OAuth login
+ *   servicenow-mcp auth logout     — remove stored token
+ *   servicenow-mcp auth whoami     — show current authenticated user
+ *   servicenow-mcp instances list  — list configured instances
+ *   servicenow-mcp instances remove <name>  — remove an instance
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { runSetup } from './setup.js';
+import { authLogin, authLogout, authWhoami } from './auth.js';
+import { listInstances, removeInstance } from './config-store.js';
+// Brand colors (teal/navy palette)
+// Terminal-adaptive: white/subtle/dim use chalk built-ins so text stays visible
+// on both dark and light (bright-white) terminal backgrounds.
+const teal = chalk.hex('#00D4AA');
+const navy = chalk.hex('#0F4C81');
+const bright = chalk.hex('#00B899');
+const dim = chalk.gray;
+const white = chalk.bold;
+const subtle = chalk.dim;
+const success = chalk.hex('#10B981');
+const err = chalk.hex('#E8466A');
+function logoText() {
+    return white('ServiceNow ') + teal.bold('MCP');
+}
+function cliBanner() {
+    console.log('');
+    console.log(bright('  ╔═╗') + teal('╔╗╔') + dim('  ') + teal('╔╦╗') + bright('╔═╗') + teal('╔═╗'));
+    console.log(teal('  ╚═╗') + navy('║║║') + dim('  ') + navy(' ║ ') + teal('║║║') + navy('╠═╝'));
+    console.log(navy('  ╚═╝') + teal('╝╚╝') + dim('  ') + teal(' ╩ ') + navy('╩ ╩') + teal('╩  ') + dim('  ') + teal('✦'));
+    console.log('');
+    console.log(`  ${logoText()}  ${dim('—')} ${subtle('400+ ServiceNow MCP tools')}`);
+    console.log(dim('  Connect ') + teal.bold('Any AI') + dim(' to ServiceNow. Instantly.'));
+    console.log('');
+}
+const program = new Command();
+program
+    .name('servicenow-mcp')
+    .description('The most comprehensive ServiceNow MCP server')
+    .version('1.0.0')
+    .addHelpText('before', '')
+    .addHelpText('beforeAll', () => {
+    cliBanner();
+    return '';
+});
+// ─── setup ────────────────────────────────────────────────────────────────────
+program
+    .command('setup')
+    .description('Interactive setup wizard — connect to ServiceNow and your AI client')
+    .option('--add', 'Add another instance without overwriting existing config')
+    .action(async (opts) => {
+    await runSetup({ add: opts.add });
+});
+// ─── auth ─────────────────────────────────────────────────────────────────────
+const auth = program.command('auth').description('Per-user authentication management');
+auth
+    .command('login')
+    .description('Authenticate as yourself — queries run in your own ServiceNow permission context')
+    .action(async () => {
+    await authLogin();
+});
+auth
+    .command('logout [instanceUrl]')
+    .description('Remove stored authentication token')
+    .action((instanceUrl) => {
+    authLogout(instanceUrl);
+});
+auth
+    .command('whoami')
+    .description('Show which ServiceNow user is currently authenticated')
+    .action(() => {
+    authWhoami();
+});
+// ─── instances ────────────────────────────────────────────────────────────────
+const instances = program.command('instances').description('Manage configured ServiceNow instances');
+instances
+    .command('list')
+    .description('List all configured instances')
+    .action(() => {
+    const list = listInstances();
+    if (list.length === 0) {
+        console.log('');
+        console.log(dim('  No instances configured. Run ') + teal('servicenow-mcp setup') + dim(' to add one.'));
+        console.log('');
+        return;
+    }
+    console.log('');
+    console.log(dim('  ' + '─'.repeat(60)));
+    console.log(`  ${dim('NAME'.padEnd(16))} ${dim('URL'.padEnd(36))} ${dim('AUTH')}`);
+    console.log(dim('  ' + '─'.repeat(60)));
+    for (const inst of list) {
+        const envBadge = inst.environment
+            ? (inst.environment === 'production' ? err(' PROD ')
+                : inst.environment === 'development' ? success(' DEV  ')
+                    : inst.environment === 'test' ? chalk.hex('#FF6B35')(' TEST ')
+                        : inst.environment === 'staging' ? navy(' STG  ')
+                            : dim(' PDI  '))
+            : '';
+        console.log(`  ${teal(inst.name.padEnd(16))} ${bright(inst.instanceUrl.padEnd(36))} ${dim(inst.authMethod)}${envBadge ? ' ' + envBadge : ''}`);
+        if (inst.group) {
+            console.log(`  ${' '.repeat(16)} ${dim('group: ' + inst.group)}`);
+        }
+    }
+    console.log(dim('  ' + '─'.repeat(60)));
+    console.log('');
+});
+instances
+    .command('remove <name>')
+    .description('Remove a configured instance')
+    .action((name) => {
+    const removed = removeInstance(name);
+    if (removed) {
+        console.log(`  ${success('✓')} ${white(`Removed instance "${name}"`)}`);
+    }
+    else {
+        console.log(`  ${err('✗')} ${white(`Instance "${name}" not found`)}`);
+    }
+});
+program.parseAsync(process.argv).catch((e) => {
+    console.error(err('Error:'), e instanceof Error ? e.message : e);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/setup.d.ts

@@ -0,0 +1,4 @@
+export declare function runSetup(options?: {
+    add?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map