@rei-standard/amsg-sw 2.0.1 → 2.1.0-next.0

package/README.md

@@ -3,9 +3,53 @@
 `@rei-standard/amsg-sw` 是 ReiStandard 主动消息标准的 Service Worker 插件包，目标是让推送展示和离线重试“开箱即用”。
 
 
+## v2.1.0 — 按 kind 分发的客户端事件
+
+2.1.0 跟随 `@rei-standard/amsg-shared` 的三轴 push schema：每条 push 现在通过 `payload.messageKind`（`content` / `reasoning` / `tool_request` / `error`）区分内容类型。SW 在收到 push 后会做两件事：
+
+1. **永远** 通过 `postMessage` 把 payload 广播给所有受控窗口（包括 `includeUncontrolled: true` 的未受控窗口）。
+2. **仅当** `messageKind === 'content'` 或 payload 没有 `messageKind`（2.0.x 老 payload 的回退路径）时，才调用 `showNotification`。`reasoning` / `tool_request` / `error` 三种 kind 一律不弹通知——业务在 app 内通过 postMessage 通道自行渲染。
+
+### 新增导出 `REI_SW_EVENT`
+
+事件名由 SW 在每次广播时打在 `e.data.event` 上：
+
+| 常量 | 字符串值 | 触发条件 |
+|------|---------|---------|
+| `REI_SW_EVENT.CONTENT_RECEIVED`      | `'rei-amsg-content-received'`      | `payload.messageKind === 'content'` |
+| `REI_SW_EVENT.REASONING_RECEIVED`    | `'rei-amsg-reasoning-received'`    | `payload.messageKind === 'reasoning'` |
+| `REI_SW_EVENT.TOOL_REQUEST_RECEIVED` | `'rei-amsg-tool-request-received'` | `payload.messageKind === 'tool_request'` |
+| `REI_SW_EVENT.ERROR_RECEIVED`        | `'rei-amsg-error-received'`        | `payload.messageKind === 'error'` |
+| `REI_SW_EVENT.UNKNOWN_RECEIVED`      | `'rei-amsg-unknown-received'`      | 缺 `messageKind`（2.0.x 老 payload / blob envelope） |
+
+### 客户端订阅示例
+
+```js
+navigator.serviceWorker.addEventListener('message', (e) => {
+  if (e.data?.type !== 'REI_AMSG_PUSH') return;
+  switch (e.data.event) {
+    case 'rei-amsg-content-received':      /* 渲染 app 内消息 */ break;
+    case 'rei-amsg-reasoning-received':    /* 渲染思考中 UI */ break;
+    case 'rei-amsg-tool-request-received': /* 弹出工具执行确认 */ break;
+    case 'rei-amsg-error-received':        /* 显示错误 toast */ break;
+    case 'rei-amsg-unknown-received':      /* 2.0.x 老 payload 的兼容路径 */ break;
+  }
+});
+```
+
+### Blob envelope
+
+当 `amsg-instant` 检测到 payload 超过 `maxInlineBytes` 时会改发 blob envelope `{ _blob: true, key, url, messageKind?, type? }`。SW **不会** 自动 fetch blob 内容（那是 client 的职责），但仍然会按 envelope 上的 `messageKind` 分发对应事件，让 client 知道有什么类型的内容即将到达，自己决定要不要拉取。Blob envelope 也只在 `messageKind === 'content'`（或缺失）时才渲染占位通知，与普通 push 行为一致。
+
+### 升级注意事项
+
+- 想给 `reasoning` / `tool_request` / `error` 也弹通知的业务：必须自行在 app 内监听上面的 postMessage 事件、调 `Notification` 或 `registration.showNotification`。SW 默认不再为它们弹通知。
+- 客户端代码继续兼容只有 `installReiSW` + `REI_SW_MESSAGE_TYPE`（队列）的 2.0.x 写法——新增导出不破坏既有 API。
+- 想拿到 push 类型相关的 TS 类型：从 `@rei-standard/amsg-shared` 引 `AmsgPush` 等类型（本包通过 JSDoc 引用同一份类型）。
+
 ## 功能概览
 
-- 处理 `push` 事件：自动解析 payload 并展示通知
+- 处理 `push` 事件：按 `messageKind` 三轴 schema 分发到客户端 + 仅 `content` 走 `showNotification`
 - 处理 `message` 事件：支持离线请求入队与主动冲刷队列
 - 处理 `sync` 事件：在网络恢复后自动重试队列请求
 - 使用 IndexedDB 存储待发送请求，避免页面关闭后丢失
@@ -97,8 +141,18 @@ export async function enqueueRequestToSW(requestPayload) {
 ## 导出 API（Exports）
 
 - `installReiSW`
+- `REI_SW_EVENT` — 2.1.0 新增，按 kind 分发的客户端事件名
+- `REI_AMSG_POSTMESSAGE_TYPE` — 2.1.0 新增，SW → client 广播信封的 `type` 字段（恒为 `'REI_AMSG_PUSH'`）
 - `REI_SW_MESSAGE_TYPE`
 
+`REI_SW_EVENT` 包含（详见上文 v2.1.0 章节）：
+
+- `CONTENT_RECEIVED`
+- `REASONING_RECEIVED`
+- `TOOL_REQUEST_RECEIVED`
+- `ERROR_RECEIVED`
+- `UNKNOWN_RECEIVED`
+
 `REI_SW_MESSAGE_TYPE` 包含：
 
 - `ENQUEUE_REQUEST`

package/dist/index.cjs

@@ -19,6 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.js
 var src_exports = {};
 __export(src_exports, {
+  REI_AMSG_POSTMESSAGE_TYPE: () => REI_AMSG_POSTMESSAGE_TYPE,
+  REI_SW_EVENT: () => REI_SW_EVENT,
   REI_SW_MESSAGE_TYPE: () => REI_SW_MESSAGE_TYPE,
   installReiSW: () => installReiSW
 });
@@ -27,6 +29,14 @@ var REI_SW_DB_NAME = "rei-sw";
 var REI_SW_DB_STORE = "request-outbox";
 var REI_SW_DB_VERSION = 1;
 var REI_SW_SYNC_TAG = "rei-sw-flush-request-outbox";
+var REI_AMSG_POSTMESSAGE_TYPE = "REI_AMSG_PUSH";
+var REI_SW_EVENT = Object.freeze({
+  CONTENT_RECEIVED: "rei-amsg-content-received",
+  REASONING_RECEIVED: "rei-amsg-reasoning-received",
+  TOOL_REQUEST_RECEIVED: "rei-amsg-tool-request-received",
+  ERROR_RECEIVED: "rei-amsg-error-received",
+  UNKNOWN_RECEIVED: "rei-amsg-unknown-received"
+});
 var REI_SW_MESSAGE_TYPE = Object.freeze({
   ENQUEUE_REQUEST: "REI_ENQUEUE_REQUEST",
   FLUSH_QUEUE: "REI_FLUSH_QUEUE",
@@ -38,14 +48,21 @@ function installReiSW(sw, opts = {}) {
   sw.addEventListener("push", (event) => {
     const payload = readPushPayload(event);
     if (!payload) return;
-    const notification = createNotificationFromPayload(payload, {
-      defaultIcon,
-      defaultBadge
-    });
-    if (!notification) return;
-    event.waitUntil(
-      sw.registration.showNotification(notification.title, notification.options)
-    );
+    const eventName = resolveEventName(payload);
+    const shouldRenderNotification = isNotificationKind(payload);
+    const work = [dispatchPushToClients(sw, eventName, payload)];
+    if (shouldRenderNotification) {
+      const notification = createNotificationFromPayload(payload, {
+        defaultIcon,
+        defaultBadge
+      });
+      if (notification) {
+        work.push(
+          sw.registration.showNotification(notification.title, notification.options)
+        );
+      }
+    }
+    event.waitUntil(Promise.all(work));
   });
   sw.addEventListener("message", (event) => {
     const message = event.data;
@@ -65,6 +82,47 @@ function installReiSW(sw, opts = {}) {
     event.waitUntil(flushQueuedRequests(sw));
   });
 }
+function resolveEventName(payload) {
+  const kind = payload && typeof payload === "object" ? payload.messageKind : void 0;
+  switch (kind) {
+    case "content":
+      return REI_SW_EVENT.CONTENT_RECEIVED;
+    case "reasoning":
+      return REI_SW_EVENT.REASONING_RECEIVED;
+    case "tool_request":
+      return REI_SW_EVENT.TOOL_REQUEST_RECEIVED;
+    case "error":
+      return REI_SW_EVENT.ERROR_RECEIVED;
+    default:
+      return REI_SW_EVENT.UNKNOWN_RECEIVED;
+  }
+}
+function isNotificationKind(payload) {
+  if (!payload || typeof payload !== "object") return false;
+  const kind = payload.messageKind;
+  if (kind === void 0 || kind === null) return true;
+  return kind === "content";
+}
+async function dispatchPushToClients(sw, eventName, payload) {
+  try {
+    const clientList = await sw.clients.matchAll({
+      type: "window",
+      includeUncontrolled: true
+    });
+    const envelope = {
+      type: REI_AMSG_POSTMESSAGE_TYPE,
+      event: eventName,
+      payload
+    };
+    for (const client of clientList) {
+      try {
+        client.postMessage(envelope);
+      } catch (_postError) {
+      }
+    }
+  } catch (_matchError) {
+  }
+}
 function readPushPayload(event) {
   if (!event.data) return null;
   try {

package/dist/index.d.cts

@@ -2,34 +2,79 @@
  * ReiStandard Service Worker helpers.
  *
  * Drop-in plugin for Service Workers that handles:
- *  - Basic push payload -> notification rendering
- *  - Offline request queueing and retry with Background Sync
+ *  - Three-axis `push` payload dispatch — keyed by `payload.messageKind`
+ *    (see `@rei-standard/amsg-shared`). Every push is mirrored to every
+ *    controlled client via `postMessage` under a per-kind event name.
+ *  - Notification rendering for `messageKind: 'content'` (and legacy
+ *    payloads without `messageKind`, for back-compat with 2.0.x
+ *    producers).
+ *  - Offline request queueing and retry with Background Sync.
  *
  * Notes:
  *  - This plugin intentionally does not install `notificationclick`.
  *    Main applications can implement their own click navigation logic.
+ *  - `reasoning` / `tool_request` / `error` pushes are dispatched as
+ *    `postMessage` events but **do not** trigger `showNotification` —
+ *    apps render those in-app via the postMessage channel.
+ *  - Blob envelopes (`{ _blob: true, key, url, messageKind? }`) are
+ *    dispatched to clients verbatim. The SW never auto-fetches the
+ *    blob body — that's the client's job.
  *
  * Usage (inside your sw.js):
- *   import { installReiSW, REI_SW_MESSAGE_TYPE } from '@rei-standard/amsg-sw';
+ *   import { installReiSW, REI_SW_EVENT, REI_SW_MESSAGE_TYPE } from '@rei-standard/amsg-sw';
  *   installReiSW(self);
  *
  * Usage (inside your web app):
- *   navigator.serviceWorker.controller?.postMessage({
- *     type: REI_SW_MESSAGE_TYPE.ENQUEUE_REQUEST,
- *     request: {
- *       url: '/api/messages/send',
- *       method: 'POST',
- *       headers: { 'Content-Type': 'application/json' },
- *       body: { text: 'hello' }
+ *   navigator.serviceWorker.addEventListener('message', (e) => {
+ *     if (e.data?.type !== 'REI_AMSG_PUSH') return;
+ *     switch (e.data.event) {
+ *       case REI_SW_EVENT.CONTENT_RECEIVED:      // render in-app message
+ *       case REI_SW_EVENT.REASONING_RECEIVED:    // render thinking UI
+ *       case REI_SW_EVENT.TOOL_REQUEST_RECEIVED: // prompt tool exec
+ *       case REI_SW_EVENT.ERROR_RECEIVED:        // show error toast
+ *       case REI_SW_EVENT.UNKNOWN_RECEIVED:      // legacy 2.0.x payload
  *     }
  *   });
  */
 
+/**
+ * @typedef {import('@rei-standard/amsg-shared').AmsgPush} AmsgPush
+ * @typedef {import('@rei-standard/amsg-shared').ContentPush} ContentPush
+ * @typedef {import('@rei-standard/amsg-shared').ReasoningPush} ReasoningPush
+ * @typedef {import('@rei-standard/amsg-shared').ToolRequestPush} ToolRequestPush
+ * @typedef {import('@rei-standard/amsg-shared').ErrorPush} ErrorPush
+ */
+
 const REI_SW_DB_NAME = 'rei-sw';
 const REI_SW_DB_STORE = 'request-outbox';
 const REI_SW_DB_VERSION = 1;
 const REI_SW_SYNC_TAG = 'rei-sw-flush-request-outbox';
 
+/**
+ * Wire-level message type for SW → client postMessage envelopes.
+ * Clients filter on `e.data.type === 'REI_AMSG_PUSH'` before reading
+ * `e.data.event` (which is one of {@link REI_SW_EVENT}'s values).
+ */
+const REI_AMSG_POSTMESSAGE_TYPE = 'REI_AMSG_PUSH';
+
+/**
+ * Per-kind event names dispatched to controlled clients. Each push the
+ * SW receives is mirrored to every window via
+ * `postMessage({ type: 'REI_AMSG_PUSH', event: <one of these>, payload })`.
+ *
+ * The mapping is keyed by `payload.messageKind`. Legacy payloads (and
+ * blob envelopes) without a `messageKind` field dispatch as
+ * {@link REI_SW_EVENT.UNKNOWN_RECEIVED} so apps can still handle 2.0.x
+ * producers during migration.
+ */
+const REI_SW_EVENT = Object.freeze({
+  CONTENT_RECEIVED: 'rei-amsg-content-received',
+  REASONING_RECEIVED: 'rei-amsg-reasoning-received',
+  TOOL_REQUEST_RECEIVED: 'rei-amsg-tool-request-received',
+  ERROR_RECEIVED: 'rei-amsg-error-received',
+  UNKNOWN_RECEIVED: 'rei-amsg-unknown-received'
+});
+
 const REI_SW_MESSAGE_TYPE = Object.freeze({
   ENQUEUE_REQUEST: 'REI_ENQUEUE_REQUEST',
   FLUSH_QUEUE: 'REI_FLUSH_QUEUE',
@@ -56,15 +101,25 @@ function installReiSW(sw, opts = {}) {
     const payload = readPushPayload(event);
     if (!payload) return;
 
-    const notification = createNotificationFromPayload(payload, {
-      defaultIcon,
-      defaultBadge
-    });
-    if (!notification) return;
+    const eventName = resolveEventName(payload);
+    const shouldRenderNotification = isNotificationKind(payload);
+
+    /** @type {Array<Promise<unknown>>} */
+    const work = [dispatchPushToClients(sw, eventName, payload)];
+
+    if (shouldRenderNotification) {
+      const notification = createNotificationFromPayload(payload, {
+        defaultIcon,
+        defaultBadge
+      });
+      if (notification) {
+        work.push(
+          sw.registration.showNotification(notification.title, notification.options)
+        );
+      }
+    }
 
-    event.waitUntil(
-      sw.registration.showNotification(notification.title, notification.options)
-    );
+    event.waitUntil(Promise.all(work));
   });
 
   sw.addEventListener('message', (event) => {
@@ -89,6 +144,85 @@ function installReiSW(sw, opts = {}) {
   });
 }
 
+/**
+ * Map a parsed push payload to its corresponding per-kind event name.
+ * Falls back to `UNKNOWN_RECEIVED` for legacy 2.0.x payloads and blob
+ * envelopes without `messageKind`.
+ *
+ * @param {Record<string, unknown>} payload
+ * @returns {string}
+ */
+function resolveEventName(payload) {
+  const kind = payload && typeof payload === 'object' ? payload.messageKind : undefined;
+  switch (kind) {
+    case 'content':
+      return REI_SW_EVENT.CONTENT_RECEIVED;
+    case 'reasoning':
+      return REI_SW_EVENT.REASONING_RECEIVED;
+    case 'tool_request':
+      return REI_SW_EVENT.TOOL_REQUEST_RECEIVED;
+    case 'error':
+      return REI_SW_EVENT.ERROR_RECEIVED;
+    default:
+      return REI_SW_EVENT.UNKNOWN_RECEIVED;
+  }
+}
+
+/**
+ * True when the payload should trigger `showNotification`. Only
+ * `messageKind: 'content'` renders a notification; everything else
+ * (`reasoning`, `tool_request`, `error`) is dispatched silently so
+ * apps can render them in-app.
+ *
+ * Legacy payloads with no `messageKind` field still render a
+ * notification — that's the 2.0.x back-compat path.
+ *
+ * @param {Record<string, unknown>} payload
+ * @returns {boolean}
+ */
+function isNotificationKind(payload) {
+  if (!payload || typeof payload !== 'object') return false;
+  const kind = payload.messageKind;
+  if (kind === undefined || kind === null) return true;
+  return kind === 'content';
+}
+
+/**
+ * Broadcast a parsed push payload to every controlled client. Failures
+ * on individual `postMessage` calls are swallowed — one offline tab
+ * shouldn't break delivery to the others. The whole broadcast is
+ * resolved (never rejected) so it can be safely passed to
+ * `event.waitUntil`.
+ *
+ * @param {ServiceWorkerGlobalScope} sw
+ * @param {string}                   eventName
+ * @param {Record<string, unknown>}  payload
+ * @returns {Promise<void>}
+ */
+async function dispatchPushToClients(sw, eventName, payload) {
+  try {
+    const clientList = await sw.clients.matchAll({
+      type: 'window',
+      includeUncontrolled: true
+    });
+    const envelope = {
+      type: REI_AMSG_POSTMESSAGE_TYPE,
+      event: eventName,
+      payload
+    };
+    for (const client of clientList) {
+      try {
+        client.postMessage(envelope);
+      } catch (_postError) {
+        // Per-client failures must not abort the broadcast.
+      }
+    }
+  } catch (_matchError) {
+    // No window clients available, or the matchAll call rejected.
+    // Either way, fail silently — notification rendering still wins.
+  }
+}
+
 function readPushPayload(event) {
   if (!event.data) return null;
 
@@ -346,4 +480,4 @@ async function removeQueuedRequest(id) {
   });
 }
 
-export { REI_SW_MESSAGE_TYPE, installReiSW };
+export { REI_AMSG_POSTMESSAGE_TYPE, REI_SW_EVENT, REI_SW_MESSAGE_TYPE, installReiSW };

package/dist/index.d.ts

@@ -2,34 +2,79 @@
  * ReiStandard Service Worker helpers.
  *
  * Drop-in plugin for Service Workers that handles:
- *  - Basic push payload -> notification rendering
- *  - Offline request queueing and retry with Background Sync
+ *  - Three-axis `push` payload dispatch — keyed by `payload.messageKind`
+ *    (see `@rei-standard/amsg-shared`). Every push is mirrored to every
+ *    controlled client via `postMessage` under a per-kind event name.
+ *  - Notification rendering for `messageKind: 'content'` (and legacy
+ *    payloads without `messageKind`, for back-compat with 2.0.x
+ *    producers).
+ *  - Offline request queueing and retry with Background Sync.
  *
  * Notes:
  *  - This plugin intentionally does not install `notificationclick`.
  *    Main applications can implement their own click navigation logic.
+ *  - `reasoning` / `tool_request` / `error` pushes are dispatched as
+ *    `postMessage` events but **do not** trigger `showNotification` —
+ *    apps render those in-app via the postMessage channel.
+ *  - Blob envelopes (`{ _blob: true, key, url, messageKind? }`) are
+ *    dispatched to clients verbatim. The SW never auto-fetches the
+ *    blob body — that's the client's job.
  *
  * Usage (inside your sw.js):
- *   import { installReiSW, REI_SW_MESSAGE_TYPE } from '@rei-standard/amsg-sw';
+ *   import { installReiSW, REI_SW_EVENT, REI_SW_MESSAGE_TYPE } from '@rei-standard/amsg-sw';
  *   installReiSW(self);
  *
  * Usage (inside your web app):
- *   navigator.serviceWorker.controller?.postMessage({
- *     type: REI_SW_MESSAGE_TYPE.ENQUEUE_REQUEST,
- *     request: {
- *       url: '/api/messages/send',
- *       method: 'POST',
- *       headers: { 'Content-Type': 'application/json' },
- *       body: { text: 'hello' }
+ *   navigator.serviceWorker.addEventListener('message', (e) => {
+ *     if (e.data?.type !== 'REI_AMSG_PUSH') return;
+ *     switch (e.data.event) {
+ *       case REI_SW_EVENT.CONTENT_RECEIVED:      // render in-app message
+ *       case REI_SW_EVENT.REASONING_RECEIVED:    // render thinking UI
+ *       case REI_SW_EVENT.TOOL_REQUEST_RECEIVED: // prompt tool exec
+ *       case REI_SW_EVENT.ERROR_RECEIVED:        // show error toast
+ *       case REI_SW_EVENT.UNKNOWN_RECEIVED:      // legacy 2.0.x payload
  *     }
  *   });
  */
 
+/**
+ * @typedef {import('@rei-standard/amsg-shared').AmsgPush} AmsgPush
+ * @typedef {import('@rei-standard/amsg-shared').ContentPush} ContentPush
+ * @typedef {import('@rei-standard/amsg-shared').ReasoningPush} ReasoningPush
+ * @typedef {import('@rei-standard/amsg-shared').ToolRequestPush} ToolRequestPush
+ * @typedef {import('@rei-standard/amsg-shared').ErrorPush} ErrorPush
+ */
+
 const REI_SW_DB_NAME = 'rei-sw';
 const REI_SW_DB_STORE = 'request-outbox';
 const REI_SW_DB_VERSION = 1;
 const REI_SW_SYNC_TAG = 'rei-sw-flush-request-outbox';
 
+/**
+ * Wire-level message type for SW → client postMessage envelopes.
+ * Clients filter on `e.data.type === 'REI_AMSG_PUSH'` before reading
+ * `e.data.event` (which is one of {@link REI_SW_EVENT}'s values).
+ */
+const REI_AMSG_POSTMESSAGE_TYPE = 'REI_AMSG_PUSH';
+
+/**
+ * Per-kind event names dispatched to controlled clients. Each push the
+ * SW receives is mirrored to every window via
+ * `postMessage({ type: 'REI_AMSG_PUSH', event: <one of these>, payload })`.
+ *
+ * The mapping is keyed by `payload.messageKind`. Legacy payloads (and
+ * blob envelopes) without a `messageKind` field dispatch as
+ * {@link REI_SW_EVENT.UNKNOWN_RECEIVED} so apps can still handle 2.0.x
+ * producers during migration.
+ */
+const REI_SW_EVENT = Object.freeze({
+  CONTENT_RECEIVED: 'rei-amsg-content-received',
+  REASONING_RECEIVED: 'rei-amsg-reasoning-received',
+  TOOL_REQUEST_RECEIVED: 'rei-amsg-tool-request-received',
+  ERROR_RECEIVED: 'rei-amsg-error-received',
+  UNKNOWN_RECEIVED: 'rei-amsg-unknown-received'
+});
+
 const REI_SW_MESSAGE_TYPE = Object.freeze({
   ENQUEUE_REQUEST: 'REI_ENQUEUE_REQUEST',
   FLUSH_QUEUE: 'REI_FLUSH_QUEUE',
@@ -56,15 +101,25 @@ function installReiSW(sw, opts = {}) {
     const payload = readPushPayload(event);
     if (!payload) return;
 
-    const notification = createNotificationFromPayload(payload, {
-      defaultIcon,
-      defaultBadge
-    });
-    if (!notification) return;
+    const eventName = resolveEventName(payload);
+    const shouldRenderNotification = isNotificationKind(payload);
+
+    /** @type {Array<Promise<unknown>>} */
+    const work = [dispatchPushToClients(sw, eventName, payload)];
+
+    if (shouldRenderNotification) {
+      const notification = createNotificationFromPayload(payload, {
+        defaultIcon,
+        defaultBadge
+      });
+      if (notification) {
+        work.push(
+          sw.registration.showNotification(notification.title, notification.options)
+        );
+      }
+    }
 
-    event.waitUntil(
-      sw.registration.showNotification(notification.title, notification.options)
-    );
+    event.waitUntil(Promise.all(work));
   });
 
   sw.addEventListener('message', (event) => {
@@ -89,6 +144,85 @@ function installReiSW(sw, opts = {}) {
   });
 }
 
+/**
+ * Map a parsed push payload to its corresponding per-kind event name.
+ * Falls back to `UNKNOWN_RECEIVED` for legacy 2.0.x payloads and blob
+ * envelopes without `messageKind`.
+ *
+ * @param {Record<string, unknown>} payload
+ * @returns {string}
+ */
+function resolveEventName(payload) {
+  const kind = payload && typeof payload === 'object' ? payload.messageKind : undefined;
+  switch (kind) {
+    case 'content':
+      return REI_SW_EVENT.CONTENT_RECEIVED;
+    case 'reasoning':
+      return REI_SW_EVENT.REASONING_RECEIVED;
+    case 'tool_request':
+      return REI_SW_EVENT.TOOL_REQUEST_RECEIVED;
+    case 'error':
+      return REI_SW_EVENT.ERROR_RECEIVED;
+    default:
+      return REI_SW_EVENT.UNKNOWN_RECEIVED;
+  }
+}
+
+/**
+ * True when the payload should trigger `showNotification`. Only
+ * `messageKind: 'content'` renders a notification; everything else
+ * (`reasoning`, `tool_request`, `error`) is dispatched silently so
+ * apps can render them in-app.
+ *
+ * Legacy payloads with no `messageKind` field still render a
+ * notification — that's the 2.0.x back-compat path.
+ *
+ * @param {Record<string, unknown>} payload
+ * @returns {boolean}
+ */
+function isNotificationKind(payload) {
+  if (!payload || typeof payload !== 'object') return false;
+  const kind = payload.messageKind;
+  if (kind === undefined || kind === null) return true;
+  return kind === 'content';
+}
+
+/**
+ * Broadcast a parsed push payload to every controlled client. Failures
+ * on individual `postMessage` calls are swallowed — one offline tab
+ * shouldn't break delivery to the others. The whole broadcast is
+ * resolved (never rejected) so it can be safely passed to
+ * `event.waitUntil`.
+ *
+ * @param {ServiceWorkerGlobalScope} sw
+ * @param {string}                   eventName
+ * @param {Record<string, unknown>}  payload
+ * @returns {Promise<void>}
+ */
+async function dispatchPushToClients(sw, eventName, payload) {
+  try {
+    const clientList = await sw.clients.matchAll({
+      type: 'window',
+      includeUncontrolled: true
+    });
+    const envelope = {
+      type: REI_AMSG_POSTMESSAGE_TYPE,
+      event: eventName,
+      payload
+    };
+    for (const client of clientList) {
+      try {
+        client.postMessage(envelope);
+      } catch (_postError) {
+        // Per-client failures must not abort the broadcast.
+      }
+    }
+  } catch (_matchError) {
+    // No window clients available, or the matchAll call rejected.
+    // Either way, fail silently — notification rendering still wins.
+  }
+}
+
 function readPushPayload(event) {
   if (!event.data) return null;
 
@@ -346,4 +480,4 @@ async function removeQueuedRequest(id) {
   });
 }
 
-export { REI_SW_MESSAGE_TYPE, installReiSW };
+export { REI_AMSG_POSTMESSAGE_TYPE, REI_SW_EVENT, REI_SW_MESSAGE_TYPE, installReiSW };

package/dist/index.mjs

@@ -3,6 +3,14 @@ var REI_SW_DB_NAME = "rei-sw";
 var REI_SW_DB_STORE = "request-outbox";
 var REI_SW_DB_VERSION = 1;
 var REI_SW_SYNC_TAG = "rei-sw-flush-request-outbox";
+var REI_AMSG_POSTMESSAGE_TYPE = "REI_AMSG_PUSH";
+var REI_SW_EVENT = Object.freeze({
+  CONTENT_RECEIVED: "rei-amsg-content-received",
+  REASONING_RECEIVED: "rei-amsg-reasoning-received",
+  TOOL_REQUEST_RECEIVED: "rei-amsg-tool-request-received",
+  ERROR_RECEIVED: "rei-amsg-error-received",
+  UNKNOWN_RECEIVED: "rei-amsg-unknown-received"
+});
 var REI_SW_MESSAGE_TYPE = Object.freeze({
   ENQUEUE_REQUEST: "REI_ENQUEUE_REQUEST",
   FLUSH_QUEUE: "REI_FLUSH_QUEUE",
@@ -14,14 +22,21 @@ function installReiSW(sw, opts = {}) {
   sw.addEventListener("push", (event) => {
     const payload = readPushPayload(event);
     if (!payload) return;
-    const notification = createNotificationFromPayload(payload, {
-      defaultIcon,
-      defaultBadge
-    });
-    if (!notification) return;
-    event.waitUntil(
-      sw.registration.showNotification(notification.title, notification.options)
-    );
+    const eventName = resolveEventName(payload);
+    const shouldRenderNotification = isNotificationKind(payload);
+    const work = [dispatchPushToClients(sw, eventName, payload)];
+    if (shouldRenderNotification) {
+      const notification = createNotificationFromPayload(payload, {
+        defaultIcon,
+        defaultBadge
+      });
+      if (notification) {
+        work.push(
+          sw.registration.showNotification(notification.title, notification.options)
+        );
+      }
+    }
+    event.waitUntil(Promise.all(work));
   });
   sw.addEventListener("message", (event) => {
     const message = event.data;
@@ -41,6 +56,47 @@ function installReiSW(sw, opts = {}) {
     event.waitUntil(flushQueuedRequests(sw));
   });
 }
+function resolveEventName(payload) {
+  const kind = payload && typeof payload === "object" ? payload.messageKind : void 0;
+  switch (kind) {
+    case "content":
+      return REI_SW_EVENT.CONTENT_RECEIVED;
+    case "reasoning":
+      return REI_SW_EVENT.REASONING_RECEIVED;
+    case "tool_request":
+      return REI_SW_EVENT.TOOL_REQUEST_RECEIVED;
+    case "error":
+      return REI_SW_EVENT.ERROR_RECEIVED;
+    default:
+      return REI_SW_EVENT.UNKNOWN_RECEIVED;
+  }
+}
+function isNotificationKind(payload) {
+  if (!payload || typeof payload !== "object") return false;
+  const kind = payload.messageKind;
+  if (kind === void 0 || kind === null) return true;
+  return kind === "content";
+}
+async function dispatchPushToClients(sw, eventName, payload) {
+  try {
+    const clientList = await sw.clients.matchAll({
+      type: "window",
+      includeUncontrolled: true
+    });
+    const envelope = {
+      type: REI_AMSG_POSTMESSAGE_TYPE,
+      event: eventName,
+      payload
+    };
+    for (const client of clientList) {
+      try {
+        client.postMessage(envelope);
+      } catch (_postError) {
+      }
+    }
+  } catch (_matchError) {
+  }
+}
 function readPushPayload(event) {
   if (!event.data) return null;
   try {
@@ -243,6 +299,8 @@ async function removeQueuedRequest(id) {
   });
 }
 export {
+  REI_AMSG_POSTMESSAGE_TYPE,
+  REI_SW_EVENT,
   REI_SW_MESSAGE_TYPE,
   installReiSW
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rei-standard/amsg-sw",
-  "version": "2.0.1",
-  "description": "ReiStandard Active Messaging service worker SDK",
+  "version": "2.1.0-next.0",
+  "description": "ReiStandard Active Messaging service worker SDK — three-axis push schema (content / reasoning / tool_request / error) with per-kind client postMessage events",
   "repository": {
     "type": "git",
     "url": "https://github.com/Tosd0/ReiStandard",
@@ -26,11 +26,15 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup"
+    "build": "tsup",
+    "test": "node --test test/*.test.mjs"
   },
   "engines": {
     "node": ">=20"
   },
+  "dependencies": {
+    "@rei-standard/amsg-shared": "0.1.0-next.0"
+  },
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"