@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.
Files changed (3) hide show
  1. package/README.md +40 -3
  2. package/dist/index.js +35 -8
  3. 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 | Check the repository's Phase 1 + Phase 2 analysis gate before dispatch; does not launch a crew |
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 attachments
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