@anyforge/mcp-server 3.10.0 → 3.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -4
- package/dist/index.js +35 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,6 +19,30 @@ Firebase login.
|
|
|
19
19
|
> MCP authorization can instead connect to the hosted endpoint
|
|
20
20
|
> `https://crew.anyforge.ai/api/mcp` and sign in with OAuth.
|
|
21
21
|
|
|
22
|
+
### Hosted OAuth workspace selection
|
|
23
|
+
|
|
24
|
+
The hosted endpoint supports an opt-in explicit workspace mode after the
|
|
25
|
+
corresponding application release. One connection can authorize up to 20
|
|
26
|
+
workspaces, selected on the consent screen with their own roles and effective
|
|
27
|
+
scopes. Existing single-workspace connections keep their behavior; reauthorize
|
|
28
|
+
to opt in or to add a workspace.
|
|
29
|
+
|
|
30
|
+
In explicit mode, call `anyforge_list_workspaces` for the currently authorized,
|
|
31
|
+
consented workspace IDs, names, roles and effective scopes, then pass
|
|
32
|
+
`workspaceId` on every tenant tool call. There is no mutable active workspace.
|
|
33
|
+
Ask the user when a target is ambiguous. Missing, unconsented or revoked targets
|
|
34
|
+
are denied. Switching workspace in the Console does not change a call's target.
|
|
35
|
+
|
|
36
|
+
**Settings → API keys → Connected clients** shows only the current workspace's
|
|
37
|
+
grant. Revoking a row withdraws that workspace; client token revocation and
|
|
38
|
+
refresh-token reuse detection revoke the whole connection.
|
|
39
|
+
|
|
40
|
+
This is specific to OAuth for the exact hosted `/api/mcp` resource. The stdio
|
|
41
|
+
package continues to use a single-workspace API key and does not add workspace
|
|
42
|
+
discovery or `workspaceId` arguments. API keys and vendor proxy endpoints also
|
|
43
|
+
retain their existing workspace boundary. Building or publishing this package
|
|
44
|
+
does not deploy hosted workspace selection.
|
|
45
|
+
|
|
22
46
|
## Platform guide for connected agents
|
|
23
47
|
|
|
24
48
|
The server advertises a static `anyforge-platform` guide without tenant data or
|
|
@@ -225,10 +249,17 @@ complete capability and local/remote workspace boundary.
|
|
|
225
249
|
| `anyforge_list_work_item_comments` | read | List the work item's discussion thread, separate from crew transcripts; every comment carries a boolean `clientVisible` |
|
|
226
250
|
| `anyforge_post_work_item_comment` | write | Add a discussion comment to a work item; internal unless `clientVisible: true` shares it with the client as it is written |
|
|
227
251
|
| `anyforge_share_work_item_comment` | write | Share an existing work-item comment with the client (`clientVisible: true`) or take it back to internal (`false`) |
|
|
252
|
+
| `anyforge_list_work_item_files` | read | List the files attached to a work item (`GET /work/{id}/files`), one page at a time |
|
|
253
|
+
| `anyforge_add_work_item_files` | write | Attach up to 5 files to a work item (`text`, `contentBase64`, or a local `path` on the stdio server); added internal, Console types and limits, all or nothing, about 7 MB of files per call; optional `idempotencyKey` for safe retries |
|
|
254
|
+
| `anyforge_upload_local_file` | write | stdio only: read a file from this machine and direct-upload it (≤ 1 GB) to a work item, initiative or program; refused on the hosted transport (`local_files_unavailable`) |
|
|
255
|
+
| `anyforge_start_file_upload` | write | Start a direct upload (`POST …/files/uploads`); returns the resumable Storage `uploadUrl` and a `curl` command |
|
|
256
|
+
| `anyforge_complete_file_upload` | write | Complete it (`POST …/files/uploads/{uploadId}`); the file is attached only now |
|
|
257
|
+
| `anyforge_list_initiative_files` | read | An initiative's Files tab (`GET /initiatives/{id}/files`) |
|
|
258
|
+
| `anyforge_list_program_files` | read | A program's Files tab (`GET /programs/{id}/files`) |
|
|
228
259
|
| `anyforge_split_work_item` | write | Replace one unstarted work item with multiple children |
|
|
229
260
|
| `anyforge_merge_work_items` | write | Replace multiple unstarted work items with one merged item |
|
|
230
261
|
| `anyforge_list_crews` | read | Discover crews by status, active state, and limit |
|
|
231
|
-
| `anyforge_get_crew` | read | Crew state + recent outputs + comments |
|
|
262
|
+
| `anyforge_get_crew` | read | Crew state + recent outputs + comments. Leads with status, halt reason, work item, PR and timestamps; `shape: "summary"` (default) excerpts long text and leaves out large snapshots, naming each; `messages: 0` is the status read; `shape: "full"` for every field |
|
|
232
263
|
| `anyforge_post_crew_comment` | write | Comment on / @-mention people on a crew (the crew does not read comments; use `anyforge_message_crew` to steer a running crew, `anyforge_amend_crew` for one at a gate) |
|
|
233
264
|
| `anyforge_message_crew` | approve | Message a running crew's Engineer ("skip X", "check Z first"). It reads the message before its next step and confirms in the crew chat; a crew not yet started or stopped inside the Engineer reads it on its first step or on resume. Refused with `crew_not_reading_messages` at a gate, in review or when finished. Optional `idempotencyKey` makes a retry safe |
|
|
234
265
|
| `anyforge_resume_crew` | approve | Resume a PAUSED/HALTED crew |
|
|
@@ -242,7 +273,7 @@ complete capability and local/remote workspace boundary.
|
|
|
242
273
|
| `anyforge_dispatch_architect` | write | Decompose an initiative into a backlog (→ HIL #1) |
|
|
243
274
|
| `anyforge_list_repo_index` | read | List the org repo index (activity, coverage, analyzed) — discover codebases to scope |
|
|
244
275
|
| `anyforge_get_repo_analysis` | read | One repo's coverage / architecture / gap summary |
|
|
245
|
-
| `anyforge_check_dispatch_readiness` | read |
|
|
276
|
+
| `anyforge_check_dispatch_readiness` | read | With `workItemId`, list every blocker that would stop a crew starting on that item; with only `repoFullName`, check the repository's analysis gate. Does not launch a crew |
|
|
246
277
|
| `anyforge_analyze_repos` | write | Start Phase-1 analysis for one or more repos; Phase 2 follows automatically when Phase 1 completes |
|
|
247
278
|
| `anyforge_start_coverage_sweep` | write | Paced Phase 1→2 analysis sweep over a program/repo set |
|
|
248
279
|
| `anyforge_refresh_repo_index` | write | Refresh the repo index + committed-coverage detection now |
|
|
@@ -293,6 +324,9 @@ complete capability and local/remote workspace boundary.
|
|
|
293
324
|
| `anyforge_update_report` | write | Change the title, description or settings, and edit widgets by id (`addWidgets`, `replaceWidgets`, `removeWidgetIds`) or replace the whole list (`widgets`). Every widget is validated as a Console save is; a refusal saves nothing |
|
|
294
325
|
| `anyforge_preview_report_query` | read | Run one report query against live data without saving anything: total, rows and a text summary (program, strategy and cycles snapshots included); needs a role that edits reports |
|
|
295
326
|
| `anyforge_describe_report_catalog` | read | The report data catalog: sources, measures, group-bys, filter fields and widget types; needs a role that edits reports |
|
|
327
|
+
| `anyforge_create_risk` | write | Record an accepted risk on a program, initiative or work item: owner (defaults to you), `reviewBy` date or `acceptedUntilMilestoneId`, trigger, mitigation. A risk never blocks dispatch, `Depends on` or the critical path |
|
|
328
|
+
| `anyforge_list_risks` | read | List accepted risks for a program (`programId`) or one subject (`subjectKind` + `subjectId`); closed risks only with `includeClosed` |
|
|
329
|
+
| `anyforge_update_risk` | write | Change a risk's status (for example `MATERIALISED` or `CLOSED`), owner, review date, mitigation or follow-up work items; only the fields passed change |
|
|
296
330
|
| `anyforge_list_report_filter_values` | read | The values a query filter field may take: an enum's closed set, or real ids with names (`query` looks one up by name); needs a role that edits reports |
|
|
297
331
|
| `anyforge_triage_ticket` | read | Run or continue a Support Triage interview — classification, readiness scoring, owning-team routing — and get a paste-ready rendering plus the structured draft; pass the same `sessionId` to continue an interview. Never files anything itself |
|
|
298
332
|
| `anyforge_list_triage_eval_cases` | read | List permitted triage eval cases; historical cases require Owner/Operator |
|
|
@@ -355,8 +389,14 @@ is internal unless `clientVisible: true`; `anyforge_share_work_item_comment`
|
|
|
355
389
|
(`itemId`, `commentId`, `clientVisible`) changes an existing comment. The gate is
|
|
356
390
|
the Console's: `write` scope and a key owner who is currently an Editor or
|
|
357
391
|
above, so a key with no user gets `key_not_attributable`. A reply can be shared
|
|
358
|
-
only while its parent is shared (`parent_not_shared`). Replies and
|
|
359
|
-
stay Console-only.
|
|
392
|
+
only while its parent is shared (`parent_not_shared`). Replies and comment
|
|
393
|
+
attachments stay Console-only. Item files go through `anyforge_add_work_item_files`
|
|
394
|
+
(same gate; bytes as `contentBase64`). Larger files, and initiative and program
|
|
395
|
+
files, go through a direct upload (`tools/files.ts`): the bytes go to Storage
|
|
396
|
+
through a resumable session the API opens, never through the API.
|
|
397
|
+
`anyforge_upload_local_file` reads a local path and is refused when
|
|
398
|
+
`isHostedTransport()` is true, because the hosted endpoint runs the same
|
|
399
|
+
handlers on the server, where a path would name the server's own disk.
|
|
360
400
|
|
|
361
401
|
The structured Program Genesis writes are program-scoped. Brief saves are full
|
|
362
402
|
versioned replacements through `anyforge_save_program_brief_version`. Initiative
|