snow-flow 5.0.11 → 8.0.0

package/.env.example

@@ -0,0 +1,171 @@
+# ============================================
+# ServiceNow Configuration
+# ============================================
+SNOW_INSTANCE=your-instance.service-now.com
+SNOW_CLIENT_ID=your-client-id
+SNOW_CLIENT_SECRET=your-client-secret
+
+# ============================================
+# LLM Provider Configuration (75+ Providers!)
+# ============================================
+
+# Choose your LLM provider (set during 'snow-flow auth login')
+# Popular: anthropic, openai, google, ollama, groq, mistral, cohere, deepseek
+# Local: ollama, lmstudio, jan, localai, vllm
+# Enterprise: azure-openai, aws-bedrock, gcp-vertexai
+# Full list: https://models.dev (75+ providers via OpenCode!)
+DEFAULT_LLM_PROVIDER=
+
+# Choose your model (latest versions as of 2025)
+DEFAULT_ANTHROPIC_MODEL=claude-sonnet-4.5
+DEFAULT_OPENAI_MODEL=gpt-5
+DEFAULT_GOOGLE_MODEL=gemini-2.5-flash
+DEFAULT_OLLAMA_MODEL=llama3.1
+
+# ============================================
+# Provider API Keys
+# ============================================
+
+# Anthropic (Claude)
+# Option 1: Use Claude Pro/Max subscription (leave empty, then run: opencode auth login)
+# Option 2: Use API key from https://console.anthropic.com/
+ANTHROPIC_API_KEY=
+
+# OpenAI (GPT)
+# Get API key: https://platform.openai.com/api-keys
+OPENAI_API_KEY=
+
+# Google AI (Gemini)
+# Get API key: https://aistudio.google.com/app/apikey
+GOOGLE_API_KEY=
+
+# ============================================
+# Local/Offline Providers (100% Free)
+# ============================================
+
+# Ollama - Run models locally
+# Install: https://ollama.com
+# Usage: ollama pull llama3.1 && ollama serve
+OLLAMA_BASE_URL=http://localhost:11434
+DEFAULT_OLLAMA_MODEL=llama3.3
+
+# LM Studio - Desktop app with GUI
+# Download: https://lmstudio.ai
+OPENAI_BASE_URL=http://localhost:1234/v1
+DEFAULT_LMSTUDIO_MODEL=llama-3.3-8b
+
+# LocalAI - Self-hosted OpenAI-compatible server
+# Install: https://localai.io
+LOCALAI_BASE_URL=http://localhost:8080/v1
+DEFAULT_LOCALAI_MODEL=llama3.3
+
+# vLLM - High-performance inference (2-4x faster)
+# Install: pip install vllm
+VLLM_BASE_URL=http://localhost:8000/v1
+DEFAULT_VLLM_MODEL=llama3.3
+
+# ============================================
+# Other Cloud Providers (60+ more available!)
+# ============================================
+
+# Groq (Ultra-fast inference - 800+ tokens/sec)
+# Get API key: https://console.groq.com/keys
+GROQ_API_KEY=
+
+# DeepSeek (Specialized for coding)
+# Get API key: https://platform.deepseek.com/api_keys
+DEEPSEEK_API_KEY=
+
+# Mistral AI (European alternative)
+# Get API key: https://console.mistral.ai/api-keys
+MISTRAL_API_KEY=
+
+# Cohere (Command R+ models)
+# Get API key: https://dashboard.cohere.com/api-keys
+COHERE_API_KEY=
+
+# Perplexity (Web search enabled)
+# Get API key: https://www.perplexity.ai/settings/api
+PERPLEXITY_API_KEY=
+
+# OpenRouter (200+ models aggregator)
+# Get API key: https://openrouter.ai/keys
+OPENROUTER_API_KEY=
+
+# Together AI (Open source models)
+# Get API key: https://api.together.xyz/settings/api-keys
+TOGETHER_API_KEY=
+
+# Replicate (Run any model)
+# Get API key: https://replicate.com/account/api-tokens
+REPLICATE_API_KEY=
+
+# ============================================
+# Enterprise Providers
+# ============================================
+
+# Azure OpenAI (Enterprise)
+AZURE_OPENAI_API_KEY=
+AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
+AZURE_OPENAI_DEPLOYMENT_NAME=gpt-4o
+
+# AWS Bedrock (Enterprise)
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_REGION=us-east-1
+
+# GCP Vertex AI (Enterprise)
+GCP_PROJECT_ID=
+GCP_LOCATION=us-central1
+GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
+
+# ============================================
+# Snow-Flow Configuration
+# ============================================
+
+# Log level: debug, info, warn, error
+LOG_LEVEL=info
+
+# Enable performance tracking
+ENABLE_PERFORMANCE_TRACKING=true
+
+# Enable memory system
+ENABLE_MEMORY_SYSTEM=true
+
+# ============================================
+# Quick Setup Guide (75+ LLM Providers Supported!)
+# ============================================
+#
+# 1. Configure ServiceNow OAuth (required):
+#    - SNOW_INSTANCE, SNOW_CLIENT_ID, SNOW_CLIENT_SECRET
+#
+# 2. Choose ONE LLM provider option from 75+ providers:
+#
+#    A. Claude Pro/Max (if you have subscription):
+#       DEFAULT_LLM_PROVIDER=anthropic
+#       ANTHROPIC_API_KEY= (leave empty)
+#
+#    B. Cloud API (pay-per-use):
+#       DEFAULT_LLM_PROVIDER=anthropic (or openai, google, groq, mistral, deepseek, etc.)
+#       ANTHROPIC_API_KEY=your-api-key
+#
+#    C. Local/Free (Ollama, LM Studio, Jan, etc):
+#       DEFAULT_LLM_PROVIDER=ollama
+#       OLLAMA_BASE_URL=http://localhost:11434
+#
+#    D. Enterprise (Azure, AWS, GCP):
+#       DEFAULT_LLM_PROVIDER=azure-openai (or aws-bedrock, gcp-vertexai)
+#       [Configure enterprise credentials above]
+#
+# 3. Authenticate:
+#    snow-flow auth login
+#    (Automatically handles both LLM provider AND ServiceNow!)
+#
+# 4. Start developing:
+#    snow-flow swarm "create incident dashboard"
+#    (or launch OpenCode: opencode)
+#
+# For detailed setup and full provider list, see:
+# - README.md (75+ provider options explained)
+# - https://models.dev (complete provider catalog)
+# - https://github.com/groeimetai/snow-flow

package/CLAUDE.md

@@ -633,21 +633,137 @@ Snow-Flow now automatically sets its Update Set as the user's current Update Set
 - KPI management
 - Scheduled delivery
 
-### 11. ServiceNow Machine Learning Server
-**Purpose:** AI/ML capabilities
+### 11. ServiceNow Machine Learning & Predictive Intelligence Server
+**Purpose:** AI/ML capabilities with BOTH native ServiceNow PI and local TensorFlow.js training
 
-**Key Tools:**
-- `snow_train_classifier` - Train incident classifier
-- `snow_predict_change_risk` - Predict change risks
-- `snow_detect_anomalies` - Anomaly detection
-- `snow_forecast_incidents` - Incident forecasting
-- `snow_optimize_process` - Process optimization
+**🚨 CRITICAL: Two COMPLETELY Different ML Approaches!**
+
+Snow-Flow provides TWO distinct machine learning approaches. **YOU MUST ASK THE USER which approach they need based on their requirements!**
+
+---
+
+#### **🏢 Native ServiceNow Predictive Intelligence (NEW! v7.4.0)**
+**Runs:** INSIDE ServiceNow instance (native platform capability)
+**License:** Requires ServiceNow Predictive Intelligence license
+**Use For:** Production ML solutions, enterprise deployments
+**Auto-Retrain:** ✅ Yes (ServiceNow manages lifecycle)
+**Integration:** ✅ Seamless (native ServiceNow tables/records)
+
+**Complete PI Solution Builder (5 Tools):**
+- `snow_create_pi_solution` - Create PI solution definitions (classification, regression, similarity, clustering)
+- `snow_train_pi_solution` - Trigger model training in ServiceNow (10-30 min process)
+- `snow_monitor_pi_training` - Monitor training progress and accuracy metrics
+- `snow_activate_pi_solution` - Activate trained solutions for production use
+- `snow_list_pi_solutions` - List all PI solutions with status and metrics
+
+**Prediction Tools (Use Trained Solutions):**
+- `ml_predictive_intelligence` - Make predictions using activated PI solutions
+- `ml_performance_analytics` - Native Performance Analytics ML integration
+- `ml_hybrid_recommendation` - Hybrid ML recommendations
+
+**When to Recommend Native PI:**
+- ✅ User has Predictive Intelligence license
+- ✅ Production deployment required
+- ✅ Need auto-retrain and lifecycle management
+- ✅ Want native ServiceNow integration
+- ✅ Enterprise scale and support required
+
+**Example Conversation:**
+```
+User: "I need to predict incident categories automatically"
+Agent: "Do you have a ServiceNow Predictive Intelligence license?
+        - If YES: I'll create a native PI solution that trains in ServiceNow
+        - If NO: I can create a local TensorFlow.js model (dev/testing only)"
+```
+
+---
+
+#### **💻 Local TensorFlow.js ML Training (Experimental)**
+**Runs:** Locally on developer machine (NOT in ServiceNow)
+**License:** Free (no ServiceNow license required)
+**Use For:** Development, testing, experimentation
+**Auto-Retrain:** ❌ No (manual process)
+**Integration:** ⚠️ Limited (requires custom deployment)
+
+**Local ML Tools:**
+- `snow_train_classifier` - Train incident classifier locally with TensorFlow.js
+- `snow_predict_change_risk` - Local change risk prediction
+- `snow_detect_anomalies` - Local anomaly detection
+- `snow_forecast_incidents` - Local incident forecasting with time series
+- `snow_optimize_process` - Local process optimization
+
+**When to Recommend Local TensorFlow.js:**
+- ✅ No Predictive Intelligence license available
+- ✅ Development/testing/proof-of-concept only
+- ✅ Want to experiment with ML before buying license
+- ⚠️ NOT for production use (experimental only)
+
+**Example Conversation:**
+```
+User: "I want to try ML but don't have a PI license yet"
+Agent: "Perfect! I can train a local TensorFlow.js model for testing.
+        Note: This is experimental and not for production.
+        When ready for production, you'll need ServiceNow PI license."
+```
+
+---
+
+#### **📋 Decision Matrix for AI Agent**
+
+**Ask yourself when user requests ML:**
+
+| User Says | Has PI License? | Recommend |
+|-----------|----------------|-----------|
+| "Create incident predictor" | ✅ Yes | Native PI: `snow_create_pi_solution` → `snow_train_pi_solution` |
+| "Create incident predictor" | ❌ No | Local TensorFlow.js: `snow_train_classifier` + explain limitations |
+| "Production ML solution" | ✅ Yes | Native PI (always) |
+| "Production ML solution" | ❌ No | **STOP:** Explain PI license required for production |
+| "Test/experiment with ML" | Either | Can use local TensorFlow.js, mention PI for production |
+| "Predict on existing solution" | N/A | `ml_predictive_intelligence` (works with trained PI solutions) |
+
+**🚨 ALWAYS Ask About License:**
+When user requests ML capabilities, ALWAYS ask:
+1. "Do you have a ServiceNow Predictive Intelligence license?"
+2. "Is this for production use or development/testing?"
+
+**Never assume!** Different licenses = completely different tools!
+
+---
+
+#### **Complete ML Workflow Examples**
+
+**Production Workflow (Native PI):**
+```bash
+# 1. Create solution definition
+snow-flow swarm "create PI solution to predict incident category based on description and caller"
+
+# 2. Train in ServiceNow (10-30 min)
+snow-flow swarm "train the incident category predictor"
+
+# 3. Monitor training
+snow-flow swarm "check training progress and accuracy"
+
+# 4. Activate for production
+snow-flow swarm "activate incident category predictor with 80% confidence threshold"
+
+# 5. Make predictions
+snow-flow swarm "predict category for incident INC0010001"
+```
+
+**Development Workflow (Local TensorFlow.js):**
+```bash
+# Train locally (immediate)
+snow-flow swarm "train local incident classifier for testing"
+
+# Note: Deployment requires custom integration work
+# Recommend upgrading to PI license for production
+```
+
+---
 
 **Features:**
-- Predictive analytics
-- Pattern recognition
-- Anomaly detection
-- Process optimization
+- ✅ **Native ServiceNow PI:** Production-ready, licensed, auto-retrain, full lifecycle
+- ⚠️ **Local TensorFlow.js:** Free, experimental, development only, manual deployment
 
 ### 12. ServiceNow Knowledge & Catalog Server
 **Purpose:** Knowledge base and service catalog management

package/LICENSE

@@ -1,21 +1,93 @@
-MIT License
-
-Copyright (c) 2025 Snow-Flow Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.