paperclip-plugin-google-chat 0.1.1 → 0.1.2

package/README.md

@@ -73,6 +73,23 @@ src/
 
 Pure logic (formatting, parsing, routing, validation) is separated from the SDK-facing worker so it is unit-tested without a running Paperclip (`tests/`).
 
+## Adapter compatibility (important)
+
+The plugin's **worker-side** features work with **any** adapter, because they run in the
+plugin worker, not the agent:
+
+- ✅ **Event notifications** (`events.subscribe` → Chat)
+- ✅ **Inbound slash commands** (`webhooks.receive`)
+- ✅ **Daily digest job** (`jobs.schedule`)
+
+The **agent tools** (`post_to_google_chat`, `escalate_to_human`, `send_briefing`) are only
+callable by adapters whose tool calls are routed **through Paperclip's tool dispatcher**. They
+are **not available to `claude_local` / `codex_local` "process" adapters**, which run the CLI
+(e.g. `claude -p`) as a black-box subprocess — Paperclip captures stdout but never sees the
+agent's individual tool calls, so plugin tools can't be surfaced to them. For a CLI-based
+fleet, drive Chat via the event/webhook features above, or give the agent its own posting
+mechanism (an MCP server, or a direct webhook `curl`).
+
 ## Develop
 
 ```bash

package/dist/constants.d.ts

@@ -4,7 +4,7 @@
  * the same convention).
  */
 export declare const PLUGIN_ID = "google-chat";
-export declare const PLUGIN_VERSION = "0.1.1";
+export declare const PLUGIN_VERSION = "0.1.2";
 /** Webhook endpoint keys declared in the manifest and matched in `onWebhook`. */
 export declare const WEBHOOK_KEYS: {
     /** Google Chat app events (MESSAGE, ADDED_TO_SPACE, CARD_CLICKED, …) POST here. */
@@ -21,13 +21,17 @@ export declare const JOB_KEYS: {
     readonly dailyDigest: "daily-digest";
 };
 /**
- * Domain events we translate into Google Chat notifications. The host emits these;
- * we subscribe via `ctx.events.on`. Names mirror the kitchen-sink event surface.
+ * Domain events we translate into Google Chat notifications. These are exact
+ * members of the host's `PLUGIN_EVENT_TYPES` catalog (@paperclipai/shared),
+ * verified against the deployed release. The host has NO `issue.completed` or
+ * `approval.requested`: completion is an `issue.updated` to a terminal status,
+ * and an approval request is `approval.created`.
  */
 export declare const DOMAIN_EVENTS: {
     readonly issueCreated: "issue.created";
     readonly issueUpdated: "issue.updated";
-    readonly issueCompleted: "issue.completed";
-    readonly approvalRequested: "approval.requested";
+    readonly approvalCreated: "approval.created";
     readonly agentRunFailed: "agent.run.failed";
 };
+/** Issue statuses treated as "completed" for notification purposes. */
+export declare const TERMINAL_ISSUE_STATUSES: Set<string>;

package/dist/constants.js

@@ -4,7 +4,7 @@
  * the same convention).
  */
 export const PLUGIN_ID = "google-chat";
-export const PLUGIN_VERSION = "0.1.1";
+export const PLUGIN_VERSION = "0.1.2";
 /** Webhook endpoint keys declared in the manifest and matched in `onWebhook`. */
 export const WEBHOOK_KEYS = {
     /** Google Chat app events (MESSAGE, ADDED_TO_SPACE, CARD_CLICKED, …) POST here. */
@@ -21,13 +21,17 @@ export const JOB_KEYS = {
     dailyDigest: "daily-digest",
 };
 /**
- * Domain events we translate into Google Chat notifications. The host emits these;
- * we subscribe via `ctx.events.on`. Names mirror the kitchen-sink event surface.
+ * Domain events we translate into Google Chat notifications. These are exact
+ * members of the host's `PLUGIN_EVENT_TYPES` catalog (@paperclipai/shared),
+ * verified against the deployed release. The host has NO `issue.completed` or
+ * `approval.requested`: completion is an `issue.updated` to a terminal status,
+ * and an approval request is `approval.created`.
  */
 export const DOMAIN_EVENTS = {
     issueCreated: "issue.created",
     issueUpdated: "issue.updated",
-    issueCompleted: "issue.completed",
-    approvalRequested: "approval.requested",
+    approvalCreated: "approval.created",
     agentRunFailed: "agent.run.failed",
 };
+/** Issue statuses treated as "completed" for notification purposes. */
+export const TERMINAL_ISSUE_STATUSES = new Set(["done", "completed", "closed"]);

package/dist/events.js

@@ -6,7 +6,7 @@
  * gated by the per-event config toggles. The mapping is pure so it can be tested
  * without the SDK; the worker performs the actual `postToWebhook`.
  */
-import { DOMAIN_EVENTS } from "./constants.js";
+import { DOMAIN_EVENTS, TERMINAL_ISSUE_STATUSES } from "./constants.js";
 import { formatAgentRunFailed, formatApprovalRequested, formatIssueCompleted, formatIssueCreated, } from "./google-chat.js";
 function asIssue(data) {
     const d = data ?? {};
@@ -27,11 +27,17 @@ export function mapEventToNotification(event, config) {
             if (!config.notifyOnIssueCreated)
                 return null;
             return { routeKey: "default", text: formatIssueCreated(asIssue(event.data)) };
-        case DOMAIN_EVENTS.issueCompleted:
+        case DOMAIN_EVENTS.issueUpdated: {
+            // The host has no `issue.completed`; completion surfaces as an update to a
+            // terminal status. Only notify on that transition, not every edit.
             if (!config.notifyOnIssueCompleted)
                 return null;
-            return { routeKey: "default", text: formatIssueCompleted(asIssue(event.data)) };
-        case DOMAIN_EVENTS.approvalRequested:
+            const issue = asIssue(event.data);
+            if (!issue.status || !TERMINAL_ISSUE_STATUSES.has(issue.status.toLowerCase()))
+                return null;
+            return { routeKey: "default", text: formatIssueCompleted(issue) };
+        }
+        case DOMAIN_EVENTS.approvalCreated:
             if (!config.notifyOnApprovalRequested)
                 return null;
             return { routeKey: "approvals", text: formatApprovalRequested(asIssue(event.data)) };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-plugin-google-chat",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Bidirectional Google Chat integration for Paperclip — post agent/issue notifications to spaces and drive Paperclip from Chat slash commands.",
   "type": "module",
   "license": "MIT",