@anynotate/protocol 0.4.0 → 0.5.0

package/PROTOCOL.md

@@ -4,7 +4,7 @@ The bridge is an HTTP server on `127.0.0.1`, port `47291` by default (`ANYNOTATE
 
 ## Handshake
 
-`POST /health` (or `GET`) → `{ "ok": true, "bridgeVersion": "0.5.1", "protocol": { "version": 2, "min": 1 } }`.
+`POST /health` (or `GET`) → `{ "ok": true, "bridgeVersion": "0.6.1", "protocol": { "version": 2, "min": 1 } }`.
 
 A client supports a range of protocol versions (the extension: `min 2, max 2`) and calls `compatibility(clientRange, response.protocol)`:
 
@@ -40,7 +40,7 @@ The allow-list is the valid `chrome-extension://` entries from `$ANYNOTATE_HOME/
 | Method and path | Body | Response |
 |---|---|---|
 | `GET` / `POST /health` | — | `HealthResponse` |
-| `GET` / `POST /sessions` | — | `Session[]`: live push sessions, herdr panes (`method: "herdr"`), then sessions seen by the prompt hook outside herdr (`method: "next-prompt"`) |
+| `GET` / `POST /sessions` | — | `Session[]`: live push sessions, herdr panes (`method: "herdr"`), then sessions seen by the prompt hook outside herdr (`method: "next-prompt"`, with the agent's own conversation title when the bridge can read it) |
 | `POST /bundles` | `multipart/form-data`: field `bundle` = JSON `BundleInput`; files `page.md`, `screenshot.png`, optional `snapshot.html`, `crops/A<n>.png` | `201 SendResponse` (`{ id, status }`); `400 ErrorResponse` for an invalid bundle or file name |
 | `POST /bundles/<id>/status`, `GET /bundles/<id>` | — | `BundleStatusResponse` (`{ bundle, status }`; `status` is `null` if the status file is missing or unreadable); `404` if unknown |
 | `POST /bundles/<id>/ack` | `AckRequest` (`{ "summary"?: string }`) | `OkResponse`; `404` if unknown or busy |
@@ -111,8 +111,9 @@ Each entry is a CSS selector for an `<iframe>`, outermost first, resolved in the
 - **v1** — handshake, token-only access, native-host token delivery.
 - **v2** — intents `explain`, `change`, `approve` (legacy `question`, `bug`, `note` still accepted). `PROTOCOL_MIN` stays `1`: a v2 bridge accepts v1 clients.
   - Optional `region` on element annotations (additive, `@anynotate/protocol` 0.4.0, bridge 0.5.1).
-  - Optional `offscreen: true` on any annotation whose target was not on screen at send time (`box` and crop are from when it was last seen); `README.md` adds `(off-screen when sent)` to its heading (additive, same releases).
+  - Optional `offscreen: true` on any annotation whose target was not on the page at send time (`box` and crop are from when the note was made); `README.md` puts "Not on the page when sent — crop is from when the note was made." under its heading (without the crop clause when no crop was sent; additive, same releases; wording since bridge 0.6.1).
   - Optional `anchor.frames` on notes made inside same-origin iframes; `README.md` names the frames after the selector (additive, same releases).
+  - Optional `workspace` on `Session`: the display name of the herdr workspace holding a herdr pane (additive, `@anynotate/protocol` 0.5.0, bridge 0.6.1).
 
 ## Threat model
 

package/dist/fixtures.d.ts

@@ -25,6 +25,7 @@ export declare const responseSchemas: {
         }>;
         pane: z.ZodOptional<z.ZodString>;
         sessionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        workspace: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     SendResponse: z.ZodObject<{
         id: z.ZodString;

package/dist/fixtures.js

@@ -33,13 +33,13 @@ export const examplePage = "# Tomato soup\n\nstir in ⟦A1⟧200 ml cream before
 export const responseSchemas = {
     HealthResponse, SessionsResponse, SendResponse, BundleStatusResponse, OkResponse, ErrorResponse,
 };
-const health = { ok: true, bridgeVersion: "0.5.1", protocol: { version: 2, min: 1 } };
+const health = { ok: true, bridgeVersion: "0.6.1", protocol: { version: 2, min: 1 } };
 const queued = { state: "queued", at: "2026-09-24T15:32:01.000Z" };
 const exampleBundle = { ...exampleBundleInput, id: EXAMPLE_BUNDLE_ID, files: { page: "page.md", screenshot: "screenshot.png" } };
 export const conformance = [
     { name: "health-extension", request: { method: "POST", path: "/health", auth: "extension" }, status: 200, response: { schema: "HealthResponse", example: health } },
     { name: "health-probe", request: { method: "GET", path: "/health", auth: "none" }, status: 200, response: { schema: "HealthResponse", example: health } },
-    { name: "sessions-extension", request: { method: "POST", path: "/sessions", auth: "extension" }, status: 200, response: { schema: "SessionsResponse", example: [{ id: "w1:p2", agent: "claude", cwd: "/home/me/project", title: "shell", method: "herdr", pane: "w1:p2" }] } },
+    { name: "sessions-extension", request: { method: "POST", path: "/sessions", auth: "extension" }, status: 200, response: { schema: "SessionsResponse", example: [{ id: "w1:p2", agent: "claude", cwd: "/home/me/project", title: "shell", method: "herdr", pane: "w1:p2", workspace: "project" }] } },
     { name: "sessions-token", request: { method: "GET", path: "/sessions", auth: "token" }, status: 200, response: { schema: "SessionsResponse", example: [] } },
     { name: "sessions-extension-no-token", request: { method: "POST", path: "/sessions", auth: "extension-no-token" }, status: 401, response: { schema: "ErrorResponse", example: { error: "bad token" } } },
     { name: "sessions-unauthenticated", request: { method: "POST", path: "/sessions", auth: "none" }, status: 401, response: { schema: "ErrorResponse", example: { error: "bad token" } } },

package/dist/index.d.ts

@@ -275,6 +275,7 @@ export declare const Session: z.ZodObject<{
     }>;
     pane: z.ZodOptional<z.ZodString>;
     sessionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    workspace: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Session = z.infer<typeof Session>;
 export declare const PROTOCOL_VERSION = 2;
@@ -300,6 +301,7 @@ export declare const SessionsResponse: z.ZodArray<z.ZodObject<{
     }>;
     pane: z.ZodOptional<z.ZodString>;
     sessionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    workspace: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
 export type SessionsResponse = z.infer<typeof SessionsResponse>;
 export declare const SendResponse: z.ZodObject<{

package/dist/index.js

@@ -77,6 +77,8 @@ export const Session = z.object({
     method: z.enum(["push", "herdr", "next-prompt"]),
     pane: z.string().optional(),
     sessionIds: z.array(z.string()).optional(),
+    /** Display name of the herdr workspace a herdr pane is in. */
+    workspace: z.string().optional(),
 });
 // Protocol v2. Additive changes (optional fields, new endpoints) keep the version; removals, renames and
 // semantic changes bump PROTOCOL_VERSION, and the bridge keeps accepting the previous version for a release.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anynotate/protocol",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Wire types and zod schemas shared by Anynotate clients and the Anynotate bridge.",
   "license": "Apache-2.0",
   "author": "Kun Xu",

package/src/fixtures.ts

@@ -57,14 +57,14 @@ export type Exchange = {
   response: { schema: SchemaName; example: unknown };
 };
 
-const health = { ok: true, bridgeVersion: "0.5.1", protocol: { version: 2, min: 1 } };
+const health = { ok: true, bridgeVersion: "0.6.1", protocol: { version: 2, min: 1 } };
 const queued = { state: "queued", at: "2026-09-24T15:32:01.000Z" };
 const exampleBundle = { ...exampleBundleInput, id: EXAMPLE_BUNDLE_ID, files: { page: "page.md", screenshot: "screenshot.png" } };
 
 export const conformance: Exchange[] = [
   { name: "health-extension", request: { method: "POST", path: "/health", auth: "extension" }, status: 200, response: { schema: "HealthResponse", example: health } },
   { name: "health-probe", request: { method: "GET", path: "/health", auth: "none" }, status: 200, response: { schema: "HealthResponse", example: health } },
-  { name: "sessions-extension", request: { method: "POST", path: "/sessions", auth: "extension" }, status: 200, response: { schema: "SessionsResponse", example: [{ id: "w1:p2", agent: "claude", cwd: "/home/me/project", title: "shell", method: "herdr", pane: "w1:p2" }] } },
+  { name: "sessions-extension", request: { method: "POST", path: "/sessions", auth: "extension" }, status: 200, response: { schema: "SessionsResponse", example: [{ id: "w1:p2", agent: "claude", cwd: "/home/me/project", title: "shell", method: "herdr", pane: "w1:p2", workspace: "project" }] } },
   { name: "sessions-token", request: { method: "GET", path: "/sessions", auth: "token" }, status: 200, response: { schema: "SessionsResponse", example: [] } },
   { name: "sessions-extension-no-token", request: { method: "POST", path: "/sessions", auth: "extension-no-token" }, status: 401, response: { schema: "ErrorResponse", example: { error: "bad token" } } },
   { name: "sessions-unauthenticated", request: { method: "POST", path: "/sessions", auth: "none" }, status: 401, response: { schema: "ErrorResponse", example: { error: "bad token" } } },

package/src/index.ts

@@ -99,6 +99,8 @@ export const Session = z.object({
   method: z.enum(["push", "herdr", "next-prompt"]),
   pane: z.string().optional(),
   sessionIds: z.array(z.string()).optional(),
+  /** Display name of the herdr workspace a herdr pane is in. */
+  workspace: z.string().optional(),
 });
 export type Session = z.infer<typeof Session>;