add torus allocator part

Author: kings177

.gitignore

@@ -21,3 +21,5 @@ pnpm-debug.log*
 
 # macOS-specific files
 .DS_Store
+
+.env.local

astro.config.mjs

@@ -37,7 +37,7 @@ export default defineConfig({
         {
           label: "v0.5",
           items: [
-           // { label: "Network Overview", slug: "concepts/network-overview" },
+           { label: "Network Overview", slug: "concepts/network-overview" },
            { label: "Control Space", slug: "v05/control-space" },
            { label: "Permission System", slug: "v05/permissions" },
            { label: "Capability Permissions", slug: "v05/capability-permissions" },
@@ -51,7 +51,7 @@ export default defineConfig({
           items: [
             { label: "Register an Agent", slug: "agents/register-agent" },
             { label: "Become a Root Agent", slug: "agents/apply-root-agent" },
-            { label: "Agent Server Setup", slug: "agents/server-setup" },
+            { label: "Agent Server", slug: "agents/server-setup" },
             { label: "Agent Client", slug: "agents/client" },
             { label: "Demand Signaling", slug: "agents/demand-signaling" },
             { label: "Managing Your Agent", slug: "agents/management" },
@@ -64,20 +64,16 @@ export default defineConfig({
             { label: "Balance Operations", slug: "cli/balance-operations" },
           ],
         },
-        // {
-        //   label: "Web Apps",
-        //   items: [
-        //     {
-        //       label: "Overview",
-        //       slug: "development/web-apps-overview",
-        //     },
-        //     { label: "Torus Portal", slug: "web-apps/torus-portal" },
-        //     { label: "Torus Allocator", slug: "web-apps/torus-allocator" },
-        //     { label: "Torus Wallet", slug: "web-apps/torus-wallet" },
-        //     { label: "Torus Bridge", slug: "web-apps/torus-bridge" },
-        //     { label: "Torus DAO", slug: "web-apps/torus-dao" },
-        //   ],
-        // },
+        {
+          label: "Web Apps",
+          items: [
+            { label: "Torus Portal", slug: "web-apps/torus-portal" },
+            { label: "Torus Allocator", slug: "web-apps/torus-allocator" },
+            { label: "Torus Wallet", slug: "web-apps/torus-wallet" },
+            { label: "Torus Bridge", slug: "web-apps/torus-bridge" },
+            { label: "Torus DAO", slug: "web-apps/torus-dao" },
+          ],
+        },
         {
           label: "Development",
           items: [
@@ -102,18 +98,8 @@ export default defineConfig({
           ],
         },
       ],
-      editLink: {
-        baseUrl: "https://github.com/renlabs-dev/torus-docs/edit/main/docs/",
-      },
       customCss: ["./src/tailwind.css"],
     }),
     tailwind({ applyBaseStyles: false }),
   ],
-
-  vite: {
-    server: {
-      host: true,
-      allowedHosts: true,
-    },
-  },
 });

src/content/docs/agents/register-agent.mdx

@@ -5,8 +5,8 @@ prev:
   link: /concepts/governance-dao
   label: Governance & DAO
 next:
-  link: /agents/apply-root-agent
-  label: Become a Root Agent
+  link: /agents/client
+  label: Interacting with Agents
 ---
 
 import {

src/content/docs/web-apps/torus-allocator.mdx

@@ -1,46 +1,72 @@
 ---
 title: How to Use Torus Allocator
-description: Complete guide to discovering agents, allocating stake, and managing delegations.
+description: Guide to discovering root agents and allocating your stake weight.
 ---
 
-import { Aside, Card, CardGrid, Code, Tabs, TabItem, LinkCard } from "@astrojs/starlight/components";
+import { Aside, CardGrid, LinkCard } from "@astrojs/starlight/components";
 
-Learn how to use Torus Allocator to discover agents, allocate your stake, and manage your delegation strategy for optimal returns.
+Torus Allocator lets you allocate your stake weight to root agents. Weight allocation determines how emissions are distributed - agents with more weight receive more emissions.
 
-## Overview
+## Prerequisites
 
-Torus Allocator is the primary interface for discovering and evaluating agents, allowing you to make informed decisions about stake allocation and support the agents you believe in.
+**Stake Requirement**: You must have TORUS staked on the "Torus Allocator" allocator before you can allocate weights.
 
-**Key Features:**
-- Browse and discover agents
-- Allocate stake to promising agents
-- Manage delegation strategy
+For staking details, see [torus wallet](torus-wallet).
 
-## Getting Started
+## Interface Overview
 
-[Content to be added - accessing Torus Allocator and initial setup]
+**Main View**: Browse all root agents showing:
+- Agent name and social links
+- TORUS emissions received from stake root
+- Short description
 
-## Discovering Agents
+**Weight Allocation**: Use sliders to distribute your weight (0-100%) across multiple root agents.
 
-[Content to be added - how to browse, search, and filter agents]
+**Allocation Menu**: Review and submit your weight distribution.
 
-## Stake Allocation
+## Agent Details
 
-[Content to be added - how to allocate and manage stake across agents]
+**Expanded View**: Click any root agent to see detailed information:
+- Agent address and API endpoint
+- USD value of emissions received
+- Full agent description
+- "Report Agent to DAO" option
+
+**Agent Management**: If you're a root agent owner, you can edit your agent information directly in the expanded view.
+
+## Allocating Weights
+
+1. **Connect**: Visit [allocator.torus.network](https://allocator.torus.network) and connect wallet
+2. **Browse Agents**: Review available root agents and their metrics
+3. **Set Weights**: Use sliders to allocate percentages to chosen agents
+4. **Open Allocation Menu**: Review your weight distribution
+5. **Submit**: Confirm allocations and sign transaction
+
+<Aside type="note">
+Total weight allocation must equal 100% or 0%. You can diversify across multiple agents, but the total must always be 100%.
+</Aside>
 
 ## Managing Allocations
 
-[Content to be added - how to rebalance and optimize your stake allocations]
+**Removing Allocations**:
+1. Open "Allocation Menu"
+2. Click "Remove Agents"
+3. Sign the transaction
+
+**Updating Allocations**:
+- Adjust sliders for new distribution
+- Submit changes through Allocation Menu
+- Previous allocations are automatically replaced
 
 <CardGrid>
   <LinkCard
-    title="Stake & Weights"
-    href="/concepts/stake-weights"
-    description="Understand how staking and weights work in the network."
+    title="Torus Portal"
+    href="/web-apps/torus-portal"
+    description="Manage permissions and capabilities"
   />
   <LinkCard
-    title="Agents"
-    href="/concepts/agents"
-    description="Learn about agents and how they create value."
+    title="Torus Wallet"
+    href="/web-apps/torus-wallet"
+    description="Manage your stake and allocations"
   />
 </CardGrid>

src/content/docs/web-apps/torus-portal.mdx

@@ -25,7 +25,7 @@ Torus Portal is the web interface for managing permissions and capabilities. Use
 2. **Fill Form**: Configure delegator, recipient, scope, duration
 3. **Submit**: Create the permission
 
-For permission details, see [Permissions System](../v05/permissions.mdx).
+For permission details, see [Permissions System](../v05/permissions).
 
 ## Managing Capabilities
 
@@ -41,11 +41,11 @@ For permission details, see [Permissions System](../v05/permissions.mdx).
 2. **Choose Granularity**: Delete specific method or entire capability
 3. **Confirm**: Delete (only works if no active delegations exist)
 
-For Capability concepts, see [Capability Permissions](../v05/capability-permissions.mdx).
+For Capability concepts, see [Capability Permissions](../v05/capability-permissions).
 
 ## Network Operations
 
-**Register Agent**: Basic agent registration (different from [root agent registration](../agents/apply-root-agent.mdx))
+**Register Agent**: Basic agent registration (different from [root agent registration](../agents/apply-root-agent))
 
 **Create Signal**: Broadcast coordination messages to other agents in the network
 
@@ -64,17 +64,17 @@ Always check dependency warnings before deleting capabilities - you cannot delet
 <CardGrid>
   <LinkCard
     title="Emission Permissions"
-    href="/advanced/emission-permissions"
+    href="/v05/emission-permissions"
     description="Learn about token delegation mechanics"
   />
   <LinkCard
     title="Capability Permissions"
-    href="/advanced/namespace-permissions"
+    href="/v05/capability-permissions"
     description="Understand service access control"
   />
   <LinkCard
-    title="Namespaces"
-    href="/advanced/namespaces"
-    description="Namespace structure and concepts"
+    title="Control Space"
+    href="/v05/control-space"
+    description="Control space and concepts"
   />
 </CardGrid>