snow-flow 4.2.2 → 4.2.4

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/dist/cli.js CHANGED
@@ -1590,97 +1590,7 @@ program
1590
1590
  cliLogger.error('āŒ Invalid memory operation');
1591
1591
  }
1592
1592
  });
1593
- // Auth command - OAuth implementation
1594
- program
1595
- .command('auth <action>')
1596
- .description('Authentication management (login, logout, status)')
1597
- .option('--instance <instance>', 'ServiceNow instance (e.g., dev12345.service-now.com)')
1598
- .option('--client-id <clientId>', 'OAuth Client ID')
1599
- .option('--client-secret <clientSecret>', 'OAuth Client Secret')
1600
- .action(async (action, options) => {
1601
- const oauth = new snow_oauth_js_1.ServiceNowOAuth();
1602
- if (action === 'login') {
1603
- cliLogger.info('šŸ”‘ Starting ServiceNow OAuth authentication...');
1604
- // Get credentials from options or environment
1605
- const instance = options.instance || process.env.SNOW_INSTANCE;
1606
- const clientId = options.clientId || process.env.SNOW_CLIENT_ID;
1607
- const clientSecret = options.clientSecret || process.env.SNOW_CLIENT_SECRET;
1608
- if (!instance || !clientId || !clientSecret) {
1609
- console.error('āŒ Missing required OAuth credentials');
1610
- cliLogger.info('\nšŸ“ Please provide:');
1611
- cliLogger.info(' --instance: ServiceNow instance (e.g., dev12345.service-now.com)');
1612
- cliLogger.info(' --client-id: OAuth Client ID');
1613
- cliLogger.info(' --client-secret: OAuth Client Secret');
1614
- cliLogger.info('\nšŸ’” Or set environment variables:');
1615
- cliLogger.info(' export SNOW_INSTANCE=your-instance.service-now.com');
1616
- cliLogger.info(' export SNOW_CLIENT_ID=your-client-id');
1617
- cliLogger.info(' export SNOW_CLIENT_SECRET=your-client-secret');
1618
- return;
1619
- }
1620
- // Start OAuth flow
1621
- const result = await oauth.authenticate(instance, clientId, clientSecret);
1622
- if (result.success) {
1623
- cliLogger.info('\nāœ… Authentication successful!');
1624
- cliLogger.info('šŸŽ‰ Snow-Flow is now connected to ServiceNow!');
1625
- cliLogger.info('\nšŸ“‹ Next steps:');
1626
- cliLogger.info(' 1. Test connection: snow-flow auth status');
1627
- cliLogger.info(' 2. Start development: snow-flow swarm "create a widget for incident management"');
1628
- // Test connection
1629
- const client = new servicenow_client_js_1.ServiceNowClient();
1630
- const testResult = await client.testConnection();
1631
- if (testResult.success) {
1632
- cliLogger.info(`\nšŸ” Connection test successful!`);
1633
- cliLogger.info(`šŸ‘¤ Logged in as: ${testResult.data.name} (${testResult.data.user_name})`);
1634
- }
1635
- }
1636
- else {
1637
- console.error(`\nāŒ Authentication failed: ${result.error}`);
1638
- process.exit(1);
1639
- }
1640
- }
1641
- else if (action === 'logout') {
1642
- cliLogger.info('šŸ”“ Logging out...');
1643
- await oauth.logout();
1644
- }
1645
- else if (action === 'status') {
1646
- cliLogger.info('šŸ“Š Authentication Status:');
1647
- const isAuthenticated = await oauth.isAuthenticated();
1648
- const credentials = await oauth.loadCredentials();
1649
- if (isAuthenticated && credentials) {
1650
- console.log(' ā”œā”€ā”€ Status: āœ… Authenticated');
1651
- console.log(` ā”œā”€ā”€ Instance: ${credentials.instance}`);
1652
- console.log(' ā”œā”€ā”€ Method: OAuth 2.0');
1653
- console.log(` ā”œā”€ā”€ Client ID: ${credentials.clientId}`);
1654
- if (credentials.expiresAt) {
1655
- const expiresAt = new Date(credentials.expiresAt);
1656
- console.log(` └── Token expires: ${expiresAt.toLocaleString()}`);
1657
- }
1658
- // Test connection
1659
- const client = new servicenow_client_js_1.ServiceNowClient();
1660
- const testResult = await client.testConnection();
1661
- if (testResult.success) {
1662
- console.log(`\nšŸ” Connection test: āœ… Success`);
1663
- if (testResult.data.message) {
1664
- console.log(` ${testResult.data.message}`);
1665
- }
1666
- console.log(`🌐 Instance: ${testResult.data.email || credentials.instance}`);
1667
- }
1668
- else {
1669
- console.log(`\nšŸ” Connection test: āŒ Failed`);
1670
- console.log(` Error: ${testResult.error}`);
1671
- }
1672
- }
1673
- else {
1674
- console.log(' ā”œā”€ā”€ Status: āŒ Not authenticated');
1675
- console.log(' ā”œā”€ā”€ Instance: Not configured');
1676
- console.log(' └── Method: Not set');
1677
- console.log('\nšŸ’” Run "snow-flow auth login" to authenticate');
1678
- }
1679
- }
1680
- else {
1681
- console.log('āŒ Invalid action. Use: login, logout, or status');
1682
- }
1683
- });
1593
+ // Auth commands are now handled by registerAuthCommands() at the top of this file
1684
1594
  // Initialize Snow-Flow project
1685
1595
  program
1686
1596
  .command('init')
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "snow-flow",
3
- "version": "4.2.2",
3
+ "version": "4.2.4",
4
4
  "description": "Conversational ServiceNow development platform using Claude Code. Multi-agent orchestration with 20+ MCP servers providing 200+ ServiceNow tools for comprehensive platform development.",
5
5
  "main": "dist/index.js",
6
6
  "type": "commonjs",
@@ -191,40 +191,40 @@
191
191
  What is Snow-Flow?
192
192
  </h2>
193
193
  <p class="hero-inspired-subtitle" style="font-size: var(--font-xl); max-width: 800px; margin: 0 auto;">
194
- AI-powered ServiceNow development that transforms manual workflows into intelligent automation
194
+ Conversational ServiceNow development platform using Claude Code as your development interface
195
195
  </p>
196
196
  </div>
197
197
 
198
198
  <!-- How it Works Grid -->
199
199
  <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8" style="margin-bottom: var(--space-20);">
200
200
 
201
- <!-- MCP Architecture -->
201
+ <!-- MCP Server Integration -->
202
202
  <div class="hero-inspired-card text-center">
203
203
  <div style="font-size: var(--font-4xl); margin-bottom: var(--space-4);">šŸ—ļø</div>
204
- <h3 style="color: white; font-size: var(--font-xl); margin-bottom: var(--space-3);">MCP Architecture</h3>
204
+ <h3 style="color: white; font-size: var(--font-xl); margin-bottom: var(--space-3);">MCP Server Integration</h3>
205
205
  <p style="color: var(--gray-200); line-height: var(--leading-relaxed);">
206
- 23 specialized MCP servers provide Claude AI with direct access to ServiceNow APIs.
207
- Each server handles specific modules like ITAM, SecOps, and notifications.
206
+ 20+ specialized MCP (Model Context Protocol) servers provide Claude Code with direct ServiceNow API access.
207
+ Each server handles specific ServiceNow operations like table queries, widget deployment, and machine learning.
208
208
  </p>
209
209
  </div>
210
210
 
211
- <!-- AI-Powered Development -->
211
+ <!-- Conversational Development -->
212
212
  <div class="hero-inspired-card text-center">
213
213
  <div style="font-size: var(--font-4xl); margin-bottom: var(--space-4);">šŸ¤–</div>
214
- <h3 style="color: white; font-size: var(--font-xl); margin-bottom: var(--space-3);">AI-Powered Development</h3>
214
+ <h3 style="color: white; font-size: var(--font-xl); margin-bottom: var(--space-3);">Conversational Development</h3>
215
215
  <p style="color: var(--gray-200); line-height: var(--leading-relaxed);">
216
- Claude AI understands ServiceNow's complexity and generates production-ready code.
217
- From widget debugging to enterprise asset management - AI handles the heavy lifting.
216
+ Develop ServiceNow solutions through natural conversation with Claude Code.
217
+ No more navigating ServiceNow's web interface - just describe what you need and let the multi-agent system handle it.
218
218
  </p>
219
219
  </div>
220
220
 
221
- <!-- Enterprise Scale -->
221
+ <!-- Multi-Agent Orchestration -->
222
222
  <div class="hero-inspired-card text-center">
223
- <div style="font-size: var(--font-4xl); margin-bottom: var(--space-4);">šŸ¢</div>
224
- <h3 style="color: white; font-size: var(--font-xl); margin-bottom: var(--space-3);">Enterprise Scale</h3>
223
+ <div style="font-size: var(--font-4xl); margin-bottom: var(--space-4);">⚔</div>
224
+ <h3 style="color: white; font-size: var(--font-xl); margin-bottom: var(--space-3);">Multi-Agent Orchestration</h3>
225
225
  <p style="color: var(--gray-200); line-height: var(--leading-relaxed);">
226
- Supports massive widgets (5MB+), enterprise queries (100k+ records), and complex workflows.
227
- Built for real enterprise ServiceNow environments.
226
+ Complex ServiceNow tasks are handled by coordinated specialist agents.
227
+ Each agent focuses on specific capabilities like widget development, data analysis, or deployment automation.
228
228
  </p>
229
229
  </div>
230
230
  </div>
@@ -232,39 +232,39 @@
232
232
  <!-- How Snow-Flow Works -->
233
233
  <div class="hero-inspired-card" style="padding: var(--space-12); margin-bottom: var(--space-16);">
234
234
  <h3 style="color: white; font-size: var(--font-3xl); text-align: center; margin-bottom: var(--space-8);">
235
- How Snow-Flow Transforms ServiceNow Development
235
+ ServiceNow Development: Traditional vs Conversational
236
236
  </h3>
237
237
 
238
238
  <div class="grid grid-cols-1 lg:grid-cols-2 gap-12">
239
- <!-- Before Snow-Flow -->
239
+ <!-- Traditional ServiceNow Development -->
240
240
  <div>
241
241
  <h4 style="color: #ef4444; font-size: var(--font-xl); margin-bottom: var(--space-4);">
242
- āŒ Before Snow-Flow
242
+ āŒ Traditional ServiceNow Development
243
243
  </h4>
244
244
  <ul style="color: var(--gray-300); line-height: var(--leading-relaxed); list-style: none; padding: 0;">
245
- <li style="margin-bottom: var(--space-2);">• Manual widget deployment with copy-paste</li>
246
- <li style="margin-bottom: var(--space-2);">• Limited to 30k character scripts</li>
247
- <li style="margin-bottom: var(--space-2);">• No local editing capabilities</li>
248
- <li style="margin-bottom: var(--space-2);">• Manual asset tracking and compliance</li>
249
- <li style="margin-bottom: var(--space-2);">• Fragmented security incident response</li>
250
- <li style="margin-bottom: var(--space-2);">• Multi-tool workflows for simple tasks</li>
251
- <li style="margin-bottom: var(--space-2);">• Hours of manual configuration</li>
245
+ <li style="margin-bottom: var(--space-2);">• Web-based development through ServiceNow UI</li>
246
+ <li style="margin-bottom: var(--space-2);">• Limited browser text editing capabilities</li>
247
+ <li style="margin-bottom: var(--space-2);">• Copy-paste workflows between browser tabs</li>
248
+ <li style="margin-bottom: var(--space-2);">• Separate interfaces for different artifact types</li>
249
+ <li style="margin-bottom: var(--space-2);">• Manual table queries and data analysis</li>
250
+ <li style="margin-bottom: var(--space-2);">• Context switching between ServiceNow modules</li>
251
+ <li style="margin-bottom: var(--space-2);">• Steep learning curve for ServiceNow-specific patterns</li>
252
252
  </ul>
253
253
  </div>
254
254
 
255
- <!-- After Snow-Flow -->
255
+ <!-- Conversational Development with Snow-Flow -->
256
256
  <div>
257
257
  <h4 style="color: #10b981; font-size: var(--font-xl); margin-bottom: var(--space-4);">
258
- āœ… With Snow-Flow v4.2.0 ENTERPRISE
258
+ āœ… Conversational Development with Snow-Flow
259
259
  </h4>
260
260
  <ul style="color: var(--gray-300); line-height: var(--leading-relaxed); list-style: none; padding: 0;">
261
- <li style="margin-bottom: var(--space-2);">• AI-powered widget development and deployment</li>
262
- <li style="margin-bottom: var(--space-2);">• Support for 5MB+ enterprise widgets</li>
263
- <li style="margin-bottom: var(--space-2);">• Local editing with Claude Code's native tools</li>
264
- <li style="margin-bottom: var(--space-2);">• Automated asset lifecycle and license optimization</li>
265
- <li style="margin-bottom: var(--space-2);">• Intelligent security operations with SOAR</li>
266
- <li style="margin-bottom: var(--space-2);">• Single platform for all ServiceNow development</li>
267
- <li style="margin-bottom: var(--space-2);">• Minutes of automated configuration</li>
261
+ <li style="margin-bottom: var(--space-2);">• Natural language development through Claude Code</li>
262
+ <li style="margin-bottom: var(--space-2);">• Native code editing with full IDE features</li>
263
+ <li style="margin-bottom: var(--space-2);">• Local file-based development workflow</li>
264
+ <li style="margin-bottom: var(--space-2);">• Unified interface for all ServiceNow operations</li>
265
+ <li style="margin-bottom: var(--space-2);">• Conversational queries: "Show me all P1 incidents"</li>
266
+ <li style="margin-bottom: var(--space-2);">• Multi-agent coordination for complex tasks</li>
267
+ <li style="margin-bottom: var(--space-2);">• AI handles ServiceNow complexity and best practices</li>
268
268
  </ul>
269
269
  </div>
270
270
  </div>
@@ -273,43 +273,42 @@
273
273
  <!-- Core Capabilities -->
274
274
  <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
275
275
 
276
- <!-- Local Development -->
276
+ <!-- Conversational ServiceNow Operations -->
277
277
  <div class="hero-inspired-card">
278
278
  <div style="display: flex; align-items: center; margin-bottom: var(--space-4);">
279
- <span style="font-size: var(--font-3xl); margin-right: var(--space-3);">šŸ’»</span>
280
- <h4 style="color: white; font-size: var(--font-xl);">Local Development Bridge</h4>
279
+ <span style="font-size: var(--font-3xl); margin-right: var(--space-3);">šŸ’¬</span>
280
+ <h4 style="color: white; font-size: var(--font-xl);">Conversational ServiceNow Operations</h4>
281
281
  </div>
282
282
  <p style="color: var(--gray-200); margin-bottom: var(--space-4);">
283
- Pull any ServiceNow artifact to local files, edit with Claude Code's powerful tools,
284
- then push back with validation. No more copy-paste development.
283
+ Talk to your ServiceNow instance through natural language. Ask Claude Code to query tables,
284
+ deploy widgets, or analyze data - the MCP servers handle the technical implementation.
285
285
  </p>
286
286
  <div style="background: rgba(0,0,0,0.4); padding: var(--space-3); border-radius: var(--radius-md); font-family: var(--font-mono); font-size: var(--font-sm); color: var(--gray-300);">
287
- snow_pull_artifact({<br>
288
- &nbsp;&nbsp;sys_id: "widget_sys_id",<br>
289
- &nbsp;&nbsp;table: "sp_widget"<br>
290
- })<br>
291
- // Edit locally with Claude Code<br>
292
- snow_push_artifact({ sys_id: "widget_sys_id" })
287
+ "Show me all P1 incidents from last week"<br>
288
+ // → snow_query_table handles the query<br>
289
+ <br>
290
+ "Deploy this widget to my portal"<br>
291
+ // → snow_deploy validates and deploys
293
292
  </div>
294
293
  </div>
295
294
 
296
- <!-- Enterprise Automation -->
295
+ <!-- Local Development Bridge -->
297
296
  <div class="hero-inspired-card">
298
297
  <div style="display: flex; align-items: center; margin-bottom: var(--space-4);">
299
- <span style="font-size: var(--font-3xl); margin-right: var(--space-3);">šŸ¢</span>
300
- <h4 style="color: white; font-size: var(--font-xl);">Enterprise Automation</h4>
298
+ <span style="font-size: var(--font-3xl); margin-right: var(--space-3);">šŸ’»</span>
299
+ <h4 style="color: white; font-size: var(--font-xl);">Local Development Bridge</h4>
301
300
  </div>
302
301
  <p style="color: var(--gray-200); margin-bottom: var(--space-4);">
303
- Complete enterprise modules for ITAM (asset management), SecOps (security operations),
304
- and multi-channel notifications. Real enterprise capabilities, not demos.
302
+ Pull ServiceNow artifacts to local files, edit with native development tools,
303
+ then push back with validation. No more browser-based limitations.
305
304
  </p>
306
305
  <div style="background: rgba(0,0,0,0.4); padding: var(--space-3); border-radius: var(--radius-md); font-family: var(--font-mono); font-size: var(--font-sm); color: var(--gray-300);">
307
- snow_create_security_incident({<br>
308
- &nbsp;&nbsp;title: "Malware Detection",<br>
309
- &nbsp;&nbsp;threat_type: "malware",<br>
310
- &nbsp;&nbsp;iocs: ["192.168.1.100"]<br>
306
+ snow_pull_artifact({<br>
307
+ &nbsp;&nbsp;sys_id: "widget_sys_id",<br>
308
+ &nbsp;&nbsp;table: "sp_widget"<br>
311
309
  })<br>
312
- // Automated threat response activated
310
+ // Edit locally with full IDE features<br>
311
+ snow_push_artifact({ sys_id: "widget_sys_id" })
313
312
  </div>
314
313
  </div>
315
314
  </div>
@@ -317,11 +316,10 @@ snow_create_security_incident({<br>
317
316
  <!-- Call to Action -->
318
317
  <div class="text-center" style="margin-top: var(--space-16);">
319
318
  <a href="#install" class="btn btn-hero-primary" style="font-size: var(--font-lg); padding: var(--space-4) var(--space-8);">
320
- Start Building with Snow-Flow
321
- <span style="margin-left: var(--space-2);">šŸš€</span>
319
+ Start Conversational ServiceNow Development
322
320
  </a>
323
321
  <p style="color: var(--gray-400); margin-top: var(--space-4); font-size: var(--font-sm);">
324
- npm install snow-flow@latest • 5 minute setup • Enterprise ready
322
+ npm install snow-flow • Setup in minutes • Talk to your ServiceNow instance
325
323
  </p>
326
324
  </div>
327
325
  </div>