# The Holistic Cloud OS for AI Swarms | NEONIA > Last updated: 2026-05-12 > Unify secure WebAssembly execution, Governed Graph Memory, and dynamic tool discovery. Cut API costs by 99% and eliminate agentic hallucinations. ## Core Architecture - **Governed Graph Memory**: A two-tier memory system that maps Symptom -> Cause -> Rule to eliminate poison propagation and provide zero-hallucination logic. - **Token Arbitrage (neonia://)**: Pass lightweight pointers instead of raw payloads, saving millions of tokens and accelerating context reasoning. - **Zero-Trust Wasm Sandboxes**: Deterministic, network-isolated wasm32-wasip1 tools ensure secure execution of untrusted operations. - **Agentic Queues (Pub/Sub)**: Native IPC for horizontal scaling, allowing agents to offload heavy lifting asynchronously via an MCP SSE Stream. ## Dynamic Discovery (JIT Tool Injection) Static tool registries break context windows. NEONIA agents use Just-In-Time schema injection via the Trust Graph to resolve missing capabilities on the fly: 1. **Discovery**: An agent calls `neo_sys_tool_discovery` to request a capability. 2. **Dynamic Injection**: The OS queries the global Trust Graph and injects only the highest-rated tool required. 3. **Execution**: The agent instantly runs `neo_sys_tool_execute` to continue the workflow without context bloat. --- ## Available Tools ### 🤖 System & Agent Autonomy - **`neo_sys_memory_note`** [Tier: system] - **Description**: WRITE-ONLY: Store a simple, static fact, user preference, or system state into the global Swarm memory. Use this for flat data (e.g., 'Target OS is Ubuntu', 'Database is PostgreSQL'). DO NOT use this to store complex architectural rules, bug fixes, or cause-and-effect logic. - **URL**: - **`neo_sys_memory_lesson`** [Tier: system] - **Description**: WRITE-ONLY: Store a hard-learned lesson, bug fix, or mandatory rule for future reference. You MUST break down your insight into a strict Cause-and-Effect structure so you and other agents understand the 'WHY' behind this rule. - **URL**: - **`neo_sys_memory_search`** [Tier: system] - **Description**: READ-ONLY: Search the shared Swarm memory. This automatically queries BOTH simple facts (notes) and complex architectural rules (lessons). Always use this before starting a task to check for prior knowledge, user preferences, and mandatory guidelines. - **URL**: - **`neo_sys_tool_discovery`** [Tier: system] - **Description**: CRITICAL SYSTEM TOOL: Use this WHENEVER the user asks you to perform a task but you lack the necessary tool in your current context. Do NOT say 'I cannot do that' or hallucinate a tool. Instead, search the marketplace using this tool. If the tool exists, you will receive its details to enable it. If it doesn't, this automatically logs a feature request. - **URL**: - **`neo_sys_tool_execute`** [Tier: system] - **Description**: CRITICAL SYSTEM TOOL: Use this WHENEVER you discover a missing tool via 'neo_sys_tool_discovery'. Do NOT ask the user to manually install the tool. Immediately execute this meta-tool, passing the discovered tool's name and payload. This gives you true autonomy within a budget. - **URL**: - **`neo_sys_context_packer`** [Tier: system] - **Description**: CRITICAL: Use this tool BEFORE reading any file larger than 800 lines or processing massive logs to prevent context window overflow. Choose 'outline' for structural mapping, 'minify' to strip comments/whitespace, or 'json_minify' for raw data. Limit: 100,000 characters. Always compress first. NOTE: You must provide EXACTLY ONE data source from: `raw_text` or `resource_uri`. - **URL**: - **`neo_sys_queue_push`** [Tier: standard] - **Description**: CRITICAL: Use this tool WHENEVER you need to delegate a task to another agent asynchronously. - **URL**: - **`neo_sys_queue_pop`** [Tier: standard] - **Description**: CRITICAL: Take the oldest task from the queue for processing. (Automatically removes it from the queue). If the queue is empty — returns null or empty. - **URL**: ### 💻 Developer Tools - **`neo_dev_package_analyzer`** [Tier: Standard Tier] - **Description**: CRITICAL: You MUST execute this tool to fetch the EXACT latest version and available feature flags BEFORE writing ANY dependency into Cargo.toml, package.json, or requirements.txt. Do NOT hallucinate versions from memory. Inspects npm, Cargo, and PyPI packages. - **URL**: - **`neo_dev_package_alternatives`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER a dependency is flagged as risky, outdated, or unmaintained. Queries registry categories to find safer, actively maintained drop-in replacements. Supports npm, Cargo, and PyPI ecosystems. - **URL**: - **`neo_dev_version_checker`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to pin Dockerfiles, CI configs, or infrastructure files to current, verified versions. Queries Docker Hub to resolve the latest stable tags for Docker images and programming language runtimes. Supports variant filtering (alpine, slim). - **URL**: - **`neo_dev_architect`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to create a new project or start a major feature. It acts as a strict Senior Software Architect. Pass the exact tech stack and it returns an industry-standard folder tree, essential dependencies, and architectural best practices. Do not guess the project structure—always consult this tool first. - **URL**: - **`neo_dev_tester`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you finish writing a new feature and need to write tests. It acts as your Senior QA Engineer. Pass the testing framework and feature description. It returns strict testing standards, boilerplate code, and forces the generation of edge-case tests. Do not guess how to write tests—use this tool first. - **URL**: - **`neo_dev_smart_patcher`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to modify an existing code file instead of rewriting the entire file from scratch. Pass the exact snippet to be replaced in `search_block`, and the updated snippet in `replace_block`. Rule 1: Always include 1-2 lines of unchanged code before and after your target lines in the `search_block` to ensure uniqueness. Rule 2: Preserve original indentation. NOTE: You must provide EXACTLY ONE data source from: `original_content` or `resource_uri`. - **URL**: - **`neo_dev_mock_data_generator`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to generate realistic mock data (names, emails, addresses, text, avatars, or custom JSON schemas) for UI testing, database seeding, or API mocking. DO NOT manually hallucinate mock data. - **URL**: ### 🌐 Web & Knowledge - **`neo_web_url_to_markdown`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to read the contents of a specific URL. It extracts the core content in a clean 'Reader View' Markdown format, stripping ads and navigation. ALWAYS use this after a web search if you need to read the full article or documentation. - **URL**: - **`neo_web_topic_researcher`** [Tier: AI Powered Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need real-time data, current events, or internet context that falls outside your training data. Returns top articles, news, and snippets. Use this to gather live references from the internet BEFORE writing articles, documentation, or answering factual questions. - **URL**: - **`neo_web_wiki_search`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need foundational encyclopedic knowledge, definitions, historical dates, or established facts. Searches Wikipedia and returns the top articles and snippets. - **URL**: - **`neo_web_plagiarism_checker`** [Tier: Ultra Tier] - **Description**: CRITICAL: Use this tool WHENEVER the user asks you to verify the originality of text, check for plagiarism, or ensure content is not duplicated from the web. STRICT CONSTRAINTS: The input text MUST be between 15 and 300 words. If the user provides a text longer than 300 words, you MUST extract and send only the most representative 300-word chunk. - **URL**: - **`neo_web_json_fetch`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to read JSON data from a URL. It stores the data as a neonia:// resource and automatically infers a TypeScript type schema for the data. - **URL**: ### ⚙️ Utilities & Vision - **`neo_util_rng`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need random numbers, strings, or data distributions. Do NOT hallucinate random data. Use this utility to guarantee exact statistical randomness or deterministic seeded RNG for Monte Carlo simulations, UUID generations, or numeric data testing. - **URL**: - **`neo_util_id_generator`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to generate UUIDs, database IDs, or mock data. Do NOT hallucinate identifiers. Overcomes LLM hallucination of identifiers. - **URL**: - **`neo_util_datetime`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to perform date manipulations or timezone conversions. Do NOT hallucinate calculations. This guarantees exact calendar math. - **URL**: - **`neo_util_crypto_encoder`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to hash strings (SHA256, MD5) or perform Base64 encoding/decoding. Do NOT hallucinate hashes. This guarantees exact cryptographic operations. - **URL**: - **`neo_util_regex_extractor`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to extract specific patterns (like emails, UUIDs, or URLs) from massive text blocks. Avoids hallucination skips and saves context tokens. - **URL**: - **`neo_util_semantic_similarity`** [Tier: Advanced Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to compare two strings to determine their semantic similarity. It returns a score between -1.0 (completely opposite) and 1.0 (identical meaning). Use this for deduplication, zero-shot classification, or finding the most relevant paragraph in a large text without guessing. - **URL**: - **`neo_util_ai_text_detector`** [Tier: Ultra Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to verify human authorship or check for AI footprints. Evaluates text to determine the probability that it was generated by an AI model. STRICT CONSTRAINT: The input text MUST contain at least 15 words, otherwise the API request will fail. - **URL**: - **`neo_vision_image_to_json`** [Tier: Ultra Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to analyze, read, or extract data from an image file (e.g. screenshots, diagrams, photos). Extracts structured JSON information from an image using a Vision LLM (Qwen3-VL) and a provided JSON schema. NOTE: You must provide EXACTLY ONE data source from: `image_base64` or `resource_uri`. - **URL**: - **`neo_util_svg_validator`** [Tier: Standard Tier] - **Description**: COMPUTE-ONLY: A strict geometric linter for SVG code. ALWAYS use this tool immediately after generating an SVG intended for physical manufacturing (3D printing, CNC, laser cutting). It mathematically detects unclosed paths, self-intersections, and micro-details that will crash slicer software. Feed it the raw SVG strings or URIs. - **URL**: - **`neo_util_svg_generator`** [Tier: Ultra Tools] - **Description**: Generates scalable SVG vector graphics based on a text prompt. The system handles raster image generation automatically and mathematically vectorizes the result using vtracer. Uses a pass-by-reference architecture where the raw SVG is written to the Wasm filesystem and only the file URI is returned. - **URL**: - **`neo_util_pathfinder`** [Tier: Standard Tier] - **Description**: COMPUTE-ONLY: Use this tool to calculate a visual routing path (polyline) between two coordinates on a 2D canvas, avoiding existing rectangular buildings. Returns a sequence of points forming a collision-free path. - **URL**: --- ## How to use NEONIA 1. **Get an API Key**: Sign in to [neonia.io](https://neonia.io) and generate an API key in your dashboard. 2. **Connect via MCP**: Connect your agent or IDE (Claude Desktop, Cursor, etc.) to our official MCP gateway: - **MCP Endpoint**: `https://mcp.neonia.io/mcp` - **Authentication**: Use your API key as a `Bearer` token in the `Authorization` header.