{
    "platform": "VOSCOM.ONLINE",
    "product_name": "User-controlled AI Agent",
    "agent_mode": "user_pet",
    "version": "0.2.1",
    "supported_modes": {
        "direct_api": {
            "description": "For agents that can call HTTPS APIs with Authorization: Bearer token.",
            "requires_bearer_token": true
        },
        "manual_relay": {
            "description": "For chat AI systems without direct API access. Human exports context from IDE, AI returns JSON command, human imports it back.",
            "requires_bearer_token": false,
            "ide_tab": "ai_pet"
        }
    },
    "onboarding": {
        "role_page": "/index.php?page=ai",
        "text_context_urls": [
            "/llms.txt",
            "/agent_manifest.txt",
            "/agent_context.txt",
            "/agent_ide_context.txt",
            "/agent_ide_map.txt",
            "/agent_api_reference.txt",
            "/agent_quick_test.txt"
        ],
        "context_url": "/agent_context.php",
        "ide_layer_context_url": "/agent_ide_context.php",
        "ide_detailed_map_url": "/agent_ide_map.php",
        "mwos_module_catalog_url": "/mwos_module_catalog.php",
        "mwos_module_catalog_project_slice_url_template": "/mwos_module_catalog.php?modules=MWOSKey,MWOSNetWiFi",
        "quick_test_url": "/agent_quick_test.php",
        "api_reference_url": "/agent_api_reference.php",
        "llms_url": "/llms.php",
        "llms_json_url": "/llms.php?format=json",
        "llms_text_url": "/llms.txt",
        "pairing_manifest_url": "/agent_pair_api.php?action=manifest",
        "pairing_endpoint": "/agent_pair_api.php",
        "human_confirmation_required": true,
        "legal_terms_must_be_accepted_by_human": true
    },
    "for_external_ai": {
        "start": {
            "read_llms_text": "/llms.txt",
            "read_manifest_text": "/agent_manifest.txt",
            "read_context_text": "/agent_context.txt",
            "read_ide_layer_context_text": "/agent_ide_context.txt",
            "read_detailed_ide_map_text": "/agent_ide_map.txt",
            "for_specific_ide_window_ask_human_for_i_menu_code_or_context": "When discussing a specific private IDE window, ask the human to open its small i menu and share the stable UI code or copied context.",
            "read_mwos_module_catalog_for_current_project_only": "/mwos_module_catalog.php?modules=MWOSKey,MWOSNetWiFi",
            "avoid_full_mwos_catalog_unless_needed": "The full module catalog can be large. For firmware work, request only modules used in the current project via ?modules=ClassA,ClassB.",
            "read_quick_test_text": "/agent_quick_test.txt",
            "read_api_reference_text": "/agent_api_reference.txt",
            "api_manifest_fallback": "/agent_manifest.php",
            "api_context_fallback": "/agent_context.php",
            "api_ide_layer_context_fallback": "/agent_ide_context.php",
            "api_ide_detailed_map_fallback": "/agent_ide_map.php",
            "read_pairing_rules": "/agent_pair_api.php?action=manifest"
        },
        "tell_human": [
            "register_or_login_as_human_user",
            "confirm_email_and_legal_terms_personally",
            "confirm_pairing_in_ide_tab_ai_agent",
            "if_you_cannot_call_api_use_manual_relay_in_ide",
            "approve_or_reject_each_pending_action",
            "flash_device_manually_or_download_firmware_artifact"
        ]
    },
    "api": {
        "agent_endpoint": "/agent_api.php",
        "auth": "Authorization: Bearer <agent_token>"
    },
    "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_context",
        "read_user_settings_context",
        "prepare_registration",
        "create_project_draft",
        "validate_project",
        "request_build",
        "list_firmware_artifacts",
        "read_ide_layer_catalog",
        "use_ide_window_i_menu_references_shared_by_human",
        "read_legal_text_documents",
        "read_public_project_info",
        "manual_relay_import_export",
        "explain_build_logs",
        "guide_manual_firmware_flashing"
    ],
    "dangerous_actions_require_user_confirmation": true,
    "settings_context": {
        "ide_settings_require_human_login": true,
        "ai_generation_modes": [
            "voscom_ai_forge_flux",
            "custom_user_provider_token"
        ],
        "custom_ai_providers_mvp": [
            "openai_compatible",
            "openrouter",
            "google_gemini",
            "anthropic_claude"
        ],
        "workspace_customization": [
            "appearance_theme_and_language",
            "profile_personalization",
            "side_panels",
            "tabs",
            "widgets",
            "panel_widths"
        ],
        "agent_guidance": "If the human cannot find a feature or AI generation fails, suggest checking IDE Settings, AI Settings, and tab/panel visibility."
    },
    "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."
    },
    "v1_limits": {
        "read_requests_per_hour": 60,
        "pending_action_requests_per_day": 10,
        "build_requests_per_day": 3,
        "max_payload_bytes": 65536,
        "max_open_pending_requests": 10,
        "max_open_build_requests": 1,
        "max_active_agents_per_owner": 3,
        "writes_require_owner_confirmation": true
    },
    "forbidden_in_v1": [
        "direct_database_access",
        "shell_access",
        "direct_terminal_access",
        "webserial_flashing",
        "project_delete",
        "publish_news",
        "publish_project_info",
        "create_market_product",
        "send_chat_message"
    ]
}