@zhin.js/adapter-github 6.0.0 → 6.0.2

package/lib/endpoint.js

@@ -1,96 +1,55 @@
-/**
- * GithubEndpoint — lifecycle, outbound send, inbound admit.
- */
-import path from 'node:path';
+import { Endpoint } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { GhClient } from './gh-client.js';
-import { registerGithubAgentEndpoint } from './github-agent-deps.js';
-import { lookupGithubOauthAccessToken } from './oauth-users.js';
 import { enrichInboundContent, formatInboundContent, formatOutboundBody, githubInboundConversation, parseChannelId, } from './protocol.js';
 import { registerGithubWebhookRoutes } from './webhook.js';
-import { WorkspaceManager } from './workspace-manager.js';
+import { GithubClient } from './client.js';
 /**
  * GitHub 是代码协作面（issue/PR），无好友/群/频道等 IM 社交概念，
  * 不适用 EndpointManagement 语义端口；本 endpoint 不暴露该端口。
  */
-export class GithubEndpoint {
+export class GithubEndpoint extends Endpoint {
     #logger;
     #options;
-    gh;
-    config;
-    name;
-    #workspaceManager = null;
+    client;
     #routeReleases = [];
     #open = false;
     #started = false;
-    #unregisterAgent;
     constructor(options) {
+        super();
         this.#logger = getAdapterLogger('github', options.config.id);
         this.#options = options;
-        this.config = options.config;
-        this.name = options.config.id;
-        this.gh = options.createClient?.(options.config) ?? defaultCreateClient(options.config);
-    }
-    getAPI() {
-        return this.gh;
-    }
-    async getUserOrDefaultAPI(platform, platformUid) {
-        if (platform && platformUid) {
-            const token = await lookupGithubOauthAccessToken(this.#options.database, platform, platformUid);
-            if (token)
-                return this.gh.withToken(token);
-        }
-        return this.gh;
-    }
-    getClientId() {
-        return this.gh.clientId || null;
-    }
-    getHost() {
-        return this.config.host;
-    }
-    getAppSlug() {
-        return this.gh.appSlug || null;
+        const api = options.createClient?.(options.config) ?? defaultCreateClient(options.config);
+        this.client = new GithubClient(options.config.id, api, options.config, options.database);
     }
-    getInstallations() {
-        return this.gh.installations || [];
-    }
-    getWorkspaceManager() {
-        if (this.#workspaceManager)
-            return this.#workspaceManager;
-        const workspaceRoot = this.config.workspaceRoot
-            ?? path.join(process.cwd(), 'data', 'github-workspaces');
-        this.#workspaceManager = new WorkspaceManager(this.gh, workspaceRoot);
-        return this.#workspaceManager;
-    }
-    getDatabase() {
-        return this.#options.database;
+    get config() {
+        return this.client.config;
     }
     async start() {
         if (this.#started)
             return;
         this.#started = true;
         try {
-            const result = await this.gh.verifyAuth();
+            const result = await this.client.api.verifyAuth();
             if (!result.ok)
                 throw new Error(`GitHub 认证失败: ${result.message}`);
-            this.#unregisterAgent = registerGithubAgentEndpoint(this.name, this);
-            if (this.config.webhookSecret) {
+            if (this.client.config.webhookSecret) {
                 if (!this.#options.http) {
                     throw new TypeError('GitHub webhook_secret requires httpHostToken');
                 }
                 this.#routeReleases.push(...registerGithubWebhookRoutes(this.#options.http, this));
                 this.#logger.debug(formatCompact({
-                    endpoint: this.name,
+                    endpoint: this.client.name,
                     op: 'webhook',
-                    path: this.config.webhookPath,
+                    path: this.client.config.webhookPath,
                 }));
             }
             else {
                 this.#logger.debug(formatCompact({
-                    endpoint: this.name,
+                    endpoint: this.client.name,
                     op: 'connect',
                     mode: 'api-only',
-                    bot: this.gh.authenticatedUser,
+                    bot: this.client.api.authenticatedUser,
                 }));
             }
         }
@@ -110,8 +69,6 @@ export class GithubEndpoint {
         this.#open = false;
         for (const release of this.#routeReleases.splice(0))
             release();
-        this.#unregisterAgent?.();
-        this.#unregisterAgent = undefined;
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
@@ -121,13 +78,13 @@ export class GithubEndpoint {
             throw new Error(`无效的 GitHub conversation ID: ${conversation.id}`);
         const text = formatOutboundBody(payload);
         const r = parsed.type === 'issue'
-            ? await this.gh.createIssueComment(parsed.repo, parsed.number, text)
-            : await this.gh.createPRComment(parsed.repo, parsed.number, text);
+            ? await this.client.api.createIssueComment(parsed.repo, parsed.number, text)
+            : await this.client.api.createPRComment(parsed.repo, parsed.number, text);
         if (!r.ok)
             throw new Error(`发送失败: ${JSON.stringify(r.data)}`);
         this.#logger.debug(formatCompact({
             op: 'github_send',
-            endpoint: this.name,
+            endpoint: this.client.name,
             target: `${conversation.kind}:${conversation.id}`,
             messageId: r.data.id,
         }));
@@ -137,17 +94,19 @@ export class GithubEndpoint {
     admit(comment) {
         if (!this.#open)
             return;
-        const botUser = this.config.botLogin || this.gh.getBotLogin() || this.gh.authenticatedUser;
+        const botUser = this.client.config.botLogin
+            || this.client.api.getBotLogin()
+            || this.client.api.authenticatedUser;
         if (botUser && comment.sender === botUser)
             return;
         const conversation = githubInboundConversation(String(this.#options.id), comment);
-        const content = enrichInboundContent(formatInboundContent(comment.content), this.config, botUser ?? undefined, comment.repo);
-        void this.#options.gateway.receive({
+        const content = enrichInboundContent(formatInboundContent(comment.content), this.client.config, botUser ?? undefined, comment.repo);
+        void this.emit('message.receive', {
             conversation,
             message: { conversation, id: comment.id },
             content,
             sender: { id: comment.sender, name: comment.sender },
-            endpointId: this.name,
+            endpointId: this.client.name,
             metadata: Object.freeze({
                 repo: comment.repo,
                 kind: comment.kind,
@@ -161,6 +120,17 @@ export class GithubEndpoint {
             }));
         });
     }
+    admitPlatform(name, event) {
+        if (!this.#open)
+            return;
+        void this.emitPlatform(name, event).catch((error) => {
+            this.#logger.warn(formatCompact({
+                op: 'github_platform_event_failed',
+                event: name,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
+    }
 }
 export function defaultCreateClient(config) {
     const appAuth = config.appId && config.privateKey

package/lib/github-bot-handlers.d.ts

@@ -2,25 +2,26 @@
  * GitHub App Bot workflow handlers (Installation Token identity).
  */
 import type { Message } from 'zhin.js';
+import type { GithubClient } from './client.js';
 export declare function executeGithubPrepareWorkspace(args: {
     repo?: string;
-}, commMessage?: Message): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;
 export declare function executeGithubPatchFile(args: {
     repo?: string;
     path: string;
     content: string;
     message: string;
     branch?: string;
-}, commMessage?: Message): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;
 export declare function executeGithubPushBranch(args: {
     repo?: string;
     branch?: string;
     message: string;
-}, commMessage?: Message): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;
 export declare function executeGithubCreatePr(args: {
     repo?: string;
     title: string;
     body?: string;
     head?: string;
     base?: string;
-}, commMessage?: Message): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;

package/lib/github-bot-handlers.js

@@ -1,8 +1,7 @@
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
-import { getAdapter, getGithubAgentDeps } from './github-agent-deps.js';
 import { parseMessageChannel, resolveWorkspaceBranch, formatChannelContext, } from './github-channel-context.js';
-function requireBotGh() {
-    const gh = getAdapter().getAPI();
+function requireBotGh(client) {
+    const gh = client.api;
     if (!gh?.isAppAuth) {
         throw new Error('需要 GitHub App 认证（app_id + private_key），Bot 写操作不可用');
     }
@@ -23,11 +22,11 @@ function resolveChannel(msg, repo) {
     }
     throw new Error('无法解析 GitHub 频道（需要 Issue/PR 评论上下文）');
 }
-export async function executeGithubPrepareWorkspace(args, commMessage) {
+export async function executeGithubPrepareWorkspace(args, client, commMessage) {
     const msg = resolveCommMessage(commMessage);
     const ctx = resolveChannel(msg, args.repo);
-    const gh = requireBotGh();
-    const wm = getGithubAgentDeps().getWorkspaceManager();
+    const gh = requireBotGh(client);
+    const wm = client.workspaceManager;
     const { branch, base } = await resolveWorkspaceBranch(gh, ctx);
     const repoPath = await wm.checkoutBranch(ctx.repo, branch, base);
     return [
@@ -37,10 +36,10 @@ export async function executeGithubPrepareWorkspace(args, commMessage) {
         `📍 ${formatChannelContext(ctx)}`,
     ].join('\n');
 }
-export async function executeGithubPatchFile(args, commMessage) {
+export async function executeGithubPatchFile(args, client, commMessage) {
     const msg = resolveCommMessage(commMessage);
     const ctx = resolveChannel(msg, args.repo);
-    const gh = requireBotGh();
+    const gh = requireBotGh(client);
     const { branch } = args.branch
         ? { branch: args.branch }
         : await resolveWorkspaceBranch(gh, ctx);
@@ -53,19 +52,19 @@ export async function executeGithubPatchFile(args, commMessage) {
     const url = r.data.content?.html_url ?? r.data.commit?.html_url ?? '';
     return `✅ 已更新 \`${args.path}\` @ \`${branch}\`${url ? `\n🔗 ${url}` : ''}`;
 }
-export async function executeGithubPushBranch(args, commMessage) {
+export async function executeGithubPushBranch(args, client, commMessage) {
     const msg = resolveCommMessage(commMessage);
     const ctx = resolveChannel(msg, args.repo);
-    const gh = requireBotGh();
-    const wm = getGithubAgentDeps().getWorkspaceManager();
+    const gh = requireBotGh(client);
+    const wm = client.workspaceManager;
     const branch = args.branch ?? (await resolveWorkspaceBranch(gh, ctx)).branch;
     const result = await wm.commitAndPush(ctx.repo, branch, args.message);
     return `✅ ${result}\n📍 ${ctx.repo} @ \`${branch}\``;
 }
-export async function executeGithubCreatePr(args, commMessage) {
+export async function executeGithubCreatePr(args, client, commMessage) {
     const msg = resolveCommMessage(commMessage);
     const ctx = resolveChannel(msg, args.repo);
-    const gh = requireBotGh();
+    const gh = requireBotGh(client);
     const resolved = await resolveWorkspaceBranch(gh, ctx);
     const head = args.head ?? resolved.branch;
     const base = args.base ?? resolved.base;

package/lib/github-endpoint-commands.d.ts

@@ -1 +1 @@
-export declare const githubEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage>>>;
+export declare const githubEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage, string | undefined>>>;

package/lib/github-tool-handlers.d.ts

@@ -1,17 +1,18 @@
 import type { Message } from 'zhin.js';
+import type { GithubClient } from './client.js';
 export declare function executeGithubStar(args: {
     action: 'star' | 'unstar' | 'check';
     repo: string;
-}, commMessage?: Message): Promise<string>;
-export declare function executeGithubBind(_args: Record<string, never>, commMessage?: Message): Promise<string>;
-export declare function executeGithubUnbind(_args: Record<string, never>, commMessage?: Message): Promise<string>;
-export declare function executeGithubWhoami(_args: Record<string, never>, commMessage?: Message): Promise<string>;
-export declare function executeGithubInstall(): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;
+export declare function executeGithubBind(_args: Record<string, never>, client: GithubClient, commMessage?: Message): Promise<string>;
+export declare function executeGithubUnbind(_args: Record<string, never>, client: GithubClient, commMessage?: Message): Promise<string>;
+export declare function executeGithubWhoami(_args: Record<string, never>, client: GithubClient, commMessage?: Message): Promise<string>;
+export declare function executeGithubInstall(client: GithubClient): Promise<string>;
 export declare function executeGithubSubscribe(args: {
     repo: string;
     events?: string;
-}, commMessage?: Message): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;
 export declare function executeGithubUnsubscribe(args: {
     repo: string;
-}, commMessage?: Message): Promise<string>;
-export declare function executeGithubSubscriptions(_args: Record<string, never>, commMessage?: Message): Promise<string>;
+}, client: GithubClient, commMessage?: Message): Promise<string>;
+export declare function executeGithubSubscriptions(_args: Record<string, never>, client: GithubClient, commMessage?: Message): Promise<string>;

package/lib/github-tool-handlers.js

@@ -1,28 +1,24 @@
 import { formatCompact } from '@zhin.js/logger';
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
 import { GhClient } from './gh-client.js';
-import { getAdapter, getGithubAgentDeps } from './github-agent-deps.js';
-function oauthModel() {
-    const db = getGithubAgentDeps().getDatabase?.();
+function oauthModel(client) {
+    const db = client.database;
     return db?.models?.get('github_oauth_users');
 }
-function subscriptionsModel() {
-    const db = getGithubAgentDeps().getDatabase?.();
+function subscriptionsModel(client) {
+    const db = client.database;
     return db?.models?.get('github_subscriptions');
 }
 function depsLogger() {
-    return getGithubAgentDeps().logger ?? {
+    return {
         debug: (...args) => console.debug(...args),
         warn: (...args) => console.warn(...args),
         error: (...args) => console.error(...args),
     };
 }
-export async function executeGithubStar(args, commMessage) {
-    const adapter = getAdapter();
+export async function executeGithubStar(args, client, commMessage) {
     const msg = commMessage ?? getCurrentCommMessage();
-    const gh = await adapter.getUserOrDefaultAPI(msg?.$adapter, msg?.$sender.id);
-    if (!gh)
-        return '❌ 没有可用的 GitHub bot';
+    const gh = await client.getUserOrDefaultApi(msg?.$adapter, msg?.$sender.id);
     switch (args.action) {
         case 'star': {
             const r = await gh.starRepo(args.repo);
@@ -40,16 +36,15 @@ export async function executeGithubStar(args, commMessage) {
             return `❌ 未知操作: ${args.action}`;
     }
 }
-export async function executeGithubBind(_args, commMessage) {
-    const adapter = getAdapter();
+export async function executeGithubBind(_args, client, commMessage) {
     const log = depsLogger();
     const msg = commMessage ?? getCurrentCommMessage();
     if (!msg?.$adapter || !msg?.$sender?.id)
         return '❌ 无法获取当前用户信息';
-    const clientId = adapter.getClientId();
+    const clientId = client.clientId;
     if (!clientId)
         return '❌ Endpoint 未配置 GitHub App 或 App 无 client_id，无法进行账号绑定';
-    const model = oauthModel();
+    const model = oauthModel(client);
     if (!model)
         return '❌ 数据库未就绪';
     const [existing] = await model.select().where({ platform: msg.$adapter, platform_uid: msg.$sender.id });
@@ -57,7 +52,7 @@ export async function executeGithubBind(_args, commMessage) {
         return `⚠️ 你已绑定 GitHub 账号: ${existing.github_login}\n如需重新绑定，请先执行 github_unbind`;
     }
     try {
-        const host = adapter.getHost();
+        const host = client.host;
         const codeResp = await GhClient.deviceFlowRequestCode(clientId, host);
         const tokenPromise = GhClient.deviceFlowPollToken(clientId, codeResp.device_code, codeResp.interval, codeResp.expires_in, host);
         const replyMsg = [
@@ -97,11 +92,11 @@ export async function executeGithubBind(_args, commMessage) {
         return `❌ Device Flow 启动失败: ${e instanceof Error ? e.message : String(e)}`;
     }
 }
-export async function executeGithubUnbind(_args, commMessage) {
+export async function executeGithubUnbind(_args, client, commMessage) {
     const msg = commMessage ?? getCurrentCommMessage();
     if (!msg?.$adapter || !msg?.$sender?.id)
         return '❌ 无法获取当前用户信息';
-    const model = oauthModel();
+    const model = oauthModel(client);
     if (!model)
         return '❌ 数据库未就绪';
     const [existing] = await model.select().where({ platform: msg.$adapter, platform_uid: msg.$sender.id });
@@ -110,31 +105,29 @@ export async function executeGithubUnbind(_args, commMessage) {
     await model.delete().where({ id: existing.id });
     return `✅ 已解除 GitHub 账号绑定: ${existing.github_login}`;
 }
-export async function executeGithubWhoami(_args, commMessage) {
-    const adapter = getAdapter();
+export async function executeGithubWhoami(_args, client, commMessage) {
     const msg = commMessage ?? getCurrentCommMessage();
     if (!msg?.$adapter || !msg?.$sender?.id)
         return '❌ 无法获取当前用户信息';
-    const model = oauthModel();
+    const model = oauthModel(client);
     if (!model)
         return '❌ 数据库未就绪';
     const [existing] = await model.select().where({ platform: msg.$adapter, platform_uid: msg.$sender.id });
     if (!existing)
         return '📭 你尚未绑定 GitHub 账号\n🔗 使用 github_bind 绑定你的账号';
-    const userGh = new GhClient({ host: adapter.getHost(), token: existing.access_token });
+    const userGh = new GhClient({ host: client.host, 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`;
 }
-export async function executeGithubInstall() {
-    const adapter = getAdapter();
-    const slug = adapter.getAppSlug();
+export async function executeGithubInstall(client) {
+    const slug = client.appSlug;
     if (!slug)
         return '❌ Endpoint 未配置 GitHub App';
-    const host = adapter.getHost() || 'github.com';
-    const installations = adapter.getInstallations();
+    const host = client.host || 'github.com';
+    const installations = client.installations;
     let msg = `🔗 请点击以下链接安装 GitHub App 到你的仓库：\n   https://${host}/apps/${slug}/installations/new`;
     if (installations.length) {
         msg += `\n\n📋 当前已安装 (${installations.length}):`;
@@ -144,12 +137,12 @@ export async function executeGithubInstall() {
     }
     return msg;
 }
-export async function executeGithubSubscribe(args, commMessage) {
+export async function executeGithubSubscribe(args, client, commMessage) {
     const msg = commMessage ?? getCurrentCommMessage();
     if (!msg?.$adapter || !msg?.$sender.id || !msg?.$channel?.id || !msg?.$endpoint) {
         return '❌ 无法获取当前聊天通道信息';
     }
-    const model = subscriptionsModel();
+    const model = subscriptionsModel(client);
     if (!model)
         return '❌ 数据库未就绪';
     const validEvents = ['push', 'issue', 'star', 'fork', 'unstar', 'pull_request'];
@@ -179,12 +172,12 @@ export async function executeGithubSubscribe(args, commMessage) {
     });
     return `✅ 已订阅 ${args.repo}\n📡 事件: ${events.join(', ')}\n📌 通知将推送到当前通道`;
 }
-export async function executeGithubUnsubscribe(args, commMessage) {
+export async function executeGithubUnsubscribe(args, client, commMessage) {
     const msg = commMessage ?? getCurrentCommMessage();
     if (!msg?.$adapter || !msg?.$channel?.id || !msg?.$endpoint) {
         return '❌ 无法获取当前聊天通道信息';
     }
-    const model = subscriptionsModel();
+    const model = subscriptionsModel(client);
     if (!model)
         return '❌ 数据库未就绪';
     const [existing] = await model.select().where({
@@ -198,12 +191,12 @@ export async function executeGithubUnsubscribe(args, commMessage) {
     await model.delete().where({ id: existing.id });
     return `✅ 已取消订阅 ${args.repo}`;
 }
-export async function executeGithubSubscriptions(_args, commMessage) {
+export async function executeGithubSubscriptions(_args, client, commMessage) {
     const msg = commMessage ?? getCurrentCommMessage();
     if (!msg?.$adapter || !msg?.$channel?.id || !msg?.$endpoint) {
         return '❌ 无法获取当前聊天通道信息';
     }
-    const model = subscriptionsModel();
+    const model = subscriptionsModel(client);
     if (!model)
         return '❌ 数据库未就绪';
     const subs = await model.select().where({

package/lib/index.d.ts

@@ -1,7 +1,7 @@
 export { buildChannelId, enrichInboundContent, formatInboundContent, formatNotification, formatOutboundBody, normalizeWebhookPath, parseChannelId, parseIssueCommentInbound, parsePrReviewCommentInbound, parsePrReviewInbound, resolveGithubConfig, shouldAutoReplyRepo, verifyWebhookSignature, type GithubAdapterConfig, type GithubInboundComment, type GithubWireSegment, type ResolvedGithubConfig, } from './protocol.js';
 export * from './types.js';
-export { getAdapter, getGithubAgentDeps, registerGithubAgentEndpoint, setGithubAgentDeps, type GithubAgentDeps, type GithubAgentEndpoint, } from './github-agent-deps.js';
 export { GhClient } from './gh-client.js';
+export { GithubClient, githubClient, type GithubClientEventMap } from './client.js';
 export { WorkspaceManager } from './workspace-manager.js';
 export { parseMessageChannel, issueBranchName, resolveWorkspaceBranch, formatChannelContext, } from './github-channel-context.js';
 export { GithubEndpoint, defaultCreateClient, type GithubEndpointOptions, } from './endpoint.js';

package/lib/index.js

@@ -1,7 +1,7 @@
 export { buildChannelId, enrichInboundContent, formatInboundContent, formatNotification, formatOutboundBody, normalizeWebhookPath, parseChannelId, parseIssueCommentInbound, parsePrReviewCommentInbound, parsePrReviewInbound, resolveGithubConfig, shouldAutoReplyRepo, verifyWebhookSignature, } from './protocol.js';
 export * from './types.js';
-export { getAdapter, getGithubAgentDeps, registerGithubAgentEndpoint, setGithubAgentDeps, } from './github-agent-deps.js';
 export { GhClient } from './gh-client.js';
+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';

package/lib/protocol.d.ts

@@ -77,7 +77,7 @@ 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 MessageGateway.receive from markdown/comment body. */
+/** 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;

package/lib/protocol.js

@@ -83,7 +83,7 @@ export function enrichInboundContent(content, config, botLogin, repo) {
         return content;
     return `@${login} ${content}`;
 }
-/** Build inbound text for MessageGateway.receive from markdown/comment body. */
+/** Build inbound text for OutboundMessageService.receive from markdown/comment body. */
 export function formatInboundContent(body) {
     return body;
 }

package/lib/webhook.d.ts

@@ -6,6 +6,7 @@ import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { type GithubInboundComment, type ResolvedGithubConfig } from './protocol.js';
 export interface GithubWebhookHandler {
     readonly config: ResolvedGithubConfig;
+    admitPlatform(name: string, event: unknown): void;
     admit(comment: GithubInboundComment): void;
 }
 export declare function registerGithubWebhookRoutes(http: HttpHost, handler: GithubWebhookHandler): HttpRouteRegistration[];

package/lib/webhook.js

@@ -66,6 +66,7 @@ export async function dispatchGithubWebhookPayload(event, payload, handler) {
     const body = payload;
     const repo = body.repository?.full_name;
     logger.debug(`Webhook: ${event}${body.action ? `.${body.action}` : ''} ${repo || ''}`);
+    handler.admitPlatform(typeof body.action === 'string' && body.action ? `${event}.${body.action}` : event, payload);
     if (event === 'issue_comment') {
         const inbound = parseIssueCommentInbound(payload);
         if (inbound)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-github",
-  "version": "6.0.0",
+  "version": "6.0.2",
   "description": "Zhin.js GitHub adapter for Plugin Runtime (App auth + webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -41,20 +41,22 @@
     "directory": "plugins/adapters/github"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.2.0",
-    "@zhin.js/core": "1.5.13",
-    "@zhin.js/host-http": "1.0.12",
+    "@zhin.js/adapter": "1.2.1",
+    "@zhin.js/core": "1.5.14",
+    "@zhin.js/feature-kit": "1.0.13",
+    "@zhin.js/host-http": "1.0.13",
     "@zhin.js/im-contract": "1.0.4",
-    "@zhin.js/logger": "1.0.76"
+    "@zhin.js/logger": "1.0.77"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.2.0",
-    "@zhin.js/agent": "1.1.15",
-    "@zhin.js/command": "1.0.15",
-    "@zhin.js/core": "1.5.13",
-    "@zhin.js/host-http": "1.0.12",
-    "zhin.js": "6.0.13"
+    "@zhin.js/adapter": "1.2.1",
+    "@zhin.js/agent": "1.1.17",
+    "@zhin.js/command": "1.0.16",
+    "@zhin.js/core": "1.5.14",
+    "@zhin.js/host-http": "1.0.13",
+    "@zhin.js/prompt-section": "0.0.1",
+    "zhin.js": "6.0.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -63,6 +65,9 @@
     "@zhin.js/command": {
       "optional": true
     },
+    "@zhin.js/prompt-section": {
+      "optional": true
+    },
     "zhin.js": {
       "optional": true
     },
@@ -75,8 +80,9 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.15",
-    "zhin.js": "6.0.13"
+    "@zhin.js/agent": "1.1.17",
+    "@zhin.js/prompt-section": "0.0.1",
+    "zhin.js": "6.0.14"
   },
   "files": [
     "adapters",

package/plugin.js

@@ -34,22 +34,5 @@ export default definePlugin({
             defineGithubOauthUsersTable(host);
             host.define('github_subscriptions', { ...GITHUB_SUBSCRIPTIONS_SCHEMA });
         }
-        // Agent prompt contributor (orchestrator/deferred-worker GitHub guidance).
-        // `zhin.js/agent` is an optional peer — skip silently on IM-only installs.
-        let cancelled = false;
-        let unregister;
-        void Promise.all([
-            import('zhin.js/agent'),
-            import("./lib/agent-prompt.js"),
-        ]).then(([agent, prompt]) => {
-            if (cancelled)
-                return;
-            agent.registerAgentPromptContributor(prompt.createGithubAgentPromptContributor());
-            unregister = () => agent.unregisterAgentPromptContributor('github');
-        }).catch(() => { });
-        return () => {
-            cancelled = true;
-            unregister?.();
-        };
     },
 });