{ "platform": "VOSCOM.ONLINE", "version": "2.1", "purpose": "Public instructions for external AI/LLM agents.", "agent_mode": "user_pet", "quick_start": [ "/llms.txt", "/agent_manifest.txt", "/agent_ide_context.txt", "/agent_ide_map.txt", "/agent_context.txt", "/agent_quick_test.txt", "/agent_api_reference.txt" ], "php_api_fallbacks": [ "/agent_manifest.php", "/agent_ide_context.php", "/agent_ide_map.php", "/agent_context.php", "/agent_quick_test.php", "/agent_api_reference.php" ], "private_ide_requires_human_login": true, "mvp_status": "Demo/MVP. Some functions are real, some are demo/stubbed, and real hardware work must be reviewed by the human.", "public_site_layers": [ "public_website", "public_ai_helper_voscom_ai_forge_before_registration", "demo_ide_preview_read_only", "private_browser_ide_after_human_login", "agent_api_for_user_controlled_ai", "manual_relay_for_chat_ai_without_api_access" ], "public_ai_helper": { "name": "Public AI Helper / VOSCOM AI FORGE", "available_before_registration": true, "summary": "A public website AI widget that can explain the platform, MWOS, IDE, public pages, projects, components, task exchange, marketplace, currencies, pricing/support, and help formulate a project idea.", "limits": "Consultative only before login. It has no access to private projects, balances, build artifacts, hardware ports, admin data, or protected actions." }, "demo_ide_preview": { "available_before_normal_registration": true, "mode": "read_only", "summary": "A DEMO IDE preview lets visitors inspect tabs and tools before creating a real account.", "blocked_or_limited_actions": [ "create", "save", "send", "build", "publish", "flash", "private_account_work" ], "guidance": "Suggest DEMO for orientation. For real project work, registration/login is still required." }, "public_project_subdomains": [ { "name": "CNC.VOSCOM.ONLINE", "url": "https://cnc.voscom.online/", "demo_url": "https://cnc.voscom.online/mwos/sci-fi-cnc-js/", "purpose": "CNC machine retrofit and Web-HMI/MWOS control platform." }, { "name": "STL.VOSCOM.ONLINE", "url": "https://stl.voscom.online/", "purpose": "STL-VS industrial radio modem for fuel-station price-display communication." } ], "capabilities": [ "read_public_context", "read_ide_layer_catalog", "read_detailed_ide_map", "use_ide_window_i_menu_references_shared_by_human", "read_legal_text_documents", "prepare_pairing_request", "help_fill_engineering_project_card", "prepare_mwos_project_draft", "explain_validation_and_build_logs", "create_pending_action_requests_after_pairing", "list_firmware_artifacts_after_authorization", "guide_human_manual_firmware_download_or_flashing" ], "engineering_project_card": { "summary": "The private IDE Project tab contains an engineering Project Card that captures planning data before firmware generation.", "purpose": "Move from toy-like firmware generation to real engineering planning: stage, domain, requirements, constraints, hardware, interfaces, faults, diagnostics, security, and growth.", "location": "IDE -> Project -> Project Card", "stored_project_fields": [ "project_stage", "project_domain" ], "stage_values": [ "training_or_test", "experiment", "prototype", "pilot", "industrial_product", "critical_or_regulated_system", "unknown" ], "agent_guidance": "Before proposing build/code/MML for a vague idea, help the human fill or review the Project Card. For pilot, industrial, or critical stages, ask stricter questions about safety, fault handling, diagnostics, validation, and maintenance." }, "human_confirmation_required_for": [ "email_confirmation", "legal_terms", "pairing", "project_writes", "validation_requests", "build_requests", "firmware_flashing", "content_publication" ], "forbidden_actions": [ "accept_legal_terms_for_human", "ask_for_passwords_cookies_sessions_or_bearer_tokens", "enter_private_ide_pages_directly", "write_or_publish_content_directly", "flash_hardware_directly", "access_database_shell_filesystem_or_admin_areas" ], "manual_relay_mode": { "recommended_when_ai_cannot_call_api": true, "do_not_paste_tokens_into_chat": true, "human_exports_context_from_ide_ai_agent_tab": true, "ai_returns_one_json_command": true, "human_imports_and_approves_or_rejects": true }, "ai_connection_modes": { "site_voscom_ai_forge": { "billing": "paid_with_internal_flux", "summary": "Built-in VOSCOM AI FORGE route using platform AI resources." }, "user_api_token": { "billing": "not_charged_by_voscom_internal_flux_for_ai_request", "summary": "The human uses their own external provider API token. External provider costs, if any, belong to that user account." }, "personal_browser_voscom_ai_forge": { "billing": "not_charged_by_voscom_internal_flux_for_ai_request", "summary": "The human runs a local helper using their own browser session." } }, "earning_platform_resources": { "primary_route": "Task Exchange / economy tab", "summary": "If the human asks how to earn VOSCOM internal resources, point them to the Task Exchange first. Users can accept paid quests from administrators or other users, complete them, submit a result/report, and receive the reward after customer acceptance.", "live_db_rag_provider": "economy_tasks", "confirmation_block": "economy_task_take", "suggest_filters": [ "user_level", "skills", "currency", "reward", "task_type", "deadline", "status", "requirements" ] }, "ide_window_information_menus": { "feature_name": "IDE window i menu / UI passport", "summary": "Many private IDE windows, side panels, widgets, and settings screens have a small i menu with a human-readable description and feedback actions.", "stable_ui_element_codes": "UI passports use stable codes such as VUI-TAB-005, VUI-SIDE-018, VUI-PROJ-003, VUI-SET-006.", "human_can": [ "read_what_the_window_is_for", "copy_stable_ui_element_number", "copy_direct_link_or_technical_context", "report_bug_to_voscom_support", "suggest_improvement", "ask_built_in_voscom_ai_about_this_window" ], "external_agent_guidance": "If the human asks about a specific IDE area, ask them to open the i menu on that window and share the UI element number or copied context. Treat the code as a precise reference to the IDE location. Do not enter the private IDE directly." }, "important_links": { "llms_text": "/llms.txt", "manifest_text": "/agent_manifest.txt", "agent_context_text": "/agent_context.txt", "ide_context_text": "/agent_ide_context.txt", "ide_map_text": "/agent_ide_map.txt", "quick_test_text": "/agent_quick_test.txt", "api_reference_text": "/agent_api_reference.txt", "manifest_api": "/agent_manifest.php", "agent_context_api": "/agent_context.php", "ide_context_api": "/agent_ide_context.php", "ide_map_api": "/agent_ide_map.php", "legal_index": "/legal_index.php?lang=en", "legal_text_index": "/legal_text.php?lang=en" }, "markdown_url": "/llms.php", "text_url": "/llms.txt" }