snow-flow 4.0.0-final-claude → 4.0.0

package/README.md

@@ -1,14 +1,14 @@
 <div align="center">
   <img src="assets/snow-flow-logo.svg" alt="Snow-Flow Logo" width="200" height="200">
   
-  # ❄️ Snow-Flow v4.0.0 - Final Claude Code CLI Edition ❄️
+  # ❄️ Snow-Flow v3.6.25 ❄️
   
   <p align="center">
     <strong>🚀 Revolutionary ServiceNow Development Framework with AI-Powered Automation</strong>
   </p>
   
   <p align="center">
-    <a href="https://www.npmjs.com/package/snow-flow"><img src="https://img.shields.io/badge/npm-v4.0.0--final--claude-CB3837?style=for-the-badge&logo=npm" alt="npm version"></a>
+    <a href="https://www.npmjs.com/package/snow-flow"><img src="https://img.shields.io/npm/v/snow-flow.svg?style=for-the-badge&logo=npm&color=CB3837" alt="npm version"></a>
     <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge" alt="License: MIT"></a>
     <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/snow-flow.svg?style=for-the-badge&logo=node.js&color=339933" alt="Node.js Version"></a>
     <a href="https://github.com/groeimetai/snow-flow"><img src="https://img.shields.io/github/stars/groeimetai/snow-flow?style=for-the-badge&logo=github" alt="GitHub Stars"></a>
@@ -21,54 +21,29 @@
 
 ---
 
-## 🚨 Important Announcement: Final Claude Code CLI Edition
-
-<div align="center">
-  <table>
-    <tr>
-      <td align="center">
-        <h3>⚡ This is the Final Claude Code CLI Version ⚡</h3>
-        <p>Snow-Flow v4.0.0 marks the end of an era. This is the last version designed specifically for Claude Code CLI.</p>
-        <p><strong>🔮 What's Coming Next:</strong></p>
-        <ul align="left">
-          <li>🤖 Support for <strong>ANY LLM</strong>: OpenAI, Google Gemini, Anthropic Claude, Ollama, and more</li>
-          <li>🔌 Modular provider system with unified interface</li>
-          <li>💻 Native CLI with interactive chat interface</li>
-          <li>🔄 Seamless switching between LLM providers</li>
-          <li>📊 Same great ServiceNow tools, now LLM-agnostic</li>
-        </ul>
-        <p><strong>Thank you to all Claude Code users who made this journey possible! 🙏</strong></p>
-      </td>
-    </tr>
-  </table>
-</div>
-
----
-
-## 🎉 What's New in v4.0.0-final-claude
+## 🎉 What's New in v3.6.25
 
 <div align="center">
   <table>
     <tr>
       <td align="center" width="50%">
-        <h3>🏁 Final Release Features</h3>
+        <h3>🚀 Major Features</h3>
         <ul align="left">
-          <li><strong>🔚 Final Claude Code CLI Version</strong><br/>Last release for Claude Code users</li>
-          <li><strong>📚 Complete Feature Set</strong><br/>All 18 MCP servers, 200+ tools</li>
-          <li><strong>🎯 Catalog UI Policy Support</strong><br/>Deploy via unified <code>snow_deploy</code> tool</li>
-          <li><strong>🔒 Knowledge Base Verification</strong><br/>Prevents orphaned articles</li>
-          <li><strong>✨ Beautiful Documentation</strong><br/>Enhanced README and website</li>
+          <li><strong>Catalog UI Policy Deployment</strong><br/>Deploy via unified <code>snow_deploy</code> tool</li>
+          <li><strong>Knowledge Base Verification</strong><br/>Prevents orphaned articles with strict validation</li>
+          <li><strong>Catalog Variable Table Fix</strong><br/>Variables now use correct <code>item_option_new</code></li>
+          <li><strong>Enhanced UI Policy Debugging</strong><br/>Comprehensive reference field debugging</li>
+          <li><strong>18th MCP Server</strong><br/>Local Development Server for artifact syncing</li>
         </ul>
       </td>
       <td align="center" width="50%">
-        <h3>🚀 Latest Improvements</h3>
+        <h3>🔧 Critical Fixes</h3>
         <ul align="left">
-          <li>✅ Catalog variables table fix (v3.6.23)</li>
-          <li>✅ UI policy debugging enhanced (v3.6.22)</li>
-          <li>✅ Knowledge validation added (v3.6.25)</li>
-          <li>✅ MCP transport 3x faster</li>
-          <li>✅ ES5 validation throughout</li>
-          <li>🎁 All previous fixes included</li>
+          <li>✅ Catalog variables now visible in ServiceNow</li>
+          <li>✅ UI policy actions reference fields fixed</li>
+          <li>✅ Non-existent KB error handling added</li>
+          <li>✅ MCP transport 3x faster operations</li>
+          <li>✅ Widget coherence validation improved</li>
         </ul>
       </td>
     </tr>

package/dist/cli.js

@@ -53,11 +53,6 @@ const agent_detector_js_1 = require("./utils/agent-detector.js");
 const version_js_1 = require("./version.js");
 const logger_js_1 = require("./utils/logger.js");
 const chalk_1 = __importDefault(require("chalk"));
-// New provider-agnostic engine imports (compile-safe placeholders)
-const llm_config_loader_js_1 = require("./config/llm-config-loader.js");
-const interactive_js_1 = require("./agent/interactive.js");
-const auth_js_1 = require("./cli/auth.js");
-const session_js_1 = require("./cli/session.js");
 // Load environment variables
 dotenv_1.default.config();
 // Create CLI logger instance
@@ -67,10 +62,6 @@ program
     .name('snow-flow')
     .description('ServiceNow Multi-Agent Development Framework')
     .version(version_js_1.VERSION);
-// Register auth commands (API key management)
-(0, auth_js_1.registerAuthCommands)(program);
-// Register session inspection commands
-(0, session_js_1.registerSessionCommands)(program);
 // Flow deprecation handler - check for flow-related commands
 function checkFlowDeprecation(command, objective) {
     const flowKeywords = ['flow', 'create-flow', 'xml-flow', 'flow-designer'];
@@ -99,18 +90,6 @@ function checkFlowDeprecation(command, objective) {
 program
     .command('swarm <objective>')
     .description('Execute multi-agent orchestration for a ServiceNow task - één command voor alles!')
-    // New engine selector: defaults to auto (uses config-driven agent when available)
-    .option('--engine <engine>', 'Execution engine (auto|agent|claude)', 'auto')
-    .option('--config <path>', 'Path to snowflow.config file')
-    .option('--show-reasoning', 'Show LLM reasoning in a different color (default)', true)
-    .option('--no-show-reasoning', 'Hide LLM reasoning blocks')
-    .option('--save-output <path>', 'Save full assistant output to a file')
-    .option('--resume <sessionId>', 'Resume an existing interactive session')
-    // Provider overrides (optional, config-driven by default)
-    .option('--provider <provider>', 'LLM provider override')
-    .option('--model <model>', 'Model override')
-    .option('--base-url <url>', 'Base URL override for openai-compatible or gateways')
-    .option('--api-key-env <name>', 'Use specific API key env var')
     .option('--strategy <strategy>', 'Execution strategy (development, _analysis, research)', 'development')
     .option('--mode <mode>', 'Coordination mode (hierarchical, mesh, distributed)', 'hierarchical')
     .option('--max-agents <number>', 'Maximum number of agents', '5')
@@ -287,66 +266,6 @@ program
             cliLogger.info(`🤖 Autonomous Systems: ❌ All Disabled`);
         }
     }
-    // Detect agent engine via config (provider-agnostic) when requested or available
-    const shouldUseAgent = (() => {
-        if (options.engine === 'agent')
-            return true;
-        if (options.engine === 'claude')
-            return false;
-        // auto: use agent when config file is present and valid
-        const cfg = (0, llm_config_loader_js_1.loadSnowFlowConfig)({
-            configPath: options.config,
-            overrides: {
-                llm: {
-                    provider: options.provider || undefined,
-                    model: options.model || undefined,
-                    baseURL: options.baseUrl || options.baseURL || undefined,
-                    apiKeyEnv: options.apiKeyEnv || undefined,
-                },
-            },
-        });
-        return Boolean(cfg && cfg.llm && cfg.llm.provider && cfg.llm.model);
-    })();
-    if (shouldUseAgent) {
-        const cfg = (0, llm_config_loader_js_1.loadSnowFlowConfig)({
-            configPath: options.config,
-            overrides: {
-                llm: {
-                    provider: options.provider || undefined,
-                    model: options.model || undefined,
-                    baseURL: options.baseUrl || options.baseURL || undefined,
-                    apiKeyEnv: options.apiKeyEnv || undefined,
-                },
-            },
-        });
-        if (!cfg) {
-            cliLogger.error('❌ Geen snowflow.config.(json|js|cjs) gevonden. Voeg config toe of gebruik --engine claude.');
-            process.exit(1);
-        }
-        // Basic validation for MVP
-        if (!cfg.llm?.provider || !cfg.llm?.model) {
-            cliLogger.error('❌ Config mist llm.provider of llm.model');
-            process.exit(1);
-        }
-        cliLogger.info('\n🤖 Using provider-agnostic Snow-Flow agent (interactive)');
-        try {
-            await (0, interactive_js_1.runInteractive)({
-                provider: cfg.llm.provider,
-                model: String(cfg.llm.model),
-                baseURL: cfg.llm.baseURL,
-                apiKeyEnv: cfg.llm.apiKeyEnv,
-                mcp: cfg.mcp,
-                system: cfg.agent?.system,
-                maxSteps: cfg.agent?.maxSteps ?? 40,
-                showReasoning: options.showReasoning !== false,
-                resumeId: options.resume || undefined,
-            });
-        }
-        catch (e) {
-            cliLogger.error('❌ Interactive agent error:', e instanceof Error ? e.message : String(e));
-        }
-        return; // end here; skip legacy Claude path
-    }
     // Analyze the objective using intelligent agent detection
     const taskAnalysis = analyzeObjective(objective, parseInt(options.maxAgents));
     // Debug logging to understand task type detection

package/dist/dynamic-version.js

@@ -36,7 +36,7 @@ function getDynamicVersion() {
         console.warn('Warning: Could not read version from package.json:', error);
     }
     // Fallback to hardcoded version
-    return '4.0.0-final-claude';
+    return '3.6.25';
 }
 // Export a constant that uses the dynamic version
 exports.VERSION = getDynamicVersion();

package/dist/mcp/shared/mcp-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP Types
+ * Common types for MCP server implementations
+ */
+export interface MCPServerConfig {
+    name: string;
+    description?: string;
+    version?: string;
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: any;
+}
+export interface MCPResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+}
+export interface MCPRequest {
+    tool: string;
+    params: any;
+}
+export interface MCPLogger {
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+    debug(message: string, meta?: any): void;
+}
+export interface MCPMemoryManager {
+    store(key: string, value: any): Promise<void>;
+    retrieve(key: string): Promise<any>;
+    delete(key: string): Promise<boolean>;
+    list(): Promise<string[]>;
+}
+//# sourceMappingURL=mcp-types.d.ts.map

package/dist/mcp/shared/mcp-types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * MCP Types
+ * Common types for MCP server implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp-types.js.map

package/dist/memory/hierarchical-memory-system.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hierarchical Memory System
+ * Extended memory system with hierarchical organization
+ */
+import { MemorySystem } from './memory-system';
+export interface HierarchicalMemorySystem extends MemorySystem {
+    dbPath?: string;
+    namespace?: string;
+    storeInNamespace(namespace: string, key: string, value: any): Promise<void>;
+    retrieveFromNamespace(namespace: string, key: string): Promise<any>;
+    listNamespaces(): Promise<string[]>;
+    clearNamespace(namespace: string): Promise<void>;
+}
+export declare class DefaultHierarchicalMemorySystem implements HierarchicalMemorySystem {
+    private memory;
+    dbPath?: string;
+    namespace?: string;
+    constructor(dbPath?: string, namespace?: string);
+    private getNamespaceMap;
+    store(key: string, value: any): Promise<void>;
+    retrieve(key: string): Promise<any>;
+    get(key: string): Promise<any>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    storeInNamespace(namespace: string, key: string, value: any): Promise<void>;
+    retrieveFromNamespace(namespace: string, key: string): Promise<any>;
+    listNamespaces(): Promise<string[]>;
+    clearNamespace(namespace: string): Promise<void>;
+}
+//# sourceMappingURL=hierarchical-memory-system.d.ts.map

package/dist/memory/hierarchical-memory-system.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Hierarchical Memory System
+ * Extended memory system with hierarchical organization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultHierarchicalMemorySystem = void 0;
+class DefaultHierarchicalMemorySystem {
+    constructor(dbPath, namespace) {
+        this.memory = new Map();
+        this.dbPath = dbPath;
+        this.namespace = namespace || 'default';
+    }
+    getNamespaceMap(namespace) {
+        if (!this.memory.has(namespace)) {
+            this.memory.set(namespace, new Map());
+        }
+        return this.memory.get(namespace);
+    }
+    async store(key, value) {
+        await this.storeInNamespace(this.namespace || 'default', key, value);
+    }
+    async retrieve(key) {
+        return this.retrieveFromNamespace(this.namespace || 'default', key);
+    }
+    async get(key) {
+        return this.retrieve(key);
+    }
+    async delete(key) {
+        const nsMap = this.getNamespaceMap(this.namespace || 'default');
+        return nsMap.delete(key);
+    }
+    async clear() {
+        await this.clearNamespace(this.namespace || 'default');
+    }
+    async list() {
+        const nsMap = this.getNamespaceMap(this.namespace || 'default');
+        return Array.from(nsMap.keys());
+    }
+    async exists(key) {
+        const nsMap = this.getNamespaceMap(this.namespace || 'default');
+        return nsMap.has(key);
+    }
+    async storeInNamespace(namespace, key, value) {
+        const nsMap = this.getNamespaceMap(namespace);
+        nsMap.set(key, value);
+    }
+    async retrieveFromNamespace(namespace, key) {
+        const nsMap = this.getNamespaceMap(namespace);
+        return nsMap.get(key);
+    }
+    async listNamespaces() {
+        return Array.from(this.memory.keys());
+    }
+    async clearNamespace(namespace) {
+        this.memory.delete(namespace);
+    }
+}
+exports.DefaultHierarchicalMemorySystem = DefaultHierarchicalMemorySystem;
+//# sourceMappingURL=hierarchical-memory-system.js.map

package/dist/memory/memory-system.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Basic Memory System Interface
+ * Minimal implementation to satisfy missing imports
+ */
+export interface MemorySystem {
+    store(key: string, value: any): Promise<void>;
+    retrieve(key: string): Promise<any>;
+    get(key: string): Promise<any>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+}
+export declare class BasicMemorySystem implements MemorySystem {
+    private memory;
+    store(key: string, value: any): Promise<void>;
+    retrieve(key: string): Promise<any>;
+    get(key: string): Promise<any>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+}
+export declare const defaultMemorySystem: BasicMemorySystem;
+//# sourceMappingURL=memory-system.d.ts.map

package/dist/memory/memory-system.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Basic Memory System Interface
+ * Minimal implementation to satisfy missing imports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultMemorySystem = exports.BasicMemorySystem = void 0;
+class BasicMemorySystem {
+    constructor() {
+        this.memory = new Map();
+    }
+    async store(key, value) {
+        this.memory.set(key, value);
+    }
+    async retrieve(key) {
+        return this.memory.get(key);
+    }
+    async get(key) {
+        return this.memory.get(key);
+    }
+    async delete(key) {
+        return this.memory.delete(key);
+    }
+    async clear() {
+        this.memory.clear();
+    }
+    async list() {
+        return Array.from(this.memory.keys());
+    }
+    async exists(key) {
+        return this.memory.has(key);
+    }
+}
+exports.BasicMemorySystem = BasicMemorySystem;
+exports.defaultMemorySystem = new BasicMemorySystem();
+//# sourceMappingURL=memory-system.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "4.0.0-final-claude",
-  "description": "FINAL CLAUDE CODE CLI EDITION - This is the last version specifically designed for Claude Code CLI. Future versions will support multiple LLMs (OpenAI, Google, Anthropic, Ollama, etc.) through a modular provider system. Thank you to all Claude Code users!",
+  "version": "4.0.0",
+  "description": "KNOWLEDGE BASE VERIFICATION - v3.6.25 adds critical validation to snow_create_knowledge_article. Now throws error when non-existent knowledge base is specified, preventing orphaned articles. Includes helpful suggestions to create or discover valid knowledge bases.",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {
@@ -396,15 +396,10 @@
     "npm": ">=8.0.0"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^2.0.4",
-    "@ai-sdk/google": "^1.2.22",
-    "@ai-sdk/openai": "^1.3.24",
-    "@modelcontextprotocol/sdk": "^1.15.1",
-    "@openrouter/ai-sdk-provider": "^1.1.2",
     "@tensorflow/tfjs-node": "^4.22.0",
+    "@modelcontextprotocol/sdk": "^1.15.1",
     "@types/node-fetch": "^2.6.12",
     "@types/uuid": "^10.0.0",
-    "ai": "^5.0.14",
     "axios": "^1.10.0",
     "better-sqlite3": "^9.6.0",
     "boxen": "^8.0.1",

package/.env.example

@@ -1,89 +0,0 @@
-# Closed-source
-OPENAI_API_KEY=
-GOOGLE_API_KEY=
-
-# Gateways / OSS
-OPENROUTER_API_KEY=
-OPENAI_COMPAT_API_KEY=   # voor xAI Grok en DeepSeek (OpenAI-compatible)
-
-# ServiceNow Configuration
-# ===========================================
-
-# ServiceNow Instance URL (without https://)
-# Example: dev12345.service-now.com
-SNOW_INSTANCE=your-instance.service-now.com
-
-# OAuth Client ID from ServiceNow Application Registry
-SNOW_CLIENT_ID=your-oauth-client-id
-
-# OAuth Client Secret from ServiceNow Application Registry
-SNOW_CLIENT_SECRET=your-oauth-client-secret
-
-# ===========================================
-# Snow-Flow Configuration
-# ===========================================
-
-# Enable debug logging (true/false)
-SNOW_FLOW_DEBUG=true
-
-# MAXIMUM DEBUG LEVELS
-DEBUG=*                          # Debug ALLES
-NODE_ENV=development            # Development mode voor extra debug info
-LOG_LEVEL=trace                 # Trace is nog hoger dan debug
-VERBOSE=true                    # Extra verbose output
-MCP_DEBUG=true                  # MCP specific debugging
-MCP_LOG_LEVEL=trace            # MCP trace level logging
-SNOW_FLOW_TRACE=true           # Snow-Flow trace logging
-CLAUDE_CODE_DEBUG=true         # Claude Code debug mode
-HTTP_TRACE=true                # HTTP request/response tracing
-
-# Default coordination strategy
-SNOW_FLOW_STRATEGY=development
-
-# Maximum number of agents
-SNOW_FLOW_MAX_AGENTS=5
-
-# ===========================================
-# Claude Code API Integration (30 minutes)
-# ===========================================
-# API timeout for Claude Code integration - 30 minutes
-# This ensures Snow-Flow works smoothly with Claude Code's extended operation timeouts
-API_TIMEOUT_MS=1800000
-
-# ===========================================
-# Timeout Configuration (v3.0.1+)
-# ===========================================
-# IMPORTANT: Snow-Flow has NO TIMEOUTS by default for maximum reliability.
-# Operations run until completion. Only set timeouts if you specifically need them.
-# All timeout values below are COMMENTED OUT - uncomment only what you need.
-
-# Memory Operations (TodoWrite, etc.)
-# MCP_MEMORY_TIMEOUT=30000      # 30 seconds
-# MCP_MEMORY_TIMEOUT=60000      # 1 minute
-# MCP_MEMORY_TIMEOUT=120000     # 2 minutes
-
-# ServiceNow API Operations
-# SNOW_API_TIMEOUT=60000        # 1 minute - quick operations
-# SNOW_API_TIMEOUT=180000       # 3 minutes - standard operations
-# SNOW_API_TIMEOUT=300000       # 5 minutes - complex queries
-
-# Deployment Operations
-# SNOW_DEPLOYMENT_TIMEOUT=300000  # 5 minutes - simple deployments
-# SNOW_DEPLOYMENT_TIMEOUT=600000  # 10 minutes - complex widgets
-
-# MCP transport timeout (should be higher than SNOW_DEPLOYMENT_TIMEOUT if both set)
-# MCP_DEPLOYMENT_TIMEOUT=360000   # 6 minutes
-# MCP_DEPLOYMENT_TIMEOUT=720000   # 12 minutes
-
-# ===========================================
-# Response Size Limits (v3.4.34+)
-# ===========================================
-# Maximum MCP response size to prevent timeouts
-# Default: 500KB (sufficient for most widgets/flows)
-# MCP_MAX_RESPONSE_SIZE=500000    # 500KB default (recommended)
-# MCP_MAX_RESPONSE_SIZE=1000000   # 1MB for larger artifacts
-# MCP_MAX_RESPONSE_SIZE=2000000   # 2MB for very large responses
-
-# Maximum array items in responses
-# MCP_MAX_ARRAY_ITEMS=500         # 500 items default
-# MCP_MAX_ARRAY_ITEMS=1000        # 1000 for large datasets