@anyforge/mcp-server 3.11.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 +40 -3
- 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,6 +249,13 @@ 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 |
|
|
@@ -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 |
|
|
@@ -358,8 +389,14 @@ is internal unless `clientVisible: true`; `anyforge_share_work_item_comment`
|
|
|
358
389
|
(`itemId`, `commentId`, `clientVisible`) changes an existing comment. The gate is
|
|
359
390
|
the Console's: `write` scope and a key owner who is currently an Editor or
|
|
360
391
|
above, so a key with no user gets `key_not_attributable`. A reply can be shared
|
|
361
|
-
only while its parent is shared (`parent_not_shared`). Replies and
|
|
362
|
-
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.
|
|
363
400
|
|
|
364
401
|
The structured Program Genesis writes are program-scoped. Brief saves are full
|
|
365
402
|
versioned replacements through `anyforge_save_program_brief_version`. Initiative
|