@zhin.js/adapter-github 1.0.1 → 1.1.0

package/lib/index.js

@@ -1,387 +1,9 @@
-/**
- * GitHub 适配器入口：类型扩展、模型、导出、注册
- */
-import { formatCompact, registerAgentPromptContributor, unregisterAgentPromptContributor, usePlugin } from 'zhin.js';
-import { createGithubAgentPromptContributor } from './agent-prompt.js';
-import { GitHubAdapter } from './adapter.js';
-import { GhClient } from './gh-client.js';
-import { registerGithubMcp } from './register-github-mcp.js';
+export { buildChannelId, enrichInboundContent, formatInboundContent, formatNotification, formatOutboundBody, normalizeWebhookPath, parseChannelId, parseIssueCommentInbound, parsePrReviewCommentInbound, parsePrReviewInbound, resolveGithubConfig, shouldAutoReplyRepo, verifyWebhookSignature, } from './protocol.js';
 export * from './types.js';
-export { GitHubEndpoint, parseMarkdown, toMarkdown } from './endpoint.js';
-export { GitHubAdapter } from './adapter.js';
 export { GhClient } from './gh-client.js';
-const plugin = usePlugin();
-const { provide, defineModel, useContext, logger } = plugin;
-registerGithubMcp(plugin);
-defineModel('github_subscriptions', {
-    id: { type: 'integer', primary: true },
-    repo: { type: 'text', nullable: false },
-    events: { type: 'json', default: [] },
-    target_id: { type: 'text', nullable: false },
-    target_type: { type: 'text', nullable: false },
-    adapter: { type: 'text', nullable: false },
-    endpoint: { type: 'text', nullable: false },
-});
-defineModel('github_events', {
-    id: { type: 'integer', primary: true },
-    repo: { type: 'text', nullable: false },
-    event_type: { type: 'text', nullable: false },
-    payload: { type: 'json', default: {} },
-});
-defineModel('github_oauth_users', {
-    id: { type: 'integer', primary: true },
-    platform: { type: 'text', nullable: false },
-    platform_uid: { type: 'text', nullable: false },
-    github_login: { type: 'text', nullable: false },
-    access_token: { type: 'text', nullable: false },
-    created_at: { type: 'integer', default: 0 },
-});
-provide({
-    name: 'github',
-    description: 'GitHub Adapter — Issues/PRs as chat channels, full repo management via gh CLI',
-    mounted: async (p) => {
-        registerAgentPromptContributor(createGithubAgentPromptContributor());
-        const adapter = new GitHubAdapter(p);
-        await adapter.start();
-        return adapter;
-    },
-    dispose: async (adapter) => {
-        unregisterAgentPromptContributor('github');
-        await adapter.stop();
-    },
-});
-// 混合模式：有 router + webhook_secret → Webhook 实时；否则 → 轮询降级
-useContext('github', (adapter) => {
-    if (adapter.hasWebhookConfig) {
-        // 尝试注册 Webhook（需要 router Context）
-        const router = plugin.inject('router');
-        if (router) {
-            adapter.setupWebhook(router);
-            logger.debug(formatCompact({ op: 'events', source: 'webhook' }));
-        }
-        else {
-            // router 还没就绪，等它挂载后再注册
-            plugin.useContext('router', (r) => {
-                adapter.setupWebhook(r);
-                logger.debug(formatCompact({ op: 'events', source: 'webhook', deferred: true }));
-            });
-        }
-    }
-    // Webhook 未配置或未激活时，总是启动轮询作为兜底
-    if (!adapter.webhookActive) {
-        adapter.startPolling();
-        logger.debug(formatCompact({ op: 'events', source: 'poll' }));
-    }
-    return () => adapter.stopPolling();
-});
-// ── Tool 工具注册 ─────────────────────────────────────────────────────────
-useContext('tool', 'github', (toolService, adapter) => {
-    const tools = [
-        // --- Star ---
-        {
-            name: 'github_star',
-            description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Endpoint 默认账号）',
-            parameters: {
-                type: 'object',
-                properties: {
-                    action: { type: 'string', description: 'star|unstar|check', enum: ['star', 'unstar', 'check'] },
-                    repo: { type: 'string', description: 'owner/repo (必填)' },
-                },
-                required: ['action', 'repo'],
-            },
-            tags: ['github'],
-            execute: async (args, commMessage) => {
-                const gh = await adapter.getUserOrDefaultAPI(commMessage?.$adapter, commMessage?.$sender.id);
-                if (!gh)
-                    return '❌ 没有可用的 GitHub bot';
-                const { action, repo } = args;
-                switch (action) {
-                    case 'star': {
-                        const r = await gh.starRepo(repo);
-                        return r.ok ? `⭐ 已 Star ${repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-                    }
-                    case 'unstar': {
-                        const r = await gh.unstarRepo(repo);
-                        return r.ok ? `💔 已取消 Star ${repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
-                    }
-                    case 'check': {
-                        const starred = await gh.isStarred(repo);
-                        return starred ? `⭐ 已 Star ${repo}` : `☆ 尚未 Star ${repo}`;
-                    }
-                    default: return `❌ 未知操作: ${action}`;
-                }
-            },
-        },
-        // --- Bind (Device Flow) ---
-        {
-            name: 'github_bind',
-            description: '绑定你的 GitHub 账号 — 使用 Device Flow 授权，无需输入密码',
-            parameters: {
-                type: 'object',
-                properties: {},
-            },
-            tags: ['github'],
-            execute: async (_args, commMessage) => {
-                if (!commMessage?.$adapter || !commMessage?.$sender?.id) {
-                    return '❌ 无法获取当前用户信息';
-                }
-                const clientId = adapter.getClientId();
-                if (!clientId)
-                    return '❌ Endpoint 未配置 GitHub App 或 App 无 client_id，无法进行账号绑定';
-                const db = plugin.root?.inject('database');
-                const model = db?.models?.get('github_oauth_users');
-                if (!model)
-                    return '❌ 数据库未就绪';
-                // 检查是否已绑定
-                const [existing] = await model.select().where({ platform: commMessage.$adapter, platform_uid: commMessage.$sender.id });
-                if (existing) {
-                    return `⚠️ 你已绑定 GitHub 账号: ${existing.github_login}\n如需重新绑定，请先执行 github_unbind`;
-                }
-                try {
-                    const host = adapter.getHost();
-                    const codeResp = await GhClient.deviceFlowRequestCode(clientId, host);
-                    // 异步轮询 token（最多等 codeResp.expires_in 秒）
-                    const tokenPromise = GhClient.deviceFlowPollToken(clientId, codeResp.device_code, codeResp.interval, codeResp.expires_in, host);
-                    // 先回复用户授权链接
-                    const replyMsg = [
-                        `🔗 请在浏览器中打开以下链接进行授权：`,
-                        `   ${codeResp.verification_uri}`,
-                        ``,
-                        `📋 输入验证码: **${codeResp.user_code}**`,
-                        ``,
-                        `⏳ 等待授权中…（${Math.floor(codeResp.expires_in / 60)} 分钟内有效）`,
-                    ].join('\n');
-                    // 在后台等待用户授权完成
-                    tokenPromise.then(async (tokenData) => {
-                        if (!tokenData) {
-                            // 授权超时或被拒绝 — 由于 execute 已经返回了，这里只能通过日志记录
-                            logger.warn(formatCompact({ op: 'device_flow', ok: false, platform: commMessage.$adapter, sender: commMessage.$sender.id }));
-                            return;
-                        }
-                        // 使用 token 获取 GitHub 用户名
-                        const userGh = new GhClient({ host, token: tokenData.access_token });
-                        const authResult = await userGh.verifyAuth();
-                        const login = authResult.ok ? authResult.user : 'unknown';
-                        await model.insert({
-                            id: Date.now(),
-                            platform: commMessage.$adapter,
-                            platform_uid: commMessage.$sender.id,
-                            github_login: login,
-                            access_token: tokenData.access_token,
-                            created_at: Date.now(),
-                        });
-                        logger.info(formatCompact({ op: 'bind', platform: commMessage.$adapter, sender: commMessage.$sender.id, login }));
-                        // 尝试回复绑定成功消息
-                        if (commMessage?.$reply) {
-                            await commMessage.$reply(`✅ GitHub 账号绑定成功！\n👤 ${login}`);
-                        }
-                    }).catch(err => {
-                        logger.error('GitHub Device Flow 错误:', err);
-                    });
-                    return replyMsg;
-                }
-                catch (e) {
-                    return `❌ Device Flow 启动失败: ${e instanceof Error ? e.message : String(e)}`;
-                }
-            },
-        },
-        // --- Unbind ---
-        {
-            name: 'github_unbind',
-            description: '解除你绑定的 GitHub 账号',
-            parameters: {
-                type: 'object',
-                properties: {},
-            },
-            tags: ['github'],
-            execute: async (_args, commMessage) => {
-                if (!commMessage?.$adapter || !commMessage?.$sender?.id) {
-                    return '❌ 无法获取当前用户信息';
-                }
-                const db = plugin.root?.inject('database');
-                const model = db?.models?.get('github_oauth_users');
-                if (!model)
-                    return '❌ 数据库未就绪';
-                const [existing] = await model.select().where({ platform: commMessage.$adapter, platform_uid: commMessage.$sender.id });
-                if (!existing)
-                    return '📭 你尚未绑定 GitHub 账号';
-                await model.delete().where({ id: existing.id });
-                return `✅ 已解除 GitHub 账号绑定: ${existing.github_login}`;
-            },
-        },
-        // --- Whoami ---
-        {
-            name: 'github_whoami',
-            description: '查看你绑定的 GitHub 账号信息',
-            parameters: {
-                type: 'object',
-                properties: {},
-            },
-            tags: ['github'],
-            execute: async (_args, commMessage) => {
-                if (!commMessage?.$adapter || !commMessage?.$sender?.id) {
-                    return '❌ 无法获取当前用户信息';
-                }
-                const db = plugin.root?.inject('database');
-                const model = db?.models?.get('github_oauth_users');
-                if (!model)
-                    return '❌ 数据库未就绪';
-                const [existing] = await model.select().where({ platform: commMessage.$adapter, platform_uid: commMessage.$sender.id });
-                if (!existing)
-                    return '📭 你尚未绑定 GitHub 账号\n🔗 使用 github_bind 绑定你的账号';
-                // 验证 token 是否仍然有效
-                const userGh = new GhClient({ host: adapter.getHost(), token: existing.access_token });
-                const auth = await userGh.verifyAuth();
-                if (auth.ok) {
-                    return `👤 已绑定 GitHub 账号: ${auth.user}\n📅 绑定时间: ${new Date(existing.created_at).toLocaleString('zh-CN')}`;
-                }
-                return `⚠️ 已绑定账号 ${existing.github_login}，但 Token 已失效\n🔗 请执行 github_unbind 后重新 github_bind`;
-            },
-        },
-        // --- Install App ---
-        {
-            name: 'github_install',
-            description: '获取安装 GitHub App 的链接 — 安装后 Endpoint 可以访问你的仓库，你也可以使用更多功能',
-            parameters: {
-                type: 'object',
-                properties: {},
-            },
-            tags: ['github'],
-            execute: async () => {
-                const slug = adapter.getAppSlug();
-                if (!slug)
-                    return '❌ Endpoint 未配置 GitHub App';
-                const host = adapter.getHost() || 'github.com';
-                const installations = adapter.getInstallations();
-                let msg = `🔗 请点击以下链接安装 GitHub App 到你的仓库：\n   https://${host}/apps/${slug}/installations/new`;
-                if (installations.length) {
-                    msg += `\n\n📋 当前已安装 (${installations.length}):`;
-                    for (const inst of installations) {
-                        msg += `\n  • ${inst.account.login} (${inst.account.type})`;
-                    }
-                }
-                return msg;
-            },
-        },
-        // --- Subscribe ---
-        {
-            name: 'github_subscribe',
-            description: '订阅 GitHub 仓库的 Webhook 事件，事件将推送到当前聊天通道',
-            parameters: {
-                type: 'object',
-                properties: {
-                    repo: { type: 'string', description: 'owner/repo (必填)' },
-                    events: { type: 'string', description: '要订阅的事件类型，逗号分隔 (push/issue/star/fork/unstar/pull_request)，默认全部' },
-                },
-                required: ['repo'],
-            },
-            platforms: ['github'],
-            tags: ['github'],
-            execute: async (args, commMessage) => {
-                if (!commMessage?.$adapter || !commMessage?.$sender.id || !commMessage?.$channel?.id || !commMessage?.$endpoint) {
-                    return '❌ 无法获取当前聊天通道信息';
-                }
-                const db = plugin.root?.inject('database');
-                const model = db?.models?.get('github_subscriptions');
-                if (!model)
-                    return '❌ 数据库未就绪';
-                const validEvents = ['push', 'issue', 'star', 'fork', 'unstar', 'pull_request'];
-                const events = args.events
-                    ? args.events.split(',').map((s) => s.trim()).filter((e) => validEvents.includes(e))
-                    : validEvents;
-                if (!events.length)
-                    return `❌ 无效的事件类型，可选: ${validEvents.join(', ')}`;
-                const [existing] = await model.select().where({
-                    repo: args.repo,
-                    target_id: commMessage.$channel?.id,
-                    adapter: commMessage.$adapter,
-                    endpoint: commMessage.$endpoint,
-                });
-                if (existing) {
-                    await model.update({ events, target_type: commMessage.$channel?.type || 'private' }).where({ id: existing.id });
-                    return `✅ 已更新订阅 ${args.repo}\n📡 事件: ${events.join(', ')}`;
-                }
-                await model.insert({
-                    id: Date.now(),
-                    repo: args.repo,
-                    events,
-                    target_id: commMessage.$channel?.id,
-                    target_type: commMessage.$channel?.type || 'private',
-                    adapter: commMessage.$adapter,
-                    endpoint: commMessage.$endpoint,
-                });
-                return `✅ 已订阅 ${args.repo}\n📡 事件: ${events.join(', ')}\n📌 通知将推送到当前通道`;
-            },
-        },
-        // --- Unsubscribe ---
-        {
-            name: 'github_unsubscribe',
-            description: '取消订阅 GitHub 仓库的 Webhook 事件',
-            parameters: {
-                type: 'object',
-                properties: {
-                    repo: { type: 'string', description: 'owner/repo (必填)' },
-                },
-                required: ['repo'],
-            },
-            platforms: ['github'],
-            tags: ['github'],
-            execute: async (args, commMessage) => {
-                if (!commMessage?.$adapter || !commMessage?.$channel?.id || !commMessage?.$endpoint) {
-                    return '❌ 无法获取当前聊天通道信息';
-                }
-                const db = plugin.root?.inject('database');
-                const model = db?.models?.get('github_subscriptions');
-                if (!model)
-                    return '❌ 数据库未就绪';
-                const [existing] = await model.select().where({
-                    repo: args.repo,
-                    target_id: commMessage.$channel?.id,
-                    adapter: commMessage.$adapter,
-                    endpoint: commMessage.$endpoint,
-                });
-                if (!existing)
-                    return `📭 当前通道未订阅 ${args.repo}`;
-                await model.delete().where({ id: existing.id });
-                return `✅ 已取消订阅 ${args.repo}`;
-            },
-        },
-        // --- Subscriptions ---
-        {
-            name: 'github_subscriptions',
-            description: '查看当前聊天通道的 GitHub 仓库订阅列表',
-            parameters: {
-                type: 'object',
-                properties: {},
-            },
-            platforms: ['github'],
-            tags: ['github'],
-            execute: async (_args, commMessage) => {
-                if (!commMessage?.$adapter || !commMessage?.$channel?.id || !commMessage?.$endpoint) {
-                    return '❌ 无法获取当前聊天通道信息';
-                }
-                const db = plugin.root?.inject('database');
-                const model = db?.models?.get('github_subscriptions');
-                if (!model)
-                    return '❌ 数据库未就绪';
-                const subs = await model.select().where({
-                    target_id: commMessage.$channel?.id,
-                    adapter: commMessage.$adapter,
-                    endpoint: commMessage.$endpoint,
-                });
-                if (!subs?.length)
-                    return '📭 当前通道没有任何 GitHub 订阅';
-                return `📋 当前通道订阅 (${subs.length}):\n\n` +
-                    subs.map((s) => {
-                        const events = Array.isArray(s.events) ? s.events : [];
-                        return `  📦 ${s.repo}\n     📡 ${events.join(', ') || '(无事件)'}`;
-                    }).join('\n\n');
-            },
-        },
-    ];
-    const disposers = tools.map(t => toolService.addTool(t, plugin.name));
-    logger.debug(`GitHub 工具已注册: ${tools.map(t => t.name).join(', ')}`);
-    return () => disposers.forEach(d => d());
-});
-logger.debug('GitHub 适配器已加载 (gh CLI 认证)');
-//# sourceMappingURL=index.js.map
+export { GithubClient, githubClient } from './client.js';
+export { WorkspaceManager } from './workspace-manager.js';
+export { parseMessageChannel, issueBranchName, resolveWorkspaceBranch, formatChannelContext, } from './github-channel-context.js';
+export { GithubEndpoint, defaultCreateClient, } from './endpoint.js';
+export { GITHUB_OAUTH_USERS_TABLE, GITHUB_OAUTH_USERS_SCHEMA, defineGithubOauthUsersTable, lookupGithubOauthAccessToken, } from './oauth-users.js';
+export { registerGithubWebhookRoutes, handleGithubWebhookRequest, dispatchGithubWebhookPayload, } from './webhook.js';

package/lib/oauth-users.d.ts

@@ -0,0 +1,33 @@
+import type { DatabaseHost, PluginDatabaseHost } from 'zhin.js';
+export declare const GITHUB_OAUTH_USERS_TABLE = "github_oauth_users";
+export declare const GITHUB_OAUTH_USERS_SCHEMA: {
+    readonly id: {
+        readonly type: "integer";
+        readonly primary: true;
+    };
+    readonly platform: {
+        readonly type: "text";
+        readonly nullable: false;
+    };
+    readonly platform_uid: {
+        readonly type: "text";
+        readonly nullable: false;
+    };
+    readonly github_login: {
+        readonly type: "text";
+        readonly nullable: false;
+    };
+    readonly access_token: {
+        readonly type: "text";
+        readonly nullable: false;
+    };
+    readonly created_at: {
+        readonly type: "integer";
+        readonly nullable: false;
+    };
+};
+export declare function defineGithubOauthUsersTable(host: {
+    define(name: string, definition: Record<string, unknown>): void;
+}): void;
+/** Resolve a stored PAT/device-flow token; null when DB missing or no row. */
+export declare function lookupGithubOauthAccessToken(database: DatabaseHost | PluginDatabaseHost | undefined, platform: string, platformUid: string): Promise<string | null>;

package/lib/oauth-users.js

@@ -0,0 +1,38 @@
+/**
+ * github_oauth_users — SSOT for Runtime user-token binding (gh bind / Endpoint lookup).
+ */
+import { formatCompact, getLogger } from '@zhin.js/logger';
+const logger = getLogger('github');
+export const GITHUB_OAUTH_USERS_TABLE = 'github_oauth_users';
+export const GITHUB_OAUTH_USERS_SCHEMA = {
+    id: { type: 'integer', primary: true },
+    platform: { type: 'text', nullable: false },
+    platform_uid: { type: 'text', nullable: false },
+    github_login: { type: 'text', nullable: false },
+    access_token: { type: 'text', nullable: false },
+    created_at: { type: 'integer', nullable: false },
+};
+export function defineGithubOauthUsersTable(host) {
+    host.define(GITHUB_OAUTH_USERS_TABLE, { ...GITHUB_OAUTH_USERS_SCHEMA });
+}
+/** Resolve a stored PAT/device-flow token; null when DB missing or no row. */
+export async function lookupGithubOauthAccessToken(database, platform, platformUid) {
+    if (!database?.started)
+        return null;
+    const model = database.models.get(GITHUB_OAUTH_USERS_TABLE);
+    if (!model)
+        return null;
+    try {
+        const rows = await model.select().where({ platform, platform_uid: platformUid });
+        const token = rows[0]?.access_token;
+        return typeof token === 'string' && token.trim() ? token : null;
+    }
+    catch (error) {
+        logger.debug(formatCompact({
+            op: 'oauth_lookup_fail',
+            platform,
+            error: error instanceof Error ? error.message : String(error),
+        }));
+        return null;
+    }
+}

package/lib/protocol.d.ts

@@ -0,0 +1,94 @@
+/**
+ * GitHub webhook / comment helpers — no legacy Adapter/Endpoint / segment-mapper.
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ */
+import type { IncomingMessage } from 'node:http';
+import type { ConversationRef } from '@zhin.js/im-contract';
+import { type GenericWebhookPayload, type IssueCommentPayload, type PRReviewCommentPayload, type PRReviewPayload } from './types.js';
+export type { EventType, GenericWebhookPayload, GitHubComment, GitHubEndpointConfig, GitHubIssue, GitHubOAuthUser, GitHubPR, GitHubRepo, GitHubUser, IssueCommentPayload, ParsedChannel, PRReviewCommentPayload, PRReviewPayload, Subscription, } from './types.js';
+export { buildChannelId, parseChannelId } from './types.js';
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface GithubAdapterConfig {
+    readonly id?: string;
+    readonly host?: string;
+    readonly app_id?: string | number;
+    readonly appId?: string | number;
+    readonly private_key?: string;
+    readonly privateKey?: string;
+    readonly webhook_secret?: string;
+    readonly webhookSecret?: string;
+    readonly webhook_path?: string;
+    readonly webhookPath?: string;
+    readonly poll_interval?: number;
+    readonly pollInterval?: number;
+    readonly auto_reply_repos?: readonly string[];
+    readonly autoReplyRepos?: readonly string[];
+    readonly bot_login?: string;
+    readonly botLogin?: string;
+    readonly workspace_root?: string;
+    readonly workspaceRoot?: string;
+    /** Transitional: legacy root `endpoints[]` with `context: github`. */
+    readonly endpoints?: ReadonlyArray<Partial<ResolvedGithubConfig> & {
+        readonly context?: string;
+        readonly app_id?: string | number;
+        readonly private_key?: string;
+        readonly webhook_secret?: string;
+        readonly webhook_path?: string;
+        readonly poll_interval?: number;
+        readonly auto_reply_repos?: readonly string[];
+        readonly bot_login?: string;
+        readonly workspace_root?: string;
+    }>;
+}
+export interface ResolvedGithubConfig {
+    readonly context: 'github';
+    readonly id: string;
+    readonly host?: string;
+    readonly appId?: string | number;
+    readonly privateKey?: string;
+    readonly webhookSecret?: string;
+    readonly webhookPath: string;
+    readonly pollInterval: number;
+    readonly autoReplyRepos: readonly string[];
+    readonly botLogin?: string;
+    readonly workspaceRoot?: string;
+}
+export interface GithubWireSegment {
+    readonly type: string;
+    readonly data?: Record<string, unknown>;
+}
+export interface GithubInboundComment {
+    readonly id: string;
+    readonly channelId: string;
+    readonly sender: string;
+    readonly content: string;
+    readonly repo: string;
+    readonly kind: 'issue_comment' | 'pr_review_comment' | 'pr_review';
+    readonly createdAt: number;
+}
+/**
+ * 入站归一化 → ConversationRef：Issue/PR 评论区即仓库容器内的 channel 会话，
+ * 仓库（owner/repo）进 `parent`。出站侧用 `parseChannelId(conversation.id)`
+ * 在平台边界还原 repo/type/number。
+ */
+export declare function githubInboundConversation(endpointKey: string, comment: GithubInboundComment): ConversationRef;
+export declare function resolveGithubConfig(config?: GithubAdapterConfig): ResolvedGithubConfig;
+export declare function normalizeWebhookPath(path: string): string;
+export declare function shouldAutoReplyRepo(config: Pick<ResolvedGithubConfig, 'autoReplyRepos'>, repo: string): boolean;
+/** Prepend synthetic @bot for auto_reply repos (gateway text path). */
+export declare function enrichInboundContent(content: string, config: Pick<ResolvedGithubConfig, 'autoReplyRepos' | 'botLogin'>, botLogin: string | undefined, repo: string): string;
+/** Build inbound text for OutboundMessageService.receive from markdown/comment body. */
+export declare function formatInboundContent(body: string): string;
+/** Build markdown body for Issue/PR comment send. */
+export declare function formatOutboundBody(payload: unknown): string;
+export declare function verifyWebhookSignature(secret: string, rawBody: string, signatureHeader: string | undefined): boolean;
+export declare function headerValue(headers: IncomingMessage['headers'], name: string): string;
+export declare function readTextBody(request: IncomingMessage, options?: {
+    readonly limit?: number;
+}): Promise<string>;
+export declare function parseIssueCommentInbound(payload: IssueCommentPayload): GithubInboundComment | null;
+export declare function parsePrReviewCommentInbound(payload: PRReviewCommentPayload): GithubInboundComment | null;
+export declare function parsePrReviewInbound(payload: PRReviewPayload): GithubInboundComment | null;
+export declare function formatNotification(event: string, p: GenericWebhookPayload): string;
+/** Parse @mentions in markdown into a flat display string (gateway text path). */
+export declare function parseMarkdownMentions(md: string): string;