docs: add beta agent pre-run script page

[tembo]

summary

• add beta/agent-pre-run-script.mdx as a url-only beta docs page
• mark the page hidden: true and leave it out of docs.json so it is not listed in navigation
• document the proposed customer-facing path as /beta/agent-pre-run-script

validation

• git merge --no-edit origin/main returned already up to date
• npx --yes mintlify validate

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

---

Note

Low Risk
Documentation-only addition with no product or runtime code changes.

Overview
Adds a new hidden Mintlify page at beta/agent-post-trigger-hook.mdx for the beta agent post-trigger hooks feature (direct URL only; not in nav).

The page documents how per-agent shell commands run in /workspace after repo setup and before the agent starts: stdout becomes pre-run thread context, non-zero exits block the run, and TRIGGER_PAYLOAD is available for integration triggers. It includes setup steps, examples (secrets, Linear description checks), resume vs retry behavior, and a pointer to repo-level Hooks vs Snapshots for dependencies.

^{Reviewed by Cursor Bugbot for commit 5c0512d. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tembo	🟢 Ready	View Preview	Jul 17, 2026, 1:06 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[tembo]

Since script stdout is passed into agent context, this example can encourage dumping full webhook payloads that may include sensitive fields. It would be safer to show extracting only the fields needed for setup instead of printing the whole payload.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tembo	🟡 Building	–	Jul 17, 2026, 1:05 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[benja]

we sometimes use "pre-run script" and other times "post-trigger hooks" - should stick with one of them. other than that, lgtm.