paperclip-plugin-google-chat 0.1.0

package/dist/worker.js

@@ -0,0 +1,155 @@
+/**
+ * Google Chat plugin worker — wires the SDK seams together:
+ *
+ *  - setup()      registers domain-event subscriptions, the daily-digest job, and
+ *                 the agent tools.
+ *  - onWebhook()  receives Google Chat app events and routes slash commands.
+ *  - outbound     resolves a per-route incoming-webhook URL from a secret ref and
+ *                 POSTs the message via `ctx.http.fetch`.
+ *
+ * The pure logic (formatting, parsing, routing) lives in sibling modules and is
+ * unit-tested; this file is the thin SDK-facing shell.
+ */
+import { definePlugin, runWorker } from "@paperclipai/plugin-sdk";
+import { DEFAULT_CONFIG, validateConfig } from "./config.js";
+import { DOMAIN_EVENTS, JOB_KEYS, WEBHOOK_KEYS } from "./constants.js";
+import { handleCommand, parseChatEvent } from "./commands.js";
+import { mapEventToNotification } from "./events.js";
+import { postToWebhook } from "./google-chat.js";
+import { registerTools } from "./tools.js";
+let currentCtx = null;
+async function getConfig(ctx) {
+    const raw = (await ctx.config.get());
+    return { ...DEFAULT_CONFIG, ...raw };
+}
+/** Pick the secret ref for a route, falling back to the default webhook. */
+function refForRoute(config, route) {
+    switch (route) {
+        case "approvals":
+            return config.approvalsWebhookUrlRef ?? config.defaultWebhookUrlRef;
+        case "errors":
+            return config.errorsWebhookUrlRef ?? config.defaultWebhookUrlRef;
+        case "digest":
+            return config.digestWebhookUrlRef ?? config.defaultWebhookUrlRef;
+        default:
+            return config.defaultWebhookUrlRef;
+    }
+}
+/** Resolve a route's webhook URL (from a secret ref) and POST a message. */
+async function post(ctx, route, message) {
+    const config = await getConfig(ctx);
+    const ref = refForRoute(config, route);
+    if (!ref) {
+        ctx.logger?.warn?.(`No webhook secret ref configured for route "${route}"`);
+        return { ok: false, status: 0, body: `no webhook configured for route ${route}` };
+    }
+    const url = await ctx.secrets.resolve(ref);
+    return postToWebhook((u, init) => ctx.http.fetch(u, init), url, message);
+}
+/** Build the inbound command dependencies against the SDK domain APIs. */
+function buildCommandDeps(ctx, companyId) {
+    const scope = companyId ? { companyId, limit: 50, offset: 0 } : { limit: 50, offset: 0 };
+    return {
+        async listIssues() {
+            try {
+                return (await ctx.issues.list(scope)) ?? [];
+            }
+            catch {
+                return [];
+            }
+        },
+        async listAgents() {
+            try {
+                return (await ctx.agents.list(scope)) ?? [];
+            }
+            catch {
+                return [];
+            }
+        },
+        // TODO: wire to a target agent/objective intake. Setting an objective and
+        // building a report both require a chosen company + agent; the space→company
+        // mapping (a `/connect` flow, see README) is the next milestone.
+        async setObjective(text) {
+            ctx.logger?.info?.(`/objective received: ${text}`);
+            return `Queued objective: "${text}" (intake wiring pending — see README §Roadmap).`;
+        },
+        async buildReport() {
+            const [issues, agents] = await Promise.all([this.listIssues(), this.listAgents()]);
+            return `*Report*\nIssues: ${issues.length}\nAgents: ${agents.length}`;
+        },
+    };
+}
+const plugin = definePlugin({
+    async setup(ctx) {
+        currentCtx = ctx;
+        // --- Outbound: subscribe to domain events → post notifications ---
+        for (const eventType of Object.values(DOMAIN_EVENTS)) {
+            ctx.events.on(eventType, async (event) => {
+                const config = await getConfig(ctx);
+                const notification = mapEventToNotification(event, config);
+                if (!notification)
+                    return;
+                const res = await post(ctx, notification.routeKey, { text: notification.text });
+                if (!res.ok) {
+                    ctx.logger?.warn?.(`Notification post failed for ${eventType}: HTTP ${res.status}`);
+                }
+            });
+        }
+        // --- Daily digest job (hourly tick, self-gated to configured HH:MM) ---
+        ctx.jobs.register(JOB_KEYS.dailyDigest, async () => {
+            const config = await getConfig(ctx);
+            if (!config.digestMode)
+                return;
+            const now = new Date();
+            const hhmm = `${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes() < 30 ? "00" : "30").padStart(2, "0")}`;
+            // Fire when the hour matches the configured digest hour.
+            const wantHour = (config.dailyDigestTime ?? "08:00").slice(0, 2);
+            if (hhmm.slice(0, 2) !== wantHour)
+                return;
+            const deps = buildCommandDeps(ctx, undefined);
+            const report = await deps.buildReport();
+            await post(ctx, "digest", { text: `🗓️ *Daily digest*\n${report}` });
+        });
+        // --- Agent tools ---
+        registerTools(ctx, (route, message) => post(ctx, route, message));
+        ctx.logger?.info?.("google-chat plugin setup complete");
+    },
+    async onHealth() {
+        const ctx = currentCtx;
+        const config = ctx ? await getConfig(ctx) : DEFAULT_CONFIG;
+        const configured = Boolean(config.defaultWebhookUrlRef);
+        return {
+            status: configured ? "ok" : "degraded",
+            message: configured ? "google-chat plugin ready" : "no defaultWebhookUrlRef configured",
+            details: { commandsEnabled: config.enableCommands !== false, digestMode: config.digestMode === true },
+        };
+    },
+    async onValidateConfig(config) {
+        return validateConfig({ ...DEFAULT_CONFIG, ...config });
+    },
+    async onWebhook(input) {
+        if (input.endpointKey !== WEBHOOK_KEYS.chatEvents) {
+            throw new Error(`Unsupported webhook endpoint "${input.endpointKey}"`);
+        }
+        const ctx = currentCtx;
+        if (!ctx)
+            return;
+        const event = (input.parsedBody ?? {});
+        const parsed = parseChatEvent(event);
+        if (!parsed)
+            return; // not a slash command (e.g. ADDED_TO_SPACE) — ignore for now
+        const config = await getConfig(ctx);
+        const deps = buildCommandDeps(ctx, undefined);
+        const reply = await handleCommand(parsed, config, deps);
+        if (!reply)
+            return;
+        // Incoming webhooks are per-space; reply via the default route. Threaded
+        // per-space replies require the Chat REST API (serviceAccountKeyRef) — roadmap.
+        await post(ctx, "default", { text: reply, threadKey: parsed.threadKey });
+    },
+    async onShutdown() {
+        currentCtx = null;
+    },
+});
+export default plugin;
+runWorker(plugin, import.meta.url);

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "paperclip-plugin-google-chat",
+  "version": "0.1.0",
+  "description": "Bidirectional Google Chat integration for Paperclip — post agent/issue notifications to spaces and drive Paperclip from Chat slash commands.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Measured Assets",
+  "homepage": "https://github.com/measured-assets/paperclip-plugin-google-chat",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/measured-assets/paperclip-plugin-google-chat.git"
+  },
+  "keywords": [
+    "paperclip",
+    "paperclip-plugin",
+    "google-chat",
+    "google-workspace",
+    "chatops",
+    "agents"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "paperclipPlugin": {
+    "manifest": "./dist/manifest.js",
+    "worker": "./dist/worker.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "@paperclipai/plugin-sdk": ">=2026.626.0"
+  },
+  "devDependencies": {
+    "@paperclipai/plugin-sdk": "^2026.626.0",
+    "@types/node": "^22.19.21",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  }
+}