@fabric-harness/channels 0.16.0 → 0.17.0

package/dist/whatsapp.d.ts

@@ -0,0 +1,53 @@
+import type { Channel, ToolDef } from '@fabric-harness/sdk/channel';
+export interface WhatsAppConversationRef {
+    businessAccountId: string;
+    phoneNumberId: string;
+    userPhone: string;
+}
+export interface WhatsAppWebhookPayload {
+    entry?: Array<{
+        id?: string;
+        changes?: Array<{
+            value?: {
+                metadata?: {
+                    phone_number_id?: string;
+                };
+                messages?: Array<{
+                    id?: string;
+                    from?: string;
+                    text?: {
+                        body?: string;
+                    };
+                }>;
+                statuses?: Array<{
+                    id?: string;
+                    recipient_id?: string;
+                    status?: string;
+                    timestamp?: string;
+                    errors?: unknown[];
+                }>;
+            };
+        }>;
+    }>;
+}
+export interface WhatsAppChannelOptions {
+    appSecret: string;
+    verifyToken: string;
+    agent: string;
+    tenantId?: string;
+}
+export interface WhatsAppChannel extends Channel {
+    conversationKey(ref: WhatsAppConversationRef): string;
+    parseConversationKey(id: string): WhatsAppConversationRef;
+}
+export declare function whatsAppConversationKey(ref: WhatsAppConversationRef): string;
+export declare function parseWhatsAppConversationKey(id: string): WhatsAppConversationRef;
+export declare function createWhatsAppChannel(options: WhatsAppChannelOptions): WhatsAppChannel;
+export declare function replyInWhatsApp(ref: WhatsAppConversationRef, options: {
+    accessToken: string;
+    apiVersion?: string;
+    fetchImpl?: typeof fetch;
+}): ToolDef<{
+    text: string;
+}, unknown>;
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../src/whatsapp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAkB,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGpF,MAAM,WAAW,uBAAuB;IAAG,iBAAiB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAChH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,KAAK,CAAC;YACd,KAAK,CAAC,EAAE;gBACN,QAAQ,CAAC,EAAE;oBAAE,eAAe,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACxC,QAAQ,CAAC,EAAE,KAAK,CAAC;oBAAE,EAAE,CAAC,EAAE,MAAM,CAAC;oBAAC,IAAI,CAAC,EAAE,MAAM,CAAC;oBAAC,IAAI,CAAC,EAAE;wBAAE,IAAI,CAAC,EAAE,MAAM,CAAA;qBAAE,CAAA;iBAAE,CAAC,CAAC;gBAC3E,QAAQ,CAAC,EAAE,KAAK,CAAC;oBAAE,EAAE,CAAC,EAAE,MAAM,CAAC;oBAAC,YAAY,CAAC,EAAE,MAAM,CAAC;oBAAC,MAAM,CAAC,EAAE,MAAM,CAAC;oBAAC,SAAS,CAAC,EAAE,MAAM,CAAC;oBAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;iBAAE,CAAC,CAAC;aACnH,CAAC;SACH,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AACD,MAAM,WAAW,sBAAsB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;AACpH,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,eAAe,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAAC;IACtD,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAAC;CAC3D;AACD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAE5E;AACD,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAKhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA0DtF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAcjL"}

package/dist/whatsapp.js

@@ -0,0 +1,98 @@
+import { conversationKey, defineChannel, defineTool, hexToBytes, parseConversationKey, readJsonBody, verifyHmacSha256 } from '@fabric-harness/sdk/channel';
+import { timingSafeString } from './webhook-shared.js';
+export function whatsAppConversationKey(ref) {
+    return conversationKey('whatsapp', 'v1', ref.businessAccountId, ref.phoneNumberId, ref.userPhone);
+}
+export function parseWhatsAppConversationKey(id) {
+    const parsed = parseConversationKey(id);
+    if (parsed.provider !== 'whatsapp' || parsed.version !== 'v1' || parsed.segments.length !== 3)
+        throw new Error(`Invalid WhatsApp conversation key: "${id}".`);
+    const [businessAccountId, phoneNumberId, userPhone] = parsed.segments;
+    return { businessAccountId, phoneNumberId, userPhone };
+}
+export function createWhatsAppChannel(options) {
+    async function verifyRequest(request) {
+        const url = new URL(request.url);
+        const verifyToken = url.searchParams.get('hub.verify_token');
+        if (url.searchParams.get('hub.mode') !== 'subscribe' || !verifyToken || !timingSafeString(verifyToken, options.verifyToken))
+            return new Response(null, { status: 403 });
+        return new Response(url.searchParams.get('hub.challenge') ?? '', { status: 200 });
+    }
+    async function webhook(request, ctx) {
+        const body = await readJsonBody(request);
+        if (!body)
+            return new Response(null, { status: 413 });
+        const signature = request.headers.get('x-hub-signature-256');
+        if (!signature?.startsWith('sha256='))
+            return new Response(null, { status: 401 });
+        let bytes;
+        try {
+            bytes = hexToBytes(signature.slice(7));
+        }
+        catch {
+            return new Response(null, { status: 401 });
+        }
+        if (!(await verifyHmacSha256(options.appSecret, body.raw, bytes)))
+            return new Response(null, { status: 401 });
+        const payload = body.json;
+        const entries = Array.isArray(payload?.entry) ? payload.entry : [];
+        for (const entry of entries) {
+            const changes = Array.isArray(entry.changes) ? entry.changes : [];
+            for (const change of changes) {
+                const value = change.value;
+                const metadata = value?.metadata;
+                const messages = Array.isArray(value?.messages) ? value.messages : [];
+                for (const message of messages) {
+                    const text = message.text?.body;
+                    const from = message.from;
+                    if (typeof text !== 'string' || !from || !metadata?.phone_number_id)
+                        continue;
+                    const ref = { businessAccountId: String(entry.id ?? ''), phoneNumberId: String(metadata.phone_number_id), userPhone: String(from) };
+                    await ctx.dispatch(options.agent, {
+                        instanceId: whatsAppConversationKey(ref), input: { type: 'whatsapp.message', text, messageId: message.id, from },
+                        ...(message.id ? { dedupeKey: String(message.id) } : {}),
+                        tenantId: options.tenantId ?? ref.businessAccountId,
+                        actor: { onBehalfOf: String(from) },
+                    });
+                }
+                const statuses = Array.isArray(value?.statuses) ? value.statuses : [];
+                for (const status of statuses) {
+                    if (!status.recipient_id || !metadata?.phone_number_id)
+                        continue;
+                    const ref = {
+                        businessAccountId: String(entry.id ?? ''),
+                        phoneNumberId: metadata.phone_number_id,
+                        userPhone: status.recipient_id,
+                    };
+                    await ctx.dispatch(options.agent, {
+                        instanceId: whatsAppConversationKey(ref),
+                        input: { type: 'whatsapp.status', messageId: status.id, status: status.status, timestamp: status.timestamp, errors: status.errors },
+                        ...(status.id && status.status ? { dedupeKey: `${status.id}:status:${status.status}` } : {}),
+                        tenantId: options.tenantId ?? ref.businessAccountId,
+                    });
+                }
+            }
+        }
+        return new Response(null, { status: 200 });
+    }
+    return defineChannel({
+        name: 'whatsapp', routes: [{ method: 'GET', path: '/webhook', handler: verifyRequest }, { method: 'POST', path: '/webhook', handler: webhook }],
+        conversationKey: (ref) => whatsAppConversationKey(ref), parseConversationKey: (id) => parseWhatsAppConversationKey(id),
+    });
+}
+export function replyInWhatsApp(ref, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return defineTool({
+        name: 'reply_in_whatsapp', description: 'Reply in the WhatsApp conversation this agent is handling.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', minLength: 1 } }, required: ['text'] },
+        metadata: { effect: 'write', provider: 'whatsapp', channel: 'whatsapp' },
+        execute: async ({ text }) => {
+            const response = await fetchImpl(`https://graph.facebook.com/${options.apiVersion ?? 'v23.0'}/${encodeURIComponent(ref.phoneNumberId)}/messages`, {
+                method: 'POST', headers: { authorization: `Bearer ${options.accessToken}`, 'content-type': 'application/json' },
+                body: JSON.stringify({ messaging_product: 'whatsapp', to: ref.userPhone, type: 'text', text: { body: text } }),
+            });
+            return response.json();
+        },
+    });
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.js","sourceRoot":"","sources":["../src/whatsapp.ts"],"names":[],"mappings":"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"}

package/dist/zendesk.d.ts

@@ -0,0 +1,48 @@
+import type { Channel, ToolDef } from '@fabric-harness/sdk/channel';
+import { type SimpleConversationRef } from './webhook-shared.js';
+export interface ZendeskConversationRef extends SimpleConversationRef {
+}
+export interface ZendeskWebhookPayload {
+    id?: string;
+    type?: string;
+    account_id?: string;
+    ticket?: {
+        id?: string | number;
+        subject?: string;
+        description?: string;
+        requester?: {
+            id?: string | number;
+        };
+        submitter?: {
+            id?: string | number;
+        };
+    };
+    current_user?: {
+        id?: string | number;
+    };
+    detail?: Record<string, unknown>;
+}
+export interface ZendeskChannelOptions {
+    signingSecret: string;
+    agent: string;
+    subdomain: string;
+    tenantId?: string | ((payload: ZendeskWebhookPayload) => string | undefined);
+}
+export interface ZendeskChannel extends Channel {
+    conversationKey(ref: ZendeskConversationRef): string;
+    parseConversationKey(id: string): ZendeskConversationRef;
+}
+export declare const zendeskConversationKey: (ref: ZendeskConversationRef) => string;
+export declare const parseZendeskConversationKey: (id: string) => SimpleConversationRef;
+export declare function createZendeskChannel(options: ZendeskChannelOptions): ZendeskChannel;
+export declare function commentOnZendeskTicket(ref: ZendeskConversationRef, options: {
+    subdomain: string;
+    token: string;
+    email: string;
+    ticketId: string | number;
+    fetchImpl?: typeof fetch;
+}): ToolDef<{
+    text: string;
+    public?: boolean;
+}, unknown>;
+//# sourceMappingURL=zendesk.d.ts.map

package/dist/zendesk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zendesk.d.ts","sourceRoot":"","sources":["../src/zendesk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAgH,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE/K,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;CAAG;AACxE,MAAM,WAAW,qBAAqB;IAAG,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAAC,SAAS,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAAC,YAAY,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAC5T,MAAM,WAAW,qBAAqB;IAAG,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,qBAAqB,KAAK,MAAM,GAAG,SAAS,CAAC,CAAA;CAAE;AAChL,MAAM,WAAW,cAAe,SAAQ,OAAO;IAAG,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAAA;CAAE;AAElK,eAAO,MAAM,sBAAsB,GAAI,KAAK,sBAAsB,WAA0C,CAAC;AAC7G,eAAO,MAAM,2BAA2B,GAAI,IAAI,MAAM,0BAA8C,CAAC;AAErG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAkBnF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,EAAE,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,OAAO,CAAC,CAQ3O"}

package/dist/zendesk.js

@@ -0,0 +1,36 @@
+import { createJsonWebhookChannel, jsonWriteTool, parseSimpleConversationKey, simpleConversationKey, verifyBase64Hmac } from './webhook-shared.js';
+export const zendeskConversationKey = (ref) => simpleConversationKey('zendesk', ref);
+export const parseZendeskConversationKey = (id) => parseSimpleConversationKey('zendesk', id);
+export function createZendeskChannel(options) {
+    return createJsonWebhookChannel({
+        name: 'zendesk', agent: options.agent,
+        authenticate: (request, raw) => {
+            const timestamp = request.headers.get('x-zendesk-webhook-signature-timestamp');
+            if (!timestamp)
+                return false;
+            const timestampBytes = new TextEncoder().encode(timestamp);
+            const signed = new Uint8Array(timestampBytes.length + raw.length);
+            signed.set(timestampBytes);
+            signed.set(raw, timestampBytes.length);
+            return verifyBase64Hmac(options.signingSecret, signed, request.headers.get('x-zendesk-webhook-signature'));
+        },
+        normalize: (payload) => {
+            const ticketId = payload.ticket?.id;
+            const actor = payload.current_user?.id ?? payload.ticket?.submitter?.id ?? payload.ticket?.requester?.id;
+            const tenantId = (typeof options.tenantId === 'function' ? options.tenantId(payload) : options.tenantId) ?? payload.account_id ?? options.subdomain;
+            if (ticketId === undefined || actor === undefined || !tenantId)
+                return undefined;
+            return { ref: { tenantId, conversationId: String(ticketId) }, dedupeKey: payload.id ?? `${payload.type}:${ticketId}`, actorId: String(actor), input: { type: `zendesk.${payload.type ?? 'ticket'}`, ticket: payload.ticket, detail: payload.detail } };
+        },
+    });
+}
+export function commentOnZendeskTicket(ref, options) {
+    return jsonWriteTool({
+        name: 'comment_on_zendesk_ticket', description: 'Add a governed comment to the Zendesk ticket this agent is handling.', provider: 'zendesk', fetchImpl: options.fetchImpl,
+        method: 'PUT', url: `https://${options.subdomain}.zendesk.com/api/v2/tickets/${options.ticketId}.json`,
+        headers: { authorization: `Basic ${btoa(`${options.email}/token:${options.token}`)}` },
+        inputSchema: { properties: { text: { type: 'string', minLength: 1 }, public: { type: 'boolean' } }, required: ['text'] },
+        body: ({ text, public: isPublic }) => ({ ticket: { comment: { body: text, public: isPublic ?? true } } }),
+    });
+}
+//# sourceMappingURL=zendesk.js.map

package/dist/zendesk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zendesk.js","sourceRoot":"","sources":["../src/zendesk.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/channels",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Event-ingress channels (Slack, GitHub, …) for Fabric Harness agents.",
   "license": "Apache-2.0",
   "author": "Fabric",
@@ -11,7 +11,8 @@
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
-    "access": "public"
+    "access": "public",
+    "provenance": false
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,6 +21,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./compatibility": {
+      "types": "./dist/compatibility.d.ts",
+      "import": "./dist/compatibility.js"
+    },
     "./slack": {
       "types": "./dist/slack.d.ts",
       "import": "./dist/slack.js"
@@ -27,23 +32,87 @@
     "./github": {
       "types": "./dist/github.d.ts",
       "import": "./dist/github.js"
+    },
+    "./discord": {
+      "types": "./dist/discord.d.ts",
+      "import": "./dist/discord.js"
+    },
+    "./teams": {
+      "types": "./dist/teams.d.ts",
+      "import": "./dist/teams.js"
+    },
+    "./telegram": {
+      "types": "./dist/telegram.d.ts",
+      "import": "./dist/telegram.js"
+    },
+    "./twilio": {
+      "types": "./dist/twilio.d.ts",
+      "import": "./dist/twilio.js"
+    },
+    "./whatsapp": {
+      "types": "./dist/whatsapp.d.ts",
+      "import": "./dist/whatsapp.js"
+    },
+    "./google-chat": {
+      "types": "./dist/google-chat.d.ts",
+      "import": "./dist/google-chat.js"
+    },
+    "./linear": {
+      "types": "./dist/linear.d.ts",
+      "import": "./dist/linear.js"
+    },
+    "./notion": {
+      "types": "./dist/notion.d.ts",
+      "import": "./dist/notion.js"
+    },
+    "./stripe": {
+      "types": "./dist/stripe.d.ts",
+      "import": "./dist/stripe.js"
+    },
+    "./zendesk": {
+      "types": "./dist/zendesk.d.ts",
+      "import": "./dist/zendesk.js"
+    },
+    "./intercom": {
+      "types": "./dist/intercom.d.ts",
+      "import": "./dist/intercom.js"
+    },
+    "./shopify": {
+      "types": "./dist/shopify.d.ts",
+      "import": "./dist/shopify.js"
+    },
+    "./messenger": {
+      "types": "./dist/messenger.d.ts",
+      "import": "./dist/messenger.js"
+    },
+    "./resend": {
+      "types": "./dist/resend.d.ts",
+      "import": "./dist/resend.js"
+    },
+    "./salesforce-marketing-cloud": {
+      "types": "./dist/salesforce-marketing-cloud.d.ts",
+      "import": "./dist/salesforce-marketing-cloud.js"
     }
   },
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "dependencies": {
-    "@fabric-harness/sdk": "^1.12.1"
+    "@fabric-harness/sdk": "^2.2.0"
   },
   "devDependencies": {
+    "esbuild": "^0.28.1",
+    "miniflare": "^4.20260625.0",
     "typescript": "^5.8.3",
     "vitest": "^4.1.5"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc -b tsconfig.json",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:live": "vitest run test/live.test.ts"
   }
 }