Skip to content

docs: document runner binary distribution #114

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ysyneu merged 2 commits into from
Jun 26, 2026
Merged

docs: document runner binary distribution #114

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5687cc1
Feat/ai sre (#109)
ysyneu Jun 25, 2026
e2d82c4
docs: document runner binary distribution
ysyneu Jun 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,3 +13,4 @@ docs/

# claude code worktrees
.claude/worktrees/
.worktrees/
6 changes: 3 additions & 3 deletions en/ai-sre.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: AI SRE
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## What is AI SRE?
Expand Down Expand Up @@ -53,10 +53,10 @@ It is not a question-and-answer chatbot but a **hands-on troubleshooter**, integ

<AccordionGroup>
<Accordion title="How to get access" icon="key">
AI SRE requires a **Pro or higher** subscription and, during the beta, is available only to invited accounts. To participate, contact the Flashduty sales team to request whitelist access.
AI SRE requires a **Pro or higher** subscription. During the beta, submit the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist.
</Accordion>
<Accordion title="Free during beta, paid after launch" icon="gift">
AI SRE is **free** during the private beta and is not billed separately. It will become a paid capability once it launches, and the **specific pricing will be announced separately**. As a beta user, you will be notified before any charging begins; until then, you can choose whether to continue using it, and no charges will be incurred without your confirmation.
AI SRE is **free** during the private beta and is not billed separately. It will become a paid capability after commercialization starts. Before billing begins, Flashduty will share the product billing information, and you can choose whether to formally activate AI SRE or pause usage. No AI SRE charges are incurred before you confirm activation.
</Accordion>
</AccordionGroup>

Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/agents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Agent
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Apps
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/automations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Automations
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
10 changes: 7 additions & 3 deletions en/ai-sre/environments.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: BYOC
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand All @@ -32,6 +32,10 @@ The selection logic is straightforward: **when your account has an online self-h
Throughout this page, "Environment" and "Runner" refer to the same thing: the record you manage in the console is called an **Environment**, while the actual process running on your machine is called a **Runner**. One Environment record corresponds to one Runner process.
</Note>

<Note>
Runner is distributed through Flashduty's official install script and prebuilt binaries. Use the command generated by the console onboarding guide; you do not need to clone a repository or build from source.
</Note>

## Why self-hosted (BYOC)?

---
Expand Down Expand Up @@ -108,7 +112,7 @@ Go to **`Environments`** in the AI SRE left sidebar to create and connect a self
</Tabs>

<Note>
Both the `connect-url` and the install script URL are sourced dynamically from the server-side deployment configuration (`environment.runner.*` in `etc/srv.yml`) and returned by the backend when you create or retrieve an Environment — **nothing is hardcoded in the frontend bundle**. The onboarding guide already shows a complete, ready-to-copy command with the real values pre-filled.
Both the `connect-url` and `install_script_url` are returned dynamically by the backend — **nothing is hardcoded in the frontend bundle**. `install_script_url` defaults to Flashduty's official distribution source. Private or air-gapped deployments can point it to an internal mirror, but that mirror must serve `install.sh`, `releases/latest`, and `releases/download/<version>/...` release assets so first install and automatic upgrades resolve from the same source. The onboarding guide already shows a complete, ready-to-copy command with the real values pre-filled; you do not need to edit the URL manually.
</Note>
</Step>

Expand All @@ -123,7 +127,7 @@ Go to **`Environments`** in the AI SRE left sidebar to create and connect a self

Once online, the list also backfills the machine's **machine info** (OS / architecture / hostname), the Runner **version**, and the **last heartbeat** time ("just now", "N minutes ago", "N hours ago", etc.).

Runner upgrades are **server-push advertised on every heartbeat**: the backend compares the version the Runner reports against the system-configured `latest_version` using semver. If the Runner is behind, the backend pushes an upgrade notification to the Runner containing the target version, download URL, and SHA256 checksum. The Runner then downloads, verifies, and replaces itself **without any manual intervention**. Runners built from source with a `dev` version string are intentionally excluded from the comparison. When a newer version is available, an **"Upgrade available"** badge appears in the version column. Clicking it reopens the onboarding guide if you need to reinstall or view the install commands manually.
Runner upgrades are **server-push advertised on every heartbeat**: the backend compares the version the Runner reports against the system-configured `latest_version` using semver. If the Runner is behind, the backend pushes an upgrade notification to the Runner containing the target version, download URL, and SHA256 checksum. The Runner then downloads, verifies, and replaces itself **without any manual intervention**. Internal development builds that report `dev` as their version are intentionally excluded from the comparison. When a newer version is available, an **"Upgrade available"** badge appears in the version column. Clicking it reopens the onboarding guide if you need to reinstall or view the install commands manually.
</Step>
</Steps>

Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/im.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: IM Platform
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/init.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Setup
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/insight.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Usage Insights
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/knowledge.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Manage Knowledge
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/mcp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: MCP
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
10 changes: 5 additions & 5 deletions en/ai-sre/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Overview
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## What Is AI SRE
Expand Down Expand Up @@ -60,15 +60,15 @@ AI SRE is currently in private beta. Activation requires both of the following c
AI SRE requires a **Pro or higher** subscription. Consistent with other professional capabilities such as Status Page and alert ingestion, it is unavailable on lower tiers, and the UI will prompt you to upgrade.
</Accordion>
<Accordion title="Whitelist Activation" icon="users">
During the private beta, AI SRE is available only to invited accounts and must be whitelisted by Flashduty for your account. Even with a Pro subscription, accounts not on the whitelist will not see the AI SRE entry point.
During the private beta, AI SRE is available only to accounts approved through the beta application process and must be whitelisted by Flashduty for your account. Even with a Pro subscription, accounts not on the whitelist will not see the AI SRE entry point.
</Accordion>
<Accordion title="Free During Beta, Paid After Launch" icon="gift">
AI SRE is **free** during the private beta and is not billed separately. It will become a paid capability once it launches, and the **specific pricing will be announced separately**. As a beta user, you will be notified before any charging begins; until then, you can choose whether to continue using it, and no charges will be incurred without your confirmation.
AI SRE is **free** during the private beta and is not billed separately. It will become a paid capability after commercialization starts. Before billing begins, Flashduty will share the product billing information, and you can choose whether to formally activate AI SRE or pause usage. No AI SRE charges are incurred before you confirm activation.
</Accordion>
</AccordionGroup>

<Tip>
To join the private beta, contact the Flashduty sales team to request whitelist access.
To join the private beta, submit the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH). After approval, Flashduty will add your account to the whitelist.
</Tip>

## Core Capabilities
Expand Down Expand Up @@ -133,7 +133,7 @@ Visibility of each area is determined by your access permissions in the account:

<Steps>
<Step title="Activate Access">
Confirm your account has a Pro or higher subscription and has been added to the AI SRE private beta whitelist (contact the sales team to request access).
Confirm your account has a Pro or higher subscription, then submit the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH). After approval, your account is added to the AI SRE private beta whitelist.
</Step>
<Step title="Open AI SRE">
In the Flashduty console sidebar, open **AI SRE**. You will land in the **Chat** workspace by default.
Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/sandbox.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Sandbox
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
19 changes: 16 additions & 3 deletions en/ai-sre/sessions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Console
description: An AI SRE session holds one complete conversation between you and the agent, including messages, streaming responses, tool calls, and artifacts. This page covers creating and managing sessions, sending messages, previewing artifacts, context compaction, team binding, and session data export.
keywords: ["AI SRE", "session", "chat", "streaming response", "tool call", "Artifacts", "context compaction", "team binding", "export", "NDJSON"]
description: An AI SRE session holds one complete conversation between you and the agent, including messages, streaming responses, tool calls, and artifacts. This page covers creating and managing sessions, sending messages, previewing artifacts, session forking, context compaction, team binding, and session data export.
keywords: ["AI SRE", "session", "chat", "streaming response", "tool call", "Artifacts", "Fork", "context compaction", "team binding", "export", "NDJSON"]
sidebarTitle: Console
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down Expand Up @@ -158,6 +158,19 @@ Hover over a message to reveal action buttons:
| Copy | User message / artifact | Copies the message or file content to the clipboard |
| Retry | User message | Restarts a turn using that message |
| Edit | User message | Fills the message back into the input box for editing before resending |
| Fork | Agent reply from a completed turn | Creates a new session from the completed turn that produced that reply, so you can continue down a different investigation path |

### Forking a session

After a turn has fully completed, a **Fork** button appears beside the agent reply. Click it to create a new session from the completed turn that produced that reply; AI SRE opens the new session automatically.

Forking is useful when you want to try another path from the same investigation context. The new session keeps the conversation, tool-call history, bound team, and bound environment up to the selected turn, but does not include later turns from the source session. The forked session includes a "Forked from conversation" divider; click it to return to the source position in the original session.

<Note>
You can fork only from a **completed** turn in a top-level session. If the source session is still running, the selected turn has not settled, or the target is a Subagent child session, AI SRE rejects the fork.
</Note>

Forking clears temporary state that only belongs to an in-progress run, such as active-turn caches, pending mount state, frontend state that has not been persisted, and current-turn counters. Persisted history, tool calls, reusable compaction state, team binding, and environment binding are retained when they apply. The forked session has its own context, so later messages, compaction, and run results do not write back to the source session.

### Session Feedback

Expand Down
2 changes: 1 addition & 1 deletion en/ai-sre/skills.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebarTitle: Skills
---

<Info>
**Private beta**: AI SRE is currently in private beta and available to invited accounts only. To join the whitelist test, contact the Flashduty sales team to request access; features and the UI may change during the beta.
**Private beta**: AI SRE is currently in private beta. Pro or higher accounts can apply for free beta access through the [AI SRE private beta application form](https://c9xudyniiq.feishu.cn/share/base/form/shrcn0ngCfdoygiaHnAT80BfZiH); after approval, Flashduty will add your account to the whitelist. Features and the UI may change during the beta.
</Info>

## Overview
Expand Down
Loading