@pellux/goodvibes-sdk 0.18.14 → 0.18.15

package/dist/_internal/platform/adapters/signal/index.js

@@ -0,0 +1,84 @@
+import { parseJsonRecord, readBearerOrHeaderToken, readTextBodyWithinLimit } from '@pellux/goodvibes-sdk/platform/adapters/helpers';
+function readRecord(value) {
+    return value && typeof value === 'object' ? value : null;
+}
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+export async function handleSignalSurfaceWebhook(req, context) {
+    const configuredToken = String(context.configManager.get('surfaces.signal.token') ?? '')
+        || await context.serviceRegistry.resolveSecret('signal', 'primary')
+        || process.env.SIGNAL_BRIDGE_TOKEN
+        || '';
+    if (configuredToken) {
+        const providedToken = readBearerOrHeaderToken(req, 'x-goodvibes-signal-token');
+        if (providedToken !== configuredToken) {
+            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+    }
+    const rawBody = await readTextBodyWithinLimit(req);
+    if (rawBody instanceof Response)
+        return rawBody;
+    const body = parseJsonRecord(rawBody);
+    if (body instanceof Response)
+        return body;
+    const payload = readRecord(body);
+    if (!payload)
+        return Response.json({ error: 'Invalid JSON body' }, { status: 400 });
+    const recipient = readString(payload.recipient) ?? readString(payload.source) ?? readString(payload.phoneNumber);
+    const message = readString(payload.message) ?? readString(payload.text) ?? '';
+    if (!recipient)
+        return Response.json({ error: 'Missing recipient/source' }, { status: 400 });
+    const policy = await context.authorizeSurfaceIngress({
+        surface: 'signal',
+        userId: recipient,
+        channelId: recipient,
+        groupId: recipient,
+        threadId: readString(payload.threadId),
+        conversationKind: readString(payload.threadId) ? 'thread' : 'direct',
+        text: message,
+        mentioned: true,
+        metadata: payload,
+    });
+    if (!policy.allowed) {
+        return Response.json({ error: `Blocked by channel policy: ${policy.reason}` }, { status: 403 });
+    }
+    const binding = await context.routeBindings.upsertBinding({
+        kind: readString(payload.threadId) ? 'thread' : 'channel',
+        surfaceKind: 'signal',
+        surfaceId: readString(payload.account) ?? readString(context.configManager.get('surfaces.signal.account')) ?? 'signal',
+        externalId: readString(payload.threadId) ?? recipient,
+        channelId: recipient,
+        threadId: readString(payload.threadId),
+        title: recipient,
+        metadata: { ...payload },
+    });
+    if (!message) {
+        return Response.json({ acknowledged: true, queued: false, bindingId: binding.id });
+    }
+    const submission = await context.sessionBroker.submitMessage({
+        routeId: binding.id,
+        surfaceKind: 'signal',
+        surfaceId: binding.surfaceId,
+        externalId: binding.externalId,
+        threadId: binding.threadId ?? binding.channelId,
+        userId: recipient,
+        displayName: recipient,
+        title: recipient,
+        body: message,
+        metadata: payload,
+    });
+    if (submission.mode === 'continued-live') {
+        return Response.json({ acknowledged: true, continued: true, sessionId: submission.session.id, agentId: submission.activeAgentId ?? null });
+    }
+    const spawnResult = context.trySpawnAgent({ mode: 'spawn', task: submission.task }, 'handleSignalSurfaceWebhook', submission.session.id);
+    if (spawnResult instanceof Response)
+        return spawnResult;
+    await context.sessionBroker.bindAgent(submission.session.id, spawnResult.id);
+    context.queueSurfaceReplyFromBinding(submission.routeBinding ?? binding, {
+        agentId: spawnResult.id,
+        task: message,
+        sessionId: submission.session.id,
+    });
+    return Response.json({ acknowledged: true, queued: true, bindingId: binding.id, sessionId: submission.session.id, agentId: spawnResult.id });
+}

package/dist/_internal/platform/adapters/slack/index.d.ts

@@ -0,0 +1,5 @@
+import { SlackIntegration } from '../../integrations/index.js';
+import type { SurfaceAdapterContext } from '../types.js';
+export declare function handleSlackSurfaceWebhook(req: Request, context: SurfaceAdapterContext): Promise<Response>;
+export declare function handleSlackSurfacePayload(bodyRecord: Record<string, unknown>, context: SurfaceAdapterContext, slack?: SlackIntegration, req?: Request): Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/adapters/slack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/adapters/slack/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6C/G;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,mBAAyB,EAC9B,GAAG,GAAE,OAAiF,GACrF,OAAO,CAAC,QAAQ,CAAC,CAyQnB"}

package/dist/_internal/platform/adapters/slack/index.js

@@ -0,0 +1,287 @@
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { SlackIntegration } from '../../integrations/index.js';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+export async function handleSlackSurfaceWebhook(req, context) {
+    const contentLength = parseInt(req.headers.get('content-length') ?? '0', 10);
+    if (contentLength > 1_000_000) {
+        return Response.json({ error: 'Payload too large' }, { status: 413 });
+    }
+    const signingSecret = await context.serviceRegistry.resolveSecret('slack', 'signingSecret')
+        ?? process.env.SLACK_SIGNING_SECRET;
+    if (!signingSecret) {
+        logger.warn('handleSlackSurfaceWebhook: SLACK_SIGNING_SECRET not set — rejecting');
+        return Response.json({ error: 'Webhook not configured' }, { status: 503 });
+    }
+    const timestamp = req.headers.get('x-slack-request-timestamp') ?? '';
+    const signature = req.headers.get('x-slack-signature') ?? '';
+    const rawBody = await req.text();
+    const slack = new SlackIntegration(await context.serviceRegistry.resolveSecret('slack', 'webhookUrl') ?? process.env.SLACK_WEBHOOK_URL, await context.serviceRegistry.resolveSecret('slack', 'primary') ?? process.env.SLACK_BOT_TOKEN);
+    if (!slack.verifySignature(rawBody, timestamp, signature, signingSecret)) {
+        logger.warn('handleSlackSurfaceWebhook: invalid signature');
+        return Response.json({ error: 'Invalid signature' }, { status: 401 });
+    }
+    let bodyRecord;
+    const contentType = req.headers.get('content-type') ?? '';
+    if (contentType.includes('application/json')) {
+        try {
+            bodyRecord = JSON.parse(rawBody);
+        }
+        catch {
+            return Response.json({ error: 'Invalid JSON body' }, { status: 400 });
+        }
+    }
+    else {
+        bodyRecord = Object.fromEntries(new URLSearchParams(rawBody));
+    }
+    if (bodyRecord.type === 'url_verification') {
+        return Response.json({ challenge: bodyRecord.challenge });
+    }
+    return handleSlackSurfacePayload(bodyRecord, context, slack, req);
+}
+export async function handleSlackSurfacePayload(bodyRecord, context, slack = new SlackIntegration(), req = new Request('http://goodvibes.local/webhook/slack', { method: 'POST' })) {
+    const event = slack.parseEvent(bodyRecord);
+    if (event.type === 'slash_command') {
+        const task = event.text.trim();
+        const policy = await context.authorizeSurfaceIngress({
+            surface: 'slack',
+            userId: event.userId,
+            channelId: event.channelId,
+            groupId: event.channelId,
+            conversationKind: 'channel',
+            text: task,
+            mentioned: true,
+            metadata: {
+                command: event.command,
+                userName: event.userName,
+            },
+        });
+        if (!policy.allowed) {
+            return Response.json({
+                response_type: 'ephemeral',
+                text: `Blocked by channel policy: ${policy.reason}`,
+            }, { status: 403 });
+        }
+        const binding = await context.routeBindings.upsertBinding({
+            kind: 'channel',
+            surfaceKind: 'slack',
+            surfaceId: event.teamId || 'slack',
+            externalId: event.channelId,
+            channelId: event.channelId,
+            title: event.channelName || event.command,
+            metadata: {
+                command: event.command,
+                userId: event.userId,
+                userName: event.userName,
+                responseUrl: event.responseUrl,
+            },
+        });
+        if (!task) {
+            return Response.json({
+                response_type: 'ephemeral',
+                text: 'Usage: `/goodvibes <your prompt>`',
+            });
+        }
+        const controlCommand = context.parseSurfaceControlCommand(task);
+        if (controlCommand) {
+            const message = await context.performSurfaceControlCommand(controlCommand);
+            return Response.json({
+                response_type: 'ephemeral',
+                text: message,
+            });
+        }
+        let responseUrl = event.responseUrl;
+        if (responseUrl && !responseUrl.startsWith('https://hooks.slack.com/')) {
+            logger.warn('handleSlackSurfaceWebhook: suspicious responseUrl, ignoring');
+            responseUrl = undefined;
+        }
+        setImmediate(() => {
+            void (async () => {
+                const submission = await context.sessionBroker.submitMessage({
+                    routeId: binding.id,
+                    surfaceKind: 'slack',
+                    surfaceId: binding.surfaceId,
+                    externalId: event.channelId,
+                    threadId: event.channelId,
+                    userId: event.userId,
+                    displayName: event.userName,
+                    title: event.channelName || event.command,
+                    body: task,
+                    metadata: {
+                        command: event.command,
+                        responseUrl,
+                    },
+                });
+                if (submission.mode === 'continued-live') {
+                    if (responseUrl) {
+                        await fetch(responseUrl, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({
+                                response_type: 'in_channel',
+                                text: `Continuing session ${submission.session.id} via agent ${submission.activeAgentId}.`,
+                            }),
+                        }).catch(() => { });
+                    }
+                    return;
+                }
+                const spawnResult = context.trySpawnAgent({ mode: 'spawn', task: submission.task }, 'handleSlackSurfaceWebhook', submission.session.id);
+                if (spawnResult instanceof Response) {
+                    const payload = await spawnResult.json();
+                    const message = payload.error ?? 'Agent spawn failed';
+                    logger.error('handleSlackSurfaceWebhook: spawn failed', { error: message });
+                    if (responseUrl) {
+                        await fetch(responseUrl, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({
+                                response_type: 'in_channel',
+                                text: `Agent spawn failed: ${message}`,
+                            }),
+                        }).catch(() => { });
+                    }
+                    return;
+                }
+                await context.sessionBroker.bindAgent(submission.session.id, spawnResult.id);
+                context.queueSurfaceReplyFromBinding(submission.routeBinding ?? binding, {
+                    agentId: spawnResult.id,
+                    task,
+                    sessionId: submission.session.id,
+                });
+                if (responseUrl) {
+                    await fetch(responseUrl, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({
+                            response_type: 'in_channel',
+                            blocks: slack.formatAgentResult(spawnResult.id, task, `Session ${submission.session.id} active. Agent ${spawnResult.id} will reply in-channel when complete.`),
+                        }),
+                    }).catch((error) => {
+                        logger.warn('handleSlackSurfaceWebhook: follow-up post failed', {
+                            error: summarizeError(error),
+                        });
+                    });
+                }
+            })();
+        });
+        return Response.json({
+            response_type: 'in_channel',
+            text: `Running: _${task}_`,
+        });
+    }
+    if (event.type === 'event_callback') {
+        if (event.eventType !== 'app_mention' && event.eventType !== 'message') {
+            return new Response(null, { status: 200 });
+        }
+        const task = event.text.trim();
+        if (!task)
+            return new Response(null, { status: 200 });
+        const mentioned = event.eventType === 'app_mention' || /<@[A-Z0-9]+>/i.test(task);
+        const policy = await context.authorizeSurfaceIngress({
+            surface: 'slack',
+            userId: event.userId,
+            channelId: event.channelId,
+            groupId: event.channelId,
+            threadId: event.threadTs ?? event.eventTs,
+            workspaceId: event.teamId,
+            conversationKind: event.threadTs ? 'thread' : 'channel',
+            text: task,
+            mentioned,
+            metadata: {
+                eventType: event.eventType,
+                eventTs: event.eventTs,
+            },
+        });
+        if (!policy.allowed) {
+            return Response.json({ ok: false, error: `Blocked by channel policy: ${policy.reason}` }, { status: 403 });
+        }
+        const binding = await context.routeBindings.upsertBinding({
+            kind: event.threadTs ? 'thread' : 'channel',
+            surfaceKind: 'slack',
+            surfaceId: event.teamId || 'slack',
+            externalId: event.threadTs ?? event.channelId,
+            channelId: event.channelId,
+            threadId: event.threadTs,
+            title: `Slack ${event.eventType}`,
+            metadata: {
+                userId: event.userId,
+                eventType: event.eventType,
+                eventTs: event.eventTs,
+            },
+        });
+        const submission = await context.sessionBroker.submitMessage({
+            routeId: binding.id,
+            surfaceKind: 'slack',
+            surfaceId: binding.surfaceId,
+            externalId: binding.externalId,
+            threadId: binding.threadId ?? binding.channelId,
+            userId: event.userId,
+            displayName: event.userId,
+            title: `Slack ${event.eventType}`,
+            body: task,
+            metadata: {
+                eventType: event.eventType,
+                eventTs: event.eventTs,
+            },
+        });
+        if (submission.mode === 'continued-live') {
+            return Response.json({
+                ok: true,
+                continued: true,
+                sessionId: submission.session.id,
+                agentId: submission.activeAgentId,
+            });
+        }
+        const spawnResult = context.trySpawnAgent({ mode: 'spawn', task: submission.task }, 'handleSlackSurfacePayload', submission.session.id);
+        if (spawnResult instanceof Response)
+            return spawnResult;
+        await context.sessionBroker.bindAgent(submission.session.id, spawnResult.id);
+        context.queueSurfaceReplyFromBinding(submission.routeBinding ?? binding, {
+            agentId: spawnResult.id,
+            task,
+            sessionId: submission.session.id,
+        });
+        return Response.json({
+            ok: true,
+            queued: true,
+            sessionId: submission.session.id,
+            agentId: spawnResult.id,
+        });
+    }
+    const actionPayload = event.payload;
+    const actionId = Array.isArray(actionPayload.actions)
+        ? (() => {
+            const first = actionPayload.actions[0];
+            return typeof first?.action_id === 'string' ? first.action_id : '';
+        })()
+        : '';
+    if (actionId) {
+        const policy = await context.authorizeSurfaceIngress({
+            surface: 'slack',
+            userId: typeof actionPayload.user?.id === 'string'
+                ? actionPayload.user.id
+                : undefined,
+            channelId: typeof actionPayload.channel?.id === 'string'
+                ? actionPayload.channel.id
+                : undefined,
+            groupId: typeof actionPayload.channel?.id === 'string'
+                ? actionPayload.channel.id
+                : undefined,
+            conversationKind: 'channel',
+            text: actionId,
+            mentioned: true,
+            metadata: { interactive: true },
+        });
+        if (!policy.allowed) {
+            return Response.json({
+                response_type: 'ephemeral',
+                text: `Blocked by channel policy: ${policy.reason}`,
+            }, { status: 403 });
+        }
+        const message = await context.performInteractiveSurfaceAction(actionId, 'slack', req);
+        return Response.json({
+            response_type: 'ephemeral',
+            text: message,
+        });
+    }
+    return new Response(null, { status: 200 });
+}

package/dist/_internal/platform/adapters/telegram/index.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceAdapterContext } from '../types.js';
+export declare function handleTelegramSurfaceWebhook(req: Request, context: SurfaceAdapterContext): Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/adapters/telegram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/adapters/telegram/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAiCzD,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8HlH"}

package/dist/_internal/platform/adapters/telegram/index.js

@@ -0,0 +1,147 @@
+function readRecord(value) {
+    return value && typeof value === 'object' ? value : null;
+}
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function readNumberString(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return readString(value);
+}
+function extractTelegramTask(message, botUsername) {
+    const text = readString(message.text) ?? readString(message.caption) ?? '';
+    if (!text)
+        return '';
+    const trimmed = text.trim();
+    const botHandle = botUsername ? botUsername.replace(/^@/, '') : '';
+    const commandPattern = botHandle
+        ? new RegExp(`^/goodvibes(?:@${botHandle})?\\s*`, 'i')
+        : /^\/goodvibes\s*/i;
+    return trimmed.replace(commandPattern, '').trim();
+}
+function telegramConversationKind(chatType, threadId) {
+    if (threadId)
+        return 'thread';
+    if (chatType === 'private')
+        return 'direct';
+    if (chatType === 'channel')
+        return 'channel';
+    return 'group';
+}
+export async function handleTelegramSurfaceWebhook(req, context) {
+    const contentLength = parseInt(req.headers.get('content-length') ?? '0', 10);
+    if (contentLength > 1_000_000) {
+        return Response.json({ error: 'Payload too large' }, { status: 413 });
+    }
+    const configuredSecret = String(context.configManager.get('surfaces.telegram.webhookSecret') ?? '')
+        || await context.serviceRegistry.resolveSecret('telegram', 'signingSecret')
+        || process.env.TELEGRAM_WEBHOOK_SECRET
+        || '';
+    if (configuredSecret) {
+        const providedSecret = req.headers.get('x-telegram-bot-api-secret-token') ?? '';
+        if (providedSecret !== configuredSecret) {
+            return Response.json({ error: 'Unauthorized' }, { status: 401 });
+        }
+    }
+    const body = await req.json().catch(() => null);
+    const payload = readRecord(body);
+    if (!payload)
+        return Response.json({ error: 'Invalid JSON body' }, { status: 400 });
+    const message = readRecord(payload.message)
+        ?? readRecord(payload.edited_message)
+        ?? readRecord(payload.channel_post)
+        ?? readRecord(payload.edited_channel_post);
+    if (!message) {
+        return Response.json({ ok: true, ignored: true });
+    }
+    const chat = readRecord(message.chat);
+    const from = readRecord(message.from);
+    const chatId = readNumberString(chat?.id);
+    if (!chatId)
+        return Response.json({ ok: true, ignored: true });
+    const threadId = readNumberString(message.message_thread_id);
+    const botUsername = readString(context.configManager.get('surfaces.telegram.botUsername'));
+    const task = extractTelegramTask(message, botUsername);
+    const text = readString(message.text) ?? readString(message.caption) ?? '';
+    const mentioned = Boolean((chat?.type === 'private')
+        || /^\/goodvibes\b/i.test(text)
+        || (botUsername && new RegExp(`@${botUsername.replace(/^@/, '')}\\b`, 'i').test(text)));
+    const policy = await context.authorizeSurfaceIngress({
+        surface: 'telegram',
+        userId: readNumberString(from?.id),
+        channelId: chatId,
+        groupId: chatId,
+        threadId,
+        workspaceId: readString(chat?.username),
+        conversationKind: telegramConversationKind(readString(chat?.type), threadId),
+        text: task || text,
+        mentioned,
+        metadata: {
+            updateId: readNumberString(payload.update_id),
+            chatType: readString(chat?.type),
+            chatTitle: readString(chat?.title),
+            fromUsername: readString(from?.username),
+        },
+    });
+    if (!policy.allowed) {
+        return Response.json({ ok: false, error: `Blocked by channel policy: ${policy.reason}` }, { status: 403 });
+    }
+    const binding = await context.routeBindings.upsertBinding({
+        kind: threadId ? 'thread' : 'channel',
+        surfaceKind: 'telegram',
+        surfaceId: botUsername || 'telegram',
+        externalId: threadId ?? chatId,
+        channelId: chatId,
+        threadId,
+        title: readString(chat?.title) ?? readString(chat?.username) ?? chatId,
+        metadata: {
+            chatType: readString(chat?.type),
+            fromId: readNumberString(from?.id),
+            fromUsername: readString(from?.username),
+            updateId: readNumberString(payload.update_id),
+        },
+    });
+    if (!task) {
+        return Response.json({ ok: true, acknowledged: true, bindingId: binding.id });
+    }
+    const controlCommand = context.parseSurfaceControlCommand(task);
+    if (controlCommand) {
+        const message = await context.performSurfaceControlCommand(controlCommand);
+        return Response.json({ ok: true, acknowledged: true, message });
+    }
+    const submission = await context.sessionBroker.submitMessage({
+        routeId: binding.id,
+        surfaceKind: 'telegram',
+        surfaceId: binding.surfaceId,
+        externalId: binding.externalId,
+        threadId: binding.threadId ?? binding.channelId,
+        userId: readNumberString(from?.id),
+        displayName: readString(from?.username) ?? readString(from?.first_name),
+        title: binding.title ?? 'Telegram',
+        body: task,
+        metadata: {
+            chatType: readString(chat?.type),
+            updateId: readNumberString(payload.update_id),
+        },
+    });
+    if (submission.mode === 'continued-live') {
+        return Response.json({ ok: true, continued: true, sessionId: submission.session.id, agentId: submission.activeAgentId ?? null });
+    }
+    const spawnResult = context.trySpawnAgent({ mode: 'spawn', task: submission.task }, 'handleTelegramSurfaceWebhook', submission.session.id);
+    if (spawnResult instanceof Response)
+        return spawnResult;
+    await context.sessionBroker.bindAgent(submission.session.id, spawnResult.id);
+    context.queueSurfaceReplyFromBinding(submission.routeBinding ?? binding, {
+        agentId: spawnResult.id,
+        task,
+        sessionId: submission.session.id,
+    });
+    return Response.json({
+        ok: true,
+        queued: true,
+        bindingId: binding.id,
+        sessionId: submission.session.id,
+        agentId: spawnResult.id,
+    });
+}

package/dist/_internal/platform/adapters/types.d.ts

@@ -0,0 +1,81 @@
+import type { AgentManager } from '../tools/agent/index.js';
+import type { AgentRecord } from '../tools/agent/index.js';
+import type { AutomationRouteBinding } from '@pellux/goodvibes-sdk/platform/automation/routes';
+import type { AutomationSurfaceKind } from '@pellux/goodvibes-sdk/platform/automation/types';
+import type { ChannelConversationKind, ChannelPolicyDecision, RouteBindingManager } from '../channels/index.js';
+import type { SharedSessionBroker } from '../control-plane/index.js';
+import type { ServiceRegistry } from '../config/service-registry.js';
+export interface SurfaceControlCommand {
+    readonly action: 'status' | 'cancel' | 'retry';
+    readonly id: string;
+}
+export interface QueueSurfaceReplyInput {
+    readonly agentId: string;
+    readonly task: string;
+    readonly sessionId?: string;
+}
+export type TrySpawnAgentInput = Parameters<AgentManager['spawn']>[0];
+export type TrySpawnAgentResult = AgentRecord | Response;
+export type TrySpawnAgentFn = (input: TrySpawnAgentInput, logLabel: string, sessionId?: string) => TrySpawnAgentResult;
+export interface SurfaceAdapterContext {
+    readonly serviceRegistry: ServiceRegistry;
+    readonly configManager: {
+        get(key: string): unknown;
+    };
+    readonly routeBindings: RouteBindingManager;
+    readonly sessionBroker: SharedSessionBroker;
+    readonly authorizeSurfaceIngress: (input: {
+        surface: Extract<AutomationSurfaceKind, 'slack' | 'discord' | 'ntfy' | 'telegram' | 'google-chat' | 'signal' | 'whatsapp' | 'imessage' | 'msteams' | 'bluebubbles' | 'mattermost' | 'matrix'>;
+        userId?: string;
+        channelId?: string;
+        groupId?: string;
+        threadId?: string;
+        workspaceId?: string;
+        conversationKind?: ChannelConversationKind;
+        hasAnyMention?: boolean;
+        text?: string;
+        controlCommand?: string;
+        mentioned?: boolean;
+        metadata?: Record<string, unknown>;
+    }) => Promise<ChannelPolicyDecision>;
+    readonly parseSurfaceControlCommand: (text: string) => SurfaceControlCommand | null;
+    readonly performSurfaceControlCommand: (command: SurfaceControlCommand) => Promise<string>;
+    readonly performInteractiveSurfaceAction: (actionId: string, surface: 'slack' | 'discord', req: Request) => Promise<string>;
+    readonly trySpawnAgent: TrySpawnAgentFn;
+    readonly queueSurfaceReplyFromBinding: (binding: AutomationRouteBinding | undefined, input: QueueSurfaceReplyInput) => void;
+}
+export interface GenericWebhookReplyInput {
+    readonly agentId: string;
+    readonly task: string;
+    readonly sessionId?: string;
+    readonly routeId?: string;
+    readonly callbackUrl?: string;
+    readonly callbackCorrelationId?: string;
+    readonly callbackSignature?: 'shared-secret' | 'hmac-sha256';
+}
+export interface GenericWebhookAdapterContext {
+    readonly configManager: {
+        get(key: string): unknown;
+    };
+    readonly routeBindings: RouteBindingManager;
+    readonly sessionBroker: SharedSessionBroker;
+    readonly authorizeSurfaceIngress: (input: {
+        surface: Extract<AutomationSurfaceKind, 'webhook'>;
+        userId?: string;
+        channelId?: string;
+        groupId?: string;
+        threadId?: string;
+        workspaceId?: string;
+        conversationKind?: ChannelConversationKind;
+        hasAnyMention?: boolean;
+        text?: string;
+        controlCommand?: string;
+        mentioned?: boolean;
+        metadata?: Record<string, unknown>;
+    }) => Promise<ChannelPolicyDecision>;
+    readonly trySpawnAgent: TrySpawnAgentFn;
+    readonly surfaceDeliveryEnabled: (surface: Extract<AutomationSurfaceKind, 'webhook'>) => boolean;
+    readonly signWebhookPayload: (body: string, secret: string) => string;
+    readonly queueWebhookReply: (input: GenericWebhookReplyInput) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/_internal/platform/adapters/types.d.ts.map

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

package/dist/_internal/platform/adapters/types.js

@@ -0,0 +1 @@
+export {};

package/dist/_internal/platform/adapters/webhook/index.d.ts

@@ -0,0 +1,3 @@
+import type { GenericWebhookAdapterContext } from '../types.js';
+export declare function handleGenericWebhookSurface(req: Request, context: GenericWebhookAdapterContext): Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/adapters/webhook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/adapters/webhook/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAWhE,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqKxH"}