@mercury-fw/channel-google-chat 0.1.3 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @mercury-fw/channel-google-chat
 
+## 0.2.0
+
+### Minor Changes
+
+- 8bed46b: - A turn carries a `Principal` (the person behind it and the provider that vouched for them) instead of the opaque `userId` and `wikiUserId`; the core derives every per-person id from it.
+  - Episodic memory follows the principal, not the channel: a session is captured whenever a provider vouched for the person. Google Chat keeps the ids it had; the terminal and the HTTP channel (until it authenticates its callers) send a principal nobody vouched for, so they stay out of episodic memory as before.
+  - The HTTP channel accepts a `conversationId` on `/turn` and `/confirm` only made of letters, digits, `-` and `_`, up to 128 characters once trimmed, and answers `400` otherwise: a client-chosen id can no longer reach another user's wiki notes, forge log lines or break the turn. An existing HTTP conversation whose id has other characters can still be read with `/conversation`, but not continued. `/conversation` keeps opening any session key `/conversations` lists, whatever channel it came from.
+  - The model's wiki read tools refuse a per-user id that isn't one path segment, as writes already did.
+  - `CHANNEL_API_VERSION` is 2: a channel written for version 1 is refused at load.
+  - The first-party channels declare their channel api version as a literal, so an older channel can't claim a newer contract it doesn't implement.
+
 ## 0.1.3
 
 ### Patch Changes

package/dist/index.d.ts

@@ -7,5 +7,5 @@
  * missing is a misconfiguration: `build()` throws and the loader skips this
  * channel fail-soft, leaving the rest of Mercury up.
  */
-import { type ChannelPlugin } from "@mercury-fw/channel-types";
+import type { ChannelPlugin } from "@mercury-fw/channel-types";
 export declare const googleChatChannel: ChannelPlugin;

package/google-chat-provider.ts

@@ -505,8 +505,11 @@ export function createGoogleChatProvider(deps: GoogleChatProviderDeps): GoogleCh
           multiUser: !event.isDirectMessage,
           text: markedInput,
           sessionKey,
-          userId: event.sender,
-          wikiUserId: encodeURIComponent(event.sender),
+          principal: {
+            id: event.sender,
+            provider: "google-chat",
+            ...(event.senderDisplayName ? { displayName: event.senderDisplayName } : {}),
+          },
           logPrefix: `[chat:${event.space}:${event.sender}] `,
         },
         sink,

package/index.ts

@@ -7,7 +7,7 @@
  * missing is a misconfiguration: `build()` throws and the loader skips this
  * channel fail-soft, leaving the rest of Mercury up.
  */
-import { CHANNEL_API_VERSION, type ChannelPlugin, type ChannelRuntimeContext } from "@mercury-fw/channel-types";
+import type { ChannelPlugin, ChannelRuntimeContext } from "@mercury-fw/channel-types";
 import { createGoogleChatProvider } from "./google-chat-provider.ts";
 
 /** Reads a required env var, failing loudly (caught by the channel loader) instead of silently degrading. */
@@ -20,7 +20,9 @@ function require(env: ChannelRuntimeContext["env"], name: string): string {
 }
 
 export const googleChatChannel: ChannelPlugin = {
-  apiVersion: CHANNEL_API_VERSION,
+  // The contract this channel is written for, as a literal: importing
+  // CHANNEL_API_VERSION would report whichever contract is installed.
+  apiVersion: 2,
   name: "google-chat",
   build: (ctx) => {
     // No subscription configured ⇒ this instance simply doesn't run Google Chat.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mercury-fw/channel-google-chat",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -31,10 +31,10 @@
     "@google-cloud/pubsub": "^5.3.1"
   },
   "peerDependencies": {
-    "@mercury-fw/channel-types": ">=0.24.0 <1.0.0"
+    "@mercury-fw/channel-types": ">=0.34.0 <1.0.0"
   },
   "devDependencies": {
-    "@mercury-fw/channel-types": "0.29.2",
+    "@mercury-fw/channel-types": "0.34.0",
     "@mercury-fw/typescript-config": "*",
     "@types/bun": "^1.4.2",
     "typescript": "^6.0.3"