@zhin.js/adapter-github 1.1.0 → 1.1.2

package/{agent/tools/unsubscribe.ts → agents/github/skills/github-subscriptions/tools/unsubscribe/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubUnsubscribe } from '../../src/github-tool-handlers.js';
+import { executeGithubUnsubscribe } from '../../handlers.js';
 
 export default defineAgentTool<{ repo: string }>({
   description: '取消订阅 GitHub 仓库的 Webhook 事件',
@@ -10,6 +10,6 @@ export default defineAgentTool<{ repo: string }>({
   adapter: 'github',
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubUnsubscribe(input, context.$client, context.message);
+    return executeGithubUnsubscribe(input, context.$client);
   },
 });

package/agents/github/system.md

@@ -0,0 +1,3 @@
+# GITHUB Platform Agent
+
+You are the github platform specialist. Interpret requests in the current github conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[id].js → github/endpoint/add/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { githubEndpointCommands } from "../../../lib/github-endpoint-commands.js";
+import { githubEndpointCommands } from '../../definition.js';
 export default githubEndpointCommands.add;

package/commands/github/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { githubEndpointCommands } from '../../definition.js';
+
+export default githubEndpointCommands.add;

package/{lib/github-endpoint-commands.js → commands/github/endpoint/definition.js}

@@ -1,14 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * `github.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `github endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/github/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  *
  * 字段说明：private_key 内容长且含换行，不适合 kv 直传——运行时（gh-client
  * resolvePrivateKey）本就支持 PEM 内容或文件路径，故 add 采用**内联路径**形式：
- * `github.endpoint add mybot app_id=123456 private_key=./data/mybot.pem`。
+ * `github endpoint add mybot app_id=123456 private_key=./data/mybot.pem`。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { githubRuntimeStateToken } from './github-runtime-state.js';
+import { githubRuntimeStateToken } from "../../../lib/github-runtime-state.js";
 export const githubEndpointCommands = createEndpointCommands({
     adapterKey: 'github',
     adapterDisplayName: 'GitHub',
@@ -18,5 +19,5 @@ export const githubEndpointCommands = createEndpointCommands({
         { key: 'webhook_secret', env: true, description: 'webhook 签名密钥（不配则 API-only）' },
     ],
     running: (use) => use(githubRuntimeStateToken).endpoints.values(),
-    describeEntry: (entry) => `app_id: ${String(entry.app_id ?? entry.appId)}`,
+    describeEntry: (entry) => `app_id: ${String(entry.app_id)}`,
 }, defineCommand);

package/{src/github-endpoint-commands.ts → commands/github/endpoint/definition.ts}

@@ -1,14 +1,14 @@
 /**
- * `github.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `github endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/github/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  *
  * 字段说明：private_key 内容长且含换行，不适合 kv 直传——运行时（gh-client
  * resolvePrivateKey）本就支持 PEM 内容或文件路径，故 add 采用**内联路径**形式：
- * `github.endpoint add mybot app_id=123456 private_key=./data/mybot.pem`。
+ * `github endpoint add mybot app_id=123456 private_key=./data/mybot.pem`。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { githubRuntimeStateToken } from './github-runtime-state.js';
+import { githubRuntimeStateToken } from '../../../src/github-runtime-state.js';
 
 export const githubEndpointCommands = createEndpointCommands({
   adapterKey: 'github',
@@ -19,5 +19,5 @@ export const githubEndpointCommands = createEndpointCommands({
     { key: 'webhook_secret', env: true, description: 'webhook 签名密钥（不配则 API-only）' },
   ],
   running: (use) => use(githubRuntimeStateToken).endpoints.values(),
-  describeEntry: (entry) => `app_id: ${String(entry.app_id ?? entry.appId)}`,
+  describeEntry: (entry) => `app_id: ${String(entry.app_id)}`,
 }, defineCommand);

package/commands/{endpoint/list.js → github/endpoint/list/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { githubEndpointCommands } from "../../lib/github-endpoint-commands.js";
+import { githubEndpointCommands } from '../definition.js';
 export default githubEndpointCommands.list;

package/commands/github/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { githubEndpointCommands } from '../definition.js';
+
+export default githubEndpointCommands.list;

package/commands/{endpoint/remove/[id].js → github/endpoint/remove/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { githubEndpointCommands } from "../../../lib/github-endpoint-commands.js";
+import { githubEndpointCommands } from '../../definition.js';
 export default githubEndpointCommands.remove;

package/commands/github/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { githubEndpointCommands } from '../../definition.js';
+
+export default githubEndpointCommands.remove;

package/lib/client.js

@@ -1,4 +1,3 @@
-import path from 'node:path';
 import { defineEndpointClient } from 'zhin.js/adapter';
 import { lookupGithubOauthAccessToken } from './oauth-users.js';
 import { WorkspaceManager } from './workspace-manager.js';
@@ -37,9 +36,7 @@ export class GithubClient {
     }
     get workspaceManager() {
         if (!this.#workspaceManager) {
-            const root = this.config.workspaceRoot
-                ?? path.join(process.cwd(), 'data', 'github-workspaces');
-            this.#workspaceManager = new WorkspaceManager(this.api, root);
+            this.#workspaceManager = new WorkspaceManager(this.api, this.config.workspaceRoot);
         }
         return this.#workspaceManager;
     }

package/lib/endpoint.js

@@ -133,8 +133,8 @@ export class GithubEndpoint extends Endpoint {
     }
 }
 export function defaultCreateClient(config) {
-    const appAuth = config.appId && config.privateKey
-        ? { appId: config.appId, privateKey: config.privateKey }
-        : undefined;
-    return new GhClient({ host: config.host, appAuth });
+    return new GhClient({
+        host: config.host,
+        appAuth: { appId: config.appId, privateKey: config.privateKey },
+    });
 }

package/lib/github-runtime-state.js

@@ -1,6 +1,6 @@
 /**
  * GitHub 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `github.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `github endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 export const githubRuntimeStateToken = defineEndpointRuntimeStateToken('github');

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-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 { buildChannelId, enrichInboundContent, formatInboundContent, formatNotification, formatOutboundBody, normalizeWebhookPath, parseChannelId, parseIssueCommentInbound, parsePrReviewCommentInbound, parsePrReviewInbound, resolveGithubConfig, shouldAutoReplyRepo, verifyWebhookSignature, type GithubEndpointConfig, type GithubInboundComment, type GithubWireSegment, type ResolvedGithubConfig, } from './protocol.js';
 export * from './types.js';
 export { GhClient } from './gh-client.js';
 export { GithubClient, githubClient, type GithubClientEventMap } from './client.js';

package/lib/protocol.d.ts

@@ -3,55 +3,33 @@
  * 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 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 type { EventType, GenericWebhookPayload, GitHubComment, 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;
+/** One expanded GitHub endpoint configuration produced by AdapterIndex. */
+export interface GithubEndpointConfig {
+    readonly id: string;
     readonly host?: string;
-    readonly app_id?: string | number;
-    readonly appId?: string | number;
-    readonly private_key?: string;
-    readonly privateKey?: string;
+    readonly app_id: string | number;
+    readonly private_key: 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 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;
+    readonly workspaceRoot: string;
 }
 export interface GithubWireSegment {
     readonly type: string;
@@ -72,7 +50,7 @@ export interface GithubInboundComment {
  * 在平台边界还原 repo/type/number。
  */
 export declare function githubInboundConversation(endpointKey: string, comment: GithubInboundComment): ConversationRef;
-export declare function resolveGithubConfig(config?: GithubAdapterConfig): ResolvedGithubConfig;
+export declare function resolveGithubConfig(config: GithubEndpointConfig): 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). */

package/lib/protocol.js

@@ -3,8 +3,7 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import { createHmac, timingSafeEqual } from 'node:crypto';
-import { pickCredential } from 'zhin.js/adapter';
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('github');
 import { buildChannelId, } from './types.js';
@@ -22,45 +21,35 @@ export function githubInboundConversation(endpointKey, comment) {
         parent: { kind: 'channel', id: comment.repo },
     };
 }
-export function resolveGithubConfig(config = {}) {
-    const entry = config.endpoints?.find((item) => item.context === 'github');
-    const appIdRaw = pickCredential(config.appId != null ? String(config.appId) : undefined, config.app_id != null ? String(config.app_id) : undefined, entry?.appId != null ? String(entry.appId) : undefined, entry?.app_id != null ? String(entry.app_id) : undefined, process.env.GITHUB_APP_ID);
+export function resolveGithubConfig(config) {
+    const id = typeof config.id === 'string' ? config.id.trim() : '';
+    if (!id)
+        throw new TypeError('GitHub endpoint requires a non-empty id');
+    const appIdRaw = config.app_id != null ? String(config.app_id).trim() : '';
     const appId = appIdRaw ? (Number(appIdRaw) || appIdRaw) : undefined;
-    const privateKey = pickCredential(config.privateKey, config.private_key, entry?.privateKey, entry?.private_key) || undefined;
+    const privateKey = typeof config.private_key === 'string'
+        ? config.private_key.trim()
+        : '';
     if (!appId || !privateKey) {
-        throw new TypeError('GitHub adapter requires app_id + private_key (plugins.<key> or GITHUB_APP_ID)');
+        throw new TypeError('GitHub endpoint requires app_id and private_key');
     }
-    const id = (typeof config.id === 'string' && config.id)
-        || (typeof entry?.id === 'string' && entry.id)
-        || process.env.GITHUB_BOT_NAME
-        || 'github-bot';
-    const webhookSecret = config.webhookSecret ?? config.webhook_secret
-        ?? entry?.webhookSecret ?? entry?.webhook_secret
-        ?? process.env.GITHUB_WEBHOOK_SECRET
-        ?? undefined;
-    const host = config.host ?? entry?.host;
-    const webhookPath = normalizeWebhookPath(config.webhookPath ?? config.webhook_path ?? entry?.webhookPath ?? entry?.webhook_path
-        ?? '/github/webhook');
-    const pollInterval = Number(config.pollInterval ?? config.poll_interval ?? entry?.pollInterval ?? entry?.poll_interval ?? 60) || 60;
-    const autoReplyRepos = [
-        ...(config.autoReplyRepos ?? config.auto_reply_repos
-            ?? entry?.autoReplyRepos ?? entry?.auto_reply_repos ?? []),
-    ];
-    const botLogin = config.botLogin ?? config.bot_login ?? entry?.botLogin ?? entry?.bot_login;
-    const workspaceRoot = config.workspaceRoot ?? config.workspace_root
-        ?? entry?.workspaceRoot ?? entry?.workspace_root;
+    const webhookSecret = config.webhook_secret;
+    const host = config.host;
+    const webhookPath = normalizeWebhookPath(config.webhook_path ?? '/github/webhook');
+    const autoReplyRepos = [...(config.auto_reply_repos ?? [])];
+    const botLogin = config.bot_login;
+    const workspaceRoot = config.workspace_root ?? 'data/github-workspaces';
     return {
         context: 'github',
         id,
         ...(host ? { host } : {}),
-        ...(appId != null ? { appId } : {}),
-        ...(privateKey ? { privateKey } : {}),
+        appId,
+        privateKey,
         ...(webhookSecret ? { webhookSecret } : {}),
         webhookPath,
-        pollInterval,
         autoReplyRepos,
         ...(botLogin ? { botLogin } : {}),
-        ...(workspaceRoot ? { workspaceRoot } : {}),
+        workspaceRoot,
     };
 }
 export function normalizeWebhookPath(path) {

package/lib/types.d.ts

@@ -1,26 +1,3 @@
-export interface GitHubEndpointConfig {
-    context: 'github';
-    /** Endpoint 标识名称 */
-    name: string;
-    /** GitHub Enterprise 主机名（默认 github.com） */
-    host?: string;
-    /** GitHub App ID */
-    app_id?: string | number;
-    /** GitHub App 私钥（PEM 内容或文件路径） */
-    private_key?: string;
-    /** Webhook Secret（配置后启用 Webhook 接收事件，不配置则使用轮询） */
-    webhook_secret?: string;
-    /** Webhook 路由路径（默认 /github/webhook） */
-    webhook_path?: string;
-    /** 事件轮询间隔（秒，默认 60，Webhook 模式下作为降级备选） */
-    poll_interval?: number;
-    /** 这些仓库的人类 Issue/PR 评论自动触发 AI（无需 @bot） */
-    auto_reply_repos?: string[];
-    /** 覆盖 App bot 登录名（默认 {slug}[bot]） */
-    bot_login?: string;
-    /** 托管 git 工作区根目录（默认 {cwd}/data/github-workspaces） */
-    workspace_root?: string;
-}
 export interface ParsedChannel {
     repo: string;
     type: 'issue' | 'pr';

package/lib/types.js

@@ -1,6 +1,5 @@
-// ── Endpoint 配置 ─────────────────────────────────────────────────────────
-//  基于 gh CLI 认证：需要系统已安装并认证 gh CLI
-//  认证方式：gh auth login
+// ── Channel ID ───────────────────────────────────────────────────────
+//  格式: {owner}/{repo}/issues/{number} 或 {owner}/{repo}/pull/{number}
 export function parseChannelId(channelId) {
     const issueMatch = channelId.match(/^(.+?\/.+?)\/issues\/(\d+)$/);
     if (issueMatch)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-github",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Zhin.js GitHub adapter for Plugin Runtime (App auth + webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -41,22 +41,25 @@
     "directory": "plugins/adapters/github"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.12",
-    "@zhin.js/core": "1.1.35",
-    "@zhin.js/feature-kit": "1.1.0",
-    "@zhin.js/host-http": "1.1.0",
-    "@zhin.js/im-contract": "1.1.0",
-    "@zhin.js/logger": "1.1.0"
+    "@zhin.js/adapter": "1.1.14",
+    "@zhin.js/agent-feature": "1.1.1",
+    "@zhin.js/core": "1.1.37",
+    "@zhin.js/feature-kit": "1.1.1",
+    "@zhin.js/host-http": "1.1.1",
+    "@zhin.js/im-contract": "1.1.1",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/skill": "1.1.1",
+    "@zhin.js/tool": "1.1.1"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.12",
-    "@zhin.js/agent": "^1.1.23",
-    "@zhin.js/command": "^1.1.0",
-    "@zhin.js/core": "^1.1.35",
-    "@zhin.js/host-http": "^1.1.0",
-    "@zhin.js/prompt-section": "^1.1.0",
-    "zhin.js": "^1.1.0"
+    "@zhin.js/adapter": "^1.1.14",
+    "@zhin.js/agent": "^1.1.26",
+    "@zhin.js/command": "^1.1.1",
+    "@zhin.js/core": "^1.1.37",
+    "@zhin.js/host-http": "^1.1.1",
+    "@zhin.js/prompt-section": "^1.1.1",
+    "zhin.js": "^1.1.2"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -80,9 +83,9 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.23",
-    "@zhin.js/prompt-section": "1.1.0",
-    "zhin.js": "1.1.0"
+    "@zhin.js/agent": "1.1.26",
+    "@zhin.js/prompt-section": "1.1.1",
+    "zhin.js": "1.1.2"
   },
   "files": [
     "adapters",
@@ -91,9 +94,10 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "prompt-sections"
   ],
   "publishConfig": {
     "access": "public",
@@ -116,6 +120,18 @@
       {
         "package": "@zhin.js/command",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/plugin.js

@@ -5,7 +5,7 @@ import { githubRuntimeStateToken } from "./lib/github-runtime-state.js";
 import { defineGithubOauthUsersTable } from "./lib/oauth-users.js";
 /**
  * github_subscriptions — repo event subscriptions per chat channel
- * (used by github_subscriptions agent tool; schema matches legacy defineModel).
+ * (used by github_subscriptions agent tool; schema is registered through DatabaseHost).
  */
 const GITHUB_SUBSCRIPTIONS_SCHEMA = {
     id: { type: 'integer', primary: true },
@@ -18,7 +18,7 @@ const GITHUB_SUBSCRIPTIONS_SCHEMA = {
 };
 /**
  * Plugin Runtime GitHub adapter.
- * - Endpoint: `adapters/github.ts`
+ * - Endpoint: `adapters/github/index.ts`
  * - OAuth user tokens: define `github_oauth_users` when DatabaseHost is present
  */
 export default definePlugin({
@@ -27,7 +27,7 @@ export default definePlugin({
         displayName: 'GitHub Adapter',
     },
     setup(context) {
-        // 运行中 endpoint 注册表（github.endpoint list 的"运行中"数据源）
+        // 运行中 endpoint 注册表（github endpoint list 的"运行中"数据源）
         context.resources.provide(githubRuntimeStateToken, createEndpointRuntimeState());
         if (context.resources.has(databaseHostToken)) {
             const host = context.resources.use(databaseHostToken);

package/prompt-sections/platform/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentPromptSection } from '@zhin.js/prompt-section';
+export default defineAgentPromptSection({
+    title: 'GitHub',
+    content: [
+        'On GitHub, discuss Issues and Pull Requests in their current conversation context.',
+        'Use github_* tools for Bot write operations; do not use mcp_github_* writes that act as a human PAT.',
+        'Use a workspace and branch for multi-file changes, then report the resulting Pull Request or branch.',
+    ].join('\n'),
+    layer: 'tools',
+    order: 70,
+    retention: 'preferred',
+    maxChars: 1200,
+    profiles: ['interactive'],
+    platforms: ['github'],
+});

package/schema.json

@@ -11,15 +11,6 @@
       "type": "string",
       "default": "/github/webhook"
     },
-    "webhookPath": {
-      "type": "string",
-      "default": "/github/webhook"
-    },
-    "poll_interval": {
-      "type": "number",
-      "default": 60,
-      "description": "Deferred: polling fallback was removed in the Plugin Runtime migration; currently parsed but unused"
-    },
     "auto_reply_repos": {
       "type": "array",
       "items": {
@@ -55,10 +46,11 @@
     },
     "endpoints": {
       "type": "array",
+      "minItems": 1,
       "description": "多账号：一个插件实例挂多个 endpoint",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "master": {
             "type": [
@@ -85,36 +77,51 @@
             ],
             "description": "GitHub App ID"
           },
-          "appId": {
-            "type": [
-              "string",
-              "number"
-            ],
-            "description": "GitHub App ID (camelCase alias)"
-          },
           "private_key": {
             "type": "string",
             "description": "GitHub App private key (PEM content or file path)"
           },
-          "privateKey": {
-            "type": "string",
-            "description": "GitHub App private key (camelCase alias)"
-          },
           "webhook_secret": {
             "type": "string",
             "description": "Webhook HMAC secret; enables httpHostToken POST route"
           },
-          "webhookSecret": {
-            "type": "string",
-            "description": "Webhook HMAC secret (camelCase alias)"
-          },
           "id": {
             "type": "string",
+            "minLength": 1,
             "description": "GitHub App bot name"
+          },
+          "host": {
+            "type": "string",
+            "description": "GitHub Enterprise hostname"
+          },
+          "webhook_path": {
+            "type": "string",
+            "description": "Webhook route path"
+          },
+          "auto_reply_repos": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Repos whose comments auto-trigger AI"
+          },
+          "bot_login": {
+            "type": "string",
+            "description": "Override App bot login"
+          },
+          "workspace_root": {
+            "type": "string",
+            "description": "Managed git workspace root"
+          },
+          "commandPrefix": {
+            "type": "string",
+            "description": "本 endpoint 的命令前缀"
           }
         },
         "required": [
-          "id"
+          "id",
+          "app_id",
+          "private_key"
         ]
       }
     },

package/src/client.ts

@@ -1,4 +1,3 @@
-import path from 'node:path';
 import type { PluginDatabaseHost } from 'zhin.js';
 import { defineEndpointClient } from 'zhin.js/adapter';
 import { GhClient } from './gh-client.js';
@@ -43,9 +42,7 @@ export class GithubClient {
 
   get workspaceManager(): WorkspaceManager {
     if (!this.#workspaceManager) {
-      const root = this.config.workspaceRoot
-        ?? path.join(process.cwd(), 'data', 'github-workspaces');
-      this.#workspaceManager = new WorkspaceManager(this.api, root);
+      this.#workspaceManager = new WorkspaceManager(this.api, this.config.workspaceRoot);
     }
     return this.#workspaceManager;
   }

package/src/endpoint.ts

@@ -162,8 +162,8 @@ export class GithubEndpoint extends Endpoint<GithubClient> {
 }
 
 export function defaultCreateClient(config: ResolvedGithubConfig): GhClient {
-  const appAuth = config.appId && config.privateKey
-    ? { appId: config.appId, privateKey: config.privateKey }
-    : undefined;
-  return new GhClient({ host: config.host, appAuth });
+  return new GhClient({
+    host: config.host,
+    appAuth: { appId: config.appId, privateKey: config.privateKey },
+  });
 }

package/src/github-runtime-state.ts

@@ -1,6 +1,6 @@
 /**
  * GitHub 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `github.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `github endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 

package/src/index.ts

@@ -12,7 +12,7 @@ export {
   resolveGithubConfig,
   shouldAutoReplyRepo,
   verifyWebhookSignature,
-  type GithubAdapterConfig,
+  type GithubEndpointConfig,
   type GithubInboundComment,
   type GithubWireSegment,
   type ResolvedGithubConfig,