@fabric-harness/channels 0.16.1 → 0.17.1

package/dist/teams.js

@@ -0,0 +1,154 @@
+import { conversationKey, defineChannel, defineTool, parseConversationKey, readJsonBody } from '@fabric-harness/sdk/channel';
+export function teamsConversationKey(ref) {
+    return conversationKey('teams', 'v1', ref.tenantId, ref.conversationId, ref.serviceUrl, ref.activityId ?? 'root');
+}
+export function parseTeamsConversationKey(id) {
+    const parsed = parseConversationKey(id);
+    if (parsed.provider !== 'teams' || parsed.version !== 'v1' || parsed.segments.length !== 4)
+        throw new Error(`Invalid Teams conversation key: "${id}".`);
+    const [tenantId, conversationId, serviceUrl, activityId] = parsed.segments;
+    return { tenantId, conversationId, serviceUrl, ...(activityId !== 'root' ? { activityId } : {}) };
+}
+export function createTeamsChannel(options) {
+    const authenticate = options.authenticate ?? (options.applicationId
+        ? createBotFrameworkAuthenticator({ applicationId: options.applicationId, ...options.botFramework })
+        : undefined);
+    if (!authenticate)
+        throw new Error('createTeamsChannel requires applicationId or authenticate.');
+    const verifyActivity = authenticate;
+    async function activities(request, ctx) {
+        const body = await readJsonBody(request);
+        if (!body)
+            return new Response(null, { status: 413 });
+        const activity = body.json;
+        if (!activity)
+            return new Response(null, { status: 400 });
+        if (!(await verifyActivity(request, activity)))
+            return new Response(null, { status: 401 });
+        if (activity.type !== 'message' && activity.type !== 'messageUpdate' && activity.type !== 'messageDelete')
+            return new Response(null, { status: 200 });
+        if (activity.type !== 'messageDelete' && typeof activity.text !== 'string')
+            return new Response(null, { status: 200 });
+        const tenantId = String(activity.channelData?.tenant?.id ?? activity.channelId ?? 'teams');
+        const conversationId = String(activity.conversation?.id ?? '');
+        const serviceUrl = String(activity.serviceUrl ?? '');
+        if (!conversationId || !serviceUrl)
+            return new Response(null, { status: 400 });
+        const ref = { tenantId, conversationId, serviceUrl, ...(activity.replyToId ? { activityId: String(activity.replyToId) } : {}) };
+        await ctx.dispatch(options.agent, {
+            instanceId: teamsConversationKey(ref),
+            input: { type: `teams.${activity.type}`, text: activity.text ?? '', activityId: activity.id, channelId: activity.channelId },
+            ...(activity.id ? { dedupeKey: String(activity.id) } : {}),
+            tenantId,
+            ...(activity.from?.id ? { actor: { onBehalfOf: String(activity.from.id) } } : {}),
+        });
+        return new Response(null, { status: 202 });
+    }
+    return defineChannel({
+        name: 'teams', routes: [{ method: 'POST', path: '/activities', handler: activities }],
+        conversationKey: (ref) => teamsConversationKey(ref),
+        parseConversationKey: (id) => parseTeamsConversationKey(id),
+    });
+}
+/** Verify Microsoft Bot Connector signatures, issuer, audience, lifetime, service URL, and endorsement. */
+export function createBotFrameworkAuthenticator(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const metadataUrl = options.openIdMetadataUrl ?? 'https://login.botframework.com/v1/.well-known/openidconfiguration';
+    const ttl = options.cacheTtlMs ?? 60 * 60 * 1000;
+    const skew = options.clockSkewSeconds ?? 300;
+    const now = options.now ?? Date.now;
+    let cached;
+    async function load(force = false) {
+        if (!force && cached && cached.expiresAt > now())
+            return cached;
+        const metadataResponse = await fetchImpl(metadataUrl);
+        if (!metadataResponse.ok)
+            throw new Error(`Bot Framework metadata request failed with ${metadataResponse.status}.`);
+        const metadata = await metadataResponse.json();
+        if (!metadata.issuer || !metadata.jwks_uri)
+            throw new Error('Bot Framework metadata is missing issuer or jwks_uri.');
+        const keysResponse = await fetchImpl(metadata.jwks_uri);
+        if (!keysResponse.ok)
+            throw new Error(`Bot Framework key request failed with ${keysResponse.status}.`);
+        const keys = await keysResponse.json();
+        if (!Array.isArray(keys.keys))
+            throw new Error('Bot Framework key response is missing keys.');
+        cached = { metadata, keys, expiresAt: now() + ttl };
+        return cached;
+    }
+    return async (request, activity) => {
+        try {
+            const authorization = request.headers.get('authorization');
+            if (!authorization?.startsWith('Bearer '))
+                return false;
+            const token = authorization.slice(7).trim();
+            const parts = token.split('.');
+            if (parts.length !== 3)
+                return false;
+            const [encodedHeader, encodedPayload, encodedSignature] = parts;
+            const header = decodeJwtPart(encodedHeader);
+            const payload = decodeJwtPart(encodedPayload);
+            if (header.alg !== 'RS256' || typeof header.kid !== 'string')
+                return false;
+            let discovery = await load();
+            let jwk = discovery.keys.keys.find((candidate) => candidate.kid === header.kid);
+            if (!jwk) {
+                discovery = await load(true);
+                jwk = discovery.keys.keys.find((candidate) => candidate.kid === header.kid);
+            }
+            if (!jwk)
+                return false;
+            if (discovery.metadata.id_token_signing_alg_values_supported && !discovery.metadata.id_token_signing_alg_values_supported.includes('RS256'))
+                return false;
+            if (payload.iss !== discovery.metadata.issuer)
+                return false;
+            const audience = payload.aud;
+            if (audience !== options.applicationId && !(Array.isArray(audience) && audience.includes(options.applicationId)))
+                return false;
+            const current = Math.floor(now() / 1000);
+            if (typeof payload.exp !== 'number' || current - skew >= payload.exp)
+                return false;
+            if (typeof payload.nbf === 'number' && current + skew < payload.nbf)
+                return false;
+            const serviceUrl = activity.serviceUrl;
+            if (typeof serviceUrl !== 'string' || payload.serviceurl !== serviceUrl)
+                return false;
+            const channelId = activity.channelId;
+            if (typeof channelId === 'string' && jwk.endorsements && !jwk.endorsements.includes(channelId))
+                return false;
+            const key = await crypto.subtle.importKey('jwk', jwk, { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' }, false, ['verify']);
+            return await crypto.subtle.verify('RSASSA-PKCS1-v1_5', key, viewToBuffer(base64UrlBytes(encodedSignature)), viewToBuffer(new TextEncoder().encode(`${encodedHeader}.${encodedPayload}`)));
+        }
+        catch {
+            return false;
+        }
+    };
+}
+function decodeJwtPart(value) {
+    return JSON.parse(new TextDecoder().decode(base64UrlBytes(value)));
+}
+function base64UrlBytes(value) {
+    const normalized = value.replace(/-/g, '+').replace(/_/g, '/').padEnd(Math.ceil(value.length / 4) * 4, '=');
+    const decoded = atob(normalized);
+    return Uint8Array.from(decoded, (character) => character.charCodeAt(0));
+}
+function viewToBuffer(bytes) {
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+export function replyInTeamsConversation(ref, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return defineTool({
+        name: 'reply_in_teams_conversation', description: 'Reply in the Microsoft Teams conversation this agent is handling.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', minLength: 1 } }, required: ['text'] },
+        metadata: { effect: 'write', provider: 'microsoft-teams', channel: 'teams' },
+        execute: async ({ text }) => {
+            const token = typeof options.accessToken === 'function' ? await options.accessToken() : options.accessToken;
+            const base = `${ref.serviceUrl.replace(/\/$/, '')}/v3/conversations/${encodeURIComponent(ref.conversationId)}/activities`;
+            const response = await fetchImpl(ref.activityId ? `${base}/${encodeURIComponent(ref.activityId)}` : base, {
+                method: 'POST', headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' }, body: JSON.stringify({ type: 'message', text }),
+            });
+            return response.json();
+        },
+    });
+}
+//# sourceMappingURL=teams.js.map

package/dist/teams.js.map

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

package/dist/telegram.d.ts

@@ -0,0 +1,53 @@
+import type { Channel, ToolDef } from '@fabric-harness/sdk/channel';
+export interface TelegramConversationRef {
+    botId: string;
+    chatId: string;
+    threadId?: string;
+}
+export interface TelegramMessagePayload {
+    message_id?: number;
+    message_thread_id?: number;
+    text?: string;
+    chat?: {
+        id?: string | number;
+    };
+    from?: {
+        id?: string | number;
+    };
+}
+export interface TelegramUpdatePayload {
+    update_id?: number;
+    message?: TelegramMessagePayload;
+    edited_message?: TelegramMessagePayload;
+    channel_post?: TelegramMessagePayload;
+    edited_channel_post?: TelegramMessagePayload;
+    callback_query?: {
+        id?: string;
+        data?: string;
+        from?: {
+            id?: string | number;
+        };
+        message?: TelegramMessagePayload;
+    };
+}
+export interface TelegramChannelOptions {
+    botId: string;
+    botToken: string;
+    secretToken: string;
+    agent: string;
+    tenantId?: string | ((update: TelegramUpdatePayload) => string | undefined);
+}
+export interface TelegramChannel extends Channel {
+    conversationKey(ref: TelegramConversationRef): string;
+    parseConversationKey(id: string): TelegramConversationRef;
+}
+export declare function telegramConversationKey(ref: TelegramConversationRef): string;
+export declare function parseTelegramConversationKey(id: string): TelegramConversationRef;
+export declare function createTelegramChannel(options: TelegramChannelOptions): TelegramChannel;
+export declare function replyInTelegram(ref: TelegramConversationRef, options: {
+    botToken: string;
+    fetchImpl?: typeof fetch;
+}): ToolDef<{
+    text: string;
+}, unknown>;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAkB,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGpF,MAAM,WAAW,uBAAuB;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;AAC7F,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACjC;AACD,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;IAC7C,cAAc,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAAC,OAAO,CAAC,EAAE,sBAAsB,CAAA;KAAE,CAAC;CACpH;AACD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,qBAAqB,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7E;AACD,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,eAAe,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAAC;IACtD,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAAC;CAC3D;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAE5E;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAKhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA2CtF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAezJ"}

package/dist/telegram.js

@@ -0,0 +1,76 @@
+import { conversationKey, defineChannel, defineTool, parseConversationKey, readJsonBody } from '@fabric-harness/sdk/channel';
+import { timingSafeString } from './webhook-shared.js';
+export function telegramConversationKey(ref) {
+    return conversationKey('telegram', 'v1', ref.botId, ref.chatId, ref.threadId ?? 'root');
+}
+export function parseTelegramConversationKey(id) {
+    const parsed = parseConversationKey(id);
+    if (parsed.provider !== 'telegram' || parsed.version !== 'v1' || parsed.segments.length !== 3)
+        throw new Error(`Invalid Telegram conversation key: "${id}".`);
+    const [botId, chatId, threadId] = parsed.segments;
+    return { botId, chatId, ...(threadId !== 'root' ? { threadId } : {}) };
+}
+export function createTelegramChannel(options) {
+    async function webhook(request, ctx) {
+        const secretToken = request.headers.get('x-telegram-bot-api-secret-token');
+        if (!secretToken || !timingSafeString(secretToken, options.secretToken))
+            return new Response(null, { status: 401 });
+        const body = await readJsonBody(request);
+        if (!body)
+            return new Response(null, { status: 413 });
+        const update = body.json;
+        if (!update)
+            return new Response(null, { status: 400 });
+        const callback = update.callback_query;
+        const message = update.message ?? update.edited_message ?? update.channel_post ?? update.edited_channel_post ?? callback?.message;
+        const chat = message?.chat;
+        const from = callback?.from ?? message?.from;
+        const text = callback?.data ?? message?.text;
+        if (message && chat?.id !== undefined && typeof text === 'string') {
+            const ref = {
+                botId: options.botId,
+                chatId: String(chat.id),
+                ...(message.message_thread_id !== undefined ? { threadId: String(message.message_thread_id) } : {}),
+            };
+            const tenantId = typeof options.tenantId === 'function' ? options.tenantId(update) : options.tenantId;
+            await ctx.dispatch(options.agent, {
+                instanceId: telegramConversationKey(ref),
+                input: {
+                    type: callback ? 'telegram.callback' : update.edited_message || update.edited_channel_post ? 'telegram.message_edited' : 'telegram.message',
+                    text,
+                    messageId: message.message_id,
+                    callbackId: callback?.id,
+                    chatId: chat.id,
+                    userId: from?.id,
+                },
+                ...(update.update_id !== undefined ? { dedupeKey: String(update.update_id) } : callback?.id ? { dedupeKey: callback.id } : {}),
+                ...(tenantId ? { tenantId } : {}),
+                ...(from?.id !== undefined ? { actor: { onBehalfOf: String(from.id) } } : {}),
+            });
+        }
+        return new Response(null, { status: 200 });
+    }
+    return defineChannel({
+        name: 'telegram',
+        routes: [{ method: 'POST', path: '/webhook', handler: webhook }],
+        conversationKey: (ref) => telegramConversationKey(ref),
+        parseConversationKey: (id) => parseTelegramConversationKey(id),
+    });
+}
+export function replyInTelegram(ref, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return defineTool({
+        name: 'reply_in_telegram',
+        description: 'Reply in the Telegram conversation this agent is handling.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', minLength: 1 } }, required: ['text'] },
+        metadata: { effect: 'write', provider: 'telegram', channel: 'telegram' },
+        execute: async ({ text }) => {
+            const response = await fetchImpl(`https://api.telegram.org/bot${options.botToken}/sendMessage`, {
+                method: 'POST', headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ chat_id: ref.chatId, text, ...(ref.threadId ? { message_thread_id: ref.threadId } : {}) }),
+            });
+            return response.json();
+        },
+    });
+}
+//# sourceMappingURL=telegram.js.map

package/dist/telegram.js.map

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

package/dist/twilio.d.ts

@@ -0,0 +1,39 @@
+import type { Channel, ToolDef } from '@fabric-harness/sdk/channel';
+export interface TwilioConversationRef {
+    accountSid: string;
+    from: string;
+    to: string;
+}
+export interface TwilioMessagePayload {
+    AccountSid?: string;
+    MessageSid?: string;
+    From?: string;
+    To?: string;
+    Body?: string;
+    NumMedia?: string;
+    MessageStatus?: string;
+    ErrorCode?: string;
+}
+export interface TwilioChannelOptions {
+    accountSid: string;
+    authToken: string;
+    agent: string;
+    /** Public webhook URL configured in Twilio. Required when a proxy rewrites the request URL. */
+    webhookUrl?: string;
+    tenantId?: string;
+}
+export interface TwilioChannel extends Channel {
+    conversationKey(ref: TwilioConversationRef): string;
+    parseConversationKey(id: string): TwilioConversationRef;
+}
+export declare function twilioConversationKey(ref: TwilioConversationRef): string;
+export declare function parseTwilioConversationKey(id: string): TwilioConversationRef;
+export declare function createTwilioChannel(options: TwilioChannelOptions): TwilioChannel;
+export declare function verifyTwilioSignature(authToken: string, url: string, params: URLSearchParams, signature: string): Promise<boolean>;
+export declare function replyWithTwilio(ref: TwilioConversationRef, options: {
+    authToken: string;
+    fetchImpl?: typeof fetch;
+}): ToolDef<{
+    text: string;
+}, unknown>;
+//# sourceMappingURL=twilio.d.ts.map

package/dist/twilio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.d.ts","sourceRoot":"","sources":["../src/twilio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAkB,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGpF,MAAM,WAAW,qBAAqB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AACvF,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAAC;IACpD,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,CAAC;CACzD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAExE;AACD,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,CAK5E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAgChF;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASxI;AAWD,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,CAcxJ"}

package/dist/twilio.js

@@ -0,0 +1,83 @@
+import { conversationKey, defineChannel, defineTool, parseConversationKey, readRequestBody } from '@fabric-harness/sdk/channel';
+import { timingSafeString } from './webhook-shared.js';
+export function twilioConversationKey(ref) {
+    return conversationKey('twilio', 'v1', ref.accountSid, ref.from, ref.to);
+}
+export function parseTwilioConversationKey(id) {
+    const parsed = parseConversationKey(id);
+    if (parsed.provider !== 'twilio' || parsed.version !== 'v1' || parsed.segments.length !== 3)
+        throw new Error(`Invalid Twilio conversation key: "${id}".`);
+    const [accountSid, from, to] = parsed.segments;
+    return { accountSid, from, to };
+}
+export function createTwilioChannel(options) {
+    async function messages(request, ctx) {
+        const body = await readRequestBody(request);
+        if (!body)
+            return new Response(null, { status: 413 });
+        const params = new URLSearchParams(new TextDecoder().decode(body));
+        const signature = request.headers.get('x-twilio-signature') ?? '';
+        const valid = await verifyTwilioSignature(options.authToken, options.webhookUrl ?? request.url, params, signature);
+        if (!valid)
+            return new Response(null, { status: 401 });
+        const from = params.get('From');
+        const to = params.get('To');
+        const text = params.get('Body');
+        const status = params.get('MessageStatus');
+        const messageSid = params.get('MessageSid');
+        if (from && to && (text !== null || status)) {
+            const ref = { accountSid: params.get('AccountSid') ?? options.accountSid, from, to };
+            await ctx.dispatch(options.agent, {
+                instanceId: twilioConversationKey(ref),
+                input: status
+                    ? { type: 'twilio.status', status, messageId: params.get('MessageSid'), errorCode: params.get('ErrorCode'), from, to }
+                    : { type: from.startsWith('whatsapp:') ? 'twilio.whatsapp' : 'twilio.sms', text, from, to, mediaCount: params.get('NumMedia') },
+                ...(messageSid ? { dedupeKey: status ? `${messageSid}:status:${status}` : messageSid } : {}),
+                ...(options.tenantId ? { tenantId: options.tenantId } : {}),
+                actor: { onBehalfOf: from },
+            });
+        }
+        return new Response('<?xml version="1.0" encoding="UTF-8"?><Response></Response>', { status: 200, headers: { 'content-type': 'text/xml' } });
+    }
+    return defineChannel({
+        name: 'twilio', routes: [{ method: 'POST', path: '/messages', handler: messages }],
+        conversationKey: (ref) => twilioConversationKey(ref),
+        parseConversationKey: (id) => parseTwilioConversationKey(id),
+    });
+}
+export async function verifyTwilioSignature(authToken, url, params, signature) {
+    let value = url;
+    for (const key of [...new Set(params.keys())].sort()) {
+        for (const item of params.getAll(key).sort())
+            value += `${key}${item}`;
+    }
+    const cryptoKey = await crypto.subtle.importKey('raw', new TextEncoder().encode(authToken), { name: 'HMAC', hash: 'SHA-1' }, false, ['sign']);
+    const digest = new Uint8Array(await crypto.subtle.sign('HMAC', cryptoKey, new TextEncoder().encode(value)));
+    const expected = bytesToBase64(digest);
+    return timingSafeString(expected, signature);
+}
+function bytesToBase64(bytes) {
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+function stringToBase64(value) {
+    return bytesToBase64(new TextEncoder().encode(value));
+}
+export function replyWithTwilio(ref, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return defineTool({
+        name: 'reply_with_twilio', description: 'Reply by SMS or WhatsApp through Twilio.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', minLength: 1 } }, required: ['text'] },
+        metadata: { effect: 'write', provider: 'twilio', channel: 'twilio' },
+        execute: async ({ text }) => {
+            const body = new URLSearchParams({ From: ref.to, To: ref.from, Body: text });
+            const response = await fetchImpl(`https://api.twilio.com/2010-04-01/Accounts/${encodeURIComponent(ref.accountSid)}/Messages.json`, {
+                method: 'POST', headers: { authorization: `Basic ${stringToBase64(`${ref.accountSid}:${options.authToken}`)}`, 'content-type': 'application/x-www-form-urlencoded' }, body,
+            });
+            return response.json();
+        },
+    });
+}
+//# sourceMappingURL=twilio.js.map

package/dist/twilio.js.map

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

package/dist/webhook-shared.d.ts

@@ -0,0 +1,43 @@
+import type { Channel, ToolDef } from '@fabric-harness/sdk/channel';
+export interface SimpleConversationRef {
+    tenantId: string;
+    conversationId: string;
+}
+export interface NormalizedWebhookEvent {
+    ref: SimpleConversationRef;
+    dedupeKey: string;
+    actorId: string;
+    input: Record<string, unknown>;
+}
+export interface JsonWebhookChannelOptions<TPayload> {
+    name: string;
+    agent: string;
+    authenticate(request: Request, raw: Uint8Array, payload: TPayload): boolean | Promise<boolean>;
+    normalize(payload: TPayload, request: Request): NormalizedWebhookEvent | readonly NormalizedWebhookEvent[] | undefined;
+    handshake?(payload: TPayload, request: Request): Response | undefined | Promise<Response | undefined>;
+    successStatus?: number;
+}
+export interface SimpleWebhookChannel extends Channel {
+    conversationKey(ref: SimpleConversationRef): string;
+    parseConversationKey(id: string): SimpleConversationRef;
+}
+export declare function simpleConversationKey(provider: string, ref: SimpleConversationRef): string;
+export declare function parseSimpleConversationKey(provider: string, id: string): SimpleConversationRef;
+export declare function createJsonWebhookChannel<TPayload>(options: JsonWebhookChannelOptions<TPayload>): SimpleWebhookChannel;
+export declare function verifyHexHmac(secret: string, raw: Uint8Array, signature: string | null, prefix?: string): Promise<boolean>;
+export declare function verifyBase64Hmac(secret: string, raw: Uint8Array, signature: string | null): Promise<boolean>;
+/** Constant-time string comparison for shared-secret webhook tokens and signatures. */
+export declare function timingSafeString(a: string, b: string): boolean;
+export declare function bearerAuthenticator(token: string): (request: Request) => boolean;
+export declare function jsonWriteTool<TInput extends object>(options: {
+    name: string;
+    description: string;
+    provider: string;
+    inputSchema: Record<string, unknown>;
+    url: string | ((input: TInput) => string);
+    headers?: Record<string, string> | ((input: TInput) => Record<string, string>);
+    body?: (input: TInput) => unknown;
+    method?: string;
+    fetchImpl?: typeof fetch | undefined;
+}): ToolDef<TInput, unknown>;
+//# sourceMappingURL=webhook-shared.d.ts.map

package/dist/webhook-shared.d.ts.map

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

package/dist/webhook-shared.js

@@ -0,0 +1,100 @@
+import { conversationKey, defineChannel, defineTool, hexToBytes, parseConversationKey, readJsonBody, verifyHmacSha256, } from '@fabric-harness/sdk/channel';
+export function simpleConversationKey(provider, ref) {
+    return conversationKey(provider, 'v1', ref.tenantId, ref.conversationId);
+}
+export function parseSimpleConversationKey(provider, id) {
+    const parsed = parseConversationKey(id);
+    if (parsed.provider !== provider || parsed.version !== 'v1' || parsed.segments.length !== 2) {
+        throw new Error(`Invalid ${provider} conversation key: "${id}".`);
+    }
+    const [tenantId, conversationId] = parsed.segments;
+    return { tenantId, conversationId };
+}
+export function createJsonWebhookChannel(options) {
+    async function webhook(request, context) {
+        const body = await readJsonBody(request);
+        if (!body)
+            return new Response(null, { status: 413 });
+        const payload = body.json;
+        if (!payload || typeof payload !== 'object')
+            return new Response(null, { status: 400 });
+        if (!(await options.authenticate(request, body.raw, payload)))
+            return new Response(null, { status: 401 });
+        const handshake = await options.handshake?.(payload, request);
+        if (handshake)
+            return handshake;
+        const normalized = options.normalize(payload, request);
+        for (const event of normalized ? Array.isArray(normalized) ? normalized : [normalized] : []) {
+            await context.dispatch(options.agent, {
+                instanceId: simpleConversationKey(options.name, event.ref),
+                dedupeKey: event.dedupeKey,
+                tenantId: event.ref.tenantId,
+                actor: { onBehalfOf: event.actorId },
+                input: event.input,
+            });
+        }
+        return new Response(null, { status: options.successStatus ?? 200 });
+    }
+    return defineChannel({
+        name: options.name,
+        routes: [{ method: 'POST', path: '/webhook', handler: webhook }],
+        conversationKey: (ref) => simpleConversationKey(options.name, ref),
+        parseConversationKey: (id) => parseSimpleConversationKey(options.name, id),
+    });
+}
+export async function verifyHexHmac(secret, raw, signature, prefix = '') {
+    if (!signature || !signature.startsWith(prefix))
+        return false;
+    try {
+        return await verifyHmacSha256(secret, raw, hexToBytes(signature.slice(prefix.length)));
+    }
+    catch {
+        return false;
+    }
+}
+export async function verifyBase64Hmac(secret, raw, signature) {
+    if (!signature)
+        return false;
+    try {
+        const key = await crypto.subtle.importKey('raw', new TextEncoder().encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']);
+        const signatureBytes = Uint8Array.from(atob(signature), (value) => value.charCodeAt(0));
+        return await crypto.subtle.verify('HMAC', key, new Uint8Array(signatureBytes).buffer, new Uint8Array(raw).buffer);
+    }
+    catch {
+        return false;
+    }
+}
+/** Constant-time string comparison for shared-secret webhook tokens and signatures. */
+export function timingSafeString(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i += 1)
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    return diff === 0;
+}
+export function bearerAuthenticator(token) {
+    return (request) => Boolean(token) && request.headers.get('authorization') === `Bearer ${token}`;
+}
+export function jsonWriteTool(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return defineTool({
+        name: options.name,
+        description: options.description,
+        inputSchema: { type: 'object', additionalProperties: false, ...options.inputSchema },
+        metadata: { effect: 'write', provider: options.provider, channel: options.provider },
+        execute: async (input) => {
+            const response = await fetchImpl(typeof options.url === 'function' ? options.url(input) : options.url, {
+                method: options.method ?? 'POST',
+                headers: { 'content-type': 'application/json', ...(typeof options.headers === 'function' ? options.headers(input) : options.headers) },
+                ...(options.body ? { body: JSON.stringify(options.body(input)) } : {}),
+            });
+            if (!response.ok)
+                throw new Error(`${options.provider} outbound request failed with status ${response.status}.`);
+            if (response.status === 204)
+                return { ok: true };
+            return response.json();
+        },
+    });
+}
+//# sourceMappingURL=webhook-shared.js.map

package/dist/webhook-shared.js.map

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