{"description":"MattyJacks AI Context Archive β the shared knowledge base used by Valley Net and MERCENARY. All documents are returned with full content for AI/crawler ingestion.","agents":["Valley Net","MERCENARY"],"ui":"https://mattyjacks.com/context","count":35,"totalWords":74454,"totalKb":512.1,"documents":[{"name":"4weird-games.md","slug":"4weird-games","content":"# 4weird Games (4weird.com)\n\n4weird Games is a New Hampshire-based game development and educational technology studio owned by MattyJacks.\n\n## Core Specializations\n- **AI-Assisted Game Development**: Utilizing AI and machine learning models for procedural level generation, dynamic scripting, texture generation, and audio synthesis.\n- **Game Design & Prototyping**: Developing interactive gameplay mechanics and fast-shipping games under the MattyJacks gaming portfolio.\n- **4weird Academy**: An educational initiative providing remote coding, game design, and AI engineering courses for student cohorts and aspiring developers.\n\n## Synergy with MattyJacks & KouziTech\n4weird Games integrates closely with GiveGigs for talent sourcing and KouziTech for advanced agent-based AI integrations within gaming systems and educational frameworks.\n","wordCount":109,"sizeKb":0.8},{"name":"AI-FEATURES-README.md","slug":"AI-FEATURES-README","content":"# AI Features & Cost Tracking System\n\n## Overview\n\nMattyJacks.com now includes a comprehensive AI system with intelligent cost tracking, categorization, and OpenServ documentation integration. This document outlines all AI-related features and their implementation.\n\n---\n\n## Table of Contents\n\n- [AI Chat System](#ai-chat-system)\n- [Category-Based Cost Tracking](#category-based-cost-tracking)\n- [OpenServ RAG Integration](#openserv-rag-integration)\n- [API Endpoints](#api-endpoints)\n- [Architecture](#architecture)\n- [Usage Examples](#usage-examples)\n\n---\n\n## AI Chat System\n\n### Overview\n\nThe AI Chat System provides a real-time conversational interface powered by OpenAI's GPT models, with advanced prompt engineering and user engagement features.\n\n### Features\n\n#### 1. Real-Time Chat Interface\n- **Location**: `components/anything-button.tsx`\n- **Functionality**:\n - Fixed position chat window (z-index: 110, above header z-index: 100)\n - Message history with scrollable conversation\n - Real-time streaming responses\n - Responsive design (mobile & desktop)\n - Dark/light mode support\n\n#### 2. Magic Prompt Templates\n- **Location**: `components/short-prompts.ts`\n- **Count**: 20+ pre-built templates\n- **Features**:\n - Randomized selection on new conversations\n - Non-repetitive algorithm\n - Categories: MattyJacks-related, expert analysis, creative, technical\n - \"Regen\" button to generate new suggestions\n - One-click insertion into prompt box\n\n#### 3. Food Emoji Rewards\n- **Feature**: Reinforce AI behavior with food emojis\n- **Emoji List**: ππ―πππͺππ
ππ₯\n- **Behavior**:\n - Random emoji selection every 4.2 seconds\n - Resets timer when emoji is used\n - AI understands food emojis as positive reinforcement\n - Continues thinking rather than short acknowledgments\n\n#### 4. Chat Disclaimer\n- **Text**: `-+OUTPUT_NOT_100%_TRUE+-`\n- **Location**: Bottom of chat window\n- **Purpose**: Reminds users that AI output may not be 100% accurate\n- **Styling**: Small monospace text, zinc-500 color\n\n### Technical Details\n\n**Model**: gpt-5.4-mini-2026-03-17 (with fallbacks to gpt-5-mini-2025-08-07, gpt-4o-mini)\n\n**System Prompt Features**:\n- Boss/nickname customization\n- Food emoji safeguard (prevents corruption)\n- RAG context injection for OpenServ queries\n- Instruction following and safety guidelines\n\n**API Endpoint**: `/api/chat` (POST)\n\n**Request Format**:\n```json\n{\n \"messages\": [\n { \"role\": \"user\", \"content\": \"Your question here\" }\n ],\n \"nickname\": \"Boss\"\n}\n```\n\n**Response Format**:\n```json\n{\n \"message\": \"AI response text\",\n \"model\": \"gpt-5.4-mini-2026-03-17\",\n \"toolCalls\": 0,\n \"responseTimeMs\": 1234\n}\n```\n\n---\n\n## Category-Based Cost Tracking\n\n### Overview\n\nIntelligent system that automatically categorizes API usage and tracks costs by category using gpt-5.4-nano.\n\n### Categories\n\n| Category | Purpose |\n|---|---|\n| **MattyJacks** | Questions about MattyJacks, the person, projects, or brand |\n| **GiveGigs** | GiveGigs platform or feature questions |\n| **CryptArtist** | CryptArtist Studio or related projects |\n| **OpenServ** | OpenServ, agents, or autonomous systems |\n| **Personal** | Personal questions, life advice, casual chat |\n| **Coding** | Programming, development, technical questions |\n| **Weird** | Unusual, strange, or absurd requests |\n| **Marketing** | Marketing strategy, branding, promotion |\n| **Mischief** | Playful, mischievous, or humorous requests |\n| **Other** | General topics not fitting above categories |\n| **Unknown** | Cannot determine category |\n\n### Features\n\n#### 1. AI Categorization\n- **Model**: gpt-5.4-nano (cost-efficient)\n- **Assignments**: 1-3 categories per prompt\n- **Reasoning**: Includes explanation of categorization\n- **Speed**: Fast, lightweight categorization\n\n#### 2. Cost Splitting\n- **2 Categories**: 50% cost split each\n- **3 Categories**: 33% cost split each\n- **Tokens**: Proportionally split across categories\n- **Requests**: Fractional request count per category\n\n#### 3. Live Dashboard\n- **Location**: Clout Calculator component\n- **Display**:\n - Category name\n - Cost in USD\n - Percentage of total cost\n - Request count\n- **Updates**: Real-time (every 2 seconds)\n- **Layout**: Responsive grid (2-4 columns)\n\n#### 4. Cost Metrics Tracked\n- Total requests\n- Total input tokens\n- Total output tokens\n- Total tokens (combined)\n- Total cost in USD\n- Cost per category\n- Percentage breakdown\n\n### Technical Details\n\n**Files**:\n- `lib/category-cost-tracker.ts` - Core tracking system\n- `lib/prompt-categorizer.ts` - AI categorization\n- `app/api/category-costs/route.ts` - API endpoint\n- `components/clout-calculations.tsx` - Dashboard display\n\n**Storage**: In-memory (production should use database)\n\n**API Endpoint**: `/api/category-costs` (GET)\n\n**Response Format**:\n```json\n{\n \"categoryBreakdown\": [\n {\n \"category\": \"Coding\",\n \"cost\": 0.45,\n \"percentage\": 25.5,\n \"requests\": 3.5\n }\n ]\n}\n```\n\n**Pricing** (gpt-5.4-mini):\n- Input: $0.075 per 1K tokens\n- Output: $0.30 per 1K tokens\n\n---\n\n## OpenServ RAG Integration\n\n### Overview\n\nComprehensive OpenServ documentation with intelligent retrieval-augmented generation (RAG) system.\n\n### Documentation Files\n\nLocated in `context/openserv/`:\n\n| File | Purpose |\n|---|---|\n| **README.md** | Overview, quick links, key resources |\n| **SDK.md** | TypeScript SDK features, installation, core concepts |\n| **AGENT_TUTORIAL.md** | Building agents, architecture, development workflow |\n| **API_CONCEPTS.md** | API patterns, action types, authentication, error handling |\n| **EXAMPLES.md** | Real-world agent examples and patterns |\n| **ARCHITECTURE.md** | System architecture, shadow agents, control levels |\n| **DEPLOYMENT.md** | Deployment strategies, monitoring, scaling, security |\n| **TROUBLESHOOTING.md** | Common issues, debugging, FAQ |\n\n### Features\n\n#### 1. Selective RAG Scanning\n- **Location**: `lib/openserv-rag.ts`\n- **Functionality**:\n - Scans `.md` and `.txt` files in `/context/openserv/`\n - Calculates relevance scores\n - Extracts relevant snippets\n - Returns top 3 most relevant matches\n - Keyword grouping for better matching\n\n#### 2. Quick-Context Mini-AI\n- **Model**: gpt-5.4-nano\n- **Purpose**: Summarize relevant documentation\n- **Features**:\n - Processes RAG context\n - Generates concise summaries (2-3 sentences)\n - Cost-efficient (nano model)\n - Fallback to empty context if no matches\n\n#### 3. OpenServ Counter\n- **Location**: `lib/openserv-counter.ts`\n- **Features**:\n - Tracks OpenServ prompt count\n - 10% chance message display\n - Shows total prompts and spend\n - Shared across all users\n - Example: \"This is the 3247th OpenServ prompt. MattyJacks has spent $32.48 teaching OpenServ.\"\n\n#### 4. Integration with Chat\n- **Automatic Detection**: Detects OpenServ queries\n- **Context Injection**: Adds relevant documentation to system prompt\n- **Cost Tracking**: Separate OpenServ cost tracking\n- **Counter Display**: 10% chance message appended to response\n\n### Technical Details\n\n**Files**:\n- `lib/openserv-rag.ts` - RAG scanning and matching\n- `lib/openserv-counter.ts` - Counter and messaging\n- `app/api/quick-context/route.ts` - Quick-context endpoint\n- `context/openserv/` - Documentation files\n\n**API Endpoint**: `/api/quick-context` (POST)\n\n**Request Format**:\n```json\n{\n \"query\": \"How do I create an OpenServ agent?\"\n}\n```\n\n**Response Format**:\n```json\n{\n \"context\": \"Summarized documentation context\",\n \"isOpenserv\": true,\n \"source\": \"quick-context-rag\"\n}\n```\n\n**Relevance Scoring**:\n- Exact phrase match: +10 points\n- Word-by-word match: +2 points per word\n- Keyword group match: +3 points per match\n\n---\n\n## API Endpoints\n\n### Chat Endpoint\n\n**Route**: `/api/chat`\n**Method**: POST\n**Purpose**: Send messages and receive AI responses\n\n**Request**:\n```typescript\n{\n messages: Array<{\n role: \"user\" | \"assistant\";\n content: string;\n }>;\n nickname?: string;\n requestedModel?: string;\n}\n```\n\n**Response**:\n```typescript\n{\n message: string;\n model: string;\n toolCalls: number;\n responseTimeMs: number;\n debugLogs?: string[];\n}\n```\n\n### Category Costs Endpoint\n\n**Route**: `/api/category-costs`\n**Method**: GET\n**Purpose**: Fetch category cost breakdown\n\n**Response**:\n```typescript\n{\n categoryBreakdown: Array<{\n category: string;\n cost: number;\n percentage: number;\n requests: number;\n }>;\n}\n```\n\n### Quick Context Endpoint\n\n**Route**: `/api/quick-context`\n**Method**: POST\n**Purpose**: Get RAG-enhanced context for OpenServ queries\n\n**Request**:\n```typescript\n{\n query: string;\n}\n```\n\n**Response**:\n```typescript\n{\n context: string;\n isOpenserv: boolean;\n source: \"quick-context-rag\" | \"no-docs\";\n}\n```\n\n---\n\n## Architecture\n\n### Data Flow\n\n```\nUser Message\n β\nChat API (/api/chat)\n β\nβββ Categorization (gpt-5.4-nano)\nβ βββ Assign 1-3 categories\nβ\nβββ OpenServ Detection\nβ βββ If OpenServ query:\nβ βββ RAG Scanning\nβ βββ Quick-Context Summary\nβ βββ Counter Increment\nβ\nβββ OpenAI API Call (gpt-5.4-mini)\nβ βββ Process with context\nβ\nβββ Cost Tracking\nβ βββ API Cost Tracker\nβ βββ Category Cost Tracker\nβ\nβββ Response to User\n βββ Display in Chat UI\n```\n\n### Component Hierarchy\n\n```\nApp Layout\nββ Navigation (z-index: 100)\nββ Main Content\nβ ββ AnythingButton (Chat, z-index: 110)\nβ ββ Message List\nβ ββ Input Area\nβ ββ Magic Prompts\nβ ββ Food Emoji Button\nβ ββ Disclaimer\nββ Footer\n ββ CloutCalculations\n ββ View Stats\n ββ API Cost Tracking\n ββ Category Cost Breakdown\n```\n\n---\n\n## Usage Examples\n\n### Example 1: Regular Chat\n\n**User Input**: \"What's the best way to optimize a React component?\"\n\n**Flow**:\n1. Message sent to `/api/chat`\n2. Categorized as \"Coding\" (100%)\n3. No OpenServ detection\n4. OpenAI processes with system prompt\n5. Response displayed with disclaimer\n6. Costs tracked under \"Coding\" category\n\n### Example 2: OpenServ Query\n\n**User Input**: \"How do I create an autonomous agent with OpenServ?\"\n\n**Flow**:\n1. Message sent to `/api/chat`\n2. Categorized as \"OpenServ\" (100%)\n3. OpenServ detected\n4. RAG scans documentation\n5. Quick-context summarizes relevant docs\n6. Context injected into system prompt\n7. OpenAI processes with enhanced context\n8. 10% chance: Counter message appended\n9. Costs tracked under \"OpenServ\" category\n\n### Example 3: Multi-Category Query\n\n**User Input**: \"I want to build a weird marketing campaign using AI agents\"\n\n**Flow**:\n1. Message sent to `/api/chat`\n2. Categorized as: \"Marketing\" (33%), \"Weird\" (33%), \"Coding\" (33%)\n3. Costs split equally across 3 categories\n4. OpenAI processes\n5. Response displayed\n6. Each category receives 33% of the cost\n\n---\n\n## Configuration\n\n### Environment Variables\n\n```bash\n# OpenAI API Key (required)\nOPENAI_API_KEY=sk-...\n\n# Optional: Custom model selection\nOPENAI_MODEL=gpt-5.4-mini-2026-03-17\n```\n\n### Customization\n\n**Magic Prompts**: Edit `components/short-prompts.ts`\n**Categories**: Edit `lib/category-cost-tracker.ts` (COST_CATEGORIES)\n**System Prompt**: Edit `app/api/chat/route.ts` (SYSTEM_PROMPT)\n**RAG Settings**: Edit `lib/openserv-rag.ts` (MAX_SNIPPET_LENGTH, MAX_RESULTS)\n\n---\n\n## Performance Metrics\n\n### Typical Response Times\n\n- Chat response: 1-3 seconds\n- Categorization: 200-500ms\n- RAG scanning: 50-150ms\n- Quick-context: 300-800ms\n\n### Token Usage\n\n- Average chat message: 150-300 tokens\n- Categorization: 50-100 tokens\n- RAG context: 200-500 tokens\n\n### Cost Estimates\n\n- Average chat: $0.01-0.05\n- Categorization: $0.001-0.002\n- Quick-context: $0.002-0.005\n\n---\n\n## Future Enhancements\n\n- [ ] Database persistence for cost tracking\n- [ ] User-specific cost tracking\n- [ ] Cost alerts and budgets\n- [ ] Advanced RAG with vector embeddings\n- [ ] Multi-language support\n- [ ] Custom category creation\n- [ ] Cost analytics and reporting\n- [ ] Conversation export/sharing\n\n---\n\nFor more information, see the individual feature documentation files.\n","wordCount":1575,"sizeKb":11.8},{"name":"IMPLEMENTATION-SUMMARY.md","slug":"IMPLEMENTATION-SUMMARY","content":"# MattyJacks.com Implementation Summary\n\n**Last Updated**: March 20, 2026\n\n## Project Overview\n\nMattyJacks.com is a comprehensive business website with integrated AI chat, intelligent cost tracking, and OpenServ documentation system. This document summarizes all implemented features and their current status.\n\n---\n\n## Completed Features\n\n### Phase 1: Core UI & UX Fixes β
\n\n#### 1. Header Z-Index Fix\n- **Issue**: Navigation header (z-index: 100) was covering AI chat close button\n- **Solution**: Increased chat container z-index from 60 to 110\n- **File**: `components/anything-button.tsx` (line 1033)\n- **Status**: β
Complete\n\n#### 2. Chat Disclaimer\n- **Feature**: Added \"-+OUTPUT_NOT_100%_TRUE+-\" disclaimer at bottom of chat\n- **Purpose**: Reminds users that AI output may not be 100% accurate\n- **File**: `components/anything-button.tsx` (lines 1327-1331)\n- **Styling**: Small monospace text, zinc-500 color, bottom border\n- **Status**: β
Complete\n\n#### 3. OpenServ Documentation Folder\n- **Created**: `/context/openserv/` directory\n- **Files**: 5 initial markdown files\n- **Purpose**: Comprehensive OpenServ documentation for RAG system\n- **Status**: β
Complete\n\n### Phase 2: API Cost Tracking & OpenServ Counter β
\n\n#### 1. API Cost Tracker\n- **File**: `lib/api-cost-tracker.ts`\n- **Features**:\n - Tracks requests, input tokens, output tokens, total tokens, total cost\n - Per-model tracking (gpt-5.4-mini, gpt-5-mini, gpt-4o-mini)\n - OpenServ-specific cost tracking\n - In-memory storage (production: use database)\n- **Status**: β
Complete\n\n#### 2. OpenServ Counter\n- **File**: `lib/openserv-counter.ts`\n- **Features**:\n - Tracks OpenServ prompt count\n - 10% chance message display\n - Shows total prompts and spend\n - Shared across all users\n- **Integration**: `app/api/chat/route.ts` (lines 822-828)\n- **Status**: β
Complete\n\n#### 3. Chat API Integration\n- **File**: `app/api/chat/route.ts`\n- **Additions**:\n - Cost tracking imports (lines 6-7)\n - Cost tracking logic (lines 810-817)\n - OpenServ counter integration (lines 821-828)\n- **Status**: β
Complete\n\n### Phase 3: Quick-Context Mini-AI with RAG β
\n\n#### 1. OpenServ RAG System\n- **File**: `lib/openserv-rag.ts`\n- **Features**:\n - Selective document scanning (.md, .txt files)\n - Relevance scoring algorithm\n - Snippet extraction\n - Top 3 results return\n - Keyword grouping for better matching\n- **Status**: β
Complete\n\n#### 2. Quick-Context API Endpoint\n- **File**: `app/api/quick-context/route.ts`\n- **Features**:\n - gpt-5.4-nano powered summarization\n - RAG context processing\n - OpenServ query detection\n - Cost tracking\n- **Status**: β
Complete\n\n#### 3. Chat API RAG Integration\n- **File**: `app/api/chat/route.ts` (lines 679-686)\n- **Features**:\n - Automatic OpenServ detection\n - RAG context injection into system prompt\n - Seamless integration with chat flow\n- **Status**: β
Complete\n\n### Phase 4: Enhanced Documentation β
\n\n#### 1. Web Research & Documentation Enhancement\n- **Source**: Browsed OpenServ GitHub and documentation\n- **Files Enhanced**: SDK.md with advanced features\n- **Status**: β
Complete\n\n#### 2. New Documentation Files\n- **ARCHITECTURE.md**: System architecture, shadow agents, control levels (344 lines)\n- **DEPLOYMENT.md**: Deployment strategies, monitoring, scaling (400+ lines)\n- **TROUBLESHOOTING.md**: Common issues, debugging, FAQ (500+ lines)\n- **Status**: β
Complete\n\n### Phase 5: Category-Based Cost Tracking β
\n\n#### 1. Category Cost Tracker\n- **File**: `lib/category-cost-tracker.ts`\n- **Categories**: 11 (MattyJacks, GiveGigs, CryptArtist, Other, Unknown, OpenServ, Personal, Coding, Weird, Marketing, Mischief)\n- **Features**:\n - Per-category cost tracking\n - Cost splitting (50% for 2 categories, 33% for 3)\n - Request counting\n - Token tracking per category\n - Category breakdown with percentages\n- **Status**: β
Complete\n\n#### 2. Prompt Categorizer\n- **File**: `lib/prompt-categorizer.ts`\n- **Features**:\n - gpt-5.4-nano powered categorization\n - 1-3 category assignment per prompt\n - Reasoning explanation\n - JSON response parsing\n - Error handling with fallback\n- **Status**: β
Complete\n\n#### 3. Category Costs API Endpoint\n- **File**: `app/api/category-costs/route.ts`\n- **Features**:\n - GET endpoint for category breakdown\n - Formatted response with cost, percentage, requests\n - Security headers\n- **Status**: β
Complete\n\n#### 4. Chat API Category Integration\n- **File**: `app/api/chat/route.ts` (lines 813-817)\n- **Features**:\n - Automatic categorization on each prompt\n - Cost calculation and splitting\n - Category cost tracking\n- **Status**: β
Complete\n\n#### 5. Clout Calculator Enhancement\n- **File**: `components/clout-calculations.tsx`\n- **Additions**:\n - CategoryCostBreakdown interface (lines 27-32)\n - categoryCosts state (line 51)\n - Category cost fetching (lines 81-100)\n - Category cost display section (lines 202-222)\n - Responsive grid layout (2-4 columns)\n - Live updates every 2 seconds\n- **Status**: β
Complete\n\n---\n\n## File Structure\n\n### New Files Created\n\n```\nmattyjacks7/\nβββ lib/\nβ βββ api-cost-tracker.ts # API cost tracking system\nβ βββ openserv-counter.ts # OpenServ prompt counter\nβ βββ openserv-rag.ts # RAG document scanning\nβ βββ category-cost-tracker.ts # Category-based cost tracking\nβ βββ prompt-categorizer.ts # AI categorization system\nβββ app/api/\nβ βββ chat/route.ts # Enhanced with all tracking\nβ βββ quick-context/route.ts # Quick-context RAG endpoint\nβ βββ category-costs/route.ts # Category costs API endpoint\nβββ context/\n βββ mattyjacks-website-README.md # Updated main README\n βββ AI-FEATURES-README.md # Comprehensive AI features doc\n βββ IMPLEMENTATION-SUMMARY.md # This file\n βββ openserv/\n βββ README.md # OpenServ overview\n βββ SDK.md # SDK documentation\n βββ AGENT_TUTORIAL.md # Agent development guide\n βββ API_CONCEPTS.md # API patterns\n βββ EXAMPLES.md # Real-world examples\n βββ ARCHITECTURE.md # System architecture\n βββ DEPLOYMENT.md # Deployment guide\n βββ TROUBLESHOOTING.md # Troubleshooting guide\n```\n\n### Modified Files\n\n```\nmattyjacks7/\nβββ components/\nβ βββ anything-button.tsx # Chat UI (z-index fix, disclaimer)\nβ βββ clout-calculations.tsx # Enhanced with category costs\nβββ app/\nβ βββ api/chat/route.ts # All tracking integrations\nβββ context/\n βββ mattyjacks-website-README.md # Updated with latest features\n```\n\n---\n\n## Build Status\n\n**Last Build**: March 20, 2026, 4:20 PM UTC-04:00\n**Status**: β
**SUCCESS**\n**Build Time**: 6.2s (Turbopack)\n**TypeScript**: β
Compiled successfully in 9.0s\n\n### Build Output\n- 31 static pages generated\n- 8 dynamic API routes\n- All routes compiled without errors\n- No lint errors or warnings\n\n---\n\n## API Endpoints Summary\n\n| Endpoint | Method | Purpose | Status |\n|---|---|---|---|\n| `/api/chat` | POST | Chat with AI, cost tracking | β
Complete |\n| `/api/quick-context` | POST | RAG-enhanced context retrieval | β
Complete |\n| `/api/category-costs` | GET | Fetch category cost breakdown | β
Complete |\n| `/api/views` | GET | View statistics | β
Existing |\n\n---\n\n## Feature Checklist\n\n### AI Chat System\n- β
Real-time chat interface\n- β
Magic prompt templates (20+)\n- β
Food emoji rewards\n- β
Short prompt suggestions with Regen button\n- β
Chat disclaimer\n- β
Responsive design\n- β
Dark/light mode support\n\n### Cost Tracking\n- β
API cost tracker (requests, tokens, cost)\n- β
Per-model tracking\n- β
OpenServ-specific tracking\n- β
Category-based tracking (11 categories)\n- β
Cost splitting (50%/33%)\n- β
Live dashboard display\n- β
Real-time updates (2-second refresh)\n\n### OpenServ Integration\n- β
8 comprehensive documentation files\n- β
Selective RAG scanning\n- β
Quick-context mini-AI (gpt-5.4-nano)\n- β
OpenServ counter (10% chance message)\n- β
Automatic context injection\n- β
Separate cost tracking\n\n### UI/UX Improvements\n- β
Header z-index fix (chat above nav)\n- β
Chat disclaimer\n- β
Clout Calculator enhancement\n- β
Category cost breakdown display\n- β
Responsive grid layout\n- β
Live metrics updates\n\n---\n\n## Performance Metrics\n\n### Response Times\n- Chat response: 1-3 seconds\n- Categorization: 200-500ms\n- RAG scanning: 50-150ms\n- Quick-context: 300-800ms\n\n### Token Usage\n- Average chat message: 150-300 tokens\n- Categorization: 50-100 tokens\n- RAG context: 200-500 tokens\n\n### Cost Estimates\n- Average chat: $0.01-0.05\n- Categorization: $0.001-0.002\n- Quick-context: $0.002-0.005\n\n---\n\n## Known Limitations & Future Improvements\n\n### Current Limitations\n- Cost tracking uses in-memory storage (no persistence)\n- Category data resets on server restart\n- No user-specific cost tracking\n- No cost alerts or budgets\n\n### Planned Enhancements\n- [ ] Database persistence for cost tracking\n- [ ] User-specific cost tracking\n- [ ] Cost alerts and budgets\n- [ ] Advanced RAG with vector embeddings\n- [ ] Multi-language support\n- [ ] Custom category creation\n- [ ] Cost analytics and reporting\n- [ ] Conversation export/sharing\n- [ ] Memory leak investigation (profile pages, chat components)\n\n---\n\n## Documentation Files\n\n### Main README\n- **File**: `context/mattyjacks-website-README.md`\n- **Size**: 796 lines\n- **Updates**: Added Latest Features section with AI Chat, Category Tracking, OpenServ RAG\n\n### AI Features README\n- **File**: `context/AI-FEATURES-README.md`\n- **Size**: 500+ lines\n- **Content**: Comprehensive guide to all AI features, APIs, architecture, usage examples\n\n### Implementation Summary\n- **File**: `context/IMPLEMENTATION-SUMMARY.md`\n- **Size**: This document\n- **Content**: Complete overview of all implemented features and current status\n\n### OpenServ Documentation\n- **Location**: `context/openserv/`\n- **Files**: 8 markdown files\n- **Total Lines**: 1500+\n- **Coverage**: Complete OpenServ ecosystem documentation\n\n---\n\n## Testing & Verification\n\n### Build Verification\n```bash\nnpm run build\n# Result: β
SUCCESS (6.2s)\n```\n\n### Feature Testing Checklist\n- β
Chat interface loads and responds\n- β
Magic prompts display and work\n- β
Food emoji button functions\n- β
Chat disclaimer displays\n- β
Cost tracking calculates correctly\n- β
Categories assign properly\n- β
Clout Calculator displays categories\n- β
OpenServ detection works\n- β
RAG context injects correctly\n- β
Counter message displays (10% chance)\n\n---\n\n## Deployment Notes\n\n### Environment Variables Required\n```bash\nOPENAI_API_KEY=sk-...\n```\n\n### Deployment Checklist\n- β
All files created and integrated\n- β
Build passes without errors\n- β
No TypeScript errors\n- β
Security headers configured\n- β
API endpoints functional\n- β
Database ready (in-memory for now)\n\n### Post-Deployment\n- Monitor API costs and usage\n- Track category distribution\n- Watch for memory leaks\n- Collect user feedback on AI features\n\n---\n\n## Contact & Support\n\nFor questions or issues related to:\n- **AI Chat**: See `components/anything-button.tsx`\n- **Cost Tracking**: See `lib/api-cost-tracker.ts` and `lib/category-cost-tracker.ts`\n- **OpenServ**: See `context/openserv/` documentation\n- **General**: See `context/mattyjacks-website-README.md`\n\n---\n\n## Version History\n\n| Date | Version | Changes |\n|---|---|---|\n| 2026-03-20 | 1.0.0 | Initial release with all features |\n| 2026-03-19 | 0.5.0 | Phase 3 & 4 complete (RAG, docs) |\n| 2026-03-19 | 0.3.0 | Phase 2 complete (cost tracking) |\n| 2026-03-19 | 0.1.0 | Phase 1 complete (UI fixes) |\n\n---\n\n**Status**: Production Ready β
\n**Last Updated**: March 20, 2026, 4:25 PM UTC-04:00\n","wordCount":1622,"sizeKb":11.7},{"name":"contact-channels.md","slug":"contact-channels","content":"# MattyJacks Contact Channels\n\nThis document catalogs the official contact channels and support pathways for MattyJacks clients, partners, and team members.\n\n## Main Phone Line\n- **Number**: `603-999-9420` (USA)\n- **Guidelines**: Calls only. Strictly **no texts** (texts sent to this line are not monitored).\n\n## WhatsApp Support (Public / Interns)\n- **Direct WA Number**: `+1 (510) 600-5735`\n- **Guidelines**: Standard messaging support. No calling without permission.\n\n## Telegram Communications\n- **Direct User**: `@MattyJacks` (For quick B2B outreach and support)\n- **Public Telegram Channel**: `https://t.me/mattyjacks1`\n\n## Social Media\n- **X / Twitter**: `@MattyJacksX` (Latest ecosystem news and announcements)\n\n## Email Addresses\n- **Founder**: `Matt@MattyJacks.com`\n- **General Support**: `support@MattyJacks.com`\n","wordCount":107,"sizeKb":0.8},{"name":"cryptartist-studio-README.md","slug":"cryptartist-studio-README","content":"\n\n# CryptArtist Studio\n\n### The Open Creative Suite - Powered by Community\n\n**Website:** [mattyjacks.com](https://mattyjacks.com) | **GitHub:** [github.com/mattyjacks/CryptArtistStudio](https://github.com/mattyjacks/CryptArtistStudio) | **Contact:** [Matt@MattyJacks.com](mailto:Matt@MattyJacks.com)\n\n---\n\n**CryptArtist Studio** is a free, open-source, professional-grade creative suite built with\nTauri v2, React 18, TypeScript, and Rust. It bundles eleven powerful programs into a single\ndesktop application: a video/image editor, a vibe-coding IDE, a screen recorder, an\nautonomous AI agent, an integrated game development studio, a terminal-based command center,\na P2P compute-sharing tool, an installer builder, a GIMP-style image editor with AI, a\nluck-based AI seed generator, and a full settings hub.\n\nThe project is community-funded through donations at\n[mattyjacks.com](https://mattyjacks.com) and [givegigs.com](https://givegigs.com).\n\n
\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Programs in the Suite](#programs-in-the-suite)\n - [Media Mogul](#media-mogul--mmo)\n - [VibeCodeWorker](#vibecodeworker--vcw)\n - [DemoRecorder](#demorecorder--dre)\n - [ValleyNet](#valleynet--vnt)\n - [GameStudio](#gamestudio--gst)\n - [CryptArt Commander](#cryptart-commander--cac)\n - [DonatePersonalSeconds](#donatepersonalseconds--dps)\n - [Clone Tool](#clone-tool--cln)\n - [DictatePic](#dictatepic--dc)\n - [Luck Factory](#luck-factory--lck)\n - [Settings](#settings--set)\n- [Workspace Management](#workspace-management)\n - [Multi-File Workspaces](#multi-file-workspaces)\n - [Workspace Groups and Resource Sharing](#workspace-groups-and-resource-sharing)\n- [Plugin, Mod, and Theme System](#plugin-mod-and-theme-system)\n - [Plugins](#plugins)\n - [Mods](#mods)\n - [Themes](#themes)\n- [The .CryptArt File Format](#the-cryptart-file-format)\n - [Format Overview](#format-overview)\n - [Required Fields](#required-fields)\n - [Recommended Fields](#recommended-fields)\n - [Optional Fields](#optional-fields)\n - [Meta Object](#meta-object)\n - [Backward Compatibility](#backward-compatibility)\n - [Example Files](#example-files)\n- [Technology Stack](#technology-stack)\n - [Frontend](#frontend)\n - [Backend (Rust)](#backend-rust)\n - [Media Engine](#media-engine)\n - [Build System](#build-system)\n- [Project Architecture](#project-architecture)\n - [Directory Structure](#directory-structure)\n - [Frontend Architecture](#frontend-architecture)\n - [Backend Architecture](#backend-architecture)\n - [State Management](#state-management)\n- [Getting Started](#getting-started)\n - [Prerequisites](#prerequisites)\n - [Installation](#installation)\n - [Development Mode](#development-mode)\n - [Building for Production](#building-for-production)\n - [Platform Support](#platform-support)\n- [CLI Reference](#cli-reference)\n - [Global Commands](#global-commands)\n - [Project Management](#project-management-commands)\n - [Media Commands](#media-commands)\n - [AI Commands](#ai-commands)\n - [File System Commands](#file-system-commands)\n - [Server Commands](#server-commands)\n - [System Commands](#system-commands)\n- [REST API Reference](#rest-api-reference)\n - [Starting the Server](#starting-the-server)\n - [Endpoints](#endpoints)\n - [Authentication](#authentication)\n- [Configuration](#configuration)\n - [API Keys](#api-keys)\n - [FFmpeg Setup](#ffmpeg-setup)\n - [Godot Integration](#godot-integration)\n - [Tauri Configuration](#tauri-configuration)\n- [Logging System](#logging-system)\n - [Log Files](#log-files)\n - [Log Levels](#log-levels)\n - [Frontend Logging](#frontend-logging)\n- [Keyboard Shortcuts](#keyboard-shortcuts)\n- [OpenRouter Multi-Model AI Integration](#openrouter-multi-model-ai-integration)\n - [Supported Providers](#supported-providers)\n - [Model Selection](#model-selection)\n - [Fallback Behavior](#fallback-behavior)\n- [Security Hardening](#security-hardening)\n - [Overview of 300 Vulnerability Fixes](#overview-of-300-vulnerability-fixes)\n - [Security Utility Module](#security-utility-module)\n - [Content Security Policy](#content-security-policy)\n - [REST API Security Headers](#rest-api-security-headers)\n - [Input Validation Summary](#input-validation-summary)\n- [CryptArtist Studio Website](#cryptartist-studio-website)\n - [Website Pages](#website-pages)\n - [Website Technology](#website-technology)\n- [Privacy Policy and Terms of Use](#privacy-policy-and-terms-of-use)\n- [Contributing](#contributing)\n - [Development Workflow](#development-workflow)\n - [Code Style](#code-style)\n - [Pull Requests](#pull-requests)\n- [Troubleshooting](#troubleshooting)\n- [Performance Optimization](#performance-optimization)\n- [Prompt History](#prompt-history)\n- [Related Projects and Links](#related-projects-and-links)\n- [Roadmap](#roadmap)\n- [Future Plans](#future-plans)\n - [New Programs (Cκ΄S, SLM, BRD, MKT, NET, SYN, TRN, ARK, COM)](#new-programs)\n - [Existing Program Enhancements](#existing-program-enhancements)\n - [Platform and Infrastructure](#platform-and-infrastructure)\n - [AI and Machine Learning](#ai-and-machine-learning)\n - [Community and Ecosystem](#community-and-ecosystem)\n- [Detailed Cκ΄S Plan](#detailed-cκ΄s-plan)\n- [Detailed SLM Plan](#detailed-slm-plan)\n- [License](#license)\n- [Credits](#credits)\n\n---\n\n## Overview\n\nCryptArtist Studio started as a DaVinci Resolve competitor - a professional video editor\nwith AI integration. It has since evolved into a full creative suite with eleven distinct\nprograms, all sharing a unified dark theme, a common project file format (`.CryptArt`),\nand deep AI integration powered by the user's own API keys.\n\n### Key Highlights\n\n- **Eleven Programs in One** - Video editing, code editing, screen recording, AI agent,\n game development, terminal commander, P2P compute sharing, installer builder, AI image\n editor, luck seed generator, and a settings hub all in a single ~15 MB download.\n- **Security Hardened** - 300 vulnerability fixes across frontend and backend,\n including CSP, input validation, rate limiting, XSS prevention, audit logging,\n encrypted storage, SVG sanitization, WebSocket monitoring, and API guards.\n- **AI-Powered Everything** - Every program integrates with OpenAI, Anthropic, Google,\n or any OpenAI-compatible API endpoint. Users bring their own keys.\n- **The .CryptArt File Format** - A permanently future-proof JSON project file that\n will never need a format upgrade. Any `.CryptArt` file ever created will always be\n readable by any version of the app.\n- **Cross-Platform** - Runs on Windows, macOS, and Linux via Tauri. Planned launches\n on 100+ platforms including Steam (PC/Mac/Linux/Deck), iOS, Android, Xbox, PS5,\n Nintendo Switch 1 & 2, Smart TVs, Chromebook, Raspberry Pi, Arduino, calculators,\n smart watches, VR headsets, web browsers, Docker, and more. See\n [Platform Launch Plans](#platform-launch-plans---every-platform-possible) for the full list.\n- **Full CLI and REST API** - Every feature is accessible from the command line or via\n HTTP API, enabling integration with other AI tools and automation pipelines.\n- **Comprehensive Logging** - Three rolling log files track everything: a session log,\n a recent log (last 1,000 lines), and a full history log.\n- **Community-Funded** - No subscriptions, no ads. Supported by donations at\n [mattyjacks.com](https://mattyjacks.com) and [givegigs.com](https://givegigs.com).\n- **Open Source** - CryptArtist Custom License v1.69.420.3. Fork it, extend it, make it yours.\n\n### Philosophy\n\nCryptArtist Studio is built on the belief that creative tools should be:\n\n1. **Free** - No paywalls, no feature gates, no \"pro\" tiers.\n2. **Open** - CryptArtist Custom License v1.69.420.3, fully auditable, community-driven.\n3. **Permanent** - File formats that never break, software that respects your work.\n4. **AI-Native** - AI is not bolted on; it is woven into every workflow.\n5. **User-Controlled** - Your API keys, your data, your machine. No cloud dependency.\n\n### Recent Updates (March 2026)\n\n**GameStudio Enhancements:**\n- β
Upgraded to **Godot 4.6.1** (latest stable release)\n- β
**Custom Godot Path Browser** - Users can now browse and select custom Godot executable paths\n- β
**Godot Path Verification** - Backend validates custom paths before use\n- β
**Improved Godot Not Found Dialog** - Four options: Download, Browse, Rescan, or Continue\n- β
**GPT-5 Mini Default** - All AI code generation now uses GPT-5 Mini for better performance\n\n**VibeCodeWorker Improvements:**\n- β
**Shared API Keys** - Now uses centralized API keys from CryptArtist Studio Settings\n- β
**Removed Duplicate Configuration** - No need to set API keys per-program\n- β
**Better Status Indicators** - Settings panel shows available API keys (OpenAI, OpenRouter, etc.)\n- β
**GPT-5 Mini Default** - AI assistant defaults to GPT-5 Mini model\n- β
**Cleaner UI** - Simplified settings panel with clear API key status\n\n**System-Wide Updates:**\n- β
**GPT-5 Mini as Default AI Model** - All programs now default to `openai/gpt-5-mini`\n- β
**Centralized API Key Management** - All programs share keys from Settings\n- β
**Production Build Ready** - Latest .exe built and tested (v1.69.420)\n- β
**Security Hardening** - 300+ vulnerability fixes across frontend and backend\n\n---\n\n## Programs in the Suite\n\nWhen you launch CryptArtist Studio, you are greeted by the **Suite Launcher [πΊοΈSLr]** - a\nfull-window launcher displaying the CryptArtist logo and twelve program cards.\nThe Suite Launcher is itself a launchable program from within the grid.\nEach card shows the program's emoji logo, name, short code, and a one-line description.\nThe launcher includes search and filter, favorites, category sorting, grid/list views,\na rotating tips carousel, keyboard shortcuts overlay, system status indicators, and\nan AI readiness indicator.\n\n| # | Program | Emoji | Code | Shortcut | Description |\n|---|---|---|---|---|---|\n| - | **Suite Launcher** | Map | SLr | `Home` | The home screen - launch programs, open .CryptArt files, view status |\n| 1 | **Media Mogul** | TV | MMo | `1` | Video editor, image editor, and AI-powered media studio |\n| 2 | **VibeCodeWorker** | Technologist | VCW | `2` | Your personal vibe-coding IDE powered by your own API keys |\n| 3 | **DemoRecorder** | Camera | DRe | `3` | Screen recorder and live streamer for demos and gaming |\n| 4 | **ValleyNet** | Person | VNt | `4` | Autonomous AI agent that can do anything on your computer |\n| 5 | **GameStudio** | Game Controller | GSt | `5` | Combined media + code + Godot engine for game development |\n| 6 | **CryptArt Commander** | Cat | CAC | `6` | Terminal-based command center for API and CLI control |\n| 7 | **DonatePersonalSeconds** | Computer | DPS | `7` | P2P compute resource sharing for distributed tasks |\n| 8 | **Clone Tool** | Package | CLN | `9` | Create .exe, .dmg, .deb installers from your config |\n| 9 | **DictatePic** | Pie | D(pi)c | `-` | GIMP-style image editor with AI generation, inpainting, and style transfer |\n| 10 | **Luck Factory** | Clover | Lck | `-` | AI luck seed generator with guided meditation and affirmations |\n| 11 | **Settings** | Gear | Set | `0` | API key management, OpenRouter, appearance, and data |\n\nThe Suite Launcher [πΊοΈSLr] also displays a donation banner encouraging users to support\ndevelopment at [mattyjacks.com](https://mattyjacks.com) and\n[givegigs.com](https://givegigs.com).\n\n#### Suite Launcher [SLr] Features\n\n- **Search and Filter** - Type to search programs by name, code, description, or tags\n- **Category Filter** - Filter by category tags (all, video, code, ai, media, game, tools)\n- **Sort Options** - Sort by default, A-Z, most used, or favorites first\n- **Grid/List View** - Toggle between card grid and compact list layouts\n- **Favorites** - Star programs for quick access; persisted in localStorage\n- **Launch Count Tracking** - Tracks how many times each program is launched\n- **Time-Based Greeting** - Dynamic greeting based on time of day\n- **Rotating Tips** - 14 tips rotate every 8 seconds with usage hints\n- **Keyboard Shortcuts Overlay** - Press `?` to see all shortcuts\n- **Recent Projects Panel** - Press `R` to see recently opened `.CryptArt` files\n- **Quick Actions Dropdown** - Access recent projects, shortcuts, cache clear, and GitHub\n- **System Status** - Shows FFmpeg, Godot, and AI (OpenRouter/OpenAI) status\n- **Open .CryptArt Files** - Multi-file open dialog that creates workspaces\n- **Accent Color** - Configurable accent color theme\n- **Uptime Display** - Shows session uptime in the status bar\n\n---\n\n### Media Mogul - MMo\n\n**Media Mogul** is the flagship program of CryptArtist Studio. It is a professional-grade\nvideo editor, image editor, and AI-powered media production studio with an integrated\nPodcast & Audio Lab powered by ElevenLabs.\n\n#### Workspaces\n\nMedia Mogul is organized into seven workspaces, each accessible from the header tabs:\n\n| Workspace | Description |\n|---|---|\n| **Edit** | Timeline-based video editing with multi-track support |\n| **Node Mode** | Node-based compositing pipeline for advanced visual effects |\n| **Color** | Color grading and correction tools |\n| **Audio** | Audio editing, mixing, and waveform visualization |\n| **AI Studio** | AI-powered video generation, voiceover, captioning, and scripting |\n| **Podcast** | ElevenLabs voice generation, speech-to-text, and sound effects lab |\n| **Deliver** | Export settings, format selection, and render queue |\n\n#### Features\n\n- **Multi-Track Timeline** - Drag-and-drop clips onto a layered timeline with\n snap-to-grid, trimming, splitting, and ripple editing.\n- **Node-Based Compositing** - A directed acyclic graph (DAG) editor for chaining\n visual effects, color corrections, and transformations.\n- **AI Studio Mode** - Generate complete videos from a text prompt:\n - AI selects stock footage from Pexels\n - AI writes voiceover scripts\n - AI generates captions and subtitles\n - AI suggests background music from GiveGigs media bucket\n - AI creates podcast scripts and music compositions\n- **Podcast & Audio Lab (ElevenLabs)**:\n - Text-to-speech voiceover generation with selectable voice/model\n - Speech-to-text transcription for uploaded audio files\n - Sound effects generation from text prompts\n - Voice/model catalog fetch (from ElevenLabs API)\n - Generated audio output tracking for quick reuse in timeline workflows\n- **Pexels Integration** - Search and import photos and videos from Pexels directly\n into your project. Multiple resolution options for video.\n- **GiveGigs Media Bucket** - Connect to a GiveGigs.com Supabase bucket for royalty-free\n music, sound effects, and media assets.\n- **Image Generation** - Generate images using the OpenAI API (DALL-E) with custom\n prompts or AI-assisted prompt refinement.\n- **FFmpeg-Powered** - All encoding, decoding, and transcoding is handled by FFmpeg,\n which is automatically downloaded on first run.\n- **Export Options** - Export to MP4, WebM, GIF, PNG sequence, and more with\n configurable resolution, bitrate, and codec settings.\n\n#### .CryptArt Data Payload (Media Mogul)\n\nWhen Media Mogul saves a `.CryptArt` file, the `data` object contains:\n\n```json\n{\n \"workspace\": \"edit\",\n \"timeline\": { ... },\n \"mediaPool\": [ ... ],\n \"nodeGraph\": { ... },\n \"colorGrade\": { ... },\n \"exportSettings\": { ... }\n}\n```\n\n---\n\n### VibeCodeWorker - VCW\n\n**VibeCodeWorker** is a full-featured vibe-coding IDE built into CryptArtist Studio.\nIt is modeled after VS Code and Windsurf, using the MIT-licensed Monaco Editor as its\ncode editing engine. VibeCodeWorker now uses shared API keys from CryptArtist Studio Settings,\neliminating the need for per-program API key configuration.\n\n#### Layout\n\nThe VibeCodeWorker window is divided into four main areas:\n\n| Area | Position | Description |\n|---|---|---|\n| **File Explorer** | Left sidebar (200px) | Tree view of the project directory |\n| **Editor** | Center | Monaco Editor with syntax highlighting, minimap, bracket colorization |\n| **Bottom Panel** | Below editor (200px) | Tabbed panel with 5 sub-panels |\n| **AI Chat** | Right sidebar (300px) | AI assistant with context-aware code help (uses GPT-5 Mini by default) |\n\n#### API Key Management\n\n- **Shared API Keys** - VibeCodeWorker uses the same API keys configured in CryptArtist Studio Settings\n- **Supported Providers** - OpenAI, Anthropic, Google, OpenRouter\n- **Default Model** - GPT-5 Mini (openai/gpt-5-mini)\n- **Status Indicators** - Settings panel shows which API keys are available\n- **No Duplication** - Configure once in Settings, use everywhere in the suite\n\n#### Bottom Panel Tabs\n\n| Tab | Description |\n|---|---|\n| **Terminal** | Built-in terminal with basic commands (clear, pwd, help) |\n| **Problems** | Auto-scanning lint diagnostics that run on every file change |\n| **Testing** | AI-powered + pattern-based test runner with auto-test on save |\n| **Web Audit** | Lighthouse-style website quality analysis (Performance, Accessibility, SEO, Best Practices) |\n| **Search** | Cross-file search and replace with regex and case-sensitivity toggles |\n\n#### Testing Panel\n\nThe Testing panel provides two modes of analysis:\n\n**AI-Powered Testing** (requires API key):\n- Analyzes the current file for potential bugs, edge cases, and coverage gaps\n- Checks for: null safety, error handling, boundary conditions, type safety,\n security issues, race conditions\n- Returns 5-15 individual test checks with pass/fail/warning status\n\n**Pattern-Based Testing** (no API key required):\n- Detects test files (`.test.`, `.spec.`, `_test.`, `test_` patterns)\n- Counts assertions (`expect()`, `assert()`)\n- Flags TypeScript `any` usage\n- Flags empty catch blocks\n\n**Auto-Test on Save**:\n- Toggle the \"Auto-test on save\" checkbox\n- Every file save automatically triggers a test run\n- Status bar shows \"Auto-test ON\" when enabled\n\n#### Web Audit Panel\n\nThe Web Audit panel provides Google Lighthouse-style website analysis:\n\n**AI-Powered Audit** (requires API key):\n- Scores from 0-100 for: Performance, Accessibility, Best Practices, SEO\n- 15-25 individual checks covering:\n - Page load optimizations\n - Image alt tags and semantic HTML\n - ARIA roles and keyboard navigation\n - Meta tags, viewport, HTTPS\n - CSP headers, font loading\n - Mobile responsiveness\n - Heading hierarchy, link text, form labels\n\n**Pattern-Based Audit** (no API key required):\n- Checks HTML files for viewport meta, title tag, lang attribute, image alt attributes\n\nColor-coded score display:\n- Green (90+): Excellent\n- Yellow (50-89): Needs improvement\n- Red (0-49): Poor\n\n#### Problem Scanner\n\nThe Problems panel automatically scans all open files for:\n\n| Check | Severity | Description |\n|---|---|---|\n| `console.log()` | Warning | Console.log statements left in non-test code |\n| `TODO/FIXME/HACK/XXX` | Info | Task comments that need attention |\n| Lines > 200 chars | Warning | Excessively long lines |\n| `debugger` | Error | Debugger statements left in code |\n| Empty catch blocks | Warning | Error swallowing without handling |\n\n#### Supported Languages\n\nMonaco Editor provides syntax highlighting for:\n\nTypeScript, JavaScript, Python, Rust, JSON, Markdown, HTML, CSS, SCSS, TOML,\nYAML, Shell/Bash, SQL, Go, Java, C, C++, XML, SVG, and plaintext.\n\n#### AI Assistant\n\nThe AI chat panel supports multiple providers:\n\n| Provider | Models |\n|---|---|\n| **OpenAI** | GPT-5 Mini (default), gpt-4o, gpt-4-turbo, gpt-3.5-turbo, etc. |\n| **Anthropic** | Claude models |\n| **Google** | Gemini models |\n| **Custom** | Any OpenAI-compatible endpoint |\n\nThe AI assistant automatically includes the currently open file as context (up to 8,000\ncharacters) when answering questions. All AI features use the shared API keys from Settings.\n\n#### .CryptArt Data Payload (VibeCodeWorker)\n\n```json\n{\n \"rootPath\": \"/path/to/project\",\n \"openFiles\": [\n { \"path\": \"/path/to/file.ts\", \"name\": \"file.ts\" }\n ],\n \"activeFile\": \"/path/to/file.ts\",\n \"model\": \"openai/gpt-5-mini\"\n}\n```\n\n---\n\n### DemoRecorder - DRe\n\n**DemoRecorder** is a screen recording and live streaming tool designed for software\ndemos, gaming clips, and content creation.\n\n#### Features\n\n- **Screen Recording** - Record your entire screen or a specific window with\n configurable resolution and frame rate.\n- **Recording Controls** - Start, Pause, Stop buttons with a live timer display.\n- **Resolution Presets** - 720p, 1080p, 1440p, 4K, or custom resolution.\n- **FPS Options** - 24, 30, 60, or 120 frames per second.\n- **Live Streaming** - Stream to Twitch, YouTube Live, or Google Meet using\n RTMP URL and stream key.\n- **Input Logger Plugin** - Optional plugin that records keyboard and mouse events\n in a structured JSON log, timestamped to video frames. Designed for training AI\n models to replicate human computer interactions.\n **Warning:** This feature logs all keystrokes. A clear warning is shown when enabling.\n- **Integration Links** - Quick links to GiveGigs.com and SiteFari.com for publishing\n and sharing recorded demos.\n\n#### Streaming Targets\n\n| Platform | Connection Method |\n|---|---|\n| **Twitch** | RTMP URL + Stream Key |\n| **YouTube Live** | RTMP URL + Stream Key |\n| **Google Meet** | Meeting URL + Credentials |\n\n#### .CryptArt Data Payload (DemoRecorder)\n\n```json\n{\n \"resolution\": \"1920x1080\",\n \"fps\": 60,\n \"format\": \"mp4\",\n \"streamTargets\": [ ... ],\n \"inputLoggerEnabled\": false,\n \"recordings\": [ ... ]\n}\n```\n\n---\n\n### ValleyNet - VNt\n\n**ValleyNet** is an autonomous AI agent inspired by OpenClaw - the open-source\nself-hosted AI agent that executes real-world tasks via LLMs. ValleyNet brings\nthis concept directly into CryptArtist Studio.\n\n#### Features\n\n- **Natural Language Task Execution** - Type tasks in plain English:\n \"Research competitors and summarize findings\",\n \"Send this file to my Discord channel\",\n \"Book a meeting for Thursday\".\n- **Skills Marketplace** - Browse, install, and manage agent skills. Each skill\n is a directory containing a `SKILL.md` manifest file.\n- **Browser Automation** - An embedded webview that ValleyNet can control to\n browse the web, fill forms, scrape data, and interact with sites.\n- **Service Integrations** - Connect to Discord, Slack, Telegram, WhatsApp,\n Gmail, Google Calendar, and any webhook URL.\n- **Task Memory** - Persistent context that carries across sessions, with a\n full task history and memory log.\n\n#### Supported Integrations\n\n| Service | Connection Method |\n|---|---|\n| **Discord** | Bot token or webhook URL |\n| **Slack** | Bot token or webhook URL |\n| **Telegram** | Bot token |\n| **WhatsApp** | WhatsApp Business API |\n| **Gmail** | OAuth2 or app password |\n| **Google Calendar** | OAuth2 |\n| **Custom Webhook** | Any HTTP endpoint |\n\n#### .CryptArt Data Payload (ValleyNet)\n\n```json\n{\n \"skills\": [ ... ],\n \"taskHistory\": [ ... ],\n \"memory\": { ... },\n \"integrations\": { ... },\n \"browserState\": { ... }\n}\n```\n\n---\n\n### GameStudio - GSt\n\n**GameStudio** is the newest program in the suite. It combines the capabilities of\nMedia Mogul and VibeCodeWorker with Godot 4.6.1 Engine integration to enable AI-powered\ngame development. It features a custom Godot installation finder with file browser support.\n\n#### Features\n\n- **Three-Panel Layout** - Asset editor (Media Mogul), code editor (VibeCodeWorker),\n and Godot Engine side by side in a configurable layout.\n- **Godot 4.6.1 Integration** - Automatically detects Godot 4.6.1 or allows custom path\n selection via file browser. Launch, manage, and interact with Godot projects from\n within CryptArtist Studio.\n- **Custom Godot Path Browser** - If Godot is not found on the system, users can:\n - Download Godot 4.6.1 from the official website\n - Browse for a custom Godot executable path\n - Rescan the system for automatic detection\n - Continue working without Godot (code editing only)\n- **AI Game Generation** - Describe a game concept in natural language and the AI\n will generate GDScript code, scene files, and asset suggestions using GPT-5 Mini.\n- **Project Templates** - Start from pre-built templates for 2D platformers,\n top-down RPGs, puzzle games, and more.\n- **Asset Pipeline** - Use Media Mogul's AI image generation to create sprites,\n textures, and UI elements, then import them directly into Godot.\n- **Video Game Cloner** - Generate completely original games based on the mechanics\n (not lore, art, or copyrighted content) of any existing video game. See below.\n\n#### Video Game Cloner\n\nThe **Video Game Cloner** is a powerful AI-assisted tool inside GameStudio that\ncreates entirely original video games inspired by the *mechanics* of existing games.\nIt uses publicly available information (Wikipedia, wikis, gameplay descriptions) to\nunderstand game mechanics and then generates a fresh, original game with no\ncopyrighted or patented content.\n\n**How It Works:**\n\n1. **Input** - Enter the name of any video game (e.g., \"Tetris\", \"Pac-Man\", \"Portal\")\n2. **Research** - The system fetches the Wikipedia page and all publicly available\n gameplay descriptions, mechanic breakdowns, and genre classifications\n3. **Analyze** - AI extracts the core *mechanics* (movement, scoring, physics, rules)\n while explicitly filtering out all lore, characters, art, music, and trademarks\n4. **Generate (Phase 1: Emoji Graphics)** - On first run, the game is generated with\n emoji-based graphics for instant playability. Emoji sprites, emoji backgrounds,\n emoji UI elements - a fully playable game in minutes\n5. **Generate (Phase 2: AI 3D Graphics)** - AI generates basic 3D models, textures,\n and environments to replace emoji placeholders with original visual assets\n6. **Export** - The finished game is a complete Godot project ready for distribution\n\n**What Gets Cloned:**\n- Core gameplay mechanics (movement, physics, rules, win/loss conditions)\n- Genre conventions (platformer, puzzle, shooter, RPG, etc.)\n- Game design patterns (progression systems, difficulty curves, control schemes)\n- UI/UX paradigms (HUD layout concepts, menu flow patterns)\n\n**What Never Gets Cloned:**\n- Characters, names, or likenesses\n- Story, lore, dialogue, or narrative elements\n- Art assets, sprites, textures, or visual designs\n- Music, sound effects, or audio\n- Patented game mechanics (clearly flagged and avoided)\n- Trademarked terms or branding\n\n**Legal Disclaimer (shown on first run):**\n\n> **IMPORTANT LEGAL NOTICE**\n>\n> The Video Game Cloner is designed for creating original games inspired by\n> publicly available game mechanics. It is optimized for games in the **public\n> domain** but can accept any game name with the following conditions:\n>\n> 1. No copyrighted or patented content is included in generated output\n> 2. Users are solely responsible for the games they produce\n> 3. CryptArtist Studio is not liable for any games generated by this tool\n> 4. We will actively report copyright infringement at our discretion to\n> protect the platform and its community\n> 5. Patent holders and copyright owners may use this tool on their own\n> intellectual property without restriction\n> 6. By using this tool, you agree to the CryptArtist Studio Terms of Service\n>\n> If you are not the rights holder, ensure the game mechanics you are cloning\n> are not covered by active patents. When in doubt, stick to public domain games.\n\n**Emoji Graphics Mode (Phase 1 Output Example):**\n- Player character: a running emoji (e.g., a person, animal, or object)\n- Enemies: threat-themed emojis (skulls, fire, ghosts)\n- Collectibles: gem/star/coin emojis\n- Terrain: earth/tree/water/brick emojis arranged in grid or platformer layouts\n- UI: emoji-based health bars, score counters, and menus\n\n**AI 3D Graphics Mode (Phase 2 Output):**\n- AI-generated low-poly 3D models via text-to-3D\n- Procedural textures and materials\n- Basic lighting and environment setup\n- Original character designs with no resemblance to source material\n\n#### Layout Modes\n\n| Mode | Description |\n|---|---|\n| **Split** | Media + Code side by side (50/50) |\n| **Code Focus** | Full-width code editor with asset sidebar |\n| **Media Focus** | Full-width media editor with code sidebar |\n| **Godot Focus** | Full-width Godot viewport with toolbars |\n\n#### Godot Installation Detection & Management\n\nGameStudio includes a robust Godot installation detection system:\n\n**Automatic Detection:**\n- Scans system PATH for Godot executable\n- Checks common installation directories (Windows, macOS, Linux)\n- Detects Godot version via `--version` command\n- Displays status in terminal and status bar\n\n**Custom Path Selection:**\n- File browser dialog to select custom Godot executable\n- Path validation via `godot_verify_path` backend command\n- Supports .exe, .bin, and .app executables\n- Fallback verification checks file permissions and extension\n\n**Godot Not Found Dialog:**\nWhen Godot is not detected, users can:\n1. **π₯ Download Godot 4.6.1** - Opens official Godot download page\n2. **π Browse for Godot .exe** - Opens file browser for custom path selection\n3. **π Rescan System** - Re-runs automatic detection\n4. **Continue Without Godot** - Closes dialog and allows code editing only\n\n#### .CryptArt Data Payload (GameStudio)\n\n```json\n{\n \"godotProjectPath\": \"/path/to/project.godot\",\n \"godotCustomPath\": \"/custom/path/to/godot.exe\",\n \"layout\": \"split\",\n \"mediaState\": { ... },\n \"codeState\": { ... },\n \"godotState\": { ... },\n \"aiConversation\": [ ... ]\n}\n```\n\n---\n\n### CryptArt Commander - CAC\n\n**CryptArt Commander** (CAC) is a terminal-based command center that provides full\ncontrol over CryptArtist Studio through a command-line interface, REST API integration,\nand scripting capabilities. It is designed for power users, automation, and AI agent\nintegration.\n\n#### Terminal Interface\n\nThe Commander presents a full-screen terminal with a command prompt, scrollable output\nhistory, and syntax-highlighted results. It includes tab completion, command aliases,\nenvironment variables, and arrow-key history navigation.\n\n#### Built-In Commands\n\n| Command | Description |\n|---|---|\n| `help` | Show all available commands |\n| `clear` | Clear the terminal output |\n| `version` | Show CryptArtist Studio and Commander version |\n| `sysinfo` | Display system information (OS, arch, FFmpeg, Godot) |\n| `health` | Run a health check on the application |\n| `keys status` | Check which API keys are configured |\n| `keys export` | Export all API keys to JSON |\n| `ffmpeg status` | Check if FFmpeg is installed |\n| `ffmpeg install` | Install FFmpeg automatically |\n| `godot detect` | Detect Godot engine installation |\n| `ls ` | List directory contents with sizes |\n| `cat ` | Read and display a file's contents |\n| `write ` | Write content to a file |\n| `chat ` | Send a prompt to OpenAI |\n| `or ` | Send a prompt to OpenRouter (200+ models) |\n| `or models` | List available OpenRouter models |\n| `pexels ` | Search Pexels for stock media |\n| `generate ` | Generate an AI image via DALL-E |\n| `tts ` | Convert text to speech |\n| `project` | Show current project state |\n| `programs` | List all programs in the suite |\n| `run