Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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 changelog.d/added-15862-matrix-source.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
- Serve Matrix lines via authorized `GET /api/matrix/lines` and a content-free `code-lines` SSE nudge on `/api/events` (experimental, default off; [#15935](https://github.com/hivecommons/hive/issues/15935)).
94 changes: 94 additions & 0 deletions dashboard/openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -1306,6 +1306,100 @@
}
}
},
"/api/matrix/lines": {
"get": {
"tags": [
"Status"
],
"summary": "Serve Activity Monitor Matrix lines",
"description": "Serve bounded backlog of pushed lines behind dashboard.matrix. Returns 404 when matrix mode is disabled.",
"parameters": [
{
"name": "since",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 0
},
"description": "Return lines after this sequence number. since=0 returns the initial backlog up to 2000 lines."
},
{
"name": "max",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"description": "Maximum number of lines to return (clamped between 1 and 500, defaults to 200 when since > 0)."
}
],
"responses": {
"200": {
"description": "Matrix lines response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"seq": {
"type": "integer"
},
"source": {
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seq": {
"type": "integer"
},
"repo": {
"type": "string"
},
"pr": {
"type": "integer"
},
"head": {
"type": "string"
},
"path": {
"type": "string"
},
"lang": {
"type": "string"
},
"line": {
"type": "string"
},
"at": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
}
}
},
"401": {
"description": "Missing or invalid dashboard authentication."
},
"403": {
"description": "Read access required."
},
"404": {
"description": "Matrix mode disabled."
}
}
}
},
"/api/status": {
"get": {
"tags": [
Expand Down
4 changes: 2 additions & 2 deletions src/docs/api-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ History point limits, timestamp cutoffs, incremental cost reads and ETag/304 beh
| Nous / strategy lab | [`api-reference/nous.md`](api-reference/nous.md) | 25 |
| Inception | [`api-reference/inception.md`](api-reference/inception.md) | 14 |
| Beads | [`api-reference/beads.md`](api-reference/beads.md) | 5 |
| Dashboard miscellaneous | [`api-reference/dashboard-misc.md`](api-reference/dashboard-misc.md) | 55 |
| Dashboard miscellaneous | [`api-reference/dashboard-misc.md`](api-reference/dashboard-misc.md) | 56 |
| Hub SaaS | [`api-reference/hub-saas.md`](api-reference/hub-saas.md) | 102 |
| Hub server | [`api-reference/hub-server.md`](api-reference/hub-server.md) | 46 |

Expand Down Expand Up @@ -76,7 +76,7 @@ History point limits, timestamp cutoffs, incremental cost reads and ETag/304 beh

## Dashboard miscellaneous

55 routes — see [api-reference/dashboard-misc.md](api-reference/dashboard-misc.md).
56 routes — see [api-reference/dashboard-misc.md](api-reference/dashboard-misc.md).

## Hub SaaS

Expand Down
26 changes: 13 additions & 13 deletions src/docs/api-reference/agents-and-controls.md

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions src/docs/api-reference/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,6 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f
| `GET` | `/api/openrouter/models` | Dashboard auth/session | Open Router Models | `pkg/dashboard/openrouter.go:47` |
| `GET` | `/api/openrouter/credit` | Dashboard auth/session | Open Router Credit | `pkg/dashboard/openrouter.go:48` |
| `GET` | `/openrouter/callback` | Public | Open Router Callback | `pkg/dashboard/openrouter.go:49` |
| `POST` | `/api/github-app/recheck` | Dashboard auth/session | GitHub App Recheck | `pkg/dashboard/server.go:1656` |
| `POST` | `/api/github-app/install-clicked` | Dashboard auth/session | GitHub App Install Clicked | `pkg/dashboard/server.go:1657` |
| `GET` | `/gh-setup` | Public | GitHub App Setup Callback | `pkg/dashboard/server.go:1658` |
| `POST` | `/api/github-app/recheck` | Dashboard auth/session | GitHub App Recheck | `pkg/dashboard/server.go:1658` |
| `POST` | `/api/github-app/install-clicked` | Dashboard auth/session | GitHub App Install Clicked | `pkg/dashboard/server.go:1659` |
| `GET` | `/gh-setup` | Public | GitHub App Setup Callback | `pkg/dashboard/server.go:1660` |
10 changes: 5 additions & 5 deletions src/docs/api-reference/beads.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f

| Method | Path | Auth | Purpose | Source |
|---|---|---|---|---|
| `GET` | `/api/beads` | Dashboard auth/session | Beads List | `pkg/dashboard/api.go:488` |
| `GET` | `/api/beads/{agent}` | Dashboard auth/session | Beads List | `pkg/dashboard/api.go:489` |
| `POST` | `/api/beads/{agent}` | Owner only | Beads Create | `pkg/dashboard/api.go:490` |
| `POST` | `/api/beads/reset` | Owner only | Beads Reset | `pkg/dashboard/api.go:491` |
| `POST` | `/api/beads/reset/{agent}` | Owner only | Beads Reset Agent | `pkg/dashboard/api.go:492` |
| `GET` | `/api/beads` | Dashboard auth/session | Beads List | `pkg/dashboard/api.go:489` |
| `GET` | `/api/beads/{agent}` | Dashboard auth/session | Beads List | `pkg/dashboard/api.go:490` |
| `POST` | `/api/beads/{agent}` | Owner only | Beads Create | `pkg/dashboard/api.go:491` |
| `POST` | `/api/beads/reset` | Owner only | Beads Reset | `pkg/dashboard/api.go:492` |
| `POST` | `/api/beads/reset/{agent}` | Owner only | Beads Reset Agent | `pkg/dashboard/api.go:493` |
Loading
Loading