Update documentation for v0.6, including permission and delegation improvements, and namespace path adjustments for clarity

Sipher · Sipher · commit dceb466c2742 · 2025-08-10T15:20:46.000-03:00
diff --git a/DOCUMENTATION_TODOS.md b/DOCUMENTATION_TODOS.md
@@ -706,7 +706,7 @@ Focus on guides that address common confusion or unlock significant value:
 
 **Total: 14 digestible files instead of 5 overwhelming documents**
 
-**Note:** Namespace system is already well-covered in `/explanations/v05/capability-permissions.mdx` and `/explanations/v05/control-space.mdx`
+**Note:** Namespace system is already well-covered in `/explanations/v06/recursive-delegation.mdx` and `/explanations/v05/control-space.mdx`
 
 ### Resource Requirements
 - Technical writer familiar with blockchain economics
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -37,14 +37,14 @@ export default defineConfig({
               label: "v0.6",
               collapsed: true,
               items: [
-                { label: "Control Space", slug: "explanations/v05/control-space" },
-                { label: "Permission System", slug: "explanations/v05/permissions" },
+                { label: "Control Space", slug: "explanations/v06/control-space" },
+                { label: "Permission System", slug: "explanations/v06/permissions" },
                 {
-                  label: "Capability Permissions",
-                  slug: "explanations/v05/capability-permissions",
+                  label: "Recursive Delegation",
+                  slug: "explanations/v06/recursive-delegation",
                 },
-                { label: "Emission Permissions", slug: "explanations/v05/emission-permissions" },
-                { label: "Governance & DAO", slug: "explanations/v05/governance-dao" },
+                { label: "Emission Permissions", slug: "explanations/v06/emission-permissions" },
+                { label: "Governance & DAO", slug: "explanations/v06/governance-dao" },
               ],
             },
             {
@@ -62,7 +62,6 @@ export default defineConfig({
               items: [
                 { label: "Agent Registration", slug: "explanations/builders/agent-registration" },
                 { label: "Agent Editing", slug: "explanations/builders/agent-editing" },
-                { label: "Capability Permission", slug: "explanations/builders/capability-permission" },
                 { label: "Demand Signaling", slug: "explanations/builders/demand-signaling" },
                 { label: "Agent Server", slug: "explanations/builders/agent-server" },
                 { label: "Agent Client", slug: "explanations/builders/agent-client" },
@@ -100,7 +99,7 @@ export default defineConfig({
                 { label: "Edit your Agent", slug: "how-to-guides/builders/edit-your-agent" },
                 { label: "Manage Capabilities", slug: "how-to-guides/builders/manage-capabilities" },
                 { label: "Manage Permissions", slug: "how-to-guides/builders/manage-permissions" },
-                { label: "Capability Permission", slug: "how-to-guides/builders/capability-permission" },
+                { label: "Recursive Delegation", slug: "how-to-guides/builders/recursive-delegation" },
                 { label: "Create a Signal", slug: "how-to-guides/builders/create-signal" },
                 { label: "Setup Agent Server", slug: "how-to-guides/builders/setup-agent-server" },
                 { label: "Setup Agent Client", slug: "how-to-guides/builders/setup-agent-client" },
diff --git a/src/content/docs/explanations/builders/agent-registration.mdx b/src/content/docs/explanations/builders/agent-registration.mdx
@@ -45,8 +45,8 @@ Agent metadata is stored off-chain via IPFS but referenced on-chain through cont
 ### Related Concepts
 
 - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents that receive emissions directly
-- **[Permission System](https://docs.torus.network/explanations/v05/permissions/)** - How agents interact and delegate authority
-- **[Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/)** - Understanding DAO decision-making processes
+- **[Permission System](https://docs.torus.network/explanations/v06/permissions/)** - How agents interact and delegate authority
+- **[Governance & DAO](https://docs.torus.network/explanations/v06/governance-dao/)** - Understanding DAO decision-making processes
 
 <Aside type="tip" title="Ready to Register?">
   Follow our [step-by-step registration guide](https://docs.torus.network/how-to-guides/builders/register-an-agent/) to register your agent.
diff --git a/src/content/docs/explanations/goal-leaders/emission-proposals.mdx b/src/content/docs/explanations/goal-leaders/emission-proposals.mdx
@@ -49,9 +49,9 @@ For a proposal to pass, it must meet two requirements:
 
 ## Related Concepts
 
-- **[Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/)** - Understanding the broader DAO framework
+- **[Governance & DAO](https://docs.torus.network/explanations/v06/governance-dao/)** - Understanding the broader DAO framework
 - **[Tokenomics](https://docs.torus.network/explanations/holders/tokenomics/)** - How TORUS token economics work
-- **[Permission System](https://docs.torus.network/explanations/v05/permissions/)** - How governance permissions enable proposal creation
+- **[Permission System](https://docs.torus.network/explanations/v06/permissions/)** - How governance permissions enable proposal creation
 
 <Aside type="tip" title="Ready to Create a Proposal?">
   Follow our [emission proposal guide](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/) to learn the step-by-step process.
diff --git a/src/content/docs/explanations/goal-leaders/root-agents.mdx b/src/content/docs/explanations/goal-leaders/root-agents.mdx
@@ -31,7 +31,7 @@ Successful applicants demonstrate credible execution, active community participa
 ### Related Concepts
 
 - **[Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/)** - Technical details of agent registration
-- **[Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/)** - Understanding DAO decision-making processes  
+- **[Governance & DAO](https://docs.torus.network/explanations/v06/governance-dao/)** - Understanding DAO decision-making processes  
 - **[Tokenomics](https://docs.torus.network/explanations/holders/tokenomics/)** - How Root Agents access and use network emissions
 
 <Aside type="tip" title="Ready to Apply?">
diff --git a/src/content/docs/explanations/table-of-contents.mdx b/src/content/docs/explanations/table-of-contents.mdx
@@ -17,15 +17,15 @@ If you need to accomplish a specific task, check out our [How-to Guides](https:/
 
 These explanations provide deep understanding of how Torus works, the concepts, mechanisms of Torus.   
 
-## v0.5 Related Topics
+## v0.6 Related Topics
 
-Understanding the technical implementation and design of Torus v0.5:
+Understanding the technical implementation and design of Torus v0.6:
 
-- [Control Space](https://docs.torus.network/explanations/v05/control-space/) — Foundational permission and capability framework
-- [Permission System](https://docs.torus.network/explanations/v05/permissions/) — How agents interact and delegate authority
-- [Capability Permissions](https://docs.torus.network/explanations/v05/capability-permissions/) — Specific capability delegation mechanisms
-- [Emission Permissions](https://docs.torus.network/explanations/v05/emission-permissions/) — How emissions are allocated and controlled
-- [Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/) — Decision-making processes and community coordination
+- [Control Space](https://docs.torus.network/explanations/v06/control-space/) — Foundational permission and capability framework
+- [Permission System](https://docs.torus.network/explanations/v06/permissions/) — How agents interact and delegate authority
+- [Recursive Delegation](https://docs.torus.network/explanations/v06/recursive-delegation/) — Specific capability delegation mechanisms
+- [Emission Permissions](https://docs.torus.network/explanations/v06/emission-permissions/) — How emissions are allocated and controlled
+- [Governance & DAO](https://docs.torus.network/explanations/v06/governance-dao/) — Decision-making processes and community coordination
 
 ---
 
diff --git a/src/content/docs/explanations/v06/capability-permissions.mdx b/src/content/docs/explanations/v06/capability-permissions.mdx
diff --git a/src/content/docs/explanations/v06/control-space.mdx b/src/content/docs/explanations/v06/control-space.mdx
diff --git a/src/content/docs/explanations/v06/emission-permissions.mdx b/src/content/docs/explanations/v06/emission-permissions.mdx
diff --git a/src/content/docs/explanations/v06/governance-dao.mdx b/src/content/docs/explanations/v06/governance-dao.mdx
diff --git a/src/content/docs/explanations/v06/permissions.mdx b/src/content/docs/explanations/v06/permissions.mdx
diff --git a/src/content/docs/explanations/v06/recursive-delegation.mdx b/src/content/docs/explanations/v06/recursive-delegation.mdx
@@ -43,11 +43,11 @@ The root owner of a capability path can delegate any amount of permission instan
 
 ### Related Concepts
 
-- **[Permission System](https://docs.torus.network/explanations/v05/permissions/)** - Core permission mechanics and delegation basics
-- **[Capability Permissions](https://docs.torus.network/explanations/v05/capability-permissions/)** - Permission type for offchain agent capabilities
+- **[Permission System](https://docs.torus.network/explanations/v06/permissions/)** - Core permission mechanics and delegation basics
+- **[Recursive Delegation](https://docs.torus.network/explanations/v06/recursive-delegation/)** - Permission type for offchain agent capabilities
 - **[Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/)** - How agents become capable of receiving delegations  
 - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents with direct emission access for delegation
 
-<Aside type="tip" title="Ready to Create Capability Permissions?">
-Follow our [step-by-step guide to capability permissions](https://docs.torus.network/how-to-guides/builders/capability-permission/) for practical implementation instructions.
+<Aside type="tip" title="Ready to Create Recursive Delegation?">
+Follow our [step-by-step guide to recursive delegation](https://docs.torus.network/how-to-guides/builders/recursive-delegation/) for practical implementation instructions.
 </Aside>
diff --git a/src/content/docs/how-to-guides/builders/create-permission.mdx b/src/content/docs/how-to-guides/builders/create-permission.mdx
@@ -264,16 +264,16 @@ For help with permission management:
 - [Torus Community Discord](https://discord.gg/torus)
 
 <Aside type="tip" title="Want to Learn More?">
-See the [Permission System Documentation](https://docs.torus.network/explanations/v05/permissions/) for technical details.
+See the [Permission System Documentation](https://docs.torus.network/explanations/v06/permissions/) for technical details.
 </Aside>
 
 #### Related Topics
 
 <CardGrid>
   <Card title="Permission System" icon="seti:config">
-    <a href="/explanations/v05/permissions">Deep dive into architecture</a>
+    <a href="/explanations/v06/permissions">Deep dive into architecture</a>
   </Card>
   <Card title="Emission Permissions" icon="seti:shell">
-    <a href="/explanations/v05/emission-permissions">Economic coordination mechanisms</a>
+    <a href="/explanations/v06/emission-permissions">Economic coordination mechanisms</a>
   </Card>
 </CardGrid>
diff --git a/src/content/docs/how-to-guides/builders/manage-capabilities.mdx b/src/content/docs/how-to-guides/builders/manage-capabilities.mdx
@@ -171,5 +171,5 @@ Connect with the community:
 - [Twitter](https://x.com/torus_network) — Updates and ecosystem news
 
 <Aside type="tip" title="Want to Learn More?">
-Learn about [capability permissions](https://docs.torus.network/explanations/v05/capability-permissions/) delegation mechanisms and control space architecture.
+Learn about [recursive delegation](https://docs.torus.network/explanations/v06/recursive-delegation/) delegation mechanisms and control space architecture.
 </Aside>
diff --git a/src/content/docs/how-to-guides/builders/manage-permissions.mdx b/src/content/docs/how-to-guides/builders/manage-permissions.mdx
@@ -206,5 +206,5 @@ After successfully managing your permissions, you can:
 - **Create demand signals**: Signal demand for specific capabilities with [create a signal](https://docs.torus.network/how-to-guides/builders/create-signal/)
 
 <Aside type="tip" title="Want to Learn More?">
-For more technical details about how permissions work, see the [permission system explanation](https://docs.torus.network/explanations/v05/permissions/).
+For more technical details about how permissions work, see the [permission system explanation](https://docs.torus.network/explanations/v06/permissions/).
 </Aside>
diff --git a/src/content/docs/how-to-guides/builders/recursive-delegation.mdx b/src/content/docs/how-to-guides/builders/recursive-delegation.mdx
@@ -1,5 +1,5 @@
 ---
-title: Capability Permission
+title: Recursive Delegation
 description: Step-by-step guide to creating capability permissions to delegate access to your agent's endpoints and services.
 ---
 
@@ -15,8 +15,12 @@ import RedText from '/src/components/RedText.astro';
 import uiExplainedRedelegation from '/public/images/how-to-guide/capability-permission/ui-explained-re-delegation.png';
 import numberInstancesExplained from '/public/images/how-to-guide/capability-permission/number-instances-explained.png';
 
-In this guide, we'll walk through **creating capability permissions** in the Torus portal.  
-Capability permissions enable you to delegate access to your agent's endpoints and services to other agents in the network.
+In this guide, we'll walk through how to create capability permissions in the Torus Portal.
+Capability permissions allow you to recursively delegate access,
+ either from your own agent or from an agent that has granted you access, 
+ so you can hold and redelegate their permissions, endpoints, and services to other agents.
+
+
 
 ## Why Create Capability Permission?
 
diff --git a/src/content/docs/how-to-guides/table-of-contents.mdx b/src/content/docs/how-to-guides/table-of-contents.mdx
@@ -37,7 +37,7 @@ If you're developing tools, services, or integrations on Torus:
 - [Edit your Agent](https://docs.torus.network/how-to-guides/builders/edit-your-agent/)
 - [Manage Permissions](https://docs.torus.network/how-to-guides/builders/manage-permissions/) 
 - [Manage Capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/)
-- [Capability Permission](https://docs.torus.network/how-to-guides/builders/capability-permission/)
+- [Recursive Delegation](https://docs.torus.network/how-to-guides/builders/recursive-delegation/)
 - [Create a Signal](https://docs.torus.network/how-to-guides/builders/create-signal/)
 - [Setup Agent Server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/)
 - [Setup Agent Client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/)
@@ -51,7 +51,7 @@ If you're pioneering new goals or submitting DAO proposals:
 
 - [Become a Root Agent](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/)
 - [Create Emission Proposal](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/)
-- _See the [Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/) section for docs on proposal types and formats._  
+- _See the [Governance & DAO](https://docs.torus.network/explanations/v06/governance-dao/) section for docs on proposal types and formats._  
 
 ---
 
