Reconcile marketplace candidates and Agentation derivative identity

.bb/plugins.json

@@ -3,7 +3,7 @@
   "schemaVersion": 1,
   "name": "phosphor-bb-plugins",
   "plugins": [
-    { "name": "agentation", "source": "./plugins/agentation" },
+    { "name": "agentation-mentions", "source": "./plugins/agentation-mentions" },
     { "name": "perspectives", "source": "./plugins/perspectives" },
     { "name": "sticky-notes", "source": "./plugins/sticky-notes" },
     { "name": "bb-ui-reference", "source": "./plugins/bb-ui-reference" }

.github/workflows/publish.yml

@@ -8,13 +8,13 @@ on:
         required: true
         type: choice
         options:
-          - agentation
+          - agentation-mentions
           - perspectives
           - sticky-notes
           - bb-ui-reference
   push:
     tags:
-      - "agentation/v*"
+      - "agentation-mentions/v*"
       - "perspectives/v*"
       - "sticky-notes/v*"
       - "bb-ui-reference/v*"
@@ -52,7 +52,7 @@ jobs:
         run: |
           plugin="${REQUESTED_PLUGIN:-${GITHUB_REF_NAME%%/*}}"
           case "$plugin" in
-            agentation) workspace="@phosphorco/bb-plugin-agentation" ;;
+            agentation-mentions) workspace="@phosphorco/bb-plugin-agentation-mentions" ;;
             perspectives) workspace="@phosphorco/bb-plugin-perspectives" ;;
             sticky-notes) workspace="@phosphorco/bb-plugin-sticky-notes" ;;
             bb-ui-reference) workspace="@phosphorco/bb-plugin-bb-ui-reference" ;;

.github/workflows/validate-pull-request.yml

@@ -0,0 +1,44 @@
+name: Validate pull request
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the candidate
+        uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Set up Node and npm
+        uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: "24"
+          package-manager-cache: false
+
+      - name: Install locked dependencies
+        run: npm ci
+
+      - name: Test
+        run: npm run test
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build BB artifacts
+        run: npm run build
+
+      - name: Inspect Agentation Mentions package
+        run: npm pack --dry-run --ignore-scripts --workspace @phosphorco/bb-plugin-agentation-mentions
+
+      - name: Inspect Perspectives package
+        run: npm pack --dry-run --ignore-scripts --workspace @phosphorco/bb-plugin-perspectives
+
+      - name: Inspect Sticky Notes package
+        run: npm pack --dry-run --ignore-scripts --workspace @phosphorco/bb-plugin-sticky-notes
+
+      - name: Inspect BB UI Reference package
+        run: npm pack --dry-run --ignore-scripts --workspace @phosphorco/bb-plugin-bb-ui-reference

README.md

@@ -8,7 +8,7 @@
 
 | Plugin | Purpose |
 |---|---|
-| [Agentation](plugins/agentation/) | Turn visual feedback on any bb surface into structured annotations an agent can act on and resolve. |
+| [Agentation → Mentions](plugins/agentation-mentions/) | Based on Agentation by Scott Sunarto; adds native mentions, queued delivery, and verified identity tags. |
 | [Perspectives](plugins/perspectives/) | Consult independent expert agents and synthesize evidence across caller-selected lenses. |
 | [Sticky Notes](plugins/sticky-notes/) | Leave shared, movable notes directly on bb threads. |
 | [BB UI Reference](plugins/bb-ui-reference/) | Explore BB's plugin surfaces and active semantic theme palette. |
@@ -18,10 +18,10 @@
 Each plugin is published independently to npm by its prefixed release tag:
 
 ```sh
-bb plugin install npm:@phosphorco/bb-plugin-agentation@^0.1.0
-bb plugin install npm:@phosphorco/bb-plugin-perspectives@^0.1.0
-bb plugin install npm:@phosphorco/bb-plugin-sticky-notes@^0.1.0
-bb plugin install npm:@phosphorco/bb-plugin-bb-ui-reference@^0.1.0
+bb plugin install npm:@phosphorco/bb-plugin-agentation-mentions@^0.1.0
+bb plugin install npm:@phosphorco/bb-plugin-perspectives@^0.2.0
+bb plugin install npm:@phosphorco/bb-plugin-sticky-notes@^0.1.1
+bb plugin install npm:@phosphorco/bb-plugin-bb-ui-reference@^0.1.1
 ```
 
 The plugins are also submitted to the BB Community marketplace for installation from bb.
@@ -46,12 +46,12 @@ npm run build
 Install a development checkout by name:
 
 ```sh
-bb plugin install path:. --plugin agentation --yes
+bb plugin install path:. --plugin agentation-mentions --yes
 ```
 
 ## Licensing and provenance
 
 Phosphor-authored plugins are MIT licensed. Agentation preserves its upstream
 attribution and plugin-scoped third-party notices, including the PolyForm
-Shield 1.0.0 terms of its `agentation` dependency. See each plugin directory
+Shield 1.0.0 terms of its vendored `agentation` dependency. See each plugin directory
 for its exact license and notices.

package.json

@@ -13,6 +13,6 @@
     "typecheck": "npm run typecheck --workspaces --if-present"
   },
   "devDependencies": {
-    "bb-app": "0.38.0"
+    "bb-app": "0.39.0"
   }
 }

plugins/agentation-mentions/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Upstream Agentation changelog
+
+Imported from Agentation by Scott Sunarto through version 0.2.2; derivative
+releases use the separate `agentation-mentions` package and tag prefix.
+
+## 0.2.2
+
+### Patch Changes
+
+- 1432728: Support bb 0.39. The engines range is no longer pinned to one minor: it now floors at the tested bb release and excludes only the next major (`>=0.39.0 <1.0.0`), so future bb minors load without a plugin update. Built against plugin SDK 0.4.8.
+
+## 0.2.1
+
+### Patch Changes
+
+- 186c131: Make the release tag installable. Every import the server bundle pulls in at
+  runtime is now a real `dependencies` entry, so `bb plugin install` from a git
+  tag resolves it. The previous tags built only inside this workspace, where a
+  hoisted `node_modules` supplied what the manifests had left out as devDependencies —
+  a fresh checkout of the tag failed the build with `Could not resolve "zod"`.
+- 186c131: Vendor the patched upstream instead of relying on a Bun patch. `patchedDependencies`
+  is a workspace-install feature; a consumer installing the tag got the unpatched
+  package. The modified copy now lives at `vendor/agentation` with its changes
+  recorded in `vendor/agentation.patch` and its PolyForm Shield licence beside it.
+
+## 0.2.0
+
+### Minor Changes
+
+- b3ed493: Require bb 0.38 and take the SDK types from the published `@get-bb/plugin-sdk`
+  package. `engines.bb` is now `>=0.38.0 <0.39.0`, so an older bb no longer
+  installs these plugins.
+
+  Agent Proxy gains a `routingStrategy` setting (`round-robin`, `fill-first`, or
+  `weighted-round-robin`) that it writes to the core `config.yaml`. Pick
+  `fill-first` to keep several Claude OAuth accounts from rotating away the
+  upstream prompt cache.
+
+### Patch Changes
+
+- 65ececd: Release the runtime, presentation, notification, theme, and thread workflow updates.

plugins/agentation-mentions/README.md

@@ -0,0 +1,107 @@
+# Agentation → Mentions
+
+**Based on Agentation by Scott Sunarto.** This derivative starts from
+[`@smsunarto/bb-plugin-agentation` 0.2.2](https://github.com/smsunarto/bb-plugins/tree/8bc27b91333e2228607b137d09b195d90e6aecfa/plugins/agentation)
+at exact revision `8bc27b91333e2228607b137d09b195d90e6aecfa`. Scott's canonical
+**Agentation** marketplace listing is the maintained visual-annotation plugin.
+This separately named package preserves that behavior and adds a bb-native
+delivery workflow; `agentation-mentions` is a namespace distinction, not a
+claim that this is an unrelated product.
+
+The original MIT license, the modified `agentation@3.0.2` PolyForm Shield
+license, the vendor patch, and complete third-party notices ship with this
+plugin.
+
+## What the derivative adds
+
+- A composer action attaches staged annotations as a native bb mention. The
+  mention resolves the current annotation bodies when the prompt is submitted.
+- `bb agentation-mentions send --queue` uses bb's durable queued-message API;
+  omitting `--queue` sends immediately.
+- When Identity Boundaries is present, capture stores the author's identity ID
+  and delivery verifies its current profile before adding the standard
+  `[from=<tag>] ... [/from=<tag>]` identity frame. Feedback still works without
+  that optional plugin and is then left unattributed.
+- Every agent tool and CLI surface uses the distinct `agentation_mentions_*`
+  / `bb agentation-mentions` identity, so it can coexist with canonical
+  Agentation without tool or command collisions.
+
+Everything else remains recognizably Agentation: a toolbar overlays bb and
+plugin surfaces, captures AFS 1.1 annotations with bb route/plugin context,
+stores them in the plugin database, exposes a review panel, updates open
+windows in real time, and lets agents acknowledge, reply, resolve, or dismiss
+feedback.
+
+## Install
+
+```sh
+bb plugin install npm:@phosphorco/bb-plugin-agentation-mentions@^0.1.0
+```
+
+From this repository:
+
+```sh
+npm ci
+npm run build --workspace @phosphorco/bb-plugin-agentation-mentions
+bb plugin install path:. --plugin agentation-mentions --yes
+```
+
+## Use it
+
+1. Open the toolbar at the bottom-right of bb, select an element, and write the
+   feedback. The annotation records its DOM selector, available React/source
+   path, bb route, and owning plugin.
+2. In a thread composer, use the Agentation → Mentions action to insert the
+   staged batch, then submit or queue the prompt normally. Deleting the mention
+   leaves the annotations staged.
+3. An agent reads the supplied batch with the `agentation_mentions_*` tools and
+   resolves each item after fixing it. The marker disappears from open windows.
+
+The review panel retains cross-page history and reply threads. Staged feedback
+can also be assigned from the CLI:
+
+```text
+bb agentation-mentions pending [--plugin <id>] [--json]
+bb agentation-mentions staged [--json]
+bb agentation-mentions send [--queue] <threadId> [annotationId…]
+bb agentation-mentions restage <annotationId>
+bb agentation-mentions sessions
+bb agentation-mentions show <annotationId>
+bb agentation-mentions acknowledge <annotationId>
+bb agentation-mentions resolve <annotationId> [summary…]
+bb agentation-mentions dismiss <annotationId> <reason…>
+bb agentation-mentions reply <annotationId> <message…>
+bb agentation-mentions toolbar [on|off]
+```
+
+## Data, network, and authority
+
+- Annotation bodies, routing, replies, identity IDs, and retention state are
+  stored locally in this plugin's bb database/KV namespace.
+- The toolbar and review panel use bb's plugin RPC, realtime, and same-origin
+  event stream. The plugin contacts no third-party service of its own.
+- Delivery mutates only the target bb thread: immediate mode sends a prompt;
+  queue mode adds a queued prompt. Identity lookup is read-only and optional.
+- Agent tools can change annotation status and replies. They do not edit source
+  code themselves; the calling agent's normal permissions govern any fix.
+
+Resolved annotations are retained for seven days by default. Toolbar visibility
+is live state and can be changed with `bb agentation-mentions toolbar on|off`.
+
+## Artwork
+
+The rich in-plugin logo and marketplace icon are Cole-approved AM02-A. The
+package preserves the generated 1254px RGB source and the verified RGB24
+nearest-neighbor 16/24/32px derivatives byte-for-byte under `assets/`.
+
+## Develop
+
+```sh
+bb plugin dev plugins/agentation-mentions
+npm run test --workspace @phosphorco/bb-plugin-agentation-mentions
+npm run typecheck --workspace @phosphorco/bb-plugin-agentation-mentions
+```
+
+See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) and
+[vendor/README.md](vendor/README.md) for the canonical reduction and React 19
+component-detection patch.