aboutsummaryrefslogtreecommitdiff
path: root/help.html
diff options
context:
space:
mode:
Diffstat (limited to 'help.html')
-rw-r--r--help.html91
1 files changed, 76 insertions, 15 deletions
diff --git a/help.html b/help.html
index 9d484fd..3a61042 100644
--- a/help.html
+++ b/help.html
@@ -231,9 +231,9 @@ footer .tagline{color:var(--accent2);margin-top:10px;font-weight:500}
<h1>WebX11 <span>Docs</span></h1>
</div>
<div class="header-meta">
- <span class="badge badge-v">v4.3</span>
- <span class="badge badge-new">18 core · 14 ext</span>
- <span style="color:var(--text2)">145+ commands</span>
+ <span class="badge badge-v">v4.4</span>
+ <span class="badge badge-new">28 core · 17 ext</span>
+ <span style="color:var(--text2)">150+ commands</span>
</div>
</div>
</header>
@@ -248,15 +248,14 @@ footer .tagline{color:var(--accent2);margin-top:10px;font-weight:500}
<a href="#skills" class="nav-link">Skills</a>
<a href="#ollama" class="nav-link">Ollama</a>
<a href="#web" class="nav-link">Search & Web</a>
- <a href="#voice" class="nav-link">Voice & Sound</a>
- <a href="#config" class="nav-link">Config</a>
- <a href="#vault" class="nav-link">Vault</a>
- <a href="#modules" class="nav-link">Modules</a>
- <a href="#extras" class="nav-link">Extras</a>
- <a href="#busybox" class="nav-link">BusyBox</a>
- <a href="#shell" class="nav-link">Shell</a>
- <a href="#sessions" class="nav-link">Sessions</a>
- <a href="#storage" class="nav-link">Storage</a>
+ <a href="#agents" class="nav-link">Agents</a>
+ <a href="#a2a-contracts" class="nav-link">A2A</a>
+ <a href="#neural-vfs" class="nav-link">Neural VFS</a>
+ <a href="#server-monitor" class="nav-link">Monitor</a>
+ <a href="#debug-panel" class="nav-link">Debug</a>
+ <a href="#sandbox" class="nav-link">Sandbox</a>
+ <a href="#memory-graph" class="nav-link">Memory</a>
+ <a href="#world-model" class="nav-link">World Model</a>
<a href="#security" class="nav-link">Security</a>
<a href="#trouble" class="nav-link">Troubleshoot</a>
<a href="#ref" class="nav-link">Quick Ref</a>
@@ -283,7 +282,7 @@ footer .tagline{color:var(--accent2);margin-top:10px;font-weight:500}
<div class="feature-grid">
<div class="feature-card"><h4>🖥️ Terminal OS</h4><p>Full virtual filesystem with ls, cd, cat, touch, edit, find, grep and 50+ Unix-like commands.</p></div>
<div class="feature-card"><h4>🤖 AI Assistant</h4><p>Built-in AI agent with tool calling, skills, memory, and 28 tools. Just type <code>ai "your question"</code>.</p></div>
- <div class="feature-card"><h4>🧩 Module System</h4><p>40+ modules including cron, mindmap, calculator, voice, WebDAV, themes, and shell scripting.</p></div>
+ <div class="feature-card"><h4>🧩 Module System</h4><p>46 modules across 3 layers — 28 core, 17 ext + test suite. Includes cron, mindmap, calculator, voice, WebDAV, themes, shell scripting, and agent orchestration.</p></div>
<div class="feature-card"><h4>📚 Skills</h4><p>Self-improving AI remembers workflows and teaches you new capabilities — type <code>skill-list</code> to see what's installed.</p></div>
</div>
</section>
@@ -1094,7 +1093,18 @@ vfs-import</pre>
<tr><td><code>lease-list</code></td><td>Show active leases — agent tasks with status and TTL</td></tr>
<tr><td><code>orchestrate &lt;task&gt;</code></td><td>Delegate multi-step task to agent orchestrator</td></tr>
<tr><td><code>orchestrator-status</code></td><td>Show orchestrator agent pool status</td></tr>
+ <tr><td><code>orchestrator-list</code></td><td>List all spawned agents with full details</td></tr>
<tr><td><code>orchestrator-spawn &lt;role&gt; [caps...]</code></td><td>Spawn a new worker agent</td></tr>
+ <tr><td><code>orchestrator-sleep &lt;id&gt;</code></td><td>Suspend agent to VFS (survives reload)</td></tr>
+ <tr><td><code>orchestrator-wake &lt;id&gt;</code></td><td>Restore agent from VFS sleep state</td></tr>
+ <tr><td><code>orchestrator-kill &lt;id&gt;</code></td><td>Terminate an agent and revoke leases</td></tr>
+ <tr><td><code>orchestrator-purge</code></td><td>Remove dead agents (>60s silent)</td></tr>
+ <tr><td><code>orchestrator-config &lt;key&gt; &lt;value&gt;</code></td><td>Tune: spawn-limit, spawn-strategy, heartbeat-timeout, idle-timeout, restart-policy, a2a-polling</td></tr>
+ <tr><td><code>orchestrator-restart-policy &lt;id&gt; &lt;policy&gt;</code></td><td>Set per-agent restart policy: on-failure, always, never</td></tr>
+ <tr><td><code>lease-create &lt;agent-id&gt; [duration] [task]</code></td><td>Create a time-bound lease for a worker agent</td></tr>
+ <tr><td><code>lease-list</code></td><td>Show active leases — agent tasks with status and TTL</td></tr>
+ <tr><td><code>lease-revoke &lt;id&gt;</code></td><td>Revoke an active lease</td></tr>
+ <tr><td><code>lease-renew &lt;id&gt; &lt;seconds&gt;</code></td><td>Extend an active lease by N seconds</td></tr>
</table></div>
</section>
@@ -1104,6 +1114,8 @@ vfs-import</pre>
<p>Define and enforce agent-to-agent contracts with input/output schema validation. Contracts are stored in <code>/.contracts/</code> and validated during orchestrator delegation.</p>
<div class="table-wrap"><table>
<tr><th>Command</th><th>Description</th></tr>
+ <tr><td><code>a2a-send &lt;agent-id&gt; &lt;json&gt;</code></td><td>Send an A2A message to an agent's VFS inbox</td></tr>
+ <tr><td><code>a2a-list</code></td><td>Show all A2A messages with pending status</td></tr>
<tr><td><code>contract-register &lt;role&gt; [fields...] --output [fields...]</code></td><td>Register a contract with input/output schema</td></tr>
<tr><td><code>contract-list</code></td><td>List all registered contracts</td></tr>
</table></div>
@@ -1115,7 +1127,11 @@ vfs-import</pre>
<p>Semantic concept-indexing layer over the hierarchical VFS. Scans files and builds a concept → path mapping using filenames, tags, and headers.</p>
<div class="table-wrap"><table>
<tr><th>Command</th><th>Description</th></tr>
- <tr><td><code>nvfs-index</code></td><td>Scan VFS and build semantic concept index</td></tr>
+ <tr><td><code>memgraph-status</code></td><td>Memory graph node/edge counts</td></tr>
+ <tr><td><code>memgraph-search &lt;q&gt;</code></td><td>Find nodes by label or type</td></tr>
+ <tr><td><code>memgraph-stats</code></td><td>Most connected nodes, strongest edges</td></tr>
+ <tr><td><code>memgraph-export</code></td><td>Export graph as JSON</td></tr>
+ <tr><td><code>memgraph-prune</code></td><td>Remove stale low-weight edges</td></tr>
<tr><td><code>nvfs-status</code></td><td>Show index stats and last scan time</td></tr>
<tr><td><code>nvfs-resolve &lt;concept&gt;</code></td><td>Find files related to a concept (exact + fuzzy)</td></tr>
<tr><td><code>nvfs-tree [concept]</code></td><td>Show concept-to-file mapping tree</td></tr>
@@ -1132,7 +1148,10 @@ vfs-import</pre>
<tr><td><code>servers</code></td><td>List all monitored servers</td></tr>
<tr><td><code>server-check &lt;name&gt;</code></td><td>Check a server's current status</td></tr>
<tr><td><code>monitor</code></td><td>Toggle auto-monitoring (60s interval)</td></tr>
- <tr><td><code>system-health</code></td><td>Show tool latency, VFS stats, module count, memory, error rates</td></tr>
+<tr><td><code>system-health</code></td><td>Tool latency, VFS stats, modules, memory, error rates</td></tr>
+ <tr><td><code>predict &lt;task&gt;</code></td><td>Predict task duration, tool turns, and confidence</td></tr>
+ <tr><td><code>predictor-status</code></td><td>Prediction model accuracy and data points</td></tr>
+ <tr><td><code>predictor-config &lt;k&gt; &lt;v&gt;</code></td><td>Tune confidence-threshold, min-data-points</td></tr>
</table></div>
</section>
<section id="debug-panel">
@@ -1152,6 +1171,48 @@ vfs-import</pre>
<p>Useful for troubleshooting module load failures, VFS corruption, and AI context bloat.</p>
</section>
+ <!-- ── Sandbox ── -->
+ <section id="sandbox">
+ <h2>🧪 Sandboxed Execution</h2>
+ <p>WebWorkers provide isolated contexts for task execution. Each worker gets a VFS snapshot so operations don't interfere with the main terminal.</p>
+ <div class="table-wrap"><table>
+ <tr><th>Command</th><th>Description</th></tr>
+ <tr><td><code>sandbox-status</code></td><td>Show worker pool health and task metrics</td></tr>
+ <tr><td><code>sandbox-config &lt;k&gt; &lt;v&gt;</code></td><td>Configure max-workers, min-workers</td></tr>
+ <tr><td><code>sandbox-run &lt;task&gt;</code></td><td>Execute a task in the sandbox pool</td></tr>
+ </table></div>
+ <p><code>orchestrate --sandboxed &lt;task&gt;</code> routes delegation through the sandbox for full isolation.</p>
+ </section>
+
+ <!-- ── Memory Graph ── -->
+ <section id="memory-graph">
+ <h2>🧠 Memory Graph</h2>
+ <p>Cross-session persistent graph database tracking files, concepts, tasks, and tools. Nodes store metadata, edges record relationships with weighted strength. Survives page reloads via VFS persistence.</p>
+ <div class="table-wrap"><table>
+ <tr><th>Command</th><th>Description</th></tr>
+ <tr><td><code>memgraph-status</code></td><td>Show node/edge counts and graph health</td></tr>
+ <tr><td><code>memgraph-search &lt;q&gt;</code></td><td>Find nodes by label, type, or id</td></tr>
+ <tr><td><code>memgraph-stats</code></td><td>Most connected nodes and strongest edges</td></tr>
+ <tr><td><code>memgraph-export</code></td><td>Export full graph as JSON to VFS</td></tr>
+ <tr><td><code>memgraph-prune</code></td><td>Remove stale low-weight edges (>30d, &lt;3 uses)</td></tr>
+ </table></div>
+ <p>Context is automatically injected into AI system prompts for cross-session awareness.</p>
+ </section>
+
+ <!-- ── World Model ── -->
+ <section id="world-model">
+ <h2>🌐 World Model</h2>
+ <p>System self-awareness engine. Synthesizes data from memory graph, module system, skills index, telemetry, and agent pool into a unified model at <code>/system/world-model.json</code>. Auto-refreshes every 5 minutes.</p>
+ <div class="table-wrap"><table>
+ <tr><th>Command</th><th>Description</th></tr>
+ <tr><td><code>world-model</code></td><td>Show full world model breakdown</td></tr>
+ <tr><td><code>world-model-summary</code></td><td>One-line system status summary</td></tr>
+ <tr><td><code>world-model-ask &lt;q&gt;</code></td><td>Query modules, skills, agents, health, or changes</td></tr>
+ <tr><td><code>world-model-refresh</code></td><td>Force re-synthesis immediately</td></tr>
+ <tr><td><code>world-model-config &lt;k&gt; &lt;v&gt;</code></td><td>Tune refresh-interval and max-projects</td></tr>
+ </table></div>
+ </section>
+
<!-- ── Security ── -->
<section id="security">
<h2>🔒 Security</h2>