Agent Mesh
Go a2aa2a-protocolagent-meshagentic-aiinferencemcpmeshmesh-networknetwork-securitynetworking-aip2p-network
fix docs links
Antonio Ojeac2e6d4823cbc
diff --git a/docs/README.md b/docs/README.mdindex f837b3a9..77a72008 100644--- a/docs/README.md+++ b/docs/README.md@@ -164,10 +164,10 @@ SAM enables this sovereignty by moving trust from **authorities** to **cryptogra## Next Steps-- **[Getting Started](/guides/dark-mesh.md)**: Set up an enterprise dark mesh-- **[CLI Reference](/cli/reference.md)**: Full kubectl-style command hierarchy-- **[Technical Deep Dive](/concepts/federation.md)**: How federation isolation works-- **[Testing Guide](/testing.md)**: Run the test suite locally+- **[Getting Started](#/guides/dark-mesh.md)**: Set up an enterprise dark mesh+- **[CLI Reference](#/cli/reference.md)**: Full kubectl-style command hierarchy+- **[Technical Deep Dive](#/concepts/federation.md)**: How federation isolation works+- **[Testing Guide](#/testing.md)**: Run the test suite locally## Philosophydiff --git a/docs/_coverpage.md b/docs/_coverpage.mdindex cc1bd217..4cc016cb 100644--- a/docs/_coverpage.md+++ b/docs/_coverpage.md@@ -9,9 +9,9 @@- **Federation-Ready**: Isolated namespaces for enterprise dark meshes- **Audit-First**: Built-in transparency for security compliance-[Documentation](/README.md)-[GitHub](https://github.com/your-org/sam)-[Getting Started](#features)+[Documentation](#/README.md)+[GitHub](https://github.com/aojea/sam)+[Getting Started](#/quickstart.md)---diff --git a/docs/_sidebar.md b/docs/_sidebar.mdindex 84838b31..57971e26 100644--- a/docs/_sidebar.md+++ b/docs/_sidebar.md@@ -1,47 +1,27 @@<!-- Sidebar Navigation -->- **Getting Started**- - [Overview](/README.md)- - [Quick Start](/guides/dark-mesh.md)--- **User Guides**- - [Enterprise Dark Mesh](/guides/dark-mesh.md)- - [Setting Up a Federation](/guides/federation-setup.md)- - [Publishing an Agent](/guides/publish-agent.md)+ - [Overview](#/README.md)+ - [Quick Start](#/quickstart.md)+ - [Enterprise Dark Mesh](#/guides/dark-mesh.md)- **CLI Reference**- - [Command Hierarchy](/cli/reference.md)- - [sam identity](/cli/identity.md)- - [sam publish](/cli/publish.md)- - [sam call](/cli/call.md)- - [sam inspect](/cli/inspect.md)- - [sam mesh](/cli/mesh.md)+ - [Command Hierarchy](#/cli/reference.md)- **Technical Concepts**- - [Federation & Storage](/concepts/federation.md)- - [Identity & Vouch System](/concepts/identity.md)- - [Biscuit Authorization](/concepts/biscuit.md)- - [Agent Card Format](/concepts/agent-card.md)- - [A2A Protocol](/concepts/a2a-protocol.md)+ - [Federation & Storage](#/concepts/federation.md)+ - [Identity & Vouch System](#/concepts/identity.md)+ - [Biscuit Authorization](#/concepts/biscuit.md)+ - [A2A Protocol](#/concepts/a2a-protocol.md)- **Testing**- - [Testing Guide](/testing.md)- - [Running Tests Locally](/testing.md#running-tests)- - [BATS E2E Tests](/testing.md#bats-e2e)- - [Go Integration Tests](/testing.md#go-integration)--- **Operations**- - [Deployment Guide](/operations/deployment.md)- - [Monitoring](/operations/monitoring.md)- - [Troubleshooting](/operations/troubleshooting.md)+ - [Testing Guide](#/testing.md)- **Contributing**- - [Contributing Guide](/contributing.md)- - [Development Setup](/contributing.md#setup)- - [Code Style](/contributing.md#style)- - [Submitting Changes](/contributing.md#submit)+ - [Contributing Guide](#/contributing.md)- **Resources**- - [FAQ](/faq.md)- - [Glossary](/glossary.md)- - [License](https://github.com/your-org/sam/blob/main/LICENSE)+ - [FAQ](#/faq.md)+ - [Glossary](#/glossary.md)+ - [Documentation Inventory](#/DOCUMENTATION.md)+ - [License](https://github.com/aojea/sam/blob/main/LICENSE)diff --git a/docs/cli/reference.md b/docs/cli/reference.mdindex 65a31baf..9c7bd19a 100644--- a/docs/cli/reference.md+++ b/docs/cli/reference.md@@ -522,5 +522,5 @@ Use these to:## Next Steps-- **[User Journey Guide](/guides/dark-mesh.md)**: Full scenario walkthrough-- **[Concepts](/concepts/federation.md)**: Technical deep dive+- **[User Journey Guide](#/guides/dark-mesh.md)**: Full scenario walkthrough+- **[Concepts](#/concepts/federation.md)**: Technical deep divediff --git a/docs/concepts/a2a-protocol.md b/docs/concepts/a2a-protocol.mdindex f0cf76be..e30dddd0 100644--- a/docs/concepts/a2a-protocol.md+++ b/docs/concepts/a2a-protocol.md@@ -404,15 +404,15 @@ If direct connection fails, libp2p automatically:## Related Concepts-- **[Vouch](/concepts/identity.md)**: Authentication mechanism-- **[Biscuit](/concepts/biscuit.md)**: Authorization mechanism-- **[Federation](/concepts/federation.md)**: Network isolation-- **[CLI](/cli/reference.md)**: How to invoke A2A calls+- **[Vouch](#/concepts/identity.md)**: Authentication mechanism+- **[Biscuit](#/concepts/biscuit.md)**: Authorization mechanism+- **[Federation](#/concepts/federation.md)**: Network isolation+- **[CLI](#/cli/reference.md)**: How to invoke A2A calls---## Next Steps-- **[Try it Out](/guides/dark-mesh.md)**: Make your first A2A call-- **[Integration Tests](/tests/integration/)**: See A2A in action-- **[Contributing](/contributing.md)**: Help improve the protocol+- **[Try it Out](#/guides/dark-mesh.md)**: Make your first A2A call+- **[Integration Tests](https://github.com/aojea/sam/tree/main/tests/integration)**: See A2A in action+- **[Contributing](#/contributing.md)**: Help improve the protocoldiff --git a/docs/concepts/biscuit.md b/docs/concepts/biscuit.mdindex 002a3269..c24dfaa6 100644--- a/docs/concepts/biscuit.md+++ b/docs/concepts/biscuit.md@@ -486,6 +486,6 @@ return executeSkill(ctx, capability, payload)## Next Steps-- **[Identity & Vouch System](/concepts/identity.md)**: How authentication works-- **[A2A Protocol](/concepts/a2a-protocol.md)**: How authorization is enforced-- **[CLI Reference](/cli/reference.md)**: `sam inspect biscuit` usage+- **[Identity & Vouch System](#/concepts/identity.md)**: How authentication works+- **[A2A Protocol](#/concepts/a2a-protocol.md)**: How authorization is enforced+- **[CLI Reference](#/cli/reference.md)**: `sam inspect biscuit` usagediff --git a/docs/concepts/federation.md b/docs/concepts/federation.mdindex e14f3037..fb021f74 100644--- a/docs/concepts/federation.md+++ b/docs/concepts/federation.md@@ -388,6 +388,6 @@ Federated Database Architecture:## Next Steps-- **[Identity & Vouch System](/concepts/identity.md)**: Deep dive into how identity works-- **[Biscuit Authorization](/concepts/biscuit.md)**: How skill-based access control works-- **[A2A Protocol](/concepts/a2a-protocol.md)**: How agents authenticate and call each other+- **[Identity & Vouch System](#/concepts/identity.md)**: Deep dive into how identity works+- **[Biscuit Authorization](#/concepts/biscuit.md)**: How skill-based access control works+- **[A2A Protocol](#/concepts/a2a-protocol.md)**: How agents authenticate and call each otherdiff --git a/docs/concepts/identity.md b/docs/concepts/identity.mdindex a21a3149..30d1ad31 100644--- a/docs/concepts/identity.md+++ b/docs/concepts/identity.md@@ -428,6 +428,6 @@ sam inspect biscuit "bob;allow_skill=risk-audit"## Next Steps-- **[Biscuit Authorization](/concepts/biscuit.md)**: How skill-based access control works-- **[Federation & Storage](/concepts/federation.md)**: How federation isolation works-- **[A2A Protocol](/concepts/a2a-protocol.md)**: How agents authenticate to each other+- **[Biscuit Authorization](#/concepts/biscuit.md)**: How skill-based access control works+- **[Federation & Storage](#/concepts/federation.md)**: How federation isolation works+- **[A2A Protocol](#/concepts/a2a-protocol.md)**: How agents authenticate to each otherdiff --git a/docs/contributing.md b/docs/contributing.mdindex 23caf5b0..b805cd54 100644--- a/docs/contributing.md+++ b/docs/contributing.md@@ -22,7 +22,7 @@ We welcome contributions! This guide covers:```bash# Clone the repository-git clone https://github.com/your-org/sam.git+git clone https://github.com/aojea/sam.gitcd sam# Build the binarydiff --git a/docs/faq.md b/docs/faq.mdindex aa2ad511..6eda6a87 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -13,7 +13,7 @@ In short: **Pure P2P networks for agents, with cryptographic identity**.### How do I install SAM?```bash-git clone https://github.com/your-org/sam.git+git clone https://github.com/aojea/sam.gitcd sammake build./bin/sam --help@@ -44,7 +44,7 @@ Requirements: Go 1.21+, Make, BATS (for E2E tests)sam call mycapability --federation mynet --message "Do something"```-See [User Journey Guide](/guides/dark-mesh.md) for a full walkthrough.+See [User Journey Guide](#/guides/dark-mesh.md) for a full walkthrough.---@@ -67,7 +67,7 @@ A **vouch** is a cryptographic credential proving your identity to a federation.- Includes your subject (username), PeerID, and expiry- Signed by the hub (so we trust the issuer, not a server)-See [Identity & Vouch System](/concepts/identity.md).+See [Identity & Vouch System](#/concepts/identity.md).### What's a Biscuit?@@ -79,7 +79,7 @@ Format: `alice;allow_skill=weather-bot,risk-audit`- No central revocation (revoke by deleting locally)- Plain-text for transparency-See [Biscuit Authorization](/concepts/biscuit.md).+See [Biscuit Authorization](#/concepts/biscuit.md).### What's an Agent Card?@@ -169,7 +169,7 @@ If direct connection fails:2. Fall back to relay3. Communication works either way-See [CUJ-2 Test](/tests/integration/cuj_test.go) for example.+See [CUJ-2 Test](https://github.com/aojea/sam/blob/main/tests/integration/cuj_test.go) for example.### Can I run a SAM node in the cloud?@@ -408,10 +408,10 @@ func main() {Yes. Import SAM as a Go library:```bash-go get github.com/your-org/sam+go get github.com/aojea/sam```-See [pkg/net](/pkg/net), [pkg/protocol](/pkg/protocol), [pkg/economy](/pkg/economy).+See [pkg/net](https://github.com/aojea/sam/tree/main/pkg/net), [pkg/protocol](https://github.com/aojea/sam/tree/main/pkg/protocol), [pkg/economy](https://github.com/aojea/sam/tree/main/pkg/economy).### Can I use SAM with Docker/Kubernetes?@@ -433,7 +433,7 @@ For Kubernetes: Mount `~/.config/sam` as a persistent volume.### How do I contribute?-See [Contributing Guide](/contributing.md).+See [Contributing Guide](#/contributing.md).In short:1. Fork the repo@@ -500,7 +500,7 @@ Open an issue describing your use case. We prioritize based on:### What license is SAM under?-[Check LICENSE file](https://github.com/your-org/sam/blob/main/LICENSE)+[Check LICENSE file](https://github.com/aojea/sam/blob/main/LICENSE)Typically: MIT or Apache 2.0@@ -510,7 +510,7 @@ Yes, as long as you comply with the license (usually MIT/Apache means you can).### Do I need to contribute back to SAM?-Not required, but appreciated. See [Contributing Guide](/contributing.md).+Not required, but appreciated. See [Contributing Guide](#/contributing.md).---diff --git a/docs/glossary.md b/docs/glossary.mdindex 427d792f..13e772d9 100644--- a/docs/glossary.md+++ b/docs/glossary.md@@ -272,6 +272,6 @@## See Also-- **[Concepts](/concepts/federation.md)**: Technical deep dives-- **[FAQ](/faq.md)**: Common questions answered-- **[CLI Reference](/cli/reference.md)**: Command documentation+- **[Concepts](#/concepts/federation.md)**: Technical deep dives+- **[FAQ](#/faq.md)**: Common questions answered+- **[CLI Reference](#/cli/reference.md)**: Command documentationdiff --git a/docs/guides/dark-mesh.md b/docs/guides/dark-mesh.mdindex cc4a735c..7bfc8af1 100644--- a/docs/guides/dark-mesh.md+++ b/docs/guides/dark-mesh.md@@ -444,7 +444,7 @@ Operations Federation (isolated namespace: /sam/fed/operations)## Next Steps-1. **Setup Your Federations**: [Federation Setup Guide](/guides/federation-setup.md)-2. **Publish Your First Agent**: [Publishing Guide](/guides/publish-agent.md)-3. **CLI Reference**: Full command documentation at [CLI Reference](/cli/reference.md)-4. **Technical Deep Dive**: Understand federation storage at [Federation & Storage](/concepts/federation.md)+1. **Setup Your Federations**: [CLI Reference](#/cli/reference.md)+2. **Publish Your First Agent**: [Quick Start](#/quickstart.md)+3. **CLI Reference**: Full command documentation at [CLI Reference](#/cli/reference.md)+4. **Technical Deep Dive**: Understand federation storage at [Federation & Storage](#/concepts/federation.md)diff --git a/docs/index.html b/docs/index.htmlindex 7c5d7674..b82b196a 100644--- a/docs/index.html+++ b/docs/index.html@@ -51,10 +51,9 @@<script>window.$docsify = {name: '<img src="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text x=%2210%22 y=%2275%22 font-size=%2280%22 fill=%22%236366f1%22>⚡</text></svg>" style="height: 2rem; margin-right: 8px;"/> SAM',- repo: 'https://github.com/your-org/sam',+ repo: 'https://github.com/aojea/sam',// Documentation settings- basePath: '/',loadSidebar: true,loadNavbar: false,coverpage: true,@@ -130,7 +129,7 @@// Footerfooter: {- copy: '<span>© 2026 SAM Contributors. <a href="https://github.com/your-org/sam/blob/main/LICENSE">License</a></span>',+ copy: '<span>© 2026 SAM Contributors. <a href="https://github.com/aojea/sam/blob/main/LICENSE">License</a></span>',auth: '',pre: '<hr/>',style: 'text-align: center;',diff --git a/docs/quickstart.md b/docs/quickstart.mdindex 474a77d1..5d24c837 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -3,7 +3,7 @@## Installation```bash-git clone https://github.com/your-org/sam.git+git clone https://github.com/aojea/sam.gitcd sammake build./bin/sam --help@@ -152,13 +152,13 @@ sam inspect card '{"peer_id":"...","agent_card":{...}}'## Documentation-- **[Overview](/README.md)**: What SAM is and why it matters-- **[User Journey](/guides/dark-mesh.md)**: Step-by-step walkthrough-- **[CLI Reference](/cli/reference.md)**: Full command documentation-- **[Concepts](/concepts/federation.md)**: Technical deep dives-- **[Testing](/testing.md)**: How to run and write tests-- **[FAQ](/faq.md)**: Common questions-- **[Glossary](/glossary.md)**: Terminology reference+- **[Overview](#/README.md)**: What SAM is and why it matters+- **[User Journey](#/guides/dark-mesh.md)**: Step-by-step walkthrough+- **[CLI Reference](#/cli/reference.md)**: Full command documentation+- **[Concepts](#/concepts/federation.md)**: Technical deep dives+- **[Testing](#/testing.md)**: How to run and write tests+- **[FAQ](#/faq.md)**: Common questions+- **[Glossary](#/glossary.md)**: Terminology reference---@@ -172,7 +172,7 @@ sam <command> --helpSAM_DEBUG=1 sam <command># Report bugs-https://github.com/your-org/sam/issues+https://github.com/aojea/sam/issues```---diff --git a/docs/testing.md b/docs/testing.mdindex 34d6b68b..5516de35 100644--- a/docs/testing.md+++ b/docs/testing.md@@ -421,6 +421,6 @@ func TestExample(t *testing.T) {## Next Steps-- **[Quick Start](/guides/dark-mesh.md)**: Set up SAM locally-- **[CLI Reference](/cli/reference.md)**: Test with real commands-- **[Contributing](/contributing.md)**: Submit a test PR+- **[Quick Start](#/guides/dark-mesh.md)**: Set up SAM locally+- **[CLI Reference](#/cli/reference.md)**: Test with real commands+- **[Contributing](#/contributing.md)**: Submit a test PR