nowaikit 2.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +96 -0
- package/LICENSE +21 -0
- package/README.md +1253 -0
- package/desktop/renderer/dist/apple-touch-icon.png +0 -0
- package/desktop/renderer/dist/assets/index-Bb0ncZQl.css +1 -0
- package/desktop/renderer/dist/assets/index-MlBBSUMZ.js +49 -0
- package/desktop/renderer/dist/favicon-32.png +0 -0
- package/desktop/renderer/dist/favicon.svg +18 -0
- package/desktop/renderer/dist/index.html +18 -0
- package/desktop/serve.js +449 -0
- package/dist/cli/auth.d.ts +14 -0
- package/dist/cli/auth.d.ts.map +1 -0
- package/dist/cli/auth.js +179 -0
- package/dist/cli/auth.js.map +1 -0
- package/dist/cli/config-store.d.ts +28 -0
- package/dist/cli/config-store.d.ts.map +1 -0
- package/dist/cli/config-store.js +64 -0
- package/dist/cli/config-store.js.map +1 -0
- package/dist/cli/detect-clients.d.ts +16 -0
- package/dist/cli/detect-clients.d.ts.map +1 -0
- package/dist/cli/detect-clients.js +151 -0
- package/dist/cli/detect-clients.js.map +1 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +193 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/setup.d.ts +4 -0
- package/dist/cli/setup.d.ts.map +1 -0
- package/dist/cli/setup.js +575 -0
- package/dist/cli/setup.js.map +1 -0
- package/dist/cli/writers/index.d.ts +9 -0
- package/dist/cli/writers/index.d.ts.map +1 -0
- package/dist/cli/writers/index.js +140 -0
- package/dist/cli/writers/index.js.map +1 -0
- package/dist/prompts/index.d.ts +25 -0
- package/dist/prompts/index.d.ts.map +1 -0
- package/dist/prompts/index.js +38 -0
- package/dist/prompts/index.js.map +1 -0
- package/dist/prompts/itsm.d.ts +20 -0
- package/dist/prompts/itsm.d.ts.map +1 -0
- package/dist/prompts/itsm.js +110 -0
- package/dist/prompts/itsm.js.map +1 -0
- package/dist/prompts/user-prompts.d.ts +3 -0
- package/dist/prompts/user-prompts.d.ts.map +1 -0
- package/dist/prompts/user-prompts.js +35 -0
- package/dist/prompts/user-prompts.js.map +1 -0
- package/dist/resources/index.d.ts +26 -0
- package/dist/resources/index.d.ts.map +1 -0
- package/dist/resources/index.js +99 -0
- package/dist/resources/index.js.map +1 -0
- package/dist/server.d.ts +3 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +129 -0
- package/dist/server.js.map +1 -0
- package/dist/servicenow/client.d.ts +135 -0
- package/dist/servicenow/client.d.ts.map +1 -0
- package/dist/servicenow/client.js +803 -0
- package/dist/servicenow/client.js.map +1 -0
- package/dist/servicenow/instances.d.ts +28 -0
- package/dist/servicenow/instances.d.ts.map +1 -0
- package/dist/servicenow/instances.js +204 -0
- package/dist/servicenow/instances.js.map +1 -0
- package/dist/servicenow/types.d.ts +574 -0
- package/dist/servicenow/types.d.ts.map +1 -0
- package/dist/servicenow/types.js +3 -0
- package/dist/servicenow/types.js.map +1 -0
- package/dist/tools/agile.d.ts +225 -0
- package/dist/tools/agile.d.ts.map +1 -0
- package/dist/tools/agile.js +205 -0
- package/dist/tools/agile.js.map +1 -0
- package/dist/tools/app-studio.d.ts +139 -0
- package/dist/tools/app-studio.d.ts.map +1 -0
- package/dist/tools/app-studio.js +139 -0
- package/dist/tools/app-studio.js.map +1 -0
- package/dist/tools/atf.d.ts +144 -0
- package/dist/tools/atf.d.ts.map +1 -0
- package/dist/tools/atf.js +186 -0
- package/dist/tools/atf.js.map +1 -0
- package/dist/tools/catalog.d.ts +628 -0
- package/dist/tools/catalog.d.ts.map +1 -0
- package/dist/tools/catalog.js +397 -0
- package/dist/tools/catalog.js.map +1 -0
- package/dist/tools/change.d.ts +347 -0
- package/dist/tools/change.d.ts.map +1 -0
- package/dist/tools/change.js +213 -0
- package/dist/tools/change.js.map +1 -0
- package/dist/tools/core.d.ts +540 -0
- package/dist/tools/core.d.ts.map +1 -0
- package/dist/tools/core.js +373 -0
- package/dist/tools/core.js.map +1 -0
- package/dist/tools/csm.d.ts +401 -0
- package/dist/tools/csm.d.ts.map +1 -0
- package/dist/tools/csm.js +255 -0
- package/dist/tools/csm.js.map +1 -0
- package/dist/tools/deployment.d.ts +366 -0
- package/dist/tools/deployment.d.ts.map +1 -0
- package/dist/tools/deployment.js +181 -0
- package/dist/tools/deployment.js.map +1 -0
- package/dist/tools/devops.d.ts +236 -0
- package/dist/tools/devops.d.ts.map +1 -0
- package/dist/tools/devops.js +207 -0
- package/dist/tools/devops.js.map +1 -0
- package/dist/tools/flow.d.ts +496 -0
- package/dist/tools/flow.d.ts.map +1 -0
- package/dist/tools/flow.js +348 -0
- package/dist/tools/flow.js.map +1 -0
- package/dist/tools/hrsd.d.ts +789 -0
- package/dist/tools/hrsd.d.ts.map +1 -0
- package/dist/tools/hrsd.js +377 -0
- package/dist/tools/hrsd.js.map +1 -0
- package/dist/tools/incident.d.ts +256 -0
- package/dist/tools/incident.d.ts.map +1 -0
- package/dist/tools/incident.js +163 -0
- package/dist/tools/incident.js.map +1 -0
- package/dist/tools/index.d.ts +11514 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +276 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/integration.d.ts +603 -0
- package/dist/tools/integration.d.ts.map +1 -0
- package/dist/tools/integration.js +510 -0
- package/dist/tools/integration.js.map +1 -0
- package/dist/tools/itam.d.ts +462 -0
- package/dist/tools/itam.d.ts.map +1 -0
- package/dist/tools/itam.js +306 -0
- package/dist/tools/itam.js.map +1 -0
- package/dist/tools/knowledge.d.ts +187 -0
- package/dist/tools/knowledge.d.ts.map +1 -0
- package/dist/tools/knowledge.js +161 -0
- package/dist/tools/knowledge.js.map +1 -0
- package/dist/tools/ml.d.ts +263 -0
- package/dist/tools/ml.d.ts.map +1 -0
- package/dist/tools/ml.js +251 -0
- package/dist/tools/ml.js.map +1 -0
- package/dist/tools/mobile.d.ts +352 -0
- package/dist/tools/mobile.d.ts.map +1 -0
- package/dist/tools/mobile.js +122 -0
- package/dist/tools/mobile.js.map +1 -0
- package/dist/tools/notification.d.ts +590 -0
- package/dist/tools/notification.d.ts.map +1 -0
- package/dist/tools/notification.js +382 -0
- package/dist/tools/notification.js.map +1 -0
- package/dist/tools/now-assist.d.ts +300 -0
- package/dist/tools/now-assist.d.ts.map +1 -0
- package/dist/tools/now-assist.js +227 -0
- package/dist/tools/now-assist.js.map +1 -0
- package/dist/tools/performance.d.ts +447 -0
- package/dist/tools/performance.d.ts.map +1 -0
- package/dist/tools/performance.js +473 -0
- package/dist/tools/performance.js.map +1 -0
- package/dist/tools/portal.d.ts +530 -0
- package/dist/tools/portal.d.ts.map +1 -0
- package/dist/tools/portal.js +425 -0
- package/dist/tools/portal.js.map +1 -0
- package/dist/tools/problem.d.ts +110 -0
- package/dist/tools/problem.d.ts.map +1 -0
- package/dist/tools/problem.js +100 -0
- package/dist/tools/problem.js.map +1 -0
- package/dist/tools/reporting.d.ts +825 -0
- package/dist/tools/reporting.d.ts.map +1 -0
- package/dist/tools/reporting.js +460 -0
- package/dist/tools/reporting.js.map +1 -0
- package/dist/tools/script.d.ts +714 -0
- package/dist/tools/script.d.ts.map +1 -0
- package/dist/tools/script.js +629 -0
- package/dist/tools/script.js.map +1 -0
- package/dist/tools/security.d.ts +794 -0
- package/dist/tools/security.d.ts.map +1 -0
- package/dist/tools/security.js +425 -0
- package/dist/tools/security.js.map +1 -0
- package/dist/tools/sys-properties.d.ts +315 -0
- package/dist/tools/sys-properties.d.ts.map +1 -0
- package/dist/tools/sys-properties.js +372 -0
- package/dist/tools/sys-properties.js.map +1 -0
- package/dist/tools/task.d.ts +82 -0
- package/dist/tools/task.d.ts.map +1 -0
- package/dist/tools/task.js +96 -0
- package/dist/tools/task.js.map +1 -0
- package/dist/tools/updateset.d.ts +159 -0
- package/dist/tools/updateset.d.ts.map +1 -0
- package/dist/tools/updateset.js +212 -0
- package/dist/tools/updateset.js.map +1 -0
- package/dist/tools/user.d.ts +206 -0
- package/dist/tools/user.d.ts.map +1 -0
- package/dist/tools/user.js +163 -0
- package/dist/tools/user.js.map +1 -0
- package/dist/tools/va.d.ts +217 -0
- package/dist/tools/va.d.ts.map +1 -0
- package/dist/tools/va.js +178 -0
- package/dist/tools/va.js.map +1 -0
- package/dist/tools/workspace.d.ts +565 -0
- package/dist/tools/workspace.d.ts.map +1 -0
- package/dist/tools/workspace.js +201 -0
- package/dist/tools/workspace.js.map +1 -0
- package/dist/tools-manifest.json +7852 -0
- package/dist/utils/errors.d.ts +6 -0
- package/dist/utils/errors.d.ts.map +1 -0
- package/dist/utils/errors.js +11 -0
- package/dist/utils/errors.js.map +1 -0
- package/dist/utils/logging.d.ts +7 -0
- package/dist/utils/logging.d.ts.map +1 -0
- package/dist/utils/logging.js +15 -0
- package/dist/utils/logging.js.map +1 -0
- package/dist/utils/permissions.d.ts +21 -0
- package/dist/utils/permissions.d.ts.map +1 -0
- package/dist/utils/permissions.js +54 -0
- package/dist/utils/permissions.js.map +1 -0
- package/instances.example.json +71 -0
- package/package.json +110 -0
package/dist/server.js
ADDED
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
3
|
+
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
4
|
+
import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
|
|
5
|
+
import dotenv from 'dotenv';
|
|
6
|
+
import { instanceManager } from './servicenow/instances.js';
|
|
7
|
+
import { getTools } from './tools/index.js';
|
|
8
|
+
import { getResources, readResource } from './resources/index.js';
|
|
9
|
+
import { getPrompts, resolvePrompt } from './prompts/index.js';
|
|
10
|
+
import { logger } from './utils/logging.js';
|
|
11
|
+
import { ServiceNowError } from './utils/errors.js';
|
|
12
|
+
dotenv.config();
|
|
13
|
+
// Require at least one instance to be configured
|
|
14
|
+
const hasLegacy = !!process.env.SERVICENOW_INSTANCE_URL;
|
|
15
|
+
const hasMulti = Object.keys(process.env).some(k => /^SN_INSTANCE_[A-Z0-9_]+_URL$/.test(k));
|
|
16
|
+
const hasConfig = !!process.env.SN_INSTANCES_CONFIG;
|
|
17
|
+
if (!hasLegacy && !hasMulti && !hasConfig) {
|
|
18
|
+
logger.error('No ServiceNow instance configured. Set SERVICENOW_INSTANCE_URL or SN_INSTANCES_CONFIG.');
|
|
19
|
+
process.exit(1);
|
|
20
|
+
}
|
|
21
|
+
const server = new Server({
|
|
22
|
+
name: 'nowaikit',
|
|
23
|
+
version: '2.5.0',
|
|
24
|
+
}, {
|
|
25
|
+
capabilities: {
|
|
26
|
+
tools: {},
|
|
27
|
+
resources: {},
|
|
28
|
+
prompts: {},
|
|
29
|
+
},
|
|
30
|
+
});
|
|
31
|
+
const tools = getTools();
|
|
32
|
+
// ─── Tools ────────────────────────────────────────────────────────────────────
|
|
33
|
+
server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
34
|
+
return { tools };
|
|
35
|
+
});
|
|
36
|
+
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
37
|
+
const { name, arguments: args } = request.params;
|
|
38
|
+
logger.info(`Tool called: ${name}`);
|
|
39
|
+
try {
|
|
40
|
+
const tool = tools.find(t => t.name === name);
|
|
41
|
+
if (!tool) {
|
|
42
|
+
throw new ServiceNowError(`Unknown tool: ${name}`, 'UNKNOWN_TOOL');
|
|
43
|
+
}
|
|
44
|
+
// Resolve client: use named instance if specified, otherwise current active instance
|
|
45
|
+
const instanceName = args?.['instance'];
|
|
46
|
+
const client = instanceManager.getClient(instanceName);
|
|
47
|
+
const { executeTool } = await import('./tools/index.js');
|
|
48
|
+
const result = await executeTool(client, name, args || {});
|
|
49
|
+
return {
|
|
50
|
+
content: [
|
|
51
|
+
{
|
|
52
|
+
type: 'text',
|
|
53
|
+
text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
|
|
54
|
+
},
|
|
55
|
+
],
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
catch (error) {
|
|
59
|
+
logger.error(`Tool execution error: ${name}`, error);
|
|
60
|
+
if (error instanceof ServiceNowError) {
|
|
61
|
+
return {
|
|
62
|
+
content: [
|
|
63
|
+
{
|
|
64
|
+
type: 'text',
|
|
65
|
+
text: `Error: ${error.message} (Code: ${error.code})`,
|
|
66
|
+
},
|
|
67
|
+
],
|
|
68
|
+
isError: true,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
return {
|
|
72
|
+
content: [
|
|
73
|
+
{
|
|
74
|
+
type: 'text',
|
|
75
|
+
text: `Error executing tool: ${error instanceof Error ? error.message : 'Unknown error'}`,
|
|
76
|
+
},
|
|
77
|
+
],
|
|
78
|
+
isError: true,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
});
|
|
82
|
+
// ─── Resources (@ mentions) ───────────────────────────────────────────────────
|
|
83
|
+
server.setRequestHandler(ListResourcesRequestSchema, async () => {
|
|
84
|
+
return { resources: getResources() };
|
|
85
|
+
});
|
|
86
|
+
server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
|
|
87
|
+
const { uri } = request.params;
|
|
88
|
+
try {
|
|
89
|
+
const client = instanceManager.getClient();
|
|
90
|
+
const content = await readResource(client, uri);
|
|
91
|
+
return {
|
|
92
|
+
contents: [
|
|
93
|
+
{
|
|
94
|
+
uri,
|
|
95
|
+
mimeType: 'application/json',
|
|
96
|
+
text: JSON.stringify(content, null, 2),
|
|
97
|
+
},
|
|
98
|
+
],
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
catch (error) {
|
|
102
|
+
logger.error(`Resource read error: ${uri}`, error);
|
|
103
|
+
throw error;
|
|
104
|
+
}
|
|
105
|
+
});
|
|
106
|
+
// ─── Prompts (/ slash commands) ───────────────────────────────────────────────
|
|
107
|
+
server.setRequestHandler(ListPromptsRequestSchema, async () => {
|
|
108
|
+
return { prompts: getPrompts() };
|
|
109
|
+
});
|
|
110
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
111
|
+
server.setRequestHandler(GetPromptRequestSchema, async (request) => {
|
|
112
|
+
const { name, arguments: args } = request.params;
|
|
113
|
+
const result = resolvePrompt(name, args);
|
|
114
|
+
if (!result) {
|
|
115
|
+
throw new Error(`Unknown prompt: ${name}`);
|
|
116
|
+
}
|
|
117
|
+
return result;
|
|
118
|
+
});
|
|
119
|
+
// ─── Start ────────────────────────────────────────────────────────────────────
|
|
120
|
+
async function main() {
|
|
121
|
+
const transport = new StdioServerTransport();
|
|
122
|
+
await server.connect(transport);
|
|
123
|
+
logger.info(`NowAIKit server running on stdio [${tools.length} tools]`);
|
|
124
|
+
}
|
|
125
|
+
main().catch((error) => {
|
|
126
|
+
logger.error('Server startup failed', error);
|
|
127
|
+
process.exit(1);
|
|
128
|
+
});
|
|
129
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import type { ServiceNowConfig, QueryRecordsParams, QueryRecordsResponse, ServiceNowRecord } from './types.js';
|
|
2
|
+
export declare class ServiceNowClient {
|
|
3
|
+
private baseUrl;
|
|
4
|
+
private authMethod;
|
|
5
|
+
private authMode;
|
|
6
|
+
private oauthConfig?;
|
|
7
|
+
private basicConfig?;
|
|
8
|
+
private maxRetries;
|
|
9
|
+
private retryDelayMs;
|
|
10
|
+
private requestTimeoutMs;
|
|
11
|
+
/** For impersonation mode: user sys_id to pass in X-Sn-Impersonate */
|
|
12
|
+
private impersonateUserSysId?;
|
|
13
|
+
/** For per-user mode: pre-loaded token overrides service-account auth */
|
|
14
|
+
private perUserBearerToken?;
|
|
15
|
+
private accessToken?;
|
|
16
|
+
private tokenExpiry?;
|
|
17
|
+
constructor(config: ServiceNowConfig);
|
|
18
|
+
/**
|
|
19
|
+
* Return a copy of this client configured to run as a specific user.
|
|
20
|
+
* Used for per-request user context switching without mutating the shared client.
|
|
21
|
+
*/
|
|
22
|
+
withUser(options: {
|
|
23
|
+
sysId?: string;
|
|
24
|
+
bearerToken?: string;
|
|
25
|
+
}): ServiceNowClient;
|
|
26
|
+
/**
|
|
27
|
+
* Authenticate with ServiceNow using OAuth or Basic Auth
|
|
28
|
+
*/
|
|
29
|
+
private authenticate;
|
|
30
|
+
/**
|
|
31
|
+
* Get authorization header for requests.
|
|
32
|
+
* Per-user mode returns the user's own Bearer token directly.
|
|
33
|
+
* Impersonation and service-account modes use the configured service account.
|
|
34
|
+
*/
|
|
35
|
+
private getAuthHeader;
|
|
36
|
+
/**
|
|
37
|
+
* Returns the X-Sn-Impersonate header value if impersonation mode is active.
|
|
38
|
+
* ServiceNow executes the request in the context of the named user's roles/ACLs.
|
|
39
|
+
*/
|
|
40
|
+
private getImpersonateHeader;
|
|
41
|
+
/**
|
|
42
|
+
* Make HTTP request with retry logic
|
|
43
|
+
*/
|
|
44
|
+
private request;
|
|
45
|
+
/**
|
|
46
|
+
* Query records from a ServiceNow table
|
|
47
|
+
*/
|
|
48
|
+
queryRecords(params: QueryRecordsParams): Promise<QueryRecordsResponse>;
|
|
49
|
+
/**
|
|
50
|
+
* Get table schema/structure
|
|
51
|
+
*/
|
|
52
|
+
getTableSchema(tableName: string): Promise<any>;
|
|
53
|
+
/**
|
|
54
|
+
* Get a single record by sys_id
|
|
55
|
+
*/
|
|
56
|
+
getRecord(table: string, sysId: string, fields?: string): Promise<ServiceNowRecord>;
|
|
57
|
+
/**
|
|
58
|
+
* Get user details by email or username
|
|
59
|
+
*/
|
|
60
|
+
getUser(userIdentifier: string): Promise<ServiceNowRecord>;
|
|
61
|
+
/**
|
|
62
|
+
* Get group details by name or sys_id
|
|
63
|
+
*/
|
|
64
|
+
getGroup(groupIdentifier: string): Promise<ServiceNowRecord>;
|
|
65
|
+
/**
|
|
66
|
+
* Search CMDB configuration items
|
|
67
|
+
*/
|
|
68
|
+
searchCmdbCi(query?: string, limit?: number): Promise<QueryRecordsResponse>;
|
|
69
|
+
/**
|
|
70
|
+
* Get a specific CMDB configuration item
|
|
71
|
+
*/
|
|
72
|
+
getCmdbCi(ciSysId: string, fields?: string): Promise<ServiceNowRecord>;
|
|
73
|
+
/**
|
|
74
|
+
* List relationships for a CI
|
|
75
|
+
*/
|
|
76
|
+
listRelationships(ciSysId: string): Promise<any>;
|
|
77
|
+
/**
|
|
78
|
+
* List discovery schedules
|
|
79
|
+
*/
|
|
80
|
+
listDiscoverySchedules(activeOnly?: boolean): Promise<any>;
|
|
81
|
+
/**
|
|
82
|
+
* List MID servers
|
|
83
|
+
*/
|
|
84
|
+
listMidServers(activeOnly?: boolean): Promise<any>;
|
|
85
|
+
/**
|
|
86
|
+
* List active events
|
|
87
|
+
*/
|
|
88
|
+
listActiveEvents(query?: string, limit?: number): Promise<QueryRecordsResponse>;
|
|
89
|
+
/**
|
|
90
|
+
* Get CMDB health dashboard metrics
|
|
91
|
+
*/
|
|
92
|
+
cmdbHealthDashboard(): Promise<any>;
|
|
93
|
+
/**
|
|
94
|
+
* Get service mapping summary
|
|
95
|
+
*/
|
|
96
|
+
serviceMappingSummary(serviceSysId: string): Promise<any>;
|
|
97
|
+
/**
|
|
98
|
+
* Create a change request
|
|
99
|
+
*/
|
|
100
|
+
createChangeRequest(params: any): Promise<ServiceNowRecord>;
|
|
101
|
+
/**
|
|
102
|
+
* Create a record in any ServiceNow table
|
|
103
|
+
*/
|
|
104
|
+
createRecord(table: string, data: Record<string, any>): Promise<ServiceNowRecord>;
|
|
105
|
+
/**
|
|
106
|
+
* Update a record in any ServiceNow table
|
|
107
|
+
*/
|
|
108
|
+
updateRecord(table: string, sysId: string, data: Record<string, any>): Promise<ServiceNowRecord>;
|
|
109
|
+
/**
|
|
110
|
+
* Delete a record from any ServiceNow table
|
|
111
|
+
*/
|
|
112
|
+
deleteRecord(table: string, sysId: string): Promise<void>;
|
|
113
|
+
/**
|
|
114
|
+
* Call Now Assist / Generative AI endpoints (latest release)
|
|
115
|
+
*/
|
|
116
|
+
callNowAssist(endpoint: string, payload: Record<string, any>): Promise<any>;
|
|
117
|
+
/**
|
|
118
|
+
* Run aggregate/stats query on a table (ServiceNow Reporting API)
|
|
119
|
+
*/
|
|
120
|
+
runAggregateQuery(table: string, groupBy: string, _aggregate?: string, query?: string): Promise<any>;
|
|
121
|
+
/**
|
|
122
|
+
* Natural language search (simplified implementation)
|
|
123
|
+
*/
|
|
124
|
+
naturalLanguageSearch(query: string, limit?: number): Promise<any>;
|
|
125
|
+
/**
|
|
126
|
+
* Upload a file attachment to a ServiceNow record via the Attachment API.
|
|
127
|
+
* Accepts base64-encoded content and uploads it as a multipart form.
|
|
128
|
+
*/
|
|
129
|
+
uploadAttachment(table: string, recordSysId: string, fileName: string, contentType: string, contentBase64: string): Promise<any>;
|
|
130
|
+
/**
|
|
131
|
+
* Natural language update (simplified implementation)
|
|
132
|
+
*/
|
|
133
|
+
naturalLanguageUpdate(_instruction: string, _table: string): Promise<any>;
|
|
134
|
+
}
|
|
135
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/servicenow/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EAGpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA+CpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAC,CAA4B;IAChD,OAAO,CAAC,WAAW,CAAC,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IAEjC,sEAAsE;IACtE,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,yEAAyE;IACzE,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,MAAM,EAAE,gBAAgB;IAapC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB;IAc7E;;OAEG;YACW,YAAY;IAoE1B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IA4BrB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;YACW,OAAO;IAiGrB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsE7E;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwCrD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BzF;;OAEG;IACG,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+BhE;;OAEG;IACG,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BlE;;OAEG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+BrF;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI5E;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA0BtD;;OAEG;IACG,sBAAsB,CAAC,UAAU,GAAE,OAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IA0BvE;;OAEG;IACG,cAAc,CAAC,UAAU,GAAE,OAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IA0B/D;;OAEG;IACG,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+BzF;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC;IAmDzC;;OAEG;IACG,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA8B/D;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyBjE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBvF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBtG;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAmBjF;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAmBnH;;OAEG;IACG,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAc5E;;;OAGG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,GAAG,CAAC;IA4Cf;;OAEG;IACG,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAUhF"}
|