diff --git a/apps/landing/src/content/docs/getting-started/ai-agents.md b/apps/landing/src/content/docs/getting-started/ai-agents.md index 9228a70021..8fffe7f054 100644 --- a/apps/landing/src/content/docs/getting-started/ai-agents.md +++ b/apps/landing/src/content/docs/getting-started/ai-agents.md @@ -111,6 +111,34 @@ For heavier dashboard work, give your agent the [maple-dashboard-widgets](https: When no tool fits, `describe_warehouse_tables` lists the tables and columns, and `run_sql` runs a read-only query scoped to your organization. See [SQL](/docs/reference/sql). +## Check whether a Maple Cloud fix is deployed + +Each region reports the commit its dashboard and API are running. Both are public `GET` requests, no sign-in needed. + +| Region | Dashboard | API | +| ------ | --------------------------------------- | --------------------------------- | +| US | `https://app.maple.dev/version.json` | `https://api.maple.dev/health` | +| EU | `https://app.eu.maple.dev/version.json` | `https://api.eu.maple.dev/health` | + +```bash +curl -fsS https://app.maple.dev/version.json | jq -r .commit +curl -fsS -D - -o /dev/null https://api.maple.dev/health | grep -i x-maple-revision +``` + +The dashboard and API deploy separately, so compare each one. No `x-maple-revision` header means the API revision is unknown. + +To check whether a serving commit includes a merged PR, compare it with the PR's merge commit, not the branch's own commits (PRs are squash-merged): + +```bash +repo=https://api.github.com/repos/MapleTechLabs/maple +curl -fsS "$repo/pulls/" | jq -r 'select(.merged) | .merge_commit_sha' +curl -fsS "$repo/compare/..." | jq -r .status +``` + +Empty output from the first request means the PR is not merged yet. A status of `identical` or `ahead` means the fix is deployed; `behind` or `diverged` means it is not. + +Ingest and the MCP server deploy on their own and are not covered by these checks. A [changelog](/changelog) entry or a merged PR does not show what a region is running. + ## Instrument with a coding agent Open-source skills teach a coding agent how to set up OpenTelemetry for Maple: diff --git a/apps/landing/src/pages/llms.txt.ts b/apps/landing/src/pages/llms.txt.ts index 2cbddd7881..40f8d278bf 100644 --- a/apps/landing/src/pages/llms.txt.ts +++ b/apps/landing/src/pages/llms.txt.ts @@ -43,6 +43,13 @@ export const GET: APIRoute = ({ site }) => { `- Example: [${url("/docs/getting-started/introduction.md")}](${url("/docs/getting-started/introduction.md")})`, "", + "## Use Maple with an AI agent", + "", + "Query and operate Maple through MCP, find instrumentation skills, and check the dashboard and API revisions deployed to your region without a browser.", + "", + `- [AI agent guide: connection, workflows, deployed revisions and skills](${url("/docs/getting-started/ai-agents.md")})`, + "", + "## Pricing", "", "One plan: $39 a month with 100 GB each of logs, traces and metrics included, then $0.30 per GB per signal; 5,000 browser sessions included, then $0.002 per session; 1M product events included, then $5 per million (page views not counted).", @@ -59,7 +66,8 @@ export const GET: APIRoute = ({ site }) => { "## Changelog", "", - `Maple product updates, one entry per shipped change. The index enumerates every entry. ${CONVENTION("changelog")}`, + `Maple product announcements, one entry per announced change. The index enumerates every entry. ${CONVENTION("changelog")}`, + `An entry does not show which commit a region is running. To check the deployed dashboard and API revisions, see the [AI agent guide](${url("/docs/getting-started/ai-agents.md#check-whether-a-maple-cloud-fix-is-deployed")}).`, "", ...both("Changelog index", "/changelog"), `- [RSS feed](${url("/changelog/rss.xml")})`,