@open-everywhere/provider-google-chat 0.0.0-stage → 0.7.0

package/dist/agent/register.js

@@ -0,0 +1,37 @@
+// registerGoogleChatProvider — the ONE boot entry of @open-everywhere/provider-google-chat (OPE-2442). The app's
+// generated selection table imports it STATICALLY and `registerDefaultAdapters()` calls it once at boot; every
+// seam the bundle implements registers here and nowhere else.
+//
+// What Google Chat registers (and what it deliberately does NOT):
+//   • identity mapper     — bindGoogleChat (channels/google-chat-identity.ts)
+//   • capability manifest — { midTurnPost: true, reactions: false, closingProseDropped: true }: `reply` is the
+//                           wired verb (the unified dispatch through the post arm), the app sets no reactions,
+//                           and a seat's turn-final text is dropped, so `reply` is the only way out
+//   • post arm            — googleChatPostArm: the reply, into the trigger's space and thread
+//   • wake-origin codec   — the stored-data google-chat arm (channels/google-chat-origin-codec.ts)
+//   • surface message ops — googleChatMessageOps: a host notice is one more message in the space
+//   • credential probe    — "configured" = the policy is enabled (no environment read)
+//   • NO read adapter (the app cannot list a space's messages), NO card poster, NO reaction surface, NO routine
+//     dispatch — each is declared, with its reason, in surface-parity.ts.
+import { registerCapabilityManifest, registerIdentityMapper, registerPostArm, registerProviderDocs, registerProviderEvents, registerSurfaceCredentialProbe, registerSurfaceMessageOps, registerSurfaceParity, registerWakeOriginCodec, } from "@open-everywhere/core/agent/adapter-api.js";
+import { PROVIDER_DOCS } from "./docs-generated.js";
+import { GOOGLE_CHAT_SURFACE_PARITY } from "./surface-parity.js";
+import { GOOGLE_CHAT_PROVIDER_EVENTS } from "./provider-events.js";
+import { googleChatPolicy } from "./policy.js";
+import { bindGoogleChat } from "./channels/google-chat-identity.js";
+import { googleChatPostArm } from "./channels/google-chat-post-arm.js";
+import { googleChatWakeOriginCodec } from "./channels/google-chat-origin-codec.js";
+import { googleChatMessageOps } from "./channels/google-chat-message-ops.js";
+/** Perform ALL of the Google Chat bundle's registrations. Idempotent (each register call replaces). */
+export function registerGoogleChatProvider() {
+    registerIdentityMapper("google-chat", bindGoogleChat);
+    registerCapabilityManifest("google-chat", { midTurnPost: true, reactions: false, closingProseDropped: true });
+    registerSurfaceParity("google-chat", GOOGLE_CHAT_SURFACE_PARITY);
+    registerProviderEvents("google-chat", GOOGLE_CHAT_PROVIDER_EVENTS);
+    registerPostArm(googleChatPostArm);
+    registerWakeOriginCodec("google-chat", googleChatWakeOriginCodec);
+    registerSurfaceMessageOps(googleChatMessageOps);
+    registerSurfaceCredentialProbe("google-chat", () => googleChatPolicy().enabled);
+    registerProviderDocs("google-chat", PROVIDER_DOCS);
+}
+//# sourceMappingURL=register.js.map

package/dist/agent/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../agent/register.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,+GAA+G;AAC/G,8DAA8D;AAC9D,EAAE;AACF,kEAAkE;AAClE,8EAA8E;AAC9E,+GAA+G;AAC/G,+GAA+G;AAC/G,oGAAoG;AACpG,8FAA8F;AAC9F,mGAAmG;AACnG,iGAAiG;AACjG,uFAAuF;AACvF,gHAAgH;AAChH,0EAA0E;AAE1E,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,uGAAuG;AACvG,MAAM,UAAU,0BAA0B;IACxC,sBAAsB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACtD,0BAA0B,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9G,qBAAqB,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;IACjE,sBAAsB,CAAC,aAAa,EAAE,2BAA2B,CAAC,CAAC;IACnE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACnC,uBAAuB,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC;IAClE,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAChD,8BAA8B,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,CAAC;IAChF,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC"}

package/dist/agent/surface-parity.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceParityDeclaration } from "@open-everywhere/core/agent/adapter-api.js";
+export declare const GOOGLE_CHAT_SURFACE_PARITY: SurfaceParityDeclaration;
+//# sourceMappingURL=surface-parity.d.ts.map

package/dist/agent/surface-parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-parity.d.ts","sourceRoot":"","sources":["../../agent/surface-parity.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAE3F,eAAO,MAAM,0BAA0B,EAAE,wBAiDxC,CAAC"}

package/dist/agent/surface-parity.js

@@ -0,0 +1,59 @@
+// GOOGLE CHAT's surface-parity declaration (OPE-2442). See the core module's header
+// (packages/core/agent/identity/surface-parity.ts) for what the three cell shapes mean.
+//
+// The first cut is the addressed path: an @mention in a space or a direct message wakes a seat, and the seat
+// answers in the same thread. Google Chat's HTTP endpoint delivers a space message only when it @-mentions the
+// app. Ambient messages, edits and space reads need a Workspace Events subscription or the admin-approved
+// `chat.app.messages.readonly` scope, which this cut does not request. So every vendor-side gap below is "not
+// built yet": none of them is a platform limit. Two kinds of row are not gaps: `mpim` is a policy refusal (a group
+// chat has no domain to own it and is not one person's DM), and `search`, `origin-placement-carry`,
+// `engaged-row-promotion` and `seat-context-admission` do not apply to this surface by design.
+export const GOOGLE_CHAT_SURFACE_PARITY = {
+    // --- registration seams (§7.1) ---------------------------------------------------------------
+    "identity-mapper": "supported",
+    "capability-manifest": "supported",
+    "post-arm": "supported",
+    "wake-origin-codec": "supported",
+    "origin-placement-carry": {
+        unsupported: "the placement is INSIDE the conversation identity: `threadRef` keys on the thread name, the very thread a reply posts into, so two origins of one conversation already agree on placement",
+    },
+    "read-adapter": { unsupported: "not built yet — listing a space's messages needs user authentication or the admin-approved `chat.app.messages.readonly` app scope, which the app does not request" },
+    "reaction-feedback-ingest": { unsupported: "not built yet — the HTTP endpoint carries no reaction event; a Workspace Events subscription would" },
+    "ancillary-ops": { supported: "text only — a host notice is one more message in the space; no edit, file or reaction" },
+    "ambient-engagement-seam": { unsupported: "not built yet — the HTTP endpoint delivers a space message only on an @mention; a Workspace Events subscription would deliver the rest" },
+    "engaged-row-promotion": { unsupported: "no ambient leg — every Google Chat wake is addressed (`direct-mention`)" },
+    "owned-thread-ingress": { supported: "the space leg takes the inbound divert; only a reply inside an existing thread (`threadReply`) is thread-scoped" },
+    "thread-done-reaction": { unsupported: "not built yet — the app sets no reactions (no `setReaction` in the ancillary ops)" },
+    // --- wake legs and conversation shapes -------------------------------------------------------
+    "addressed-leg": "supported",
+    "ambient-leg": { unsupported: "not built yet — the HTTP endpoint delivers a space message only on an @mention; a Workspace Events subscription would deliver the rest" },
+    "seat-catch-up": { unsupported: "not built yet — the app does not list a space's messages (see the read adapter row)" },
+    "seat-context-admission": { unsupported: "the wake fills no context-line slot — the seat reads only the addressed message and its carried tail" },
+    "approval-card": {
+        unsupported: "not built yet — a Chat card with a button needs the CARD_CLICKED tap answered; a governed act asked from Google Chat takes the venue walk to a card-capable room in the same domain",
+    },
+    "judge-lift-notice": { supported: "the shared text render, posted into the space — no button yet, so the overrule is spelled out in words" },
+    "name-drop-mention": { unsupported: "not built yet — a message that names the app without an @mention never reaches the HTTP endpoint; a Workspace Events subscription would deliver it" },
+    "message-edit-wake": { unsupported: "not built yet — the HTTP endpoint sends no event for an edited message; a Workspace Events subscription would" },
+    threads: { supported: "a reply posts into the trigger's own thread (`REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD`)" },
+    rooms: { supported: "a space is a surface a domain's `reach` lists (`google-chat/<workspace>/<space id>`)" },
+    dm: { supported: "the person's own direct message with the app wakes their DM seat — internal people only" },
+    mpim: { unsupported: "policy: a group chat is refused (`group-chat`) — it has no domain to own it and is not one person's DM" },
+    // --- core verbs (§7.2) -----------------------------------------------------------------------
+    reply: "supported",
+    edit_reply: { unsupported: "not built yet — the arm registers no edit; Chat's `messages.patch` would carry one" },
+    react: { unsupported: "not built yet — no outbound reaction transport is wired" },
+    no_reply: "supported",
+    read_channel: { unsupported: "not built yet — listing a space's messages needs user authentication or the admin-approved `chat.app.messages.readonly` app scope, which the app does not request" },
+    read_thread: { unsupported: "not built yet — the same message-list scope as `read_channel`" },
+    search: { unsupported: "no work-search adapter — Google Chat is a chat surface, not a work corpus" },
+    post_message: { unsupported: "not built yet — no routine dispatch is registered, so the agent answers only in a conversation somebody started" },
+    dm_person: { unsupported: "not built yet — the app cannot open a DM a person did not start" },
+    set_dm_delivery: { unsupported: "not built yet — a Google Chat DM is never a proactive delivery channel" },
+    stop: { unsupported: "not built yet — the app reads no reactions, so there is no stop trigger" },
+    ack_stop_glyph: { unsupported: "not built yet — the app sets no reactions" },
+    ack_cancel_note: { supported: "a message in the space, through the host-notice transport" },
+    stand_down: { unsupported: "not built yet — remove the app from the space instead" },
+    post_file: { unsupported: "not built yet — the reply carries text only" },
+};
+//# sourceMappingURL=surface-parity.js.map

package/dist/agent/surface-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-parity.js","sourceRoot":"","sources":["../../agent/surface-parity.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wFAAwF;AACxF,EAAE;AACF,6GAA6G;AAC7G,+GAA+G;AAC/G,0GAA0G;AAC1G,8GAA8G;AAC9G,mHAAmH;AACnH,oGAAoG;AACpG,+FAA+F;AAI/F,MAAM,CAAC,MAAM,0BAA0B,GAA6B;IAClE,gGAAgG;IAChG,iBAAiB,EAAE,WAAW;IAC9B,qBAAqB,EAAE,WAAW;IAClC,UAAU,EAAE,WAAW;IACvB,mBAAmB,EAAE,WAAW;IAChC,wBAAwB,EAAE;QACxB,WAAW,EAAE,2LAA2L;KACzM;IACD,cAAc,EAAE,EAAE,WAAW,EAAE,mKAAmK,EAAE;IACpM,0BAA0B,EAAE,EAAE,WAAW,EAAE,oGAAoG,EAAE;IACjJ,eAAe,EAAE,EAAE,SAAS,EAAE,uFAAuF,EAAE;IACvH,yBAAyB,EAAE,EAAE,WAAW,EAAE,wIAAwI,EAAE;IACpL,uBAAuB,EAAE,EAAE,WAAW,EAAE,yEAAyE,EAAE;IACnH,sBAAsB,EAAE,EAAE,SAAS,EAAE,iHAAiH,EAAE;IACxJ,sBAAsB,EAAE,EAAE,WAAW,EAAE,mFAAmF,EAAE;IAE5H,gGAAgG;IAChG,eAAe,EAAE,WAAW;IAC5B,aAAa,EAAE,EAAE,WAAW,EAAE,wIAAwI,EAAE;IACxK,eAAe,EAAE,EAAE,WAAW,EAAE,qFAAqF,EAAE;IACvH,wBAAwB,EAAE,EAAE,WAAW,EAAE,sGAAsG,EAAE;IACjJ,eAAe,EAAE;QACf,WAAW,EAAE,qLAAqL;KACnM;IACD,mBAAmB,EAAE,EAAE,SAAS,EAAE,wGAAwG,EAAE;IAC5I,mBAAmB,EAAE,EAAE,WAAW,EAAE,oJAAoJ,EAAE;IAC1L,mBAAmB,EAAE,EAAE,WAAW,EAAE,+GAA+G,EAAE;IACrJ,OAAO,EAAE,EAAE,SAAS,EAAE,sFAAsF,EAAE;IAC9G,KAAK,EAAE,EAAE,SAAS,EAAE,sFAAsF,EAAE;IAC5G,EAAE,EAAE,EAAE,SAAS,EAAE,yFAAyF,EAAE;IAC5G,IAAI,EAAE,EAAE,WAAW,EAAE,wGAAwG,EAAE;IAE/H,gGAAgG;IAChG,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,EAAE,WAAW,EAAE,oFAAoF,EAAE;IACjH,KAAK,EAAE,EAAE,WAAW,EAAE,yDAAyD,EAAE;IACjF,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,EAAE,WAAW,EAAE,mKAAmK,EAAE;IAClM,WAAW,EAAE,EAAE,WAAW,EAAE,+DAA+D,EAAE;IAC7F,MAAM,EAAE,EAAE,WAAW,EAAE,2EAA2E,EAAE;IACpG,YAAY,EAAE,EAAE,WAAW,EAAE,iHAAiH,EAAE;IAChJ,SAAS,EAAE,EAAE,WAAW,EAAE,iEAAiE,EAAE;IAC7F,eAAe,EAAE,EAAE,WAAW,EAAE,wEAAwE,EAAE;IAC1G,IAAI,EAAE,EAAE,WAAW,EAAE,yEAAyE,EAAE;IAChG,cAAc,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC5E,eAAe,EAAE,EAAE,SAAS,EAAE,2DAA2D,EAAE;IAC3F,UAAU,EAAE,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACpF,SAAS,EAAE,EAAE,WAAW,EAAE,6CAA6C,EAAE;CAC1E,CAAC"}

package/package.json

@@ -1,6 +1,118 @@
 {
   "name": "@open-everywhere/provider-google-chat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.7.0",
+  "description": "Open Everywhere Google Chat provider — the agent as a Google Chat app: mention and DM wakes, threaded replies.",
+  "keywords": [
+    "agent",
+    "google-chat",
+    "google-workspace",
+    "chat",
+    "eve"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "homepage": "https://github.com/open-everywhere/open-everywhere/tree/main/packages/providers/google-chat",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/open-everywhere/open-everywhere.git",
+    "directory": "packages/providers/google-chat"
+  },
+  "bugs": {
+    "url": "https://github.com/open-everywhere/open-everywhere/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "agent",
+    "dist",
+    "tsconfig.json",
+    "tsconfig.build.json",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./agent/channels/google-chat-auth.js": {
+      "types": "./dist/agent/channels/google-chat-auth.d.ts",
+      "default": "./dist/agent/channels/google-chat-auth.js"
+    },
+    "./agent/channels/google-chat-front.js": {
+      "types": "./dist/agent/channels/google-chat-front.d.ts",
+      "default": "./dist/agent/channels/google-chat-front.js"
+    },
+    "./agent/channels/google-chat-identity.js": {
+      "types": "./dist/agent/channels/google-chat-identity.d.ts",
+      "default": "./dist/agent/channels/google-chat-identity.js"
+    },
+    "./agent/channels/google-chat-message-ops.js": {
+      "types": "./dist/agent/channels/google-chat-message-ops.d.ts",
+      "default": "./dist/agent/channels/google-chat-message-ops.js"
+    },
+    "./agent/channels/google-chat-origin-codec.js": {
+      "types": "./dist/agent/channels/google-chat-origin-codec.d.ts",
+      "default": "./dist/agent/channels/google-chat-origin-codec.js"
+    },
+    "./agent/channels/google-chat-post-arm.js": {
+      "types": "./dist/agent/channels/google-chat-post-arm.d.ts",
+      "default": "./dist/agent/channels/google-chat-post-arm.js"
+    },
+    "./agent/channels/google-chat-rest.js": {
+      "types": "./dist/agent/channels/google-chat-rest.d.ts",
+      "default": "./dist/agent/channels/google-chat-rest.js"
+    },
+    "./agent/channels/google-chat.js": {
+      "types": "./dist/agent/channels/google-chat.d.ts",
+      "default": "./dist/agent/channels/google-chat.js"
+    },
+    "./agent/contributions.js": {
+      "types": "./dist/agent/contributions.d.ts",
+      "default": "./dist/agent/contributions.js"
+    },
+    "./agent/docs-generated.js": {
+      "types": "./dist/agent/docs-generated.d.ts",
+      "default": "./dist/agent/docs-generated.js"
+    },
+    "./agent/policy.js": {
+      "types": "./dist/agent/policy.d.ts",
+      "default": "./dist/agent/policy.js"
+    },
+    "./agent/provider-events.js": {
+      "types": "./dist/agent/provider-events.d.ts",
+      "default": "./dist/agent/provider-events.js"
+    },
+    "./agent/register.js": {
+      "types": "./dist/agent/register.d.ts",
+      "default": "./dist/agent/register.js"
+    },
+    "./agent/surface-parity.js": {
+      "types": "./dist/agent/surface-parity.d.ts",
+      "default": "./dist/agent/surface-parity.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "npm run test:chain",
+    "test:chain": "tsx ../../../scripts/chain/run-chain.ts",
+    "test:google-chat-auth": "NODE_NO_WARNINGS=1 tsx scripts/google-chat-auth-test.ts",
+    "test:google-chat-front": "NODE_NO_WARNINGS=1 tsx scripts/google-chat-front-test.ts",
+    "test:google-chat-post-arm": "NODE_NO_WARNINGS=1 tsx scripts/google-chat-post-arm-test.ts"
+  },
+  "dependencies": {
+    "@open-everywhere/core": "0.7.0",
+    "jose": "6.2.3"
+  },
+  "peerDependencies": {
+    "eve": "0.71.0"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsx": "latest",
+    "typescript": "latest"
+  }
+}

package/tsconfig.build.json

@@ -0,0 +1,22 @@
+{
+  // PUBLISH BUILD (OPE-406). See packages/core/tsconfig.build.json for the full rationale: the
+  // sibling tsconfig.json stays noEmit (it is the typecheck gate and covers scripts/** too); this
+  // config emits ONLY the published surface (agent/**) into dist/, because a registry install
+  // cannot execute raw TypeScript and "eve build" evaluates the authored agent modules.
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    // Incremental: these run from every pre-hook (pretypecheck/pretest/prebuild), so a no-op
+    // rebuild has to be near-free or the gate chain pays a full tsc on every invocation.
+    "incremental": true,
+    // OUTSIDE outDir on purpose: a tsbuildinfo left in dist/ gets swept up by the files
+    // allowlist and PUBLISHED (caught by the tarball listing, 2026-08-12).
+    "tsBuildInfoFile": "./.tsbuildinfo",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "."
+  },
+  "include": ["agent/**/*.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2023"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["agent/**/*.ts", "scripts/**/*.ts"]
+}