docs(m108): changelog — six connectors + catalog + bounded broker mint

[indykish]

Summary

Adds a changelog <Update> for the M108 connector platform — the six new providers (Grafana, Zoho Desk, Jira, Linear, Fly, Datadog) joining GitHub and Slack.

• OAuth connectors (Zoho Desk, Jira, Linear) — refresh-token round-trip; the broker mints fresh access tokens on demand.
• API-key connectors (Datadog, Grafana, Fly) — operator-supplied key, live-probe validated before vaulting; rejected → UZ-CONN-005.
• Connector catalog — GET /v1/connectors, registry-driven dashboard cards.
• Bounded broker mint — token exchanges now deadline-armed, fail closed.

Pairs with the agentsfleet feat/m108-connector-platform branch (§3 refresh-mint, §4.1 catalog, findings ②/③/① so far). AUTH.md was updated in the product repo.

Session notes

• Authored per CHANGELOG_VOICE (one headline, consequence-first bullets, load-bearing facts — error code + endpoint — kept).
• Branched off origin/main via a worktree (the docs repo was on another milestone's branch).

🤖 Generated with Claude Code

Greptile Summary

Adds a single <Update> entry documenting the M108 connector platform: six new connectors (Grafana, Zoho Desk, Jira, Linear, Fly, Datadog), the GET /v1/connectors catalog endpoint, and the bounded broker deadline fix.

• Six connectors — OAuth (Zoho Desk, Jira, Linear) and API-key (Datadog, Grafana, Fly) archetypes documented with their credential lifecycle and the UZ-CONN-005 rejection code.
• Connector catalog — GET /v1/connectors and the registry-driven dashboard cards covered.
• Bounded broker — deadline-armed token exchanges noted as a fix within the same entry.

Confidence Score: 4/5

Documentation-only change that is safe to merge after adding the missing Integrations tag.

The entry omits the Integrations tag that every comparable connector entry in the file carries — readers filtering by that tag will not find this six-connector update. Everything else (content, structure, closing tag indentation, UI tag) is correct.

changelog.mdx — specifically the tags array on the new Update block.

Important Files Changed

Filename	Overview
changelog.mdx	Adds M108 connector platform <Update> entry covering six new connectors, the catalog endpoint, and bounded broker fix; missing "Integrations" tag means the entry is invisible to readers filtering by that tag.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant Op as Operator
    participant Dash as Dashboard
    participant API as API (/v1/connectors)
    participant Broker as Credential Broker
    participant Vault as Vault
    participant Vendor as Vendor (OAuth/API-key)

    Op->>Dash: Open Connectors
    Dash->>API: GET /v1/connectors
    API-->>Dash: Registry (archetype, configured, connected)

    alt OAuth connector (Zoho Desk / Jira / Linear)
        Op->>Dash: Connect
        Dash->>Vendor: OAuth round-trip
        Vendor-->>Vault: Refresh token stored
        Broker->>Vendor: Mint access token (deadline-armed)
        Vendor-->>Broker: Access token
        Broker-->>API: Short-lived token
    else API-key connector (Datadog / Grafana / Fly)
        Op->>API: Submit key
        API->>Vendor: Live validation probe
        alt Key valid
            Vendor-->>Vault: Key vaulted
        else Key rejected
            Vendor-->>Op: UZ-CONN-005 (nothing stored)
        end
    end

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant Op as Operator
    participant Dash as Dashboard
    participant API as API (/v1/connectors)
    participant Broker as Credential Broker
    participant Vault as Vault
    participant Vendor as Vendor (OAuth/API-key)

    Op->>Dash: Open Connectors
    Dash->>API: GET /v1/connectors
    API-->>Dash: Registry (archetype, configured, connected)

    alt OAuth connector (Zoho Desk / Jira / Linear)
        Op->>Dash: Connect
        Dash->>Vendor: OAuth round-trip
        Vendor-->>Vault: Refresh token stored
        Broker->>Vendor: Mint access token (deadline-armed)
        Vendor-->>Broker: Access token
        Broker-->>API: Short-lived token
    else API-key connector (Datadog / Grafana / Fly)
        Op->>API: Submit key
        API->>Vendor: Live validation probe
        alt Key valid
            Vendor-->>Vault: Key vaulted
        else Key rejected
            Vendor-->>Op: UZ-CONN-005 (nothing stored)
        end
    end

Loading

_{Reviews (3): Last reviewed commit: "Merge origin/main, fix </Update> indent ..." | Re-trigger Greptile}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
agentsfleet	🟢 Ready	View Preview	Jul 3, 2026, 12:11 PM

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