@zhin.js/adapter-github 1.0.1 → 1.1.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/adapter-github",
-  "version": "1.0.1",
-  "description": "Zhin.js adapter for GitHub (gh CLI) — treat issues/PRs as chat channels, full repo management, webhook notifications",
+  "version": "1.1.2",
+  "description": "Zhin.js GitHub adapter for Plugin Runtime (App auth + webhook)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,15 +18,6 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "src",
-    "lib",
-    "client",
-    "dist",
-    "skills",
-    "plugin.yml",
-    "README.md"
-  ],
   "keywords": [
     "zhin",
     "zhin.js",
@@ -44,31 +35,110 @@
     "url": "https://github.com/lc-cn"
   },
   "license": "MIT",
-  "devDependencies": {
-    "typescript": "^6.0.3",
-    "@zhin.js/host-router": "1.0.1",
-    "zhin.js": "2.0.1"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/adapters/github"
+  },
+  "dependencies": {
+    "@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": {
-    "@zhin.js/host-router": "1.0.1",
-    "zhin.js": "2.0.1"
+    "zod": "^4.0.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/host-router": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "@zhin.js/prompt-section": {
+      "optional": true
+    },
+    "zhin.js": {
+      "optional": true
+    },
+    "zod": {
       "optional": true
     }
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zhinjs/zhin.git",
-    "directory": "plugins/adapters/github"
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/agent": "1.1.26",
+    "@zhin.js/prompt-section": "1.1.1",
+    "zhin.js": "1.1.2"
   },
+  "files": [
+    "adapters",
+    "commands",
+    "plugin.js",
+    "schema.json",
+    "src",
+    "lib",
+    "agents",
+    "README.md",
+    "CHANGELOG.md",
+    "prompt-sections"
+  ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/adapter",
+        "api": "^1.0.0"
+      },
+      {
+        "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": []
+  },
   "scripts": {
     "build": "tsc",
-    "clean": "rimraf lib"
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/github/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,38 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createEndpointRuntimeState } from 'zhin.js/adapter';
+import { definePlugin, databaseHostToken } from 'zhin.js';
+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 is registered through DatabaseHost).
+ */
+const GITHUB_SUBSCRIPTIONS_SCHEMA = {
+    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 },
+};
+/**
+ * Plugin Runtime GitHub adapter.
+ * - Endpoint: `adapters/github/index.ts`
+ * - OAuth user tokens: define `github_oauth_users` when DatabaseHost is present
+ */
+export default definePlugin({
+    name: 'github',
+    metadata: {
+        displayName: 'GitHub Adapter',
+    },
+    setup(context) {
+        // 运行中 endpoint 注册表（github endpoint list 的"运行中"数据源）
+        context.resources.provide(githubRuntimeStateToken, createEndpointRuntimeState());
+        if (context.resources.has(databaseHostToken)) {
+            const host = context.resources.use(databaseHostToken);
+            defineGithubOauthUsersTable(host);
+            host.define('github_subscriptions', { ...GITHUB_SUBSCRIPTIONS_SCHEMA });
+        }
+    },
+});

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/prompt-sections/platform/index.ts

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "host": {
+      "type": "string",
+      "description": "GitHub Enterprise hostname (default github.com)"
+    },
+    "webhook_path": {
+      "type": "string",
+      "default": "/github/webhook"
+    },
+    "auto_reply_repos": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Repos whose Issue/PR comments auto-trigger AI without @bot"
+    },
+    "bot_login": {
+      "type": "string",
+      "description": "Override App bot login (default {slug}[bot])"
+    },
+    "workspace_root": {
+      "type": "string",
+      "description": "Managed git workspace root"
+    },
+    "master": {
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "框架 master（GitHub user login or id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+    },
+    "trusted": {
+      "type": "array",
+      "items": {
+        "type": [
+          "string",
+          "number"
+        ],
+        "description": "Trusted GitHub user login or id"
+      },
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+    },
+    "endpoints": {
+      "type": "array",
+      "minItems": 1,
+      "description": "多账号：一个插件实例挂多个 endpoint",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "master": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "本 endpoint 的框架 master（GitHub user login or id）；覆盖顶层 master"
+          },
+          "trusted": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Trusted GitHub user login or id"
+            },
+            "description": "本 endpoint 的 trusted 列表"
+          },
+          "app_id": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "GitHub App ID"
+          },
+          "private_key": {
+            "type": "string",
+            "description": "GitHub App private key (PEM content or file path)"
+          },
+          "webhook_secret": {
+            "type": "string",
+            "description": "Webhook HMAC secret; enables httpHostToken POST route"
+          },
+          "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",
+          "app_id",
+          "private_key"
+        ]
+      }
+    },
+    "commandPrefix": {
+      "type": "string",
+      "default": "",
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+    }
+  },
+  "required": [
+    "endpoints"
+  ]
+}

package/src/client.ts

@@ -0,0 +1,62 @@
+import type { PluginDatabaseHost } from 'zhin.js';
+import { defineEndpointClient } from 'zhin.js/adapter';
+import { GhClient } from './gh-client.js';
+import { lookupGithubOauthAccessToken } from './oauth-users.js';
+import type { ResolvedGithubConfig } from './protocol.js';
+import { WorkspaceManager } from './workspace-manager.js';
+
+/** GitHub SDK surface exposed to plugin handlers and Agent tools. */
+export class GithubClient {
+  #workspaceManager?: WorkspaceManager;
+
+  constructor(
+    readonly name: string,
+    readonly api: GhClient,
+    readonly config: ResolvedGithubConfig,
+    readonly database?: PluginDatabaseHost,
+  ) {}
+
+  async getUserOrDefaultApi(platform?: string, platformUid?: string): Promise<GhClient> {
+    if (platform && platformUid) {
+      const token = await lookupGithubOauthAccessToken(this.database, platform, platformUid);
+      if (token) return this.api.withToken(token);
+    }
+    return this.api;
+  }
+
+  get clientId(): string | null {
+    return this.api.clientId || null;
+  }
+
+  get host(): string | undefined {
+    return this.config.host;
+  }
+
+  get appSlug(): string | null {
+    return this.api.appSlug || null;
+  }
+
+  get installations() {
+    return this.api.installations || [];
+  }
+
+  get workspaceManager(): WorkspaceManager {
+    if (!this.#workspaceManager) {
+      this.#workspaceManager = new WorkspaceManager(this.api, this.config.workspaceRoot);
+    }
+    return this.#workspaceManager;
+  }
+}
+
+export type GithubClientEventMap = Record<string, unknown>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly github: {
+      readonly client: GithubClient;
+      readonly events: GithubClientEventMap;
+    };
+  }
+}
+
+export const githubClient = defineEndpointClient<GithubClient, GithubClientEventMap>('github');