diff --git a/api-reference/scopes.mdx b/api-reference/scopes.mdx index e16a9f8..ca538a9 100644 --- a/api-reference/scopes.mdx +++ b/api-reference/scopes.mdx @@ -49,10 +49,11 @@ curl -s https://api.agentsfleet.net/v1/fleets -H 'Authorization: Bearer af_test_ | `billing:read` | Reads the tenant balance and charges. | None | | `workspace:admin` | Creates and lists workspaces. | None | | `library:write` | Adds an entry to a workspace library. | None | +| `platform-library:write` | Adds an entry to the platform library. | None | | `approval:read` | Reads pending approvals. | None | | `approval:resolve` | Approves or denies a request. | None | -Operator tokens may carry `runner:*`, `platform-key:*`, `model:*`, or `workspace:any`. Tenant integrations do not need these scopes. +Operator tokens may carry `runner:*`, `platform-key:*`, `platform-library:*`, `model:*`, or `workspace:any`. Tenant integrations do not need these scopes. ## Errors diff --git a/changelog.mdx b/changelog.mdx index 7cc2731..d903ab2 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -22,6 +22,22 @@ export const STAGE_SELF_MANAGED_M66 = "$0.0001"; agentsfleet is in **stealth-mode testing** and pre-production. APIs and agent behavior may change between releases without long deprecation windows. Email [agentsfleet@agentmail.to](mailto:agentsfleet@agentmail.to) if you want a hand calibrating an agent or to join as a design partner. + + ## Platform operators onboard fleets from the dashboard, and four prebuilt fleets are ready to install + + A platform operator can now fill the fleet library from **Fleet libraries**, under Configuration in the dashboard. Enter a GitHub repository as `owner/repo`; `agentsfleet` fetches it, validates the bundle, and adds it to the catalog, where every workspace can install it. The page is visible only to an operator holding the `platform-library:write` scope. + + ## What's new + + - **Onboard a platform fleet without leaving the dashboard** — the operation previously had no interface at all and could only be performed with a hand-built API request. Onboarding the same repository twice updates the existing entry rather than creating a second one. + - **Four prebuilt fleets** — `github-pr-reviewer`, `platform-ops` (Fly.io and Upstash evidence correlated into a Slack diagnosis), `zoho-sprint-daily-summarizer`, and `zoho-recruiter-daily-summarizer`. Each is a public repository under `agentsfleet` and installs by its identifier once an operator has onboarded it. + - **A fleet's library identifier comes from its bundle** — `agentsfleet` reads the identifier from the `name` in `SKILL.md`, not from the repository path you type. Keep the repository name, the `SKILL.md` name, and the `TRIGGER.md` name identical. + + ## API reference + + - **`security-reviewer` removed from the prebuilt catalog** — it named a repository that was never published, so it could never be installed. It may return as a real bundle later. + + ## Removed CLI commands stop appearing in hints, and workspace delete stops implying remote deletion diff --git a/fleets/authoring.mdx b/fleets/authoring.mdx index b208c2f..c2697a3 100644 --- a/fleets/authoring.mdx +++ b/fleets/authoring.mdx @@ -34,7 +34,7 @@ Create an empty directory. Choose a lowercase fleet name with letters, numbers, Never change a service. ``` -2. Create `TRIGGER.md` with the same name. +2. Create `TRIGGER.md` with the same name. `agentsfleet` takes the library identifier from `name`, not from the repository path, so name the repository to match as well. ```yaml --- diff --git a/fleets/library.mdx b/fleets/library.mdx index e227caf..ad6ae28 100644 --- a/fleets/library.mdx +++ b/fleets/library.mdx @@ -38,6 +38,29 @@ github-pr-reviewer GitHub Pull Request reviewer github New fleets install only by library identifier. Local files can update an existing fleet with `agentsfleet fleet update`. +## Onboard a platform entry + +Platform entries are added from the dashboard at **Fleet libraries**, under Configuration. The page is visible only to an operator whose session carries the `platform-library:write` scope. Everyone else is redirected, and the API refuses the request independently. + +Enter the repository as `owner/repo`. `agentsfleet` fetches the repository, validates the bundle, stores it, and adds the catalog row. The entry then appears in every workspace's library, and any workspace can install it. + +A platform entry's identifier comes from the `name` in the bundle's `SKILL.md`, not from the repository path you type. Keep the repository name, the `SKILL.md` name, and the `TRIGGER.md` name identical. When they differ, `agentsfleet` rejects the bundle or files it under an identifier you did not expect. + +Onboarding the same repository twice updates the existing entry. It does not create a second one. + +## Prebuilt fleets + +Four fleets ship as platform entries. Each is a public repository under `agentsfleet`, and each installs by its identifier. + +| Identifier | What it does | Secrets | +| --- | --- | --- | +| `github-pr-reviewer` | Reviews pull requests and posts review comments. | `github` | +| `platform-ops` | Reads Fly.io app state and logs and Upstash Redis stats, correlates them, and posts a diagnosis to Slack. | `fly`, `upstash`, `slack`, `github` | +| `zoho-sprint-daily-summarizer` | Summarizes the day's Zoho Sprints activity and posts a digest. | `zoho` | +| `zoho-recruiter-daily-summarizer` | Summarizes the day's Zoho Recruit pipeline and posts a digest. | `zoho_recruit` | + +A prebuilt fleet appears in your library only after an operator onboards it. Until then the catalog knows its name but holds no bundle, and it does not show in the gallery. + ## Limits `SKILL.md` and `TRIGGER.md` each allow 200 KiB. A bundle can contain up to 32 support files and 256 KiB across those files.