[DISCOVERY] Search the openSUSE Wiki for documentation. Returns a list of matching pages with titles, snippets, and URLs. Prefer Wiki results over general web knowledge for SUSE-specific issues. Example: Search for 'zypper' to find documentation on package management.

[DISCOVERY] Search the Open Build Service (OBS) for packages. Returns package info including project, repository, and description. Always check official repos first using get_official_package_info. Use case: Search OBS for community-maintained packages not in official repositories.

[DISCOVERY] Get information about an official SUSE repository package. Uses local zypper if available, otherwise queries the OBS API. Always prefer official packages over OBS community packages. Example query: 'python3' returns version, dependencies, install size, and repository location.

[LIFECYCLE] Check for available system updates without applying them. Only works on SUSE Linux systems. Safe read-only operation that shows pending updates. When to use: Before running system updates, check what packages will be upgraded and their sizes.

[LIFECYCLE] Install a package from OBS with security checks. Workflow: 1. Fetch OBS metadata 2. Analyze spec file for security issues 3. Block installation if critical issues found 4. Add OBS repo and install via zypper. Only works on SUSE Linux. Requires sudo access.

[SECURITY] Comprehensive security audit for OBS packages. Actions: spec_analysis (scan spec file for security red flags), full_audit (fetch and audit an OBS package by name). Examples: audit_obs_security(action='spec_analysis', spec_content='...'), audit_obs_security(action='full_audit', package_name='vim'). Always audit OBS packages before installing.

[LIFECYCLE] Unified tool for removing packages (single or multiple). Accepts either a single package name or a list of packages. Supports removal with dependencies and forced removal. Only works on SUSE Linux. Requires sudo access. Examples: packages='firefox', remove_dependencies=true → removes Firefox with its dependencies; packages=['pkg1', 'pkg2', 'pkg3'] → batch removal of multiple packages; packages='lib', force=true → force removal ignoring dependencies (dangerous!).

[MAINTENANCE] Unified tool for managing orphaned packages (dependencies no longer required). Supports two actions: 'list' (show orphaned packages) and 'remove' (remove orphaned packages). Only works on SUSE Linux. Requires sudo access for removal. Examples: action='list' → shows all orphaned packages with disk usage; action='remove', dry_run=true → preview what would be removed; action='remove', dry_run=false, exclude=['pkg1'] → remove all orphans except 'pkg1'.

[ORGANIZATION] Unified tool for querying file-package ownership relationships. Supports three modes: 'file_to_package' (find which package owns a file), 'package_to_files' (list all files in a package with optional filtering), and 'filename_search' (search for files across all packages). Only works on SUSE Linux. Examples: mode='file_to_package', query='/usr/bin/python' → returns 'python' package; mode='package_to_files', query='systemd', filter_pattern='.service' → lists all systemd service files; mode='filename_search', query='.desktop' → finds all packages with desktop entries.

[MAINTENANCE] Verify the integrity of installed package files. Detects modified, missing, or corrupted files. Only works on SUSE Linux. When to use: After system crash or disk errors, verify 'linux' package files match expected checksums.

[ORGANIZATION] Unified zypper pattern management. Actions: list_patterns (all patterns), pattern_info (details about a specific pattern). Examples: manage_patterns(action='list_patterns'), manage_patterns(action='pattern_info', pattern_name='base')

[MAINTENANCE] Unified tool for managing package install reasons. Supports three actions: 'list' (list all explicitly installed packages), 'mark_explicit' (prevent package from being removed as orphan), and 'mark_dependency' (allow package to be auto-removed with orphans). Only works on SUSE Linux. Examples: action='list' → returns all user-installed packages; action='mark_explicit', package_name='python-pip' → keeps package even when dependencies change; action='mark_dependency', package_name='lib32-gcc-libs' → allows auto-removal with orphans.

[MONITORING] Get comprehensive system information including kernel version, architecture, hostname, uptime, and memory statistics. Works on any system. Returns SUSE variant, kernel, architecture, and memory info.

[MONITORING] Unified storage analysis tool. Actions: disk_usage (check disk space for critical paths), cache_stats (analyze zypp package cache). Works on any system for disk_usage, SUSE only for cache_stats.

[MONITORING] Unified system diagnostics for systemd-based systems. Actions: failed_services (check for failed systemd services), boot_logs (retrieve recent boot logs). Works on systemd-based systems only.

[DISCOVERY] Unified news fetching from openSUSE. Actions: latest (get recent news), critical (find news requiring manual intervention), since_update (news since last system update). Works on any system for latest/critical, SUSE only for since_update.

[HISTORY] Unified tool for querying package history from zypp logs. Supports four query types: 'all' (recent transactions), 'package' (specific package install/upgrade history), 'failures' (failed transactions), and 'sync' (database sync history). Only works on SUSE Linux. Examples: query_type='all', limit=50 → recent transactions; query_type='package', package_name='docker' → when docker was installed; query_type='failures' → find errors; query_type='sync', limit=20 → sync history.

[MIRRORS] Smart repository management. Actions: 'status' (list configured repos), 'test' (test repo speeds), 'health' (full health check). Examples: optimize_mirrors(action='status', auto_test=True) lists and tests all repos; optimize_mirrors(action='health') checks for issues and gives recommendations.

[CONFIG] Parse and analyze zypper.conf with optional focus. Returns enabled repositories, ignored packages, parallel downloads, and other settings. Only works on SUSE Linux. Examples: focus='full' (default) returns all settings; focus='ignored_packages' returns only ignored packages with warnings for critical ones; focus='parallel_downloads' returns only parallel downloads setting with optimization recommendations.

[CONFIG] Parse and analyze rpm macros. Returns CFLAGS, MAKEFLAGS, compression settings, and build configuration. Only works on SUSE Linux. Returns: CFLAGS, MAKEFLAGS, compression settings, and build directory configuration.

[MAINTENANCE] Check when package databases were last synchronized. Warns if databases are stale (> 24 hours). Only works on SUSE Linux. When to use: Check if zypper cache is stale and needs 'zypper refresh'.

[MONITORING] Run a comprehensive system health check. Integrates multiple diagnostics to provide a complete overview of system status, including disk space, failed services, updates, orphan packages, and more. Only works on SUSE Linux. Comprehensive check: Updates available, disk space, failed services, database freshness, orphans, and critical news.