Agent Mesh
Go a2aa2a-protocolagent-meshagentic-aiinferencemcpmeshmesh-networknetwork-securitynetworking-aip2p-network
site,docs: serve website from google.github.io/agentmesh
Antonio Ojea11ff26e7af41
diff --git a/.github/workflows/deploy-github-pages.yml b/.github/workflows/deploy-github-pages.ymlindex a22fb89a..2ba9f42d 100644--- a/.github/workflows/deploy-github-pages.yml+++ b/.github/workflows/deploy-github-pages.yml@@ -48,12 +48,9 @@ jobs:working-directory: ./site- name: Build Hugo Site- run: hugo --baseURL https://sam-mesh.dev --minify+ run: hugo --baseURL https://google.github.io/agentmesh/ --minifyworking-directory: ./site- - name: Create CNAME- run: echo "sam-mesh.dev" > ./site/public/CNAME-- name: Upload artifactuses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0with:diff --git a/README.md b/README.mdindex d3e68d09..8fb604fa 100644--- a/README.md+++ b/README.md@@ -26,18 +26,18 @@ Two properties hold everywhere:## Try it```bash-curl -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash # agentmesh-one, agentmesh-node, mcp-client and friends-agentmesh-one --data-dir ~/agentmesh-one --port 8080 & # start a local control plane, router and web console-agentmesh-node join http://127.0.0.1:8080 --bootstrap-token-path ~/agentmesh-one/join-token-agentmesh-node run --daemonize # local MCP server on 127.0.0.1:8080-agentmesh-node skill install # teach your agent to use it+curl -sL https://google.github.io/agentmesh/install.sh | bash # agentmesh-node, mcp-client and friends+agentmesh-node join https://bananas.sam-mesh.dev # one-time login+agentmesh-node run --daemonize # local MCP server on 127.0.0.1:8080+agentmesh-node skill install # teach your agent to use it```Your agent now has tools that discover and call services across the mesh,and an OpenAI-compatible endpoint that routes model requests to whoever-serves the model. The [quick start](site/content/docs/getting-started/quickstart.md)-and [your own mesh](site/content/docs/getting-started/your-own-mesh.md) guides-walk through joining an existing mesh or running a control plane of your own.+serves the model. `bananas.sam-mesh.dev` is a shared developer testnet with+no uptime promise; the [quick start](https://google.github.io/agentmesh/docs/getting-started/quickstart/)+walks through it, and [your own mesh](https://google.github.io/agentmesh/docs/getting-started/your-own-mesh/)+runs a control plane on your laptop in one command.To run a control plane of your own without installing anything, open aGitHub codespace with the released binaries and run `make testnet`. It@@ -46,7 +46,7 @@ on your GitHub account's free quota:[](https://codespaces.new/google/agentmesh?quickstart=1&devcontainer_path=.devcontainer%2Ftestnet%2Fdevcontainer.json)-The [Codespaces guide](site/content/docs/guides/codespaces.md) has the+The [Codespaces guide](https://google.github.io/agentmesh/docs/guides/codespaces/) has thesteps, what persists and what stops.## What is in a mesh@@ -60,14 +60,14 @@ steps, what persists and what stops.## Documentation-Documentation is in [`site/content/docs/`](site/content/docs/):+[google.github.io/agentmesh/docs](https://google.github.io/agentmesh/docs/) is built from `site/`.-- [Getting started](site/content/docs/getting-started/_index.md): one node on a mesh, then a mesh of your own.-- [Concepts](site/content/docs/concepts/_index.md): architecture, identity and enrollment, authorization, networking.-- [Guides](site/content/docs/guides/_index.md): exposing services, connecting agent clients, headless enrollment, Kubernetes, Cloud Run.-- [Reference](site/content/docs/reference/_index.md): every flag, configuration key, HTTP route and policy field.-- [Preview](site/content/docs/preview/_index.md): sandboxed agents and the mobile app, which work but are still settling.-- [Contributing](site/content/docs/contributing/_index.md): building, testing and the local kind environment.+- [Getting started](https://google.github.io/agentmesh/docs/getting-started/): one node on the testnet, then a mesh of your own.+- [Concepts](https://google.github.io/agentmesh/docs/concepts/): architecture, identity and enrollment, authorization, networking.+- [Guides](https://google.github.io/agentmesh/docs/guides/): exposing services, connecting agent clients, headless enrollment, Kubernetes, Cloud Run.+- [Reference](https://google.github.io/agentmesh/docs/reference/): every flag, configuration key, HTTP route and policy field.+- [Preview](https://google.github.io/agentmesh/docs/preview/): sandboxed agents and the mobile app, which work but are still settling.+- [Contributing](https://google.github.io/agentmesh/docs/contributing/): building, testing and the local kind environment.The repository has a dev container with the Go, Node and Python toolchainsand Docker, so you can build and test in a codespace or in VS Code withoutdiff --git a/agents/skills/agentmesh/SKILL.md b/agents/skills/agentmesh/SKILL.mdindex dd7d8fe5..0f0fa033 100644--- a/agents/skills/agentmesh/SKILL.md+++ b/agents/skills/agentmesh/SKILL.md@@ -30,7 +30,7 @@ guide the user through these steps. Propose each shell command and let the userapprove it before running anything.1. Check the CLI: `agentmesh-node --help`. If it is missing, install it with- `curl -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash` or+ `curl -sL https://google.github.io/agentmesh/install.sh | bash` or`go install github.com/google/agentmesh/cmd/agentmesh-node@latest`.2. Start the node in the background: `agentmesh-node run --daemonize`. It returns assoon as the node answers, and prints the endpoint, the API token file, thediff --git a/api/trust_test.go b/api/trust_test.goindex 1c363b60..c07b78cb 100644--- a/api/trust_test.go+++ b/api/trust_test.go@@ -29,7 +29,7 @@ func TestValidateControlPlaneTransport(t *testing.T) {wantErr boolwantKind error}{- {"https://hub.agentmesh.page", false, false, nil},+ {"https://hub.sam-mesh.dev", false, false, nil},{"https://10.0.0.5:8443", false, false, nil},{"http://127.0.0.1:8080", false, false, nil},{"http://localhost:8080", false, false, nil},@@ -49,8 +49,8 @@ func TestValidateControlPlaneTransport(t *testing.T) {{"https://", false, true, nil},{"https://:8443", false, true, nil},{"http://", true, true, nil},- {"ftp://hub.agentmesh.page", false, true, nil},- {"hub.agentmesh.page", false, true, nil},+ {"ftp://hub.sam-mesh.dev", false, true, nil},+ {"hub.sam-mesh.dev", false, true, nil},}for _, tt := range tests {t.Run(tt.url, func(t *testing.T) {diff --git a/charts/agentmesh/README.md b/charts/agentmesh/README.mdindex 304a7444..67a6011c 100644--- a/charts/agentmesh/README.md+++ b/charts/agentmesh/README.md@@ -6,7 +6,7 @@ own mesh.> For deployments on GKE/EKS/AKS with externally managed Postgres, DNS and> OIDC, see the-> [Kubernetes guide](../../site/content/docs/guides/kubernetes.md).+> [Kubernetes guide](https://google.github.io/agentmesh/docs/guides/kubernetes/).## Install@@ -64,7 +64,7 @@ Defaults to `true` (any node/router presenting a valid identity token isenrolled immediately, no manual step). Set to `false` if you want anadministrator to approve each enrollment via `/admin/enrollments` before anode can join — see the-[Headless enrollment guide](../../site/content/docs/guides/headless-enrollment.md).+[Headless enrollment guide](https://google.github.io/agentmesh/docs/guides/headless-enrollment/).## `controlPlane.workloadIssuer` and `controlPlane.workloadSessionTtl`diff --git a/cmd/agentmesh-node/main_test.go b/cmd/agentmesh-node/main_test.goindex 2d43d4ce..5a4024de 100644--- a/cmd/agentmesh-node/main_test.go+++ b/cmd/agentmesh-node/main_test.go@@ -64,9 +64,9 @@ func TestResolveSocketPath(t *testing.T) {func TestNormalizeControlPlaneURL(t *testing.T) {cases := map[string]string{- "bananas.agentmesh.page": "https://bananas.agentmesh.page",- "http://localhost:8080": "http://localhost:8080",- "https://bananas.agentmesh.page/": "https://bananas.agentmesh.page",+ "bananas.sam-mesh.dev": "https://bananas.sam-mesh.dev",+ "http://localhost:8080": "http://localhost:8080",+ "https://bananas.sam-mesh.dev/": "https://bananas.sam-mesh.dev",}for in, want := range cases {if got := normalizeControlPlaneURL(in); got != want {diff --git a/cmd/agentmesh-node/skill.go b/cmd/agentmesh-node/skill.goindex 9da62101..25c4e797 100644--- a/cmd/agentmesh-node/skill.go+++ b/cmd/agentmesh-node/skill.go@@ -179,7 +179,7 @@ Next steps:--header "X-Mesh-Authentication: Bearer <token>"Antigravity add that URL as "serverUrl", with the same header, to~/.gemini/config/mcp_config.json- Other agents: https://github.com/google/agentmesh/blob/main/site/content/docs/guides/connecting-agents.md+ Other agents: https://google.github.io/agentmesh/docs/guides/connecting-agents/3. Restart your agent so it picks up the skill and the mesh tools.`)}diff --git a/development/examples/multi-tier-guardrails/record.sh b/development/examples/multi-tier-guardrails/record.shindex 955c548c..9a3ccd09 100755--- a/development/examples/multi-tier-guardrails/record.sh+++ b/development/examples/multi-tier-guardrails/record.sh@@ -394,7 +394,7 @@ caption "Act 4 (Day-2 Operations): Every ALLOW and DENY across all three layersexpect "$ADMIN" "agentmesh-one admin ban \$CONTRACTOR_PEER --server \$CP_URL --data-dir \$WORK_DIR/one" 'banned' 30pause 3.5-caption "github.com/google/agentmesh"+caption "google.github.io/agentmesh"pause 3END=$(date +%s.%N)diff --git a/development/examples/sandboxed-agent/record.sh b/development/examples/sandboxed-agent/record.shindex 572d85b6..d15e159c 100755--- a/development/examples/sandboxed-agent/record.sh+++ b/development/examples/sandboxed-agent/record.sh@@ -285,7 +285,7 @@ pause 2# 8. Closecaption "The developer used their own sandbox and wrote a plain program. The admin wrote one policy document and read one log. The credential never left the office."pause 1-caption "github.com/google/agentmesh"+caption "google.github.io/agentmesh"pause 3# Ends the recording: the attached client exits with the session.diff --git a/scripts/startup-script.sh b/scripts/startup-script.shindex f03e7612..6595008e 100644--- a/scripts/startup-script.sh+++ b/scripts/startup-script.sh@@ -55,7 +55,7 @@ if [ -n "$BIN_URL" ] && [ "$BIN_URL" != "null" ]; thenelseecho "No custom binaries specified. Installing latest release from github..."export AGENTMESH_INSTALL_DIR=/usr/local/bin- curl --retry 5 --retry-connrefused --retry-delay 5 -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash+ curl --retry 5 --retry-connrefused --retry-delay 5 -sL https://google.github.io/agentmesh/install.sh | bashfi# Download the uncompressed Linux kernel for Firecracker.diff --git a/sdk/js/README.md b/sdk/js/README.mdindex 1191cde9..29e63465 100644--- a/sdk/js/README.md+++ b/sdk/js/README.md@@ -9,7 +9,7 @@ and follows the control plane's keys, bans and policy while it runs. Itpublishes no service; a tool or a model others should find by name runsbehind a `agentmesh-node`.-Guide: [Native SDKs](https://github.com/google/agentmesh/blob/main/site/content/docs/guides/native-sdks.md),+Guide: [google.github.io/agentmesh/docs/guides/native-sdks](https://google.github.io/agentmesh/docs/guides/native-sdks/),from an empty machine to two programs on a mesh.Source: [github.com/google/agentmesh/tree/main/sdk/js](https://github.com/google/agentmesh/tree/main/sdk/js).@@ -21,7 +21,7 @@ npm install agentmesh-p2p @modelcontextprotocol/sdk zodRequires Node.js 22.18 or later. In a browser, bundle it with the page(the package's `browser` field selects the browser files); the guide's-[In a browser](https://github.com/google/agentmesh/blob/main/site/content/docs/guides/native-sdks.md#in-a-browser)+[In a browser](https://google.github.io/agentmesh/docs/guides/native-sdks/#in-a-browser)section has the details and an example page.## Usediff --git a/sdk/python/README.md b/sdk/python/README.mdindex 5847f4c3..0dd21daf 100644--- a/sdk/python/README.md+++ b/sdk/python/README.md@@ -9,7 +9,7 @@ publishes no service; a tool or a model others should find by name runsbehind a `agentmesh-node`. Import it as`agent_mesh`.-Guide: [Native SDKs](https://github.com/google/agentmesh/blob/main/site/content/docs/guides/native-sdks.md),+Guide: [google.github.io/agentmesh/docs/guides/native-sdks](https://google.github.io/agentmesh/docs/guides/native-sdks/),from an empty machine to two programs on a mesh.Source: [github.com/google/agentmesh/tree/main/sdk/python](https://github.com/google/agentmesh/tree/main/sdk/python).diff --git a/site/content/docs/contributing/_index.md b/site/content/docs/contributing/_index.mdindex d0326b75..1ae807be 100644--- a/site/content/docs/contributing/_index.md+++ b/site/content/docs/contributing/_index.md@@ -136,7 +136,7 @@ The site is Hugo with the Docsy theme, under `site/`. The deploy workflowpins Hugo 0.136.5, and newer Hugo releases do not build the current Docsyversion, so use that release locally too. Run `npm ci` once in `site/` forthe CSS pipeline, then `hugo server`. The site deploys from `main` to-`sam-mesh.dev`. When a page moves, keep its old URL with `aliases` in the+`google.github.io/agentmesh`. When a page moves, keep its old URL with `aliases` in thefront matter. `tests/e2e/docs_snippets.bats` runs the Python snippet under`site/content/docs/snippets/` against a live node, so a change to thatsnippet is a change to a test.diff --git a/site/content/docs/getting-started/quickstart.md b/site/content/docs/getting-started/quickstart.mdindex 848b6249..aca26777 100644--- a/site/content/docs/getting-started/quickstart.md+++ b/site/content/docs/getting-started/quickstart.md@@ -19,7 +19,7 @@ On Linux and macOS, the install script downloads the latest release andplaces the binaries in `/usr/local/bin`:```bash-curl -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash+curl -sL https://google.github.io/agentmesh/install.sh | bash```With a Go toolchain, you can build from source instead:diff --git a/site/content/docs/preview/mobile.md b/site/content/docs/preview/mobile.mdindex 57dd42f0..a2eec96b 100644--- a/site/content/docs/preview/mobile.md+++ b/site/content/docs/preview/mobile.md@@ -54,7 +54,7 @@ update because its signature differs from the installed app, report it tothe coordinator. Uninstalling or clearing app storage deletes the savedidentity and settings.-{{< figure src="/images/agentmesh-connect-welcome.png" alt="Agent Mesh Connect welcome screen with Scan enrollment code and Enter details manually buttons" caption="The welcome screen offers both paths: Enter details manually for a public testnet, or Scan enrollment code for your own mesh." width="320" >}}+{{< figure src="../../../images/agentmesh-connect-welcome.png" alt="Agent Mesh Connect welcome screen with Scan enrollment code and Enter details manually buttons" caption="The welcome screen offers both paths: Enter details manually for a public testnet, or Scan enrollment code for your own mesh." width="320" >}}### 2. Choose your mesh@@ -100,7 +100,7 @@ Then follow option A or option B.Connect using the app switcher. Keep the app open while enrollmentfinishes. The browser message only confirms the login callback.-{{< figure src="/images/agentmesh-connect-public-login.png" alt="Cropped manual enrollment form with the Bananas control plane URL, an empty Enrollment token field, and Login and Enroll Browser button" caption="Public-testnet enrollment (cropped view). Enter your chosen testnet URL, leave Enrollment token empty, and use Login & Enroll (Browser)." width="420" >}}+{{< figure src="../../../images/agentmesh-connect-public-login.png" alt="Cropped manual enrollment form with the Bananas control plane URL, an empty Enrollment token field, and Login and Enroll Browser button" caption="Public-testnet enrollment (cropped view). Enter your chosen testnet URL, leave Enrollment token empty, and use Login & Enroll (Browser)." width="420" >}}If you need to sign in on another device, choose **Device Login (TV / OtherDevice)** instead. Open the displayed verification URL on that device,@@ -200,7 +200,7 @@ mesh://enroll?server=https%3A%2F%2Fused-encryption-assumptions-miller.trycloudflToken ID: 2542ac5fa60e (revoke early with: agentmesh-one token revoke 2542ac5fa60e)```-{{< figure src="/images/agentmesh-connect-join.png" alt="Join this mesh confirmation dialog showing a control plane hostname and Cancel and Join buttons" caption="After scanning, check the control plane hostname before tapping Join. This screenshot shows an example tunnel address and the app's shortened token hint; your values will differ." width="320" >}}+{{< figure src="../../../images/agentmesh-connect-join.png" alt="Join this mesh confirmation dialog showing a control plane hostname and Cancel and Join buttons" caption="After scanning, check the control plane hostname before tapping Join. This screenshot shows an example tunnel address and the app's shortened token hint; your values will differ." width="320" >}}The phone must be able to reach the HTTPS address. A computer's`http://127.0.0.1` address refers to the phone itself when used on the phone,@@ -247,7 +247,7 @@ or shows an error, record the status text before retrying.**Node is Running** alone does not prove a mesh connection. Report a peercount that remains zero, even if the app shows no error.-{{< figure src="/images/agentmesh-connect-running.png" alt="Agent Mesh Connect dashboard showing Node is Running, one connected peer, DHT size one, and a Node ID" caption="A connected node shows Node is Running, a Node ID, and at least one Connected Peer. Your Node ID and peer counts will differ from this example." width="320" >}}+{{< figure src="../../../images/agentmesh-connect-running.png" alt="Agent Mesh Connect dashboard showing Node is Running, one connected peer, DHT size one, and a Node ID" caption="A connected node shows Node is Running, a Node ID, and at least one Connected Peer. Your Node ID and peer counts will differ from this example." width="320" >}}### 5. Check restart and reconnectiondiff --git a/site/content/docs/privacy.md b/site/content/docs/privacy.mdindex 861264cf..978bc5c6 100644--- a/site/content/docs/privacy.md+++ b/site/content/docs/privacy.md@@ -42,4 +42,5 @@ You can instantly erase all app data, destroy your local node identity, and revoIf you have any questions about this Privacy Policy, architecture, or how your data is handled, please contact us at:+* **Project Website:** [https://google.github.io/agentmesh/](https://google.github.io/agentmesh/)* **GitHub Repository:** [https://github.com/google/agentmesh](https://github.com/google/agentmesh)diff --git a/site/content/docs/use-cases/multi-tier-guardrails.md b/site/content/docs/use-cases/multi-tier-guardrails.mdindex 9b963b97..0f17ed59 100644--- a/site/content/docs/use-cases/multi-tier-guardrails.md+++ b/site/content/docs/use-cases/multi-tier-guardrails.md@@ -4,8 +4,8 @@ weight: 25description: "How Developer, Platform, Central Security, Department Leads, Individual End-Users, and Day-2 Ops each enforce their own layer of guardrails on the same mesh."----<video controls playsinline preload="metadata" poster="/demo-poster.png" style="width:100%; border-radius:8px; box-shadow:0 4px 20px rgba(0,0,0,0.4); margin-bottom: 1.5rem;">- <source src="/demo-multi-tier-guardrails.mp4" type="video/mp4">+<video controls playsinline preload="metadata" poster="../../../demo-poster.png" style="width:100%; border-radius:8px; box-shadow:0 4px 20px rgba(0,0,0,0.4); margin-bottom: 1.5rem;">+ <source src="../../../demo-multi-tier-guardrails.mp4" type="video/mp4"></video>When every developer and team starts shipping AI agents, organizations hit a governance paradox:diff --git a/site/hugo.toml b/site/hugo.tomlindex 1b68e65e..01f41c99 100644--- a/site/hugo.toml+++ b/site/hugo.toml@@ -1,5 +1,5 @@title = "Agent Mesh"-baseURL = "https://sam-mesh.dev"+baseURL = "https://google.github.io/agentmesh/"languageCode = "en-us"enableRobotsTXT = truediff --git a/site/layouts/partials/hooks/head-end.html b/site/layouts/partials/hooks/head-end.htmlindex 7792a4ad..9bbf3f07 100644--- a/site/layouts/partials/hooks/head-end.html+++ b/site/layouts/partials/hooks/head-end.html@@ -6,6 +6,6 @@</script><!-- Agent Mesh Custom Favicons -->-<link rel="icon" type="image/png" href="/favicon.png?v=2">-<link rel="shortcut icon" href="/favicon.ico?v=2">+<link rel="icon" type="image/png" href="{{ "favicon.png?v=2" | relURL }}">+<link rel="shortcut icon" href="{{ "favicon.ico?v=2" | relURL }}"><link rel="manifest" href="{{ "manifest.json" | relURL }}">diff --git a/site/static/manifest.json b/site/static/manifest.jsonindex 2cceaa29..811d7c41 100644--- a/site/static/manifest.json+++ b/site/static/manifest.json@@ -3,32 +3,32 @@"short_name": "Agent Mesh","icons": [{- "src": "/favicons/android-36x36.png",+ "src": "favicons/android-36x36.png","sizes": "36x36","type": "image/png"},{- "src": "/favicons/android-48x48.png",+ "src": "favicons/android-48x48.png","sizes": "48x48","type": "image/png"},{- "src": "/favicons/android-72x72.png",+ "src": "favicons/android-72x72.png","sizes": "72x72","type": "image/png"},{- "src": "/favicons/android-96x96.png",+ "src": "favicons/android-96x96.png","sizes": "96x96","type": "image/png"},{- "src": "/favicons/android-144x144.png",+ "src": "favicons/android-144x144.png","sizes": "144x144","type": "image/png"},{- "src": "/favicons/android-192x192.png",+ "src": "favicons/android-192x192.png","sizes": "192x192","type": "image/png"}@@ -36,5 +36,5 @@"theme_color": "#040911","background_color": "#040911","display": "standalone",- "start_url": "/"+ "start_url": "."}