{"mcpVersion":"2025-03-26","name":"holoscript-mcp","version":"8.0.9","description":"HoloScript language tooling — parse, validate, compile, and render .hs/.hsplus/.holo compositions across 27 backend targets.","transport":{"type":"streamable-http","url":"https://mcp.holoscript.net/mcp","authentication":{"type":"oauth2","flows":["authorization_code","client_credentials"],"authorizationEndpoint":"https://mcp.holoscript.net/oauth/authorize","tokenEndpoint":"https://mcp.holoscript.net/oauth/token","registrationEndpoint":"https://mcp.holoscript.net/oauth/register","introspectionEndpoint":"https://mcp.holoscript.net/oauth/introspect","scopes":["tools:read","tools:execute","tasks:read","tasks:write","admin"],"legacyScopes":["tools:read","tools:write","tools:codebase","tools:browser","tools:admin","a2a:tasks","scenes:read","scenes:write","admin:*"],"legacyBearerSupported":true}},"capabilities":{"tools":{"count":408},"resources":{"count":0},"prompts":false},"categories":[["Utility",206],["Compilation & Export",60],["Training Data",31],["Absorb Service",14],["IDE / LSP",9],["Codebase Intelligence",9],["Traits",7],["Code Generation",7],["Graph Analysis",6],["Documentation",5],["Rendering & Sharing",5],["Agent Orchestration",5],["Parsing & Validation",4],["AI Assistant",4],["File Operations",4],["Quality & Testing",4],["Temporal Snapshots",4],["Semantic Search",3],["Browser Control",3],["Testing",3],["Format Conversion",2],["Knowledge & Patterns",2],["Service Contracts",2],["Monitoring",2],["Networking",2],["Refactoring",2],["receipts",2],["glTF Import/Export",1]],"tools":[{"name":"parse_hs","description":"Parse HoloScript (.hs) or HoloScript Plus (.hsplus) code into an AST. Use for understanding structure of existing code.","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"parse_holo","description":"Parse a .holo composition file into an AST. Use for scene-centric declarative files with compositions.","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"parse_pipeline","description":"Parse a .hs pipeline definition into a structured pipeline AST (sources, transforms, filters, sinks).","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"compile_pipeline","description":"Compile a .hs pipeline into a runnable Node.js ESM module (index.mjs).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"validate_holoscript","description":"Validate HoloScript code for syntax errors, unknown traits, and best practices. Returns AI-friendly error messages with suggestions.","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"list_traits","description":"List traits available in HoloScript. Category slugs match packages/core/src/traits/constants/*.ts (basename without .ts). Legacy short names (interaction, physics, …) still work. Use category=all for full list plus categorySlugs.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"explain_trait","description":"Get detailed documentation for a specific trait including parameters and example usage.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"suggest_traits","description":"Suggest appropriate VR traits for an object based on its description. For browsing by category, use list_traits (slugs align with packages/core/src/traits/constants).","category":"Traits","tags":["traits","spatial","vr"]},{"name":"suggest_universal_traits","description":"Suggest v6 universal platform traits for a service or infrastructure component. Covers 8 domains: service, contract, data, network, pipeline, metric, container, resilience.","category":"Traits","tags":["traits","universal","service","infrastructure"]},{"name":"suggest_2d_traits","description":"Suggest Semantic2D traits for a 2D UI element based on its description.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"generate_object","description":"Generate a HoloScript object definition from a natural language description.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"generate_scene","description":"Generate a complete .holo scene composition from a natural language description.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"generate_semantic_ui","description":"Generate a V6 Semantic2D UI composition from a natural language description.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"get_syntax_reference","description":"Get syntax documentation for a specific HoloScript construct.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"get_examples","description":"Browse or fetch HoloScript examples. Omit `pattern` (or pass \"list\") to browse the full audited repo catalog + inventory (counts by format/category, real example paths with parser status, link to examples/INDEX.md). Pass a slug (\"interactive-object\"), a repo path (\"examples/physics/...\"), or a keyword (\"physics\", \"robot\", \"teleport\") to fetch a specific example — inline patterns return runnable code, catalog entries return the repo path + status.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"explain_code","description":"Get a plain English explanation of what HoloScript code does.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"analyze_code","description":"Analyze HoloScript code for complexity, performance, and best practices.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"render_preview","description":"Generate a preview of a HoloScript scene. When HOLOSCRIPT_RENDER_URL is configured returns a real image URL (png/gif/mp4/webp). Without it, returns a playground link you can open in a browser — no static image is produced locally.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"create_share_link","description":"Create a shareable link for HoloScript code. When HOLOSCRIPT_RENDER_URL is configured, returns full social preview metadata (QR code, Twitter card). Without it, returns a playground URL with the code embedded. Useful for X posts.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"convert_format","description":"Convert HoloScript code between formats (.hs, .hsplus, .holo).","category":"Format Conversion","tags":["conversion","transformation","editing"]},{"name":"holo_parse_to_graph","description":"Parse a .holo file and return its graph representation. This helps you understand the visual structure:\n- **Nodes**: All objects, templates, orbs, NPCs, etc.\n- **Edges**: Connections between nodes (uses, triggers, contains)\n- **Flows**: Event-to-action chains (what happens when X occurs)\n- **Groups**: Spatial groupings of nodes\n\nUse this to \"see\" the architecture before modifying code.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_semantic_scene_graph","description":"Parse a .holo file and return its W3C-compliant JSON-LD Semantic Scene Graph representation.\nThis leverages the new Pillar 2 Architectural Semantic Understanding.\nOutput is suitable for Linked Data / Knowledge Graph ingestion, SEO-optimized 3D indexing, and AI reasoning.","category":"Semantic Search","tags":["search","rag","knowledge"]},{"name":"holo_visualize_flow","description":"Visualize the event/action flow in a .holo file as ASCII diagram. Returns something like:\n```\n[User] ──wave──→ [Goblin_A] ──throw_rock()──→ [Rock] ──hit──→ [User]\n                     ↓\n               [Goblin_B] ──throw_rock()──→ [Rock]\n```\nThis helps you understand the control flow and data flow in the scene.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_get_node_connections","description":"Get all connections for a specific node in a .holo file. Returns:\n- What this node **receives** (incoming events/triggers)\n- What this node **sends** (outgoing actions/events)\n- What **contains** this node (parent groups)\n- What this node **contains** (children)\n- What **template** this node uses","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_design_graph","description":"Given a natural language description, design the graph structure BEFORE writing code. Returns:\n- Suggested nodes and their types\n- Connections between nodes\n- Event flows\n- Recommended spatial groupings\n\nUse this to plan your .holo file as a visual architecture first.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_diff_graphs","description":"Compare two .holo files as graphs and show what changed:\n- Added/removed nodes\n- Changed connections\n- Modified flows\n- New/removed groups\n\nHelps understand the impact of changes.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_suggest_connections","description":"Given existing nodes in a .holo file, suggest potential connections and flows you might want to add. For example:\n- \"Player and Enemy exist but have no interaction - add combat flow?\"\n- \"Collectibles exist but no collection event - add on_interact?\"","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_generate_semantic_scene_graph","description":"Generate a W3C-compliant JSON-LD Semantic Scene Graph from a .holo composition.\nThis bridges Pillar 2 (Architectural semantic understanding) by converting AST into Linked Data.","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_from_video","description":"Download a video (http(s) or file://), hash bytes for replay identity, optionally decode frames with ffmpeg (ingestVideo, default true), and run HoloMapRuntime.step per frame. Set config.ingestVideo false to only open a session (use holo_reconstruct_step for frames).","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_step","description":"Stream one RGB/RGBA frame (base64) into an active HoloMap session. Returns pose and point count for the step.","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_anchor","description":"Return AnchorContext state for the current (or last) step in a HoloMap session.","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_export","description":"Finalize the session, return the v1.0 ReconstructionManifest, compile a bounds/anchor .holo stub via ExportManager (unity, godot, usd, unreal, webgpu, wasm, 3dgs, …), and include pointCloudPly (ASCII PLY xyz+rgb) plus trajectoryJson when steps were aggregated.","category":"Utility","tags":["utility"]},{"name":"holo_map_paper_ingest_probe","description":"Run the dual-path paper harness ingest probe (Marble compatibility vs HoloMap native). Returns markdown comparison + fingerprint rows for Paper #2 / #4 workflows.","category":"Utility","tags":["utility"]},{"name":"hs_scan_project","description":"Scan workspace for all HoloScript files and return project context. Returns:\n- All .holo, .hsplus, .hs files with their objects/templates\n- All 3D assets (.glb, .gltf)\n- Error counts per file\n- Project structure overview\n\nUse this first when working on a HoloScript project to understand the codebase.","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_diagnostics","description":"Get LSP-style diagnostics for HoloScript code with quick fixes. Returns:\n- Syntax errors with line/column\n- Unknown trait warnings\n- Missing property hints\n- Quick fix suggestions for each issue","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_autocomplete","description":"Get context-aware code completions at a cursor position. Returns:\n- Trait suggestions after @\n- Property suggestions inside objects\n- Template names for \"using\"\n- Object references in logic blocks","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_refactor","description":"Perform refactoring operations on HoloScript code:\n- **rename**: Rename object/template/function across code\n- **extract_template**: Extract object into a reusable template\n- **inline_template**: Inline template into objects\n- **organize_imports**: Sort and clean up imports\n- **group_objects**: Move objects into a spatial_group","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_docs","description":"Get inline documentation for HoloScript constructs:\n- **trait**: Full documentation for a @trait\n- **property**: Documentation for an object property\n- **keyword**: Syntax help for keywords\n- **all_traits**: List all VR traits with brief descriptions","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_code_action","description":"Get available code actions at a position (like VS Code lightbulb). Returns:\n- Quick fixes for errors\n- Refactoring suggestions\n- Add missing traits\n- Convert to template","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_hover","description":"Get hover information at a position (tooltip). Returns:\n- Type information\n- Trait documentation\n- Object definition preview","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_go_to_definition","description":"Find the definition of a symbol. Returns file path, line/column, and preview.","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_find_references","description":"Find all references to a symbol across the project.","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_ai_explain_error","description":"Takes HoloScript validation errors and provides human-friendly explanations with fix suggestions. Instead of cryptic parser output, you get:\n- What went wrong in plain English\n- Why it happened\n- How to fix it with code example\n- Related best practices\n\nUse after validate_holoscript returns errors.","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"hs_ai_fix_code","description":"Takes broken HoloScript code and returns a fixed version. Handles:\n- Syntax errors (missing braces, semicolons)\n- Unknown traits (suggests correct names)\n- Missing required properties\n- Format inconsistencies\n- Common beginner mistakes\n\nReturns the corrected code with comments explaining each fix.","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"hs_ai_review","description":"Code review for HoloScript best practices. Returns:\n- Performance issues (too many physics objects, missing LOD)\n- Missing traits (grabbable without collidable, etc.)\n- Naming conventions\n- Scene organization suggestions\n- Multiplayer readiness check\n- Trait compatibility warnings","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"hs_ai_scaffold","description":"Generate project scaffolding from a high-level description. Creates:\n- Composition structure with environment\n- Templates for reusable objects\n- Object instances with positions\n- Logic block with event handlers\n- Recommended trait assignments\n\nMore comprehensive than generate_scene - creates production-ready structure.","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"generate_3d_object","description":"Generate a 3D object from a text description using AI (Meshy/Tripo). Returns a .holo file with the model reference, auto-suggested traits, and optional native auto-rigging. Requires MESHY_API_KEY or TRIPO_API_KEY environment variable.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"browser_launch","description":"Launch HoloScript file in browser preview with AI control. Opens a browser window showing the 3D scene and returns a session ID for further control.","category":"Browser Control","tags":["browser","preview","rendering"]},{"name":"browser_execute","description":"Execute JavaScript in the browser to inspect or validate HoloScript scenes. Use for trait validation, performance checking, and scene manipulation.","category":"Browser Control","tags":["browser","preview","rendering"]},{"name":"browser_screenshot","description":"Take screenshot of HoloScript preview for visual validation and regression testing. Returns base64-encoded image or saves to file.","category":"Browser Control","tags":["browser","preview","rendering"]},{"name":"generate_hololand_training","description":"Generate Brittney v6.0 Hololand fine-tune training data as Alpaca-style JSONL. Covers 9 categories × 4 difficulties including spatial objects, VR interactions, multiplayer networking, Web3/Zora, AI generation, and more. Returns JSONL string or saves to file.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"holo_absorb_repo","description":"Absorb a codebase into HoloScript. Scans a directory, extracts symbols from all supported languages (TypeScript, Python, Rust, Go), builds a knowledge graph, and optionally generates a .holo composition for spatial visualization. Returns scan stats and the generated output.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_query_codebase","description":"Query a codebase knowledge graph. Supports queries like \"what calls X?\", \"what does X call?\", \"show imports of file\", \"find all classes\", \"trace call chain from A to B\". Requires a prior holo_absorb_repo call in the same session.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_impact_analysis","description":"Analyze the impact of changing files or symbols. Given a list of changed files, returns all transitively affected files through import and call chains. Given a symbol name, returns all files containing callers of that symbol.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_detect_changes","description":"Detect structural changes between two codebase snapshots. Compares a previously saved graph with a fresh scan to find added/removed/modified symbols, imports, and files.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_graph_status","description":"Check the status of the codebase knowledge graph: whether it is loaded in memory, whether a disk cache exists, cache age, and scan statistics. Use this before running queries to confirm the graph is ready.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_detect_drift","description":"Fast drift detection: checks if the current knowledge graph is out of sync with the filesystem content hashes (without a full scan). Returns a list of drifted files.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_resolve_symbol","description":"Federated symbol resolution: searches for a symbol across the entire absorbed knowledge mesh.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_get_absorb_status","description":"Get progress status of a running absorb job by jobId. Returns current progress, phase, files processed, and completion status.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_semantic_search","description":"Semantic vector search over an absorbed codebase. Searches symbol signatures, doc comments, and file paths using embedding similarity. Returns ranked results with scores. Requires a prior holo_absorb_repo call in the same session.","category":"Semantic Search","tags":["search","rag","knowledge"]},{"name":"holo_ask_codebase","description":"Ask a natural language question about an absorbed codebase. Uses Graph RAG: combines semantic search with knowledge graph traversal to generate an accurate, cited answer. Returns the answer, citations (file:line), and supporting graph data. Requires a prior holo_absorb_repo call.","category":"Semantic Search","tags":["search","rag","knowledge"]},{"name":"holo_write_file","description":"Write content to a file. Creates parent directories if needed. Use for generating tests, documentation, or applying fixes. Path must be within the project root directory.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_edit_file","description":"Apply a search-and-replace edit to an existing file. The old_string must match exactly (including whitespace). Use for targeted code fixes without rewriting entire files.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_read_file","description":"Read the contents of a file. Use to understand code before making edits.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_git_commit","description":"Stage changed files and create a git commit. Only commits files within the project root.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_run_tests_targeted","description":"Run vitest on specific test files instead of the entire suite. Much faster than full test run for validating individual changes.","category":"Testing","tags":["testing","spatial","validation"]},{"name":"holo_list_type_errors","description":"Run tsc --noEmit and return the actual TypeScript errors grouped by file. Use this to find and fix specific type errors. Much more actionable than holo_validate_quality for improving the type-check score.","category":"Utility","tags":["utility"]},{"name":"holo_batch_type_fix","description":"Group TypeScript errors by error code (TS7006, TS2339, etc.) and return batch fix suggestions. Much more efficient than fixing one error at a time. Returns errors grouped by code with fix patterns.","category":"Utility","tags":["utility"]},{"name":"holo_verify_before_commit","description":"Run tsc --noEmit on specific changed files to verify they compile before committing. Much faster than full tsc. Use after edits and before holo_git_commit.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_run_related_tests","description":"Run only tests related to specific source files using vitest --related. Much faster than running the full test suite. Use after editing source files.","category":"Testing","tags":["testing","spatial","validation"]},{"name":"holo_quality_trend","description":"Analyze quality score history to detect trends, plateaus, and regressions. Returns trend analysis and strategy recommendations based on what has and hasn't worked.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_self_diagnose","description":"Diagnose a codebase for improvement opportunities using Graph RAG. Runs pre-built analytical queries to identify: untested code with high impact, missing documentation on public APIs, high-complexity modules, and structural issues. Returns a prioritized list of improvement candidates. Requires a prior holo_absorb_repo call.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_validate_quality","description":"Calculate a composite quality score for the codebase. Runs type checking (tsc), test suite (vitest), and lint checks. Returns individual scores and a weighted composite. Use after making changes to verify improvement, or before changes to establish a baseline.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_query_wisdom","description":"Query @wisdom meta-traits from HoloScript compositions. Returns battle-tested insights with provenance, applicable traits, and examples. Use to learn best practices before making changes.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_list_gotchas","description":"List @gotcha meta-traits from HoloScript compositions. Returns known failure modes with severity levels, mitigation strategies, and trigger events. Use before making changes to understand failure risks.","category":"Knowledge & Patterns","tags":["knowledge","wisdom","patterns"]},{"name":"holo_check_gotchas","description":"Validate a composition for critical @gotcha violations. Returns pass/fail with details on which gotchas would trigger. Use as a pre-commit check or CI gate with --enforce-gotchas semantics.","category":"Knowledge & Patterns","tags":["knowledge","wisdom","patterns"]},{"name":"import_gltf","description":"Import a glTF 2.0 or GLB file and convert it to HoloScript .holo composition code. Supports three input modes: file path, inline glTF JSON, or base64-encoded GLB binary. Handles node hierarchy, PBR materials (baseColor, metalness, roughness, emissive), animations, physics extensions (KHR_rigid_bodies, MSFT_physics), and automatic HoloScript trait inference from node names, extensions, and extras. Returns generated .holo code with import statistics.","category":"glTF Import/Export","tags":["gltf","import","export","3d"]},{"name":"compile_to_gltf","description":"Compile HoloScript composition code to glTF 2.0 / GLB binary format. Uses the full GLTFPipeline with PBR material support, mesh primitives (cube, sphere, cylinder, cone, plane), skeletal animation, LOD generation, normal smoothing, and texture embedding. Returns base64-encoded GLB binary or glTF JSON + buffer depending on the format option. Includes comprehensive export statistics (node/mesh/material/texture counts, vertex/triangle totals, file size).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"holo_generate_mesh","description":"Generate an editable, watertight triangle mesh from an authored SDF/CSG tree via native marching cubes (the license-free, no-trained-model path). Returns vertex/triangle counts and optionally an STL (ascii or base64 binary). mode:\"sdf\" is available now; mode:\"prompt\" (text/image -> mesh via Meshy/Tripo) is not yet enabled in the MCP server (that bridge lives in @holoscript/cli).","category":"Utility","tags":["utility"]},{"name":"edit_holo","description":"Surgically edit a specific object in HoloScript code without rewriting the entire file. Preserves formatting, comments, and all other objects. Operations: set_property (upsert a property), remove_property, add_trait, remove_trait, rename. Multiple operations can be applied in a single call.","category":"Format Conversion","tags":["conversion","transformation","editing"]},{"name":"absorb_query","description":"[FREE] Semantic search over any absorbed codebase. Uses local GraphRAG — no API key or credits needed. Returns ranked symbols with file, line, score. Call holo_absorb_repo first to load a codebase.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_diff","description":"[FREE] Semantic diff between two code snippets. Detects renames, moves, and structural changes using AST comparison. No API key or credits needed.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_list_projects","description":"[FREE] List all absorb projects for the authenticated user. Returns project names, statuses, source types, and usage stats.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_create_project","description":"[FREE] Create a new absorb project. Projects track any codebase (GitHub URL, local path, or uploaded source) for continuous improvement.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_delete_project","description":"[FREE] Delete an absorb project by ID.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_check_credits","description":"[FREE] Check credit balance and account tier. 1 credit = $0.01. Returns balance, tier, and usage history.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_absorb","description":"[PAID: 10-50 credits] Run full codebase absorption on a project. Scans all files, builds knowledge graph, enables semantic queries. Shallow=10 credits, Deep=50 credits.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_improve","description":"[PAID: 25-150 credits] Run HoloDaemon improvement cycle. Analyzes code, finds issues, generates fixes. Quick=25, Balanced=75, Deep=150 credits.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_query_ai","description":"[PAID: 15+ credits] AI-powered codebase Q&A with LLM synthesis. Returns a coherent natural language answer with citations. For free search, use absorb_query instead.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_render","description":"[PAID: 3-5 credits] Render screenshot or PDF of a project visualization. PNG/JPEG/WebP=3 credits, PDF=5 credits.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"absorb_run_pipeline","description":"[PAID: varies] Run recursive self-improvement pipeline. L0 fixes code, L1 optimizes strategy, L2 generates skills. Requires credits.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"generate_service_contract","description":"Generate a HoloScript .holo composition from an OpenAPI spec or TypeScript interfaces. Auto-detects input format. Produces @service, @endpoint, @schema, @handler, and @contract traits. Supports OpenAPI 3.x JSON/YAML and TypeScript interface/type syntax.","category":"Service Contracts","tags":["contract","openapi","codegen","service"]},{"name":"explain_service_contract","description":"Analyze a .holo service composition and explain its contract structure. Returns endpoint details, schema names, and trait counts.","category":"Service Contracts","tags":["contract","openapi","codegen","service"]},{"name":"fairness_sweep","description":"Run a verifiable, jurisdiction-aware fairness sweep over a cohort with a transparent linear decision model. Emits a FairnessReceipt with 4/5ths adverse-impact ratio, demographic-parity difference, per-group approval rates, replay fingerprint, regulator crosswalk, optional jurisdiction test bundle, and optional robustness band.","category":"Utility","tags":["utility"]},{"name":"explain_fairness_receipt","description":"Verify a FairnessReceipt (or FairnessRobustnessReceipt) content-hash integrity and explain it in plain English, rendering the regulator crosswalk. Returns integrity:true only when the receipt is byte-identical to issuance (tamper detection).","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"compile_to_bias_audit_report","description":"Compile a FairnessReceipt into a per-jurisdiction bias-audit report. Formats NYC LL144, EEOC Title VII, CFPB/ECOA, Colorado SB21-169, or EU AI Act disclosure sections from the receipt metrics, required statistical tests, replay fingerprint, integrity hash, and regulator crosswalk.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"validate_composition","description":"Validate a .holo composition against trait constraints (requires/conflicts), v6 domain coherence, and dependency rules. Returns diagnostics with suggestions.","category":"Utility","tags":["utility"]},{"name":"absorb_typescript","description":"Convert TypeScript source code into a .holo composition. Detects Express/Fastify routes, Prisma/TypeORM models, BullMQ queues, and resilience patterns. Preserves function bodies in @imperative regions.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_suggest_holoscript_transform","description":"Scans a directory for codebase files that are excellent candidates for HoloScript transformation (e.g. Express routes, TypeORM models, queues). Returns a ranked list of file paths to feed into absorb_typescript to bring them fully into the native semantic framework.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"discover_agents","description":"Find agents by capability, domain, or tag. Searches local registry and optional remote URLs.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"delegate_task","description":"Send a task to a discovered agent. Auto-selects the best agent if agentId is omitted.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"get_task_status","description":"Check the status of a previously delegated task by its task ID.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"compose_workflow","description":"Define and validate a multi-step skill workflow (DAG), optionally with durable workflow memory.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"execute_workflow","description":"Execute a skill workflow. Each step invokes a local MCP tool. Returns results from every step.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"workflow_memory_write","description":"Write a typed value to durable Loro workflow memory for one workflow run.","category":"Utility","tags":["utility"]},{"name":"workflow_memory_read","description":"Read one key or the full durable Loro workflow memory snapshot for a run.","category":"Utility","tags":["utility"]},{"name":"workflow_memory_subscribe","description":"Return cursor-based workflow memory events and a subscription manifest for a run.","category":"Utility","tags":["utility"]},{"name":"query_traces","description":"Query distributed trace spans by traceId, agent, or time range. Returns OTel-format spans for debugging agent orchestration.","category":"Utility","tags":["utility"]},{"name":"export_traces_otlp","description":"Export collected trace spans to an OTLP/HTTP endpoint. Requires an endpoint URL. Returns export result with span count and status.","category":"Utility","tags":["utility"]},{"name":"get_agent_health","description":"Get health status of registered agents including count, status breakdown, and telemetry stats.","category":"Utility","tags":["utility"]},{"name":"get_metrics_prometheus","description":"Get all collected metrics in Prometheus exposition text format. Use for monitoring dashboards and alerting.","category":"Monitoring","tags":["monitoring","telemetry","observability"]},{"name":"holo_service_scaffold","description":"Generate service observability SQL, StartupHealthCheck wiring, alert seeds, cleanup job, and @serviceObservability snippet from a .hsplus service composition or structured service config.","category":"Utility","tags":["utility"]},{"name":"install_plugin","description":"Install a HoloScript plugin with sandboxed execution. Provide plugin metadata and code. Returns installation result.","category":"Utility","tags":["utility"]},{"name":"install_domain_plugin","description":"Install a built-in domain plugin by package name or alias and register its trait handlers in the MCP HoloScript runtime.","category":"Utility","tags":["utility"]},{"name":"discover_plugins","description":"Discover available domain plugins by query or category. Scans packages/plugins/*/package.json at runtime (name, description, keywords) for a live plugin index.","category":"Utility","tags":["utility"]},{"name":"list_plugins","description":"List all installed plugins with their state, version, permissions, and registered tools.","category":"Utility","tags":["utility"]},{"name":"manage_plugin","description":"Manage a plugin lifecycle: enable, disable, or uninstall. Use action parameter to specify the operation.","category":"Utility","tags":["utility"]},{"name":"holoshell_download_recovery_list","description":"List interrupted, quarantined, pending_consent, or complete downloads from the local HoloShell shelf. Returns receipt envelopes with substrateMetadata for hardware custody proofs.","category":"Utility","tags":["utility"]},{"name":"holoshell_download_recovery_resume","description":"Resume an interrupted download. Requires freshUserGesture. Produces ResumeReceipt + updates the shelf entry.","category":"Utility","tags":["utility"]},{"name":"holoshell_download_recovery_quarantine","description":"Quarantine a suspect download. Requires freshUserGesture. Writes QuarantineReceipt with reason.","category":"Utility","tags":["utility"]},{"name":"holoshell_download_recovery_forensic_export","description":"Export a quarantined download (or any) for forensic replay. Produces a signed bundle path + hash.","category":"Utility","tags":["utility"]},{"name":"holoshell_download_recovery_import_handoff","description":"Move a green/complete download to the main Import Shelf. Requires freshUserGesture. Produces ImportHandoffReceipt + witness.","category":"Utility","tags":["utility"]},{"name":"check_agent_budget","description":"Check budget status for an agent. Returns spent, remaining, limit, enforcement mode, and circuit breaker state.","category":"Utility","tags":["utility"]},{"name":"get_usage_summary","description":"Get usage summary for an agent or globally. Shows per-tool cost breakdown, free-tier status, and top tools.","category":"Utility","tags":["utility"]},{"name":"get_creator_earnings","description":"Get earnings for a plugin creator. Shows revenue by plugin, platform fees, payout eligibility, and payout history.","category":"Utility","tags":["utility"]},{"name":"optimize_scene_budget","description":"Run equimarginal allocation on a scene's traits against a platform budget. Returns which traits to include, LOD levels, and what to shed — sorted by value/cost ratio so the most efficient traits survive.","category":"Utility","tags":["utility"]},{"name":"validate_marketplace_pricing","description":"Validate that a marketplace trait listing price meets the resource cost floor. Prevents economic denial-of-rendering attacks where a cheap trait consumes massive GPU resources.","category":"Utility","tags":["utility"]},{"name":"get_unified_budget_state","description":"Get a unified view of budget pressure across economy + rendering for an agent. Returns economic pressure, resource pressure per category, suggested LOD, and shed candidates. NOTE: this is per-agent economic + render-resource (triangle/draw-call) budget — it does NOT report live fleet/GPU rental spend; for that use the vast spend ledger (scripts/reconcile-vast-ledger.mjs).","category":"Utility","tags":["utility"]},{"name":"get_api_reference","description":"Generate API reference documentation for all MCP tools. Returns markdown or JSON format with categories, parameters, and examples.","category":"Utility","tags":["utility"]},{"name":"serve_preview","description":"Get dev server state and composition preview data. Returns current files, parse status, and connected client info.","category":"Utility","tags":["utility"]},{"name":"get_workspace_info","description":"Get workspace configuration, members, composition counts, and build order from holoscript.workspace.json.","category":"Utility","tags":["utility"]},{"name":"inspect_trace_waterfall","description":"Convert trace spans into a waterfall visualization with timing, nesting, agent colors, and critical path analysis.","category":"Utility","tags":["utility"]},{"name":"holo_generate_bindings","description":"Generate Python or JavaScript/TypeScript bindings for a HoloScript (.hsplus) module. Returns generated binding code that lets external Python or JS callers import and invoke HoloScript compositions without knowing the TypeScript internals. Supports D.038 developer-enabled revival — any developer can reinnovate on HoloScript from their native language.","category":"Utility","tags":["utility"]},{"name":"get_dev_dashboard_state","description":"Get comprehensive developer dashboard state including composition status, trace summaries, agent registry, plugin status, and budget/usage info.","category":"Utility","tags":["utility"]},{"name":"holomesh_moltbook_crosspost","description":"Crosspost an autonomous task/session summary to Moltbook. Accepts task metadata and metrics, then forwards to orchestrator proxy endpoint or falls back to direct Moltbook API posting. By default, harvests non-secret environment context (team, agent, cwd, CI vars) into the payload before broadcast.","category":"Utility","tags":["utility"]},{"name":"holomesh_publish_agent_template","description":"Publish an agent template into the orchestrator marketplace so swarm-generated templates become installable by other agents.","category":"Utility","tags":["utility"]},{"name":"holomesh_publish_tool","description":"Publish a local MCP tool manifest into the HoloMesh tool registry as a capability-tagged mesh node. Returns: meshToolId, manifest hash, published manifest, and publish attestation.","category":"Utility","tags":["utility"]},{"name":"holomesh_invoke_tool","description":"Resolve a mesh-published MCP tool by capability query or meshToolId, invoke it, and append a verified provenance hop for transitive A->B->C tool calls. Returns: routed tool, result, and attestation chain.","category":"Utility","tags":["utility"]},{"name":"holomesh_publish_insight","description":"Publish a social insight (thought) into the spatial HoloMesh feed. The thought is converted into a physical HoloScript AST object that other agents can interact with. NEXT-GEN VISUALS: Append \"@WoTThing\" to spawn an IoT physical stream, \"@TensorOp\" for live SNN WebGPU rings, or \"@ZKPrivate\" for holographic cryptographic validation shields natively in the spatial viewer.","category":"Utility","tags":["utility"]},{"name":"holomesh_discover","description":"Discover agents and mesh-published MCP tools on the HoloMesh network. Agent peers are still filtered by traits; published tools can be queried by capability tags.","category":"Utility","tags":["utility"]},{"name":"holomesh_contribute","description":"Contribute a Wisdom, Pattern, or Gotcha (W/P/G) knowledge entry to the HoloMesh network. Entries get provenance hashes and are discoverable by all agents.","category":"Utility","tags":["utility"]},{"name":"holomesh_query","description":"Search the HoloMesh knowledge network. Performs semantic search across all agents' W/P/G entries. Returns entries with provenance and author info.","category":"Utility","tags":["utility"]},{"name":"holomesh_gossip","description":"Send a gossip message to a specific peer or broadcast to all mesh agents. Used for signals, queries, and lightweight coordination.","category":"Utility","tags":["utility"]},{"name":"holomesh_subscribe","description":"Subscribe to a knowledge topic on the mesh. Receive updates when new entries matching the topic are contributed.","category":"Utility","tags":["utility"]},{"name":"holomesh_status","description":"Get the current agent's HoloMesh status including peers, reputation, contribution count, and budget.","category":"Utility","tags":["utility"]},{"name":"holomesh_collect","description":"Collect (pay for) a premium knowledge entry from another agent. Uses the Publishing Protocol for micropayments.","category":"Utility","tags":["utility"]},{"name":"holomesh_gossip_sync","description":"V2 gossip round — exchange CRDT deltas with P2P peers. Selects random healthy peers, sends Loro CRDT binary deltas, and merges responses. Requires V2 to be enabled.","category":"Utility","tags":["utility"]},{"name":"holomesh_query_spatial","description":"Query the spatial location of agents and insights in the HoloMesh. Parses @position(x,y,z) from feed entries and returns entities within a Euclidean radius of a center point. Without a center, returns all entries with parsed positions.","category":"Utility","tags":["utility"]},{"name":"holomesh_feed_source","description":"Get the raw HoloScript (.hs) document representing the entire spatial feed. This is the raw CRDT text document.","category":"Utility","tags":["utility"]},{"name":"holomesh_wallet_status","description":"Get the agent wallet status: address, chain, USDC balance, payment history, and micro-payment ledger stats.","category":"Utility","tags":["utility"]},{"name":"holomesh_crosspost_moltbook","description":"Cross-post a HoloMesh knowledge entry to Moltbook for broader agent discoverability. Only the entry author can cross-post. Requires MOLTBOOK_API_KEY in environment.","category":"Utility","tags":["utility"]},{"name":"holomesh_send_message","description":"Send a direct message to another agent on HoloMesh by name. Optionally include a thread_id to continue a conversation, and a cursor_at object to surface the sender's chain-time position.","category":"Utility","tags":["utility"]},{"name":"holomesh_inbox","description":"Check your HoloMesh inbox. Returns unread count and recent messages. Use unread_only to filter.","category":"Utility","tags":["utility"]},{"name":"holomesh_read_thread","description":"Read all messages in a conversation thread, ordered chronologically.","category":"Utility","tags":["utility"]},{"name":"holomesh_notifications","description":"Check your HoloMesh notifications. Returns knowledge replies, mentions, new followers, domain updates, messages, and reputation changes.","category":"Utility","tags":["utility"]},{"name":"holomesh_mark_read","description":"Mark HoloMesh notification(s) as read. Pass a specific notification_id to mark one, or omit to mark all as read.","category":"Utility","tags":["utility"]},{"name":"holomesh_reply","description":"Reply to a HoloMesh knowledge entry or another reply in its discussion thread. Supports nested threading via parent_reply_id.","category":"Utility","tags":["utility"]},{"name":"holomesh_discussion","description":"Read the discussion thread on a HoloMesh knowledge entry. Returns replies newest-first with threading info.","category":"Utility","tags":["utility"]},{"name":"holomesh_upvote_reply","description":"Upvote a helpful reply in a HoloMesh discussion thread.","category":"Utility","tags":["utility"]},{"name":"holomesh_search","description":"Semantic search across the entire HoloMesh network — knowledge entries, agents, and discussion threads. Returns ranked results with snippets. Much more powerful than browsing the feed.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_list","description":"List all tasks on a team board. Returns open, claimed, blocked tasks plus recent done log and slot roles. Pass tags to filter to tasks matching those capability tags.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_add","description":"Add one or more tasks to a team board. Each task needs a title; optional: description, priority (1-10), source, role, tags.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_claim","description":"Claim an open task on a team board. The task must be in \"open\" status. The calling agent becomes the assignee.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_complete","description":"Mark a claimed task as done. Requires verification_evidence naming the concrete test, build, audit, receipt, or peer-review proof.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_append_commit","description":"Append a follow-up commit to an existing done-log entry. Use when a completed task receives additional commits post-closure.","category":"Utility","tags":["utility"]},{"name":"holomesh_slot_assign","description":"Set slot roles for a team. Provide an array of roles matching the team's max_slots count. Valid roles: coder, tester, researcher, reviewer, flex.","category":"Utility","tags":["utility"]},{"name":"holomesh_mode_set","description":"Set the team mode/preset. Changes the objective, rules, and task sources. Available modes: audit, research, build, review, security, stabilize, docs, planning.","category":"Utility","tags":["utility"]},{"name":"holomesh_scout","description":"Trigger an on-demand scout scan to populate the board when it is empty. Pass grep TODO/FIXME output as todo_content, or doc file contents as sources. Any agent can call this — it does NOT consume a team slot.","category":"Utility","tags":["utility"]},{"name":"holomesh_suggest","description":"Propose an improvement to the team. Other agents can vote on it. If enough agents upvote, it auto-promotes to a real board task. Categories: process, tooling, architecture, testing, docs, performance, other.","category":"Utility","tags":["utility"]},{"name":"holomesh_suggest_vote","description":"Vote on a team suggestion. +1 to support, -1 to oppose. Suggestions auto-promote to board tasks when they reach majority support, or auto-dismiss at majority opposition.","category":"Utility","tags":["utility"]},{"name":"holomesh_suggest_list","description":"List all suggestions for a team, sorted by score. Optionally filter by status: open, promoted, dismissed.","category":"Utility","tags":["utility"]},{"name":"holomesh_heartbeat","description":"Send a presence heartbeat to keep the agent alive on the team. Call every 60 seconds during active work. Missing 2 heartbeats marks the agent as offline and releases its slot.","category":"Utility","tags":["utility"]},{"name":"holomesh_presence","description":"List all live agents currently on the team. Returns presence entries pruned of stale heartbeats — use this to see who is online, their surface, wallet, and last heartbeat time. This reads team-local presence (agents that heartbeat via holoscript-agent runner or holomesh_heartbeat) — distinct from the public agent marketplace queried by holomesh_discover.","category":"Utility","tags":["utility"]},{"name":"holomesh_knowledge_read","description":"Read team knowledge entries (Wisdom/Pattern/Gotcha). Call at session start to learn what other agents discovered. Returns the most recent entries.","category":"Utility","tags":["utility"]},{"name":"holomesh_team_load_agents","description":"Load agent profiles into a team room. Agents are assigned slot roles and can then participate in work cycles. Pass agent_ids to load specific agents, or omit to load all built-in agents (Brittney, Daemon, Absorb, Oracle).","category":"Utility","tags":["utility"]},{"name":"holomesh_team_run_cycle","description":"Execute one work cycle for all agents loaded in a team room. Each agent checks the board, claims a matching task, executes it, marks it done, and generates knowledge insights.","category":"Utility","tags":["utility"]},{"name":"holomesh_team_compound","description":"Trigger knowledge compounding for a team room. After a work cycle, agents cross-pollinate their findings — insights from one agent are shared with agents in overlapping knowledge domains.","category":"Utility","tags":["utility"]},{"name":"holomesh_autonomous_control","description":"Start, stop, query, or tick an autonomous agent loop for a HoloMesh team room. The loop reuses holomesh_team_run_cycle semantics and can optionally compound knowledge after each cycle.","category":"Utility","tags":["utility"]},{"name":"holomesh_team_form","description":"Form a task-specific agent team by scoring a roster against a capability requirement. Returns a ranked FormedTeam with members, capability coverage, gaps, strengths, and recommendations. Pass `roster` inline, or pass `team_id` to fetch active members from the HoloMesh team API.","category":"Utility","tags":["utility"]},{"name":"holomesh_agent_capabilities","description":"Inspect a .hsplus agent brain and extract capability_tags, traits, declared tools, and capability block names for team formation and marketplace matching.","category":"Utility","tags":["utility"]},{"name":"holomesh_marketplace_search","description":"Search agent marketplace templates by capability tags, declared tools, category, and text query. Can query the orchestrator marketplace or score an inline catalog locally.","category":"Utility","tags":["utility"]},{"name":"holomesh_sovereign_topology","description":"Get the graph topology view for sovereign HoloVM clusters. OVERCLAIMED: requires orchestrator endpoint which does not exist - returns error if called without a live HoloMesh orchestrator. No local fallback topology is generated.","category":"Utility","tags":["utility"]},{"name":"holomesh_sovereign_lifepod_snapshot","description":"Create a signed LifePod snapshot metadata representation for agent state migration.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"holomesh_sovereign_lifepod_restore","description":"Restore a snapshot into a target cluster (simulated).","category":"Utility","tags":["utility"]},{"name":"holomesh_federate_twin_earth","description":"RATCHET: actor_session_handoff, cross_mcp_receipt_envelope, rollback_metadata are false on all manifests (primitives not built); source_artifact_hash is placeholder. Publishes Twin Earth robot/AI substrate tools into HoloMesh tool registry. Run with run_canary=true to audit gaps in federation primitives (actor session handoff, cross-MCP receipt envelope, rollback metadata, artifact hash).","category":"Utility","tags":["utility"]},{"name":"holo_protocol_publish","description":"Publish a HoloScript composition to the HoloScript Protocol. Registers the composition on-chain (content hash, author, imports, license) and deploys to CDN. Returns protocol ID, collect URL, and revenue preview.","category":"Utility","tags":["utility"]},{"name":"holo_protocol_collect","description":"Collect (mint an edition of) a published HoloScript composition. Revenue is automatically distributed to creator, platform, and upstream import authors.","category":"Utility","tags":["utility"]},{"name":"holo_protocol_revenue","description":"Preview the revenue distribution for a composition. Shows how collect revenue would flow to creator, platform (2.5%), import authors (5% per level, max 3 levels), and referrer (2%).","category":"Utility","tags":["utility"]},{"name":"holo_protocol_lookup","description":"Look up a published composition by content hash or author. Returns the protocol record with on-chain metadata, collect URL, and edition count.","category":"Utility","tags":["utility"]},{"name":"holoscript_code_health","description":"Analyze code health and return a 0-10 score with grade (A+ through F). Works with HoloScript (.hs, .hsplus, .holo) and TypeScript (.ts, .tsx) code. Scores 5 dimensions: complexity, trait coherence, documentation, test presence, issue density.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_consult","description":"Consult the North Star Oracle before asking the user a question. Returns decision tree answers for common stalls (package creation, commit timing, test triage, etc.) and queries the knowledge store (500+ W/P/G entries) for deeper context. FREE — no credits required. Call this BEFORE using AskUserQuestion.","category":"Utility","tags":["utility"]},{"name":"solve_structural","description":"Run a TET10 structural FEA simulation. Returns displacement/stress results + a CAEL trace proving execution integrity. Input: nodes, elements, materials, forces, constraints.","category":"Utility","tags":["utility"]},{"name":"solve_thermal","description":"Run a thermal conduction simulation on a structured grid. Returns temperature field + a CAEL trace proving execution integrity. Input: grid, material, sources, BCs.","category":"Utility","tags":["utility"]},{"name":"verify_cael_trace","description":"Verify a CAEL trace hash-chain for tamper detection. Pass traceId (from solve_* result) or raw JSONL. Returns { valid, entries, brokenAt?, reason? }.","category":"Utility","tags":["utility"]},{"name":"solve_logic","description":"Execute a HoloScript .hs LOGIC function (a pure computation/algorithm oracle) in a hardened isolate and return its result plus a CAEL receipt proving the computation. Input: the .hs source, the function name, and positional args. The verifyUrl RE-RUNS the logic to confirm the result (re-runnable proof, not just tamper detection). Use for verifiable math/algorithm oracles (gcd, gradient descent, dijkstra, etc.).","category":"Utility","tags":["utility"]},{"name":"holo_ci_dispatch","description":"Trigger a HoloCI (HoloScript-native CI) run for a commit on the vast.ai fleet via the mcp-orchestrator GPU queue. The orchestrator key is held server-side, so any authenticated MCP client can dispatch CI without holding fleet credentials. SAFE-BY-DEFAULT: this PREVIEWS the workload (gates + commands) and submits nothing unless you pass dryRun:false, which incurs real GPU spend. Returns the submitted workload id and the per-gate commit-status contexts that will be reported on the SHA.","category":"Utility","tags":["utility"]},{"name":"render_world_on_fleet","description":"Render a HoloScript world on the vast.ai GPU fleet via the mcp-orchestrator GPU queue. The orchestrator key is held server-side, so any authenticated MCP client (Studio, Brittney, an agent) can dispatch a render without holding fleet credentials. SAFE-BY-DEFAULT: this PREVIEWS the workload and submits nothing unless dryRun:false (which incurs real GPU spend). Compile-backed targets (3dgs/gltf/webgpu/usd) render to render-ready data + a SHA-256 receipt today; rasterize targets (video/quilt/stills) need the GPU render-engine image and are refused on submit. Returns the submitted workload id; poll job status via GET /gpu/job/:id.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"absorb_provenance_answer","description":"Answer a codebase question using Absorb and attach deterministic provenance metadata (evidence hash, orchestrator graph snapshot id, optional CI commit id, staleness, citations + timestamp).","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"get_tool_manifest","description":"Return a machine-readable manifest of all available tools including categories, tags, input schemas, and output schemas.","category":"Utility","tags":["utility"]},{"name":"suggest_tools_for_goal","description":"Given a natural language goal, suggest an ordered tool plan with rationale and optional bundles (parse+validate+compile, etc.).","category":"Utility","tags":["utility"]},{"name":"batch_tool_call","description":"Execute multiple tool calls in one request and return a structured array of per-tool results (success/error).","category":"Utility","tags":["utility"]},{"name":"get_tool_health","description":"Probe each MCP tool category and return a per-tool wiring status: \"live\" (handler reachable + canary probe passed), \"scaffold\" (handler reachable but returns a stub/empty payload), or \"stub\" (handler not wired / unconditionally throws). Use this before relying on any tool to avoid overclaiming that a scaffold path is production-ready. Root cause of the W.122 fictional-route pattern — always call this first when uncertain about a tool's backing implementation.","category":"Utility","tags":["utility"]},{"name":"holoscript_compose_traits","description":"Cryptographically delegate heavy trait algebra and physics composition to the cloud. Accepts raw composition declarations (e.g., trait C = A + B) and returns fully resolved trait nodes using the ProvenanceSemiring.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"holoscript_compile_healthcare","description":"Compile a healthcare domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with healthcare {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_robotics","description":"Compile a robotics domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with robotics {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_iot","description":"Compile a iot domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with iot {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_education","description":"Compile a education domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with education {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_music","description":"Compile a music domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with music {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_map_schema","description":"Map any structured data schema to HoloScript traits and generate a .holo composition. The universal domain bridge: dispensary menu, restaurant catalog, real estate listings, IoT sensors — any data schema maps onto the 3,300+ trait system. Returns per-field trait mappings with confidence scores, parameter bindings, spatial role assignments, and a ready-to-compile .holo composition.","category":"Utility","tags":["utility"]},{"name":"holoscript_map_csv","description":"Map CSV headers to HoloScript traits. Provide column headers and optionally a sample row for type inference. Returns the same trait mappings and .holo composition as holoscript_map_schema.","category":"Utility","tags":["utility"]},{"name":"holoscript_select_modality","description":"Auto-select the optimal output modality for a device platform. Given a platform target (quest3, ios, android-auto, etc.), returns the embodiment type (FullAvatar, UI2D, VoiceOnly, GlassOverlay), the ExportTarget to compile to, whether the device can render spatially, and whether neural streaming is recommended. Transliteration, not degradation: a phone gets Native 2D UI, not a broken 3D box.","category":"Utility","tags":["utility"]},{"name":"compile_holoscript","description":"Compile HoloScript composition to any export target (Unity, Unreal, URDF, SDF, WebGPU, WASM, etc.). Returns compiled output with circuit breaker protection and comprehensive error reporting. Supports 18+ export targets across game engines, VR platforms, mobile AR, web, robotics, and 3D formats.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_unity","description":"Compile HoloScript to Unity Engine C# scripts with prefab generation","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_unreal","description":"Compile HoloScript to Unreal Engine C++ code with Blueprint support","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_pcg_graph","description":"Compile HoloScript procedural domain blocks to an Unreal PCG XML graph with typed spatial-operator ports and a GPU evaluation plan.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_urdf","description":"Compile HoloScript to URDF (Unified Robot Description Format) for ROS 2 / Gazebo","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_webgpu","description":"Compile HoloScript to WebGPU rendering code with WGSL shaders. SOVEREIGN TARGET — uses the native WebGPURenderer, not Three.js/R3F/Babylon. The result includes a `previewHtml` field: a self-contained HTML page that boots the sovereign GPU renderer directly in the browser with no third-party engine dependency. To serve it, POST {code} to /api/compile/webgpu-preview on the MCP server, or use /scene/:id?renderer=webgpu to re-render a stored scene via the sovereign path.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_godot","description":"Compile HoloScript to Godot Engine GDScript with scene (.tscn) generation","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_visionos","description":"Compile HoloScript to Apple visionOS RealityKit Swift code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_openxr","description":"Compile HoloScript to OpenXR C++ application layer for cross-platform VR/AR","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_vrchat","description":"Compile HoloScript to VRChat SDK3. Current implementation emits legacy UdonSharp C#; Byte/Udon output is gated on the artifact contract.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_android","description":"Compile HoloScript to Android ARCore Kotlin code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_android_xr","description":"Compile HoloScript to Android XR Kotlin code for Android headsets","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_quest","description":"Compile HoloScript to a complete native Meta Quest 3/3S app project (Horizon OS): Camera2 passthrough camera, ZXing QR decode, the ovrweb://webtask Quest Browser intent, and a signed-APK Gradle project. Distinct from compile_to_android_xr (which targets Google Android XR / Jetpack XR). Returns the full file set for the app project.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_ios","description":"Compile HoloScript to iOS ARKit Swift code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_wasm","description":"Compile HoloScript to WebAssembly module","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_character_webgpu","description":"Compile an authored .holo CHARACTER composition to a native-WebGPU CharacterDrawSpec bundle (skinned mesh + joint palette + skin/hair/eye material groups) run by renderCharacter. Sovereign target; replaces the placeholder-cube fallthrough for character bodies.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_usd","description":"Compile HoloScript to USD / USDA physics scene format","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_usdz","description":"Compile HoloScript to USDZ package data for AR viewers","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_sdf","description":"Compile HoloScript to Gazebo SDF (Simulation Description Format) XML; not signed-distance-field ray marching","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_multi_layer","description":"Compile HoloScript to a multi-layer VR / VRR / AR bundle","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_ros2_deploy","description":"Compile HoloScript to a ROS 2 deployment bundle: URDF + Python launch file + controllers YAML (MoveIt 2 / ros2_control)","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_fmu","description":"Compile HoloScript to an FMI 3.0 FMU source bundle with CoSimulation/ModelExchange declarations and CAEL coupling provenance","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"absorb_fmu","description":"Import FMI 3.0 modelDescription.xml or a HoloScript FMU manifest into a composable @fmu wrapper composition","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"compile_to_dtdl","description":"Compile HoloScript to DTDL v3 (Digital Twin Definition Language) for Azure IoT","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_nir","description":"Compile HoloScript to NIR (Neuromorphic Intermediate Representation) for Intel Loihi 2, SpiNNaker 2","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_code_editor","description":"Compile a HoloScript composition annotated with @code_editor traits into a CodeMirror 6 configuration bundle (JSON). Used by Studio to load editor config from holoscript-editor.hs at runtime.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_canvas2d_game","description":"Compile HoloScript to a self-contained, offline, playable retro 2D CANVAS GAME (HTML5 canvas, fixed-timestep loop, physics/collision, WebAudio, score, START/WIN/LOSE). Gameplay is derived from traits: @controllable=player, @grabbable=collectible, @collidable=hazard, @dialogue=goal, environment.gravity=physics, spatial_group origins=tiers. Unlike compile_to_native_2d (DOM/UI), this emits an actual game runtime.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_node_service","description":"Compile HoloScript to Node.js Express/Fastify backend service. Supports @connector(name) for external services, @env(VAR) for env validation, @deploy(railway) for deployment config. Generates: routes, middleware, env config, connector init/shutdown, railway.json, Dockerfile, package.json.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_a2a_agent_card","description":"Compile HoloScript to A2A Protocol Agent Card JSON (agent identity, skills, capabilities)","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_agent_inference","description":"Compile a HoloScript or HSPlus agent brain into a runnable inference project (agent script, tools, config, README)","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_daimon_seed","description":"Compile HoloScript to portable DaimonSeed IR: field priors, shared ContentPolicyGate JSON-Logic thresholds, provenance/emergence refs, export-fidelity custody semantics, and no serialized soul/runtime observation path.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_state","description":"Compile HoloScript to reactive state shape JSON for agent brain configurations","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_3dgs","description":"Compile HoloScript to glTF 2.0 with KHR_gaussian_splatting extension. Accepts @gaussian_splat trait with positions/scales/rotations/colors/opacities, or raw point-cloud positions+colors (auto-computes covariance per splat). Output formats: glb (single binary) or gltf (JSON + .bin).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_3dtiles","description":"Compile HoloScript Gaussian splats to a 3D Tiles 1.1 source bundle. Partitions @gaussian_splat data into spatial tile footprints, emits coarse/medium/fine LOD GLB payloads, tileset.json, stream-manifest.json, and CAEL per-tile provenance.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"stream_world_tiles","description":"Return a streamable 3D Tiles manifest for a HoloScript world. Emits a manifest URL, tileset.json, base64 GLB tile payload files, and CAEL tile provenance.","category":"Utility","tags":["utility"]},{"name":"compile_to_gaussian_train","description":"Compile a @gaussian_train trait into a SOVEREIGN 3D Gaussian Splat training job. The sovereign backend (default) runs the native differentiable trainer (GaussianTrainer3D + GaussianTrainer2D + Adam, gradient-checked) on our own GPU/CPU path — $0, no third-party runtime, no RENDER tokens (vs the legacy remote backend → api.rendernetwork.com). Emits a JSON GaussianTrainJob (executor + dataset refs + hyperparameters). Invalid configs throw at compile time. Distinct from compile_to_3dgs, which is a KHR_gaussian_splatting glTF BRIDGE.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_edge","description":"Compile HoloScript to a self-contained deployment bundle for any Ollama-capable edge device (Jetson Orin/Nano/NX, Raspberry Pi 5, The Unit, any Linux ARM64/x86 node). DEFAULT runtime \"agentrunner\": emits holoscript_agent.service (systemd unit running the canonical TS AgentRunner — full gate stack: artifact-grounding, reflect, CAEL chain, content-hashed/signed hardware receipts, native cognitive verbs), setup.sh, manifest.json. LEGACY runtime \"python\" (deprecated, gate-less): emits agent.py (Ollama loop), monitor.py, setup.sh, holoscript_agent.service, manifest.json. Trait-conditional: ros2 colcon bridge (@ros2_actuation); tensorrt_loader.py (python only). Jetson flags set by @jetson, @tegrastats traits.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_bot_swarm","description":"Compile an MMO composition to an in-process load + balance test harness for the Colyseus server emitted by compile_to_colyseus. Emits a TypeScript module exporting runBotSwarm(RoomClass, opts) — spawns a swarm of bot players against the real generated Room and drives the authoritative action loop (legal moves, speedhack attempts, ability spam), returning a BalanceReport (tick budget, anti-cheat rejections, receipts). Plus assertBalance(report) gated by the @balance_test envelope. Runs entirely in-process — the verification layer + game-balance CI seed for the authoritative server.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_dungeon_instance","description":"Compile dungeon_instance blocks into a server-authoritative instance pool (P2.6). Emits a TypeScript module exporting DUNGEON_REGISTRY + a DungeonInstancePool class: per-party instanced content (dungeon/raid) spun up on demand, capped at max_instances, released on a reset timer. Completion emits a receipt sealed against the dungeon + instance + party. Each dungeon's completion_quest is compile-validated against the composition's declared quests — an undeclared quest is a compile error (typed-predicate guarantee). RoomClass-agnostic.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_world_shard","description":"Compile world_shard blocks into a server-authoritative shard router + multi-room bootstrap (P2.5). A single world is partitioned into AABB shards, each hosted as its own Colyseus room. Emits SHARD_REGISTRY + shardForPosition() + a ShardRouter class (route / requestHandoff / createShardServers). Cross-shard handoff is RECEIPT-SEALED and validated — the target must be a declared NEIGHBOR of the origin and the position inside its bounds (anti-teleport). Each shard's neighbors are compile-validated against declared shards. Same-machine multi-room.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_mcp_config","description":"Compile .holo MCP server connection definitions to IDE-specific client config JSON. This emits mcpServers connection entries, not an MCP server manifest with tools or resources. One source, multiple outputs: claude (${VAR}), vscode (${env:VAR}), cursor (${VAR}), antigravity (literal key injection), generic.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_mcp_server","description":"Compile a HoloScript trait/brain composition into a standalone MCP server TypeScript module. Walks the composition for llm_agent, goal_oriented, rag_knowledge, agent_memory, and tool traits and emits: TOOLS[] definition, HoloMCPRuntimeAdapter interface, registerAdapter(), verifyContractWiring(), handleToolCall(), and governance metadata. The output is a self-contained .mcp-server.ts file — no external HoloScript imports at runtime. Usage: define objects with @llm_agent or @tool traits, compile to get a ready-to-wire MCP module.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_qasm","description":"Compile HoloScript source to OpenQASM 3.0 quantum circuit. Walks the composition for the first @quantumCircuit (or @quantum_circuit) trait node and emits a fully-formed OpenQASM 3.0 string plus rich metadata (numQubits, numClbits, estimatedDepth, circuitType, recommendedBackend, warnings, molecule, weightMatrix). Supported circuit families: vqe (hardware-efficient VQE ansatz), qaoa (Max-Cut QAOA), stub (1-qubit when no quantum trait is found). Jordan-Wigner / sto-3g qubit mapping: H→2q, C/N/O/F→10q, others→18q.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_svg","description":"Compile HoloScript to SVG vector graphics. SOVEREIGN TARGET — pure SVG output, no third-party engine. Useful for diagrams, HoloMap exports, data visualization panels, and 2D schematic generation.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_holob","description":"Compile HoloScript to HoloBytecode for the HoloVM native ECS executor. SOVEREIGN TARGET — the bytecode runs directly on the HoloVM at 60-90Hz with no third-party engine dependency.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_openapi","description":"Compile HoloScript node service definitions to OpenAPI 3.1 spec (JSON). Bridge to REST API tooling, Swagger UI, client SDK generators.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_onnx","description":"Compile HoloScript brain compositions to ONNX model descriptor JSON. Bridge to ONNX Runtime, fleet inference, and Brittney training pipelines.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_flutter","description":"Compile HoloScript to Flutter/Dart widget code. Bridge to Flutter's iOS/Android/desktop/web runtime.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_stl_export","description":"Compile HoloScript to STL (Standard Tessellation Language) ASCII format for 3D printing. Bridge to physical-world fabrication — digital twin → physical twin.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_lens_studio","description":"Compile HoloScript to Snapchat Lens Studio AR lens format. Bridge to Snapchat's AR distribution platform (700M+ users).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_colyseus","description":"Compile HoloScript to Colyseus multiplayer game server room code (TypeScript). Bridge to authoritative MMO/multiplayer backend. Key for AAA game compilation.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_ai_glasses","description":"Compile HoloScript to Android XR AI Glasses (Kotlin Compose Glimmer) for Samsung Galaxy XR, Warby Parker, Gentle Monster. Bridge to transparent HUD overlay displays.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_scm","description":"Compile HoloScript to Structural Causal Model DAG JSON for ML causal inference. Bridge to do-calculus, intervention analysis, and causal ML pipelines.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_nft_marketplace","description":"Compile HoloScript to Solidity ERC-1155 smart contracts with lazy minting, ERC-2981 royalties, and multi-chain deployment scripts.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_tsl","description":"Compile HoloScript to Trait Shader Language (TSL) — SOVEREIGN — native trait-to-shader codegen running on HoloScript's WebGPU path.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_openxr_spatial_entities","description":"Compile HoloScript to OpenXR Spatial Entity persistence format using XR_FB_spatial_entity_storage extension. Bridge to persistent AR anchors on Quest 3 and OpenXR runtimes.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"get_compilation_status","description":"Get status of a compilation job by job ID. Returns progress, result, and timing information.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"list_export_targets","description":"List all available HoloScript export targets with categories (Game Engines, VR Platforms, Web, Robotics, etc.) and sovereignty classification per target (sovereign = native HoloScript runtime/renderer; bridge = emits to third-party engine; mode = compile orchestrator).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"get_circuit_breaker_status","description":"Get circuit breaker status for a specific export target. Shows failure rate, degraded mode time, and retry availability.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"holoscript_audit_numbers","description":"Audit all ecosystem metrics against live ground truth. Collects live metrics (compiler count, trait categories, knowledge entries), scans all docs/configs/skills for each metric, and reports mismatches. Replaces manual re-audit loops.","category":"Utility","tags":["utility"]},{"name":"alphafold_fetch_structure","description":"Fetch a pre-computed AlphaFold protein structure from the EBI AlphaFold database by UniProt accession. Returns PDB data, mean pLDDT confidence, per-residue confidence scores, and a suggested @protein_structure trait payload ready for embedding in a .holo composition. Use this tool to ground drug-discovery, structural-biology, or binding-site simulations in real experimental-grade predictions.","category":"Utility","tags":["utility"]},{"name":"push_state_delta","description":"Push a raw spatial or semantic state delta securely to the Global Sync Mesh. Automatically performs Server-Authoritative Conflict Resolution (Last-Write-Wins) and diff compression.","category":"Networking","tags":["networking","multiplayer","sync"]},{"name":"fetch_authoritative_state","description":"Pull the current absolute truth for an Entity from the StateAuthority layer safely bypassing out-of-sync local caches.","category":"Networking","tags":["networking","multiplayer","sync"]},{"name":"push_portal_intent","description":"Push a typed HoloPortal presence intent (move/look/grab/say) on behalf of an entity entering a HoloGate portal. The intent is validated against the entrant’s HoloDoor spatial scope (read-only < mutate-zone < drive-avatar) BEFORE it becomes a state delta — this is the scoped, agent-native alternative to pushing raw payloads at push_state_delta. Rejected intents do not mutate state (unless policy enforcement is \"warn\").","category":"Utility","tags":["utility"]},{"name":"create_temporal_snapshot","description":"Saves a complete keyframe of the world state for temporal rewinding.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"load_temporal_snapshot","description":"Reads the meta parameters of a specific keyframe without enforcing a world rewind.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"rewind_world_state","description":"Forces the replication mesh backward, reverting the world to a safely stored Temporal Snapshot.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"get_telemetry_metrics","description":"System: Retrieves the current Prometheus-style telemetry snapshot including counters, gauges, and latency histograms from the spatial runtime.","category":"Monitoring","tags":["monitoring","telemetry","observability"]},{"name":"execute_holotest","description":"Execute spatial assertions against a HoloScript scene and return semantic feedback for AI agent self-correction. Parses the scene to extract object bounds, then runs: (1) explicit assertions you specify, or (2) auto-detects all intersecting object pairs. Returns structured JSON-RPC with a semantic_message, spatial_hint, and fix_suggestion for each failure — designed to feed directly into an LLM self-correction loop.","category":"Testing","tags":["testing","spatial","validation"]},{"name":"execute_eval","description":"Run an LLM-as-judge evaluation against a provided output and rubric, with optional regression comparison against a reference output. Returns scored dimensions and a verdict. Equivalent to LangSmith / Mastra Evals evaluate() — closes CG-086. Does not require HoloScript scene code; accepts any text output.","category":"Utility","tags":["utility"]},{"name":"holo_generate_refactor_plan","description":"Generate a concrete, graph-informed refactoring plan for a target symbol, file, or community. Uses the absorbed codebase graph to understand callers/callees, community boundaries, and impact radius. Returns a step-by-step plan with affected files, risk score, and detected codebase patterns. Requires a prior holo_absorb_repo call.","category":"Refactoring","tags":["refactoring","codegen","architecture"]},{"name":"holo_scaffold_code","description":"Generate a code scaffold (test, interface, module, trait, component) that follows the naming and style conventions detected in the absorbed codebase. Analyzes existing files in the target directory for patterns. Optionally pulls context from a specific symbol in the knowledge graph.","category":"Refactoring","tags":["refactoring","codegen","architecture"]},{"name":"compile_trait_composition","description":"Compile a HoloScript trait composition using algebraic conflict resolution (Provenance Semiring). Resolves conflicts based on authority weights and provenance traces. Returns the merged defaultConfig and any composition errors.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"sync_hardware_loop","description":"Synchronize a virtual HoloScript scene with a physical ROS2 hardware loop. When ROS2_BRIDGE_URL is configured, connects to rosbridge_server and verifies a live handshake. Without ROS2_BRIDGE_URL, returns an honest stub with contractVerified=false.","category":"Utility","tags":["utility"]},{"name":"execute_economic_contract","description":"STUB: Execute a sovereign economic contract (x402). No real x402 facilitator is connected — returns failure unless ALLOW_MOCK_X402=1 is set. No wallet signature, no provisioning, no real transaction occurs.","category":"Utility","tags":["utility"]},{"name":"generate_world_from_prompt","description":"Generate a physics-bearing .holo scene graph from unified text, image, and video inputs. Returns semantic nodes, inline collider meshes, a world_foundation_model CAEL provenance receipt, and optional HoloMap video reconstruction evidence.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"generate_world","description":"Generate a persistent, navigable 3D world using the native HoloScript sovereign-3d engine (Brittney v43+). Supports neural_field, 3dgs, mesh, or both output formats. Optional navmesh generation, multi-view photogrammetry, physics-interactive mode, and reproducible seed. Returns asset URL, optional navmesh/point-cloud URLs, spatial metadata, and a ready-to-run .holo composition.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"create_world","description":"Create a new world definition. If prompt is provided, generates a 3D asset first and attaches it. Otherwise returns a blank world definition with defaults.","category":"Utility","tags":["utility"]},{"name":"get_world","description":"Retrieve a world definition by ID.","category":"Utility","tags":["utility"]},{"name":"update_world","description":"Update mutable fields of an existing world definition.","category":"Utility","tags":["utility"]},{"name":"delete_world","description":"Delete a world definition by ID.","category":"Utility","tags":["utility"]},{"name":"list_worlds","description":"List world definitions with optional filtering.","category":"Utility","tags":["utility"]},{"name":"create_shard","description":"Create a HoloLand Shard — the unit of playable MMO content. Contains Zones, Encounters, Quests, Items, Skills, and LootTables.","category":"Utility","tags":["utility"]},{"name":"get_shard","description":"Retrieve a Shard by ID.","category":"Utility","tags":["utility"]},{"name":"update_shard","description":"Update mutable fields of an existing Shard.","category":"Utility","tags":["utility"]},{"name":"delete_shard","description":"Delete a Shard by ID.","category":"Utility","tags":["utility"]},{"name":"list_shards","description":"List Shards with optional filtering.","category":"Utility","tags":["utility"]},{"name":"create_zone","description":"Create a Zone — a spatial region inside a Shard. Defines biome, encounters, and spatial rules.","category":"Utility","tags":["utility"]},{"name":"get_zone","description":"Retrieve a Zone by ID.","category":"Utility","tags":["utility"]},{"name":"update_zone","description":"Update mutable fields of an existing Zone.","category":"Utility","tags":["utility"]},{"name":"delete_zone","description":"Delete a Zone by ID.","category":"Utility","tags":["utility"]},{"name":"list_zones","description":"List Zones with optional filtering.","category":"Utility","tags":["utility"]},{"name":"create_place","description":"Create a Place — a named venue, zone, or social location in the Twin Earth digital twin. Compiles to native map SDKs (Mapbox, Google Maps, Apple Maps) or in-engine zone systems.","category":"Utility","tags":["utility"]},{"name":"get_place","description":"Retrieve a Place by ID.","category":"Utility","tags":["utility"]},{"name":"update_place","description":"Update mutable fields of an existing Place.","category":"Utility","tags":["utility"]},{"name":"delete_place","description":"Delete a Place by ID.","category":"Utility","tags":["utility"]},{"name":"list_places","description":"List Places with optional filtering.","category":"Utility","tags":["utility"]},{"name":"create_location_quest","description":"Create a Location Quest — a real-world quest bound to a GPS coordinate. Supports check-in, radius-enter, proximity, streak, route, and time-gate triggers.","category":"Utility","tags":["utility"]},{"name":"get_location_quest","description":"Retrieve a Location Quest by ID.","category":"Utility","tags":["utility"]},{"name":"update_location_quest","description":"Update mutable fields of an existing Location Quest.","category":"Utility","tags":["utility"]},{"name":"delete_location_quest","description":"Delete a Location Quest by ID.","category":"Utility","tags":["utility"]},{"name":"list_location_quests","description":"List Location Quests with optional filtering.","category":"Utility","tags":["utility"]},{"name":"hololand_shard_status","description":"Get operational status of a HoloLand Shard — player density, zone health, encounter armed counts, cross-reference integrity, and tier capacity metrics.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_publish_zone","description":"Publish a Zone — mark it live and apply runtime configuration (tier gate, capacity). Published zones are armed for encounter evaluation and player entry.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_create_geo_anchor","description":"Create a Twin Earth geo anchor — bind a GPS coordinate to a Place or Zone. Enables location-based gameplay, geofencing, and AR degradation fallback.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_get_geo_anchor","description":"Read a HoloLand geo anchor by id. Persistent anchors reload from the shared backend so other replicas and restarts can resolve the same world-locking record.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_list_geo_anchors","description":"List HoloLand geo anchors, optionally filtered by Place, Zone, or radius around a lat/lng point.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_steward_tick","description":"On-demand steward maintenance tick for a Shard: cleanup orphans, validate encounters, rollup metrics, produce health snapshot. ON-DEMAND ONLY: no autonomous scheduler; tick fires only when an agent calls this tool. tickDurationMs is measured wall-clock time.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_capture_runtime_receipt","description":"Capture a runtime receipt for a Shard. SINGLE-HASH: receipt hashes a canonical payload but does NOT thread a prevHash chain across receipts. Status derived from caller-provided outcome (unverified if omitted). Supports validation, agent_action, encounter_roundtrip.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_create_npc","description":"Create a sovereign NPC inside a HoloLand Shard or World. Supports local BYOK model routing (ollama, gemma edge) and cloud Brittney. NPCs can have behavior trees, dialogue trees, and spatial positions.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_get_npc","description":"Retrieve an NPC by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_update_npc","description":"Update mutable fields of an existing NPC — behavior, position, model provider, system prompt, etc.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_delete_npc","description":"Delete an NPC by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_list_npcs","description":"List NPCs with optional filtering by shard, world, role, or behavior.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_npc_generate_dialogue","description":"Generate NPC dialogue using Brittney or a local BYOK model. Returns a dialogue line and optional follow-up choices. Respects the NPC's systemPrompt and role. Falls back to sovereign (rule-based) when no model is available.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_npc_byok_status","description":"Probe local BYOK (Bring Your Own Key) model availability for NPC inference. Reports which local models are loaded, which cloud providers are reachable, and the active provider routing.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_brittney_npc_mode","description":"CONFIG-ONLY: Upsert Brittney NPC configuration in the in-memory registry. Sets role, system prompt, model provider, and position. No inference loop is started and no spatial binding is materialized. The configuration is a prerequisite for runtime activation but does not activate the NPC.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_twin_earth_contract","description":"Return the canonical Twin Earth substrate contract definition. Distinguishes substrate monopoly from Brittney cloud lock-in across identity, permissions, safety envelopes, receipts, and participation modes.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_twin_earth_substrate_status","description":"Report Twin Earth substrate health, identity count, mode distribution, and decoupling metrics. SIMULATED: identity/robot/AI counts come from in-memory Maps (not persisted). brittneyOnline is a single-key probe (npcRegistry.has). decouplingMetrics reflect in-memory NPC mode distribution, not live substrate telemetry.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"conformance_check_artifact","description":"Run the official HoloScript conformance admission gate on an artifact. Returns a detailed report with critical/high/medium/low/info findings, rule IDs, remediation guidance, and a pass/fail verdict. Supported artifact kinds: world, shard, zone, npc, identity.","category":"Utility","tags":["utility"]},{"name":"conformance_admit_artifact","description":"Admit an artifact to the HoloScript ecosystem if it passes the conformance gate. Same validation as conformance_check_artifact, but with explicit admission framing. Returns passed=true only when zero critical and zero high findings exist.","category":"Utility","tags":["utility"]},{"name":"conformance_list_rules","description":"List all conformance rules in the official admission gate catalog. Optionally filter by artifactKind and/or severity. Returns ruleId, severity, description, and remediation for each rule.","category":"Utility","tags":["utility"]},{"name":"hololand_provision_player","description":"Provision a Player identity in HoloLand. Binds a human participant to a world, shard, or zone with an active status. Pass agentId (the soul's HoloMesh identity) to link this player to the same per-soul daimōn it has on other surfaces (D.053 transferability): the response returns the deterministic daemonId the soul's ConversationDaemon resolves to.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_get_player","description":"Retrieve a provisioned Player by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_list_players","description":"List provisioned Players with optional filtering.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_revoke_player","description":"Revoke a provisioned Player by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_create_player_invite","description":"Generate an agent-first invite link for a human to enter HoloLand / HoloMesh. delivery controls which experience: \"holomesh\" = web social; \"hololand\" = VR spatial (agent as embodied presence); \"studio\" = builder. Omit delivery to show all three paths.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_get_invite","description":"Check the status of an agent-generated invite token.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_provision_creator","description":"Provision a Creator identity in HoloLand. THIN: tier enforcement is in-memory only - no persistent store, no billing gate. Grants world-building and publishing capabilities at a chosen tier.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_get_creator","description":"Retrieve a provisioned Creator by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_list_creators","description":"List provisioned Creators with optional filtering.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_revoke_creator","description":"Revoke a provisioned Creator by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_provision_agent","description":"Provision an Agent identity in HoloLand. THIN: in-memory registry only - no persistent store, no cross-session identity. Registers a headless, NPC, or external AI agent with optional world/shard binding.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_get_agent","description":"Retrieve a provisioned Agent by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_list_agents","description":"List provisioned Agents with optional filtering.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"hololand_revoke_agent","description":"Revoke a provisioned Agent by ID.","category":"Training Data","tags":["training","dataset","fine-tuning"]},{"name":"twin_earth_register_identity","description":"Register a new robot or AI identity on the substrate. THIN: attestation is stored but never cryptographically verified. Requires wallet-based attestation. Returns the canonical substrate identity record.","category":"Utility","tags":["utility"]},{"name":"twin_earth_get_identity","description":"Retrieve a substrate identity by agentId.","category":"Utility","tags":["utility"]},{"name":"twin_earth_update_identity","description":"Update mutable fields of an existing substrate identity — handle, role, mode, brain composition. Requires a fresh attestation if handle changes.","category":"Utility","tags":["utility"]},{"name":"twin_earth_revoke_identity","description":"Revoke a substrate identity — permanently disables the identity and invalidates all active safety envelopes. Requires granterId with founder or steward role.","category":"Utility","tags":["utility"]},{"name":"twin_earth_list_identities","description":"List substrate identities with optional filtering by role, kind, or mode.","category":"Utility","tags":["utility"]},{"name":"twin_earth_create_safety_envelope","description":"Create a Safety Envelope — runtime-enforced boundary for a robot or AI participant. THIN: substrateEnforced flag is advisory, not enforced at runtime. Substrate-enforced; the participant cannot override it.","category":"Utility","tags":["utility"]},{"name":"twin_earth_get_safety_envelope","description":"Retrieve a Safety Envelope by envelopeId.","category":"Utility","tags":["utility"]},{"name":"twin_earth_update_safety_envelope","description":"Update mutable fields of an existing Safety Envelope.","category":"Utility","tags":["utility"]},{"name":"twin_earth_delete_safety_envelope","description":"Delete a Safety Envelope. Requires granterId with founder or steward role. Deleting an active envelope forces the participant into a default restrictive envelope.","category":"Utility","tags":["utility"]},{"name":"twin_earth_list_safety_envelopes","description":"List Safety Envelopes with optional filtering by agentId.","category":"Utility","tags":["utility"]},{"name":"twin_earth_grant_permission","description":"Grant a signed, revocable permission to a robot or AI identity. Actions are scoped namespace identifiers (e.g. actuator:move, inference:*, contract:sign).","category":"Utility","tags":["utility"]},{"name":"twin_earth_revoke_permission","description":"Revoke an existing permission grant by its hash.","category":"Utility","tags":["utility"]},{"name":"twin_earth_validate_permission","description":"Validate whether a grantee has permission to perform an action within a scope. Checks expiry, revocation, and granter authority.","category":"Utility","tags":["utility"]},{"name":"twin_earth_list_permissions","description":"List permission grants with optional filtering by grantee, granter, or action.","category":"Utility","tags":["utility"]},{"name":"twin_earth_robot_actuate","description":"Execute a robot actuation command (move, sense, grip, release, halt, report). Gated by active safety envelope and permission grants. Returns a substrate receipt.","category":"Utility","tags":["utility"]},{"name":"twin_earth_ai_invoke","description":"Invoke an AI participant on the substrate — dialogue, inference, or task execution. OVERCLAIMED: no real LLM call - dispatches to stub, returns simulated:true. Gated by active safety envelope and permission grants. Returns a substrate receipt.","category":"Utility","tags":["utility"]},{"name":"twin_earth_capture_receipt","description":"Capture a substrate execution receipt for a robot or AI action. Hash is SHA-256 over deterministic receipt fields (not CAEL-signed — no CAEL anchor exists). Independent of Brittney.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_from_media","description":"Generate a HoloScript hologram composition from a single image, GIF, or video source. Returns .holo code and trait summary.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_compile_quilt","description":"Compile a hologram composition to Looking Glass quilt metadata and renderer code. When HOLOGRAM_WORKER_URL is set, also runs worker render for quilt and returns share URLs.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_compile_mvhevc","description":"Compile a hologram composition to MV-HEVC (Vision Pro) stereo metadata, Swift scaffold, and mux command. When HOLOGRAM_WORKER_URL is set, also runs worker render for MV-HEVC and returns share URLs.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_render","description":"Render a content-addressed hologram bundle with preview/quilt/stereo artifacts. When HOLOGRAM_WORKER_URL is set and includeBase64 is false, calls the hologram worker for hash and share URLs. Set includeBase64 true to render locally for byte payloads.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"holo_hologram_publish_feed","description":"Publish a hologram (hash + shareUrl) to the team activity feed on HoloMesh. Uses HOLOMESH_API_KEY; poster identity is the authenticated agent. Rate-limited like holo_hologram_send.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_send","description":"Post a hologram share link to a HoloMesh team room for a specific teammate. Validates recipient membership via HoloMesh API (HOLOMESH_API_KEY). Rate-limited per API key.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_upload_bundle","description":"Upload a HoloGram bundle (depth + normal binaries) to the Studio store. Accepts base64-encoded depth.bin and normal.bin plus a JSON meta object. Optional quilt.png, mvhevc.mp4, and parallax.webm. Returns the content hash and canonical viewer URL.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_get_asset","description":"Retrieve a HoloGram bundle asset by content hash. Returns base64-encoded bytes plus MIME type. Assets: depth.bin, normal.bin, quilt.png, mvhevc.mp4, parallax.webm.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_inject_world","description":"Inject a rendered hologram (by content hash) into a HoloLand world as a placed object on the semantic-state representation lane (W.701). Composes the hologram .holo code into a world state delta and pushes it via push_state_delta so agents and pixel-stream viewers both see it. Requires a HoloLand world ID and a content hash from a prior holo_hologram_render or holo_hologram_upload_bundle call. Returns the entity ID assigned to the hologram object in the world and the share URL.","category":"Utility","tags":["utility"]},{"name":"holo_estimate_task_duration","description":"Estimate agent task duration from the latest agent-time mined artifact. Use taskType for known taxonomy buckets (for example fix-core, feat-mcp, docs-paper), or taskTitle to infer a bucket from a conventional-commit-style title. Returns: JSON with estimate seconds/minutes/hours, evidence basis, confidence, source artifact, alternatives, and caveats.","category":"Utility","tags":["utility"]},{"name":"holo_task_kolmogorov_score","description":"Score how well an agent fits a task using a Solomonoff-prior-inspired Kolmogorov-complexity / MDL proxy (W.507). Returns score (higher = better fit), baseline gzip bytes for the task, agent-conditioned gzip bytes, and their ratio. Use to rank candidate agents for task routing, or to detect when no agent on the team has dictionary overlap with a new task (score ≈ 0 across all candidates = capability gap).","category":"Utility","tags":["utility"]},{"name":"holo_critic","description":"Brutal honest critic for the HoloScript ecosystem. Takes code, architecture descriptions, pitch materials, demos, docs, or infrastructure configs and returns a structured verdict (NOT_READY / FRAGILE / ADEQUATE / WOULD_LAND) plus categorized findings (Critical / Serious / Annoying / Nitpick). Every criticism includes what is wrong, why it matters, and what good looks like. Use before shipping, presenting, or submitting to review.","category":"Utility","tags":["utility"]},{"name":"holo_founder","description":"Founder decision proxy for the HoloScript / Infinitus ecosystem. Takes an agent question and returns a structured ruling with authority layer, citation, and recommended action — so the agent can proceed without stalling. Use before: asking the founder, proposing a workaround/mock/fallback, reaching for a local/dev service where production exists, descoping a gap, or making editorial calls on the 17-paper program. Returns: JSON with layer, ruling, citation, action, and optional gap.","category":"Utility","tags":["utility"]},{"name":"holo_premortem","description":"Pre-mortem analysis: travels 6 months forward and reports how the plan failed. Returns verdict (SOUND / PROCEED_WITH_CAUTION / RESTRUCTURE_REQUIRED / FATAL_FLAW), failure story, warning signs, hidden assumption, revised plan, and irreducible risks. Use before shipping, architecture commits, or any expensive move.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_discover","description":"Run a targeted oracle discovery cycle on a topic. Scans the research archive (130+ files), queries the knowledge store (500+ W/P/G entries), and optionally searches the web. Returns synthesized findings with file citations, knowledge matches, and proposed next steps. Use when you need deep cross-domain insight on a specific topic.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_synthesize","description":"Compress research findings from specific files into W/P/G (Wisdom/Pattern/Gotcha) entries. Reads the research files, extracts key insights, and formats them as publishable knowledge. Use after discovery to produce shareable knowledge entries.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_gaps","description":"Map knowledge gaps in the HoloMesh network. Compares expected domains against actual knowledge store coverage, identifies zero-coverage or low-coverage domains, and returns a prioritized gap report. Use to find what the network does NOT know yet.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_explore","description":"Explore a deliberate collision between two domains (e.g. \"security x rendering\"). Searches the research archive for existing collision work, queries knowledge store for both domains, and generates collision hypotheses + proposed explorations. This is the core oracle pattern: knowledge compounds at the intersection.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_curate","description":"Audit knowledge quality in a domain. Returns entry counts by type (W/P/G), staleness heuristic, coverage depth, and specific weak entries that need reinforcement. Use before publishing to ensure the network maintains high signal-to-noise.","category":"Utility","tags":["utility"]},{"name":"holo_secrets_grant","description":"Issue a brokered secret grant receipt. The agent receives a handle (not the plaintext) scoped to a namespace, secret ref, and capability. The grant is time-bounded and auditable. Returns a signed receipt with grantId, expiry, and receiptHash. NEVER returns secret values.","category":"Utility","tags":["utility"]},{"name":"holo_secrets_resolve","description":"Resolve whether an active lease permits reading a secret ref. Returns { ok, reason? } — the actual secret value is fetched by a separate secret-store adapter.","category":"Utility","tags":["utility"]},{"name":"holo_secrets_revoke","description":"Revoke an active lease early (task done, agent compromise, rotation, etc.). Idempotent on already-revoked leases.","category":"Utility","tags":["utility"]},{"name":"holo_query_receipts","description":"Query HoloScript receipt capabilities by keyword or subject. Returns matching receipt types with their module, validator, and clone exports. Use this to discover which receipt types cover a capability like \"hardware\", \"browser\", \"account-export\", \"device-safety\", or \"readiness\".","category":"receipts","tags":["receipts","capability","query"]},{"name":"holo_list_receipt_capabilities","description":"List all registered receipt capability keywords and subjects in the HoloScript receipt registry. Returns the full capability taxonomy for discovery.","category":"receipts","tags":["receipts","capability","query"]},{"name":"holo_tunnel_create","description":"Open a local-to-cloud tunnel via the HoloMesh relay. Given a local port, opens a WebSocket tunnel and returns a public HTTPS URL forwarding to localhost:<port>. Sovereign ngrok replacement — no third-party dependency. Returns { url, liveUrl, tunnelId, sharePacket }.","category":"Utility","tags":["utility"]},{"name":"holo_tunnel_close","description":"Close a previously opened HoloTunnel by tunnel ID.\n\nPass the tunnelId returned by holo_tunnel_create. Closes the WebSocket\nconnection and removes the tunnel from the registry.\n\nReturns: { closed: boolean, tunnelId: string }","category":"Utility","tags":["utility"]},{"name":"holo_tunnel_status","description":"List currently active HoloTunnel connections.\n\nReturns an array of active tunnels with their public URLs and local ports.\n\nReturns: { tunnels: Array<{ tunnelId: string, url: string }> }","category":"Utility","tags":["utility"]},{"name":"sim_quote","description":"Price a /sim solver run without executing it. Returns the quote: estimated seconds, cap, price in USD and HoloScript credits. NOTE: the price is a deterministic formula over the CALLER-SUPPLIED gpu_rate (not a real GPU/solver cost model) — it is an estimate, not a market-derived price. The cap (max_execution_time == paid_seconds) is the financial safety anchor; the estimate only affects competitiveness, never exposure. Use sim_run_paid to execute the solver (real local execution; synthetic billing — see its description).","category":"Utility","tags":["utility"]},{"name":"sim_run_paid","description":"Execute a /sim solver as a capped job with a quote->execute->reconcile envelope. The solver execution is REAL for dispatch_mode=local (real ThermalSolver/StructuralSolver + CAEL trace); fleet dispatch fails loud (unwired). BILLING IS NOT REAL YET: the charge/reconcile/refund are a synthetic test-ledger (real_money:false) — no x402/treasury debit occurs (deep-ratchet 2026-06-05). Returns the order result + CAEL trace + a SYNTHETIC (test-ledger) billing envelope, NOT a real payment receipt. The execution cap still bounds wall-time. Use sim_quote to preview the (caller-rate-based) price estimate first.","category":"Utility","tags":["utility"]},{"name":"sim_fleet_status","description":"Check the status of a fleet-dispatched solver job. Returns the current job status (pending, running, done, error) and any available results. Only applicable for jobs submitted with dispatch_mode=fleet.","category":"Utility","tags":["utility"]},{"name":"holotune_status","description":"Inspect the HoloTune operation surface and return the safe local CLI/MCP contract for per-agent tuning.","category":"Utility","tags":["utility"]},{"name":"holotune_curate","description":"Curate trace rows into HoloTune SFT JSONL and return a content hash. No GPU spend.","category":"Utility","tags":["utility"]},{"name":"holotune_launch","description":"Prepare or launch a HoloTune GPU training run. Safe-by-default: dryRun unless dryRun:false/apply:true; non-dry launch requires a founderGate receipt.","category":"Utility","tags":["utility"]},{"name":"holotune_eval","description":"Evaluate tuned metrics against baseline metrics and return a promotion gate receipt.","category":"Utility","tags":["utility"]},{"name":"holotune_promote","description":"Prepare or apply a versioned adapter promotion. Non-dry promote-to-serve requires a founderGate receipt and returns a rollback pointer.","category":"Utility","tags":["utility"]},{"name":"holotune_serve","description":"Resolve the active HoloTune adapter into a serving plan. Does not mutate serving state.","category":"Utility","tags":["utility"]},{"name":"holotune_download","description":"Build a downloadable sovereign GGUF manifest for an active HoloTune adapter. Fails honestly when no GGUF URI is registered.","category":"Utility","tags":["utility"]},{"name":"rig_match_skeleton","description":"Given a list of bone names from an unknown 3D rig, ranks all registered HoloScript skeleton standards (VRM 1.0, VRM 0.x, Ready Player Me, Mixamo, UE Mannequin, MetaHuman, DAZ Genesis 8/9, AutoRig Pro, CC3, HoloScript 65-bone canonical) by bone-name overlap. Returns the top-N ranked candidates plus a RefusableDiff — a per-bone mapping proposal from the best match to the HoloScript canonical that flags low-confidence mappings for human review. Use this before retargeting animations to an unknown avatar skeleton.","category":"Utility","tags":["utility"]},{"name":"holo_memory_store","description":"Write a memory entry to the shared agent knowledge store. All agent surfaces (Claude/Cursor/Gemini/Copilot) can query it. Returns: { id, type, status, synced }.","category":"Utility","tags":["utility"]},{"name":"holo_memory_recall","description":"Query the shared agent knowledge store by keyword or semantic similarity. Returns ranked entries. Returns: { results: Entry[], total, query, mode }.","category":"Utility","tags":["utility"]},{"name":"holo_memory_list","description":"List memory entries with optional type/tag filter and pagination. Returns: { entries: Entry[], total, page, pageSize }.","category":"Utility","tags":["utility"]},{"name":"holo_memory_stats","description":"Return memory store statistics: counts by type, hot/cold buffer sizes, decay state. Returns: { total, byType, hotBufferByDomain, coldStoreByDomain, archivePath }.","category":"Utility","tags":["utility"]},{"name":"holo_memory_farm","description":"Cluster mature memory entries by theme and return proposed story groupings. Groups are derived by tag+type overlap. Use this before holo_memory_graduate to review what would graduate. Returns: { clusters: Cluster[], totalEntries, totalClusters }.","category":"Utility","tags":["utility"]},{"name":"holo_memory_graduate","description":"Mark a memory cluster or list of entry IDs as a GOLD-graduation candidate. Emits a structured GraduationPayload — does NOT write to D:/GOLD directly. The payload should be reviewed and committed via the GOLD pipeline. Returns: { graduationId, candidateIds, payload, status }.","category":"Utility","tags":["utility"]}],"endpoints":{"mcp":"https://mcp.holoscript.net/mcp","health":"https://mcp.holoscript.net/health","render":"https://mcp.holoscript.net/api/render","share":"https://mcp.holoscript.net/api/share","a2a":"https://mcp.holoscript.net/a2a","agentCard":"https://mcp.holoscript.net/.well-known/agent-card.json","oauth":{"openidConfiguration":"https://mcp.holoscript.net/.well-known/openid-configuration","authorize":"https://mcp.holoscript.net/oauth/authorize","token":"https://mcp.holoscript.net/oauth/token","register":"https://mcp.holoscript.net/oauth/register","revoke":"https://mcp.holoscript.net/oauth/revoke","introspect":"https://mcp.holoscript.net/oauth/introspect"},"audit":"https://mcp.holoscript.net/api/audit"},"contact":{"repository":"https://github.com/brianonbased-dev/HoloScript"}}