@zhin.js/adapter-github 3.0.1 → 3.0.2

package/README.md

@@ -12,7 +12,7 @@
 - ✅ **事件通知**：Webhook 订阅，跨平台推送到任意聊天
 - ✅ **GitHub App 认证**：JWT → Installation Token，自动刷新
 - ✅ **OAuth 用户绑定**：用户可绑定自己的 GitHub 账号，star/fork 以个人身份执行
-- ✅ **AI Skill**：所有工具自动暴露给 AI 调用
+- ✅ **Bot 开发工作流**：托管 git 工作区 + App 身份 push/开 PR（HITL 确认）
 - ✅ **无 router 也能运行**：核心功能不依赖 HTTP 服务，有 router 时自动注册 Webhook 和 OAuth 路由
 
 ## 安装
@@ -37,7 +37,7 @@ pnpm add @zhin.js/adapter-github
 4. 权限设置（Permissions）：
    - **Repository → Issues**: Read & Write
    - **Repository → Pull requests**: Read & Write
-   - **Repository → Contents**: Read
+   - **Repository → Contents**: Read & Write（Bot 提交代码）
    - **Repository → Metadata**: Read
    - **Repository → Actions**: Read（查看 CI）
 5. 订阅事件（Subscribe to events）：
@@ -56,7 +56,10 @@ endpoints:
     app_id: 123456
     private_key: ./data/github-app.pem   # PEM 文件路径或直接粘贴内容
     webhook_secret: your-secret          # 可选；配置后启用 Webhook
-    webhook_path: /pub/github/webhook    # 可选；默认 /github/webhook，/pub/* 可绕过 Bearer
+    webhook_path: /pub/github/webhook    # 可选
+    auto_reply_repos:                    # 可选：这些 repo 的评论自动触发 AI
+      - zhinjs/zhin
+    workspace_root: ./data/github-workspaces  # 可选：Bot git 工作区
 
 plugins:
   - database
@@ -67,13 +70,11 @@ plugins:
 ```env
 GITHUB_APP_ID=123456
 GITHUB_WEBHOOK_SECRET=your-secret
-# MCP server-github（适配器自动 addMcp，与 App 认证独立）
-GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx
-# 或 ai.githubMcp.token / ai.mcpServers
+# MCP server-github（可选；PAT = 人身份，默认关闭）
+# ai.githubMcp.enabled: true
+# GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx
 ```
 
-或在 `zhin.config.yml` 中设置 `ai.githubMcp.token`（优先于环境变量）。
-
 `private_key` 支持两种写法：
 - 文件路径：`./data/github-app.pem`
 - 直接内容：`"-----BEGIN RSA PRIVATE KEY-----\n..."`
@@ -97,12 +98,21 @@ GitHub adapter 将 Issue/PR 映射为聊天频道：
 | `github_bind` / `github_unbind` / `github_whoami` | 用户 GitHub 账号绑定 |
 | `github_install` | GitHub App 安装链接 |
 | `github_subscribe` / `github_unsubscribe` / `github_subscriptions` | 频道级 Webhook 订阅 |
+| `github_prepare_workspace` | Clone/fetch 托管工作区并 checkout 分支 |
+| `github_patch_file` | Contents API 单文件更新（Bot 身份） |
+| `github_push_branch` | git commit + push（**需 HITL**） |
+| `github_create_pr` | 创建 PR（**需 HITL**） |
+
+### Bot 工作流（App 身份）
 
-### MCP（`@modelcontextprotocol/server-github`）
+- 评论回复：Webhook → `$reply`，Installation Token，UI 显示 `{slug}[bot]` + **Bot** 徽章
+- 开发提交：`github_prepare_workspace` → bash 改代码 → `github_push_branch`（确认）→ Issue 场景 `github_create_pr`
+- PR 线程：push 到现有 PR head 分支，不新开 PR
+- 工作区默认：`data/github-workspaces/{owner}/{repo}`
 
-配置 `GITHUB_PERSONAL_ACCESS_TOKEN`（或 `ai.githubMcp.token`）后，适配器通过 `orchestrator.addMcp` 注册 `github` server；AI 侧工具名为 `mcp_github_*`（如 `mcp_github_fork_repository`、`mcp_github_create_issue`）。
+### MCP（`@modelcontextprotocol/server-github`，可选）
 
-**BREAKING**：`github_fork` 已移除，请改用 `mcp_github_fork_repository`。
+仅当 `ai.githubMcp.enabled: true` 且配置 PAT 时注册。`mcp_github_*` 以**用户 PAT** 操作，**不能**作为 Bot 写仓库。Bot 写操作请用上方 `github_*` 工具。
 
 ### 使用示例
 
@@ -153,7 +163,8 @@ Headers:
 | 操作类型 | 使用的 Token | 原因 |
 |---------|------------|------|
 | 读取 issue/PR/repo 信息 | App JWT | 不涉及用户身份 |
-| 评论（bot 发言） | App JWT | 以机器人身份发言 |
+| 评论（bot 发言） | App Installation Token | 以 `{slug}[bot]` 机器人身份发言 |
+| push / 开 PR | App Installation Token + git author | UI **Bot** 徽章（非 Member） |
 | star / unstar | User OAuth | 个人行为 |
 | fork | User OAuth | 个人行为 |
 

package/{skills/github/SKILL.md → agent/skills/github.md}

@@ -60,6 +60,10 @@ tools:
   - github_subscribe
   - github_unsubscribe
   - github_subscriptions
+  - github_prepare_workspace
+  - github_patch_file
+  - github_push_branch
+  - github_create_pr
 always: false
 requires:
   bins:
@@ -72,7 +76,8 @@ requires:
 
 本技能提供三种操作方式：
 - **适配器内置工具**（`github_*`）：用户交互类操作，具备账号绑定、Device Flow 授权、频道级订阅等适配器专有逻辑
-- **MCP server-github**（`mcp_github_*`）：Issue/PR/搜索/Fork 等 GitHub API（需 `GITHUB_PERSONAL_ACCESS_TOKEN` 或 `ai.githubMcp.token`）
+- **Bot 写仓库工具**（`github_prepare_workspace` / `github_patch_file` / `github_push_branch` / `github_create_pr`）：Installation Token，UI 显示 **Bot** 身份；push/开 PR 需 HITL
+- **MCP server-github**（`mcp_github_*`，可选）：需 `ai.githubMcp.enabled: true` + PAT，**人身份**，勿用于 Bot 写仓库
 - **bash + gh CLI**：仓库自动化操作，灵活覆盖 GitHub API 全场景
 
 ## 一、适配器内置工具
@@ -94,7 +99,18 @@ requires:
 |------|------|
 | `github_star` | Star 或取消 Star 一个仓库。优先使用用户绑定的 GitHub 账号，未绑定则降级为 Endpoint 默认账号 |
 
-### MCP（server-github，单一 PAT）
+### Bot 开发工作流（App 身份）
+
+| 工具 | 说明 |
+|------|------|
+| `github_prepare_workspace` | Clone/fetch 托管工作区并 checkout Issue/PR 对应分支 |
+| `github_patch_file` | Contents API 单文件更新（小改） |
+| `github_push_branch` | git commit + push（**需 HITL**） |
+| `github_create_pr` | 创建 PR（**需 HITL**；Issue 线程常用） |
+
+Issue 线程：新分支 → 开发 → push → 开 PR。PR 线程：push 到现有 head 分支。
+
+### MCP（server-github，可选 PAT）
 
 | 工具 | 说明 |
 |------|------|
@@ -112,9 +128,10 @@ requires:
 ### 内置工具执行规则
 
 1. `github_star` 优先使用用户绑定的 GitHub 账号，未绑定则降级为 Endpoint 默认账号
-2. Fork 与通用 API 使用 `mcp_github_*`（Bot PAT，非 per-user OAuth）
-3. 当用户想操作自己的 GitHub 账号进行 Star 时，先引导用户使用 `github_bind` 绑定
-4. Webhook 订阅关联到当前聊天通道，仅在该通道接收事件通知
+2. Bot 写仓库用 `github_*` 工具，不用 `mcp_github_*` 写操作
+3. MCP 仅 opt-in（`ai.githubMcp.enabled: true`），PAT 为人身份
+4. 当用户想操作自己的 GitHub 账号进行 Star 时，先引导用户使用 `github_bind` 绑定
+5. Webhook 订阅关联到当前聊天通道，仅在该通道接收事件通知
 
 ---
 

package/agent/tools/bind.ts

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubBind } from '../../src/github-tool-handlers.js';
+
+export default defineTool({
+  description: '绑定你的 GitHub 账号 — 使用 Device Flow 授权，无需输入密码',
+  inputSchema: z.object({}),
+  tags: ['github'],
+  async execute() {
+    return executeGithubBind({});
+  },
+});

package/agent/tools/create_pr.ts

@@ -0,0 +1,19 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubCreatePr } from '../../src/github-bot-handlers.js';
+
+export default defineTool<{ repo?: string; title: string; body?: string; head?: string; base?: string }>({
+  description: '以 GitHub App Bot 身份创建 Pull Request（需 HITL 确认；Issue 场景常用）',
+  inputSchema: z.object({
+    repo: z.string().optional().describe('owner/repo'),
+    title: z.string().describe('PR 标题'),
+    body: z.string().optional().describe('PR 正文'),
+    head: z.string().optional().describe('head 分支，缺省为工作区分支'),
+    base: z.string().optional().describe('base 分支，缺省为仓库默认分支'),
+  }),
+  tags: ['github'],
+  approval: 'always',
+  async execute(input) {
+    return executeGithubCreatePr(input);
+  },
+});

package/agent/tools/install.ts

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubInstall } from '../../src/github-tool-handlers.js';
+
+export default defineTool({
+  description: '获取安装 GitHub App 的链接 — 安装后 Endpoint 可以访问你的仓库，你也可以使用更多功能',
+  inputSchema: z.object({}),
+  tags: ['github'],
+  async execute() {
+    return executeGithubInstall();
+  },
+});

package/agent/tools/patch_file.ts

@@ -0,0 +1,18 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubPatchFile } from '../../src/github-bot-handlers.js';
+
+export default defineTool<{ repo?: string; path: string; content: string; message: string; branch?: string }>({
+  description: '通过 Contents API 单文件更新（小改；Bot Installation Token 身份）',
+  inputSchema: z.object({
+    repo: z.string().optional().describe('owner/repo'),
+    path: z.string().describe('仓库内文件路径'),
+    content: z.string().describe('新文件内容'),
+    message: z.string().describe('commit message'),
+    branch: z.string().optional().describe('目标分支，缺省从 Issue/PR 上下文推断'),
+  }),
+  tags: ['github'],
+  async execute(input) {
+    return executeGithubPatchFile(input);
+  },
+});

package/agent/tools/prepare_workspace.ts

@@ -0,0 +1,14 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubPrepareWorkspace } from '../../src/github-bot-handlers.js';
+
+export default defineTool<{ repo?: string }>({
+  description: 'Clone/fetch 托管工作区并 checkout 到 Issue/PR 对应分支（GitHub App Bot 身份）',
+  inputSchema: z.object({
+    repo: z.string().optional().describe('owner/repo，缺省从当前 Issue/PR 频道推断'),
+  }),
+  tags: ['github'],
+  async execute(input) {
+    return executeGithubPrepareWorkspace(input);
+  },
+});

package/agent/tools/push_branch.ts

@@ -0,0 +1,17 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubPushBranch } from '../../src/github-bot-handlers.js';
+
+export default defineTool<{ repo?: string; branch?: string; message: string }>({
+  description: '在托管工作区 git commit 并 push 到远程分支（需 HITL 确认；Bot 身份）',
+  inputSchema: z.object({
+    repo: z.string().optional().describe('owner/repo'),
+    branch: z.string().optional().describe('分支名，缺省从上下文推断'),
+    message: z.string().describe('commit message'),
+  }),
+  tags: ['github'],
+  approval: 'always',
+  async execute(input) {
+    return executeGithubPushBranch(input);
+  },
+});

package/agent/tools/star.ts

@@ -0,0 +1,15 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubStar } from '../../src/github-tool-handlers.js';
+
+export default defineTool<{ action: 'star' | 'unstar' | 'check'; repo: string }>({
+  description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Endpoint 默认账号）',
+  inputSchema: z.object({
+    action: z.enum(['star', 'unstar', 'check']),
+    repo: z.string().min(1),
+  }),
+  tags: ['github'],
+  async execute(input) {
+    return executeGithubStar(input);
+  },
+});

package/agent/tools/subscribe.ts

@@ -0,0 +1,16 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubSubscribe } from '../../src/github-tool-handlers.js';
+
+export default defineTool<{ repo: string; events?: string }>({
+  description: '订阅 GitHub 仓库的 Webhook 事件，事件将推送到当前聊天通道',
+  inputSchema: z.object({
+    repo: z.string().min(1),
+    events: z.string().optional(),
+  }),
+  platforms: ['github'],
+  tags: ['github'],
+  async execute(input) {
+    return executeGithubSubscribe(input);
+  },
+});

package/agent/tools/subscriptions.ts

@@ -0,0 +1,13 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubSubscriptions } from '../../src/github-tool-handlers.js';
+
+export default defineTool({
+  description: '查看当前聊天通道的 GitHub 仓库订阅列表',
+  inputSchema: z.object({}),
+  platforms: ['github'],
+  tags: ['github'],
+  async execute() {
+    return executeGithubSubscriptions({});
+  },
+});

package/agent/tools/unbind.ts

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubUnbind } from '../../src/github-tool-handlers.js';
+
+export default defineTool({
+  description: '解除你绑定的 GitHub 账号',
+  inputSchema: z.object({}),
+  tags: ['github'],
+  async execute() {
+    return executeGithubUnbind({});
+  },
+});

package/agent/tools/unsubscribe.ts

@@ -0,0 +1,15 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubUnsubscribe } from '../../src/github-tool-handlers.js';
+
+export default defineTool<{ repo: string }>({
+  description: '取消订阅 GitHub 仓库的 Webhook 事件',
+  inputSchema: z.object({
+    repo: z.string().min(1),
+  }),
+  platforms: ['github'],
+  tags: ['github'],
+  async execute(input) {
+    return executeGithubUnsubscribe(input);
+  },
+});

package/agent/tools/whoami.ts

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubWhoami } from '../../src/github-tool-handlers.js';
+
+export default defineTool({
+  description: '查看你绑定的 GitHub 账号信息',
+  inputSchema: z.object({}),
+  tags: ['github'],
+  async execute() {
+    return executeGithubWhoami({});
+  },
+});

package/lib/agent/tools/bind.js

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubBind } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '绑定你的 GitHub 账号 — 使用 Device Flow 授权，无需输入密码',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute() {
+        return executeGithubBind({});
+    },
+});
+//# sourceMappingURL=bind.js.map

package/lib/agent/tools/bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../../agent/tools/bind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,eAAe,UAAU,CAAC;IACxB,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/create_pr.js

@@ -0,0 +1,19 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubCreatePr } from '../../src/github-bot-handlers.js';
+export default defineTool({
+    description: '以 GitHub App Bot 身份创建 Pull Request（需 HITL 确认；Issue 场景常用）',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        title: z.string().describe('PR 标题'),
+        body: z.string().optional().describe('PR 正文'),
+        head: z.string().optional().describe('head 分支，缺省为工作区分支'),
+        base: z.string().optional().describe('base 分支，缺省为仓库默认分支'),
+    }),
+    tags: ['github'],
+    approval: 'always',
+    async execute(input) {
+        return executeGithubCreatePr(input);
+    },
+});
+//# sourceMappingURL=create_pr.js.map

package/lib/agent/tools/create_pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_pr.js","sourceRoot":"","sources":["../../../agent/tools/create_pr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,eAAe,UAAU,CAAgF;IACvG,WAAW,EAAE,0DAA0D;IACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KAC1D,CAAC;IACF,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,QAAQ,EAAE,QAAQ;IAClB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/install.js

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubInstall } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '获取安装 GitHub App 的链接 — 安装后 Endpoint 可以访问你的仓库，你也可以使用更多功能',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute() {
+        return executeGithubInstall();
+    },
+});
+//# sourceMappingURL=install.js.map

package/lib/agent/tools/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../agent/tools/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,eAAe,UAAU,CAAC;IACxB,WAAW,EAAE,wDAAwD;IACrE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,oBAAoB,EAAE,CAAC;IAChC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/patch_file.js

@@ -0,0 +1,18 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubPatchFile } from '../../src/github-bot-handlers.js';
+export default defineTool({
+    description: '通过 Contents API 单文件更新（小改；Bot Installation Token 身份）',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        path: z.string().describe('仓库内文件路径'),
+        content: z.string().describe('新文件内容'),
+        message: z.string().describe('commit message'),
+        branch: z.string().optional().describe('目标分支，缺省从 Issue/PR 上下文推断'),
+    }),
+    tags: ['github'],
+    async execute(input) {
+        return executeGithubPatchFile(input);
+    },
+});
+//# sourceMappingURL=patch_file.js.map

package/lib/agent/tools/patch_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch_file.js","sourceRoot":"","sources":["../../../agent/tools/patch_file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,eAAe,UAAU,CAAqF;IAC5G,WAAW,EAAE,qDAAqD;IAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;QACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KAClE,CAAC;IACF,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/prepare_workspace.js

@@ -0,0 +1,14 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubPrepareWorkspace } from '../../src/github-bot-handlers.js';
+export default defineTool({
+    description: 'Clone/fetch 托管工作区并 checkout 到 Issue/PR 对应分支（GitHub App Bot 身份）',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo，缺省从当前 Issue/PR 频道推断'),
+    }),
+    tags: ['github'],
+    async execute(input) {
+        return executeGithubPrepareWorkspace(input);
+    },
+});
+//# sourceMappingURL=prepare_workspace.js.map

package/lib/agent/tools/prepare_workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare_workspace.js","sourceRoot":"","sources":["../../../agent/tools/prepare_workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEjF,eAAe,UAAU,CAAoB;IAC3C,WAAW,EAAE,gEAAgE;IAC7E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;KACvE,CAAC;IACF,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,6BAA6B,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/push_branch.js

@@ -0,0 +1,17 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubPushBranch } from '../../src/github-bot-handlers.js';
+export default defineTool({
+    description: '在托管工作区 git commit 并 push 到远程分支（需 HITL 确认；Bot 身份）',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        branch: z.string().optional().describe('分支名，缺省从上下文推断'),
+        message: z.string().describe('commit message'),
+    }),
+    tags: ['github'],
+    approval: 'always',
+    async execute(input) {
+        return executeGithubPushBranch(input);
+    },
+});
+//# sourceMappingURL=push_branch.js.map

package/lib/agent/tools/push_branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push_branch.js","sourceRoot":"","sources":["../../../agent/tools/push_branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,eAAe,UAAU,CAAsD;IAC7E,WAAW,EAAE,kDAAkD;IAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KAC/C,CAAC;IACF,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,QAAQ,EAAE,QAAQ;IAClB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/star.js

@@ -0,0 +1,15 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubStar } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Endpoint 默认账号）',
+    inputSchema: z.object({
+        action: z.enum(['star', 'unstar', 'check']),
+        repo: z.string().min(1),
+    }),
+    tags: ['github'],
+    async execute(input) {
+        return executeGithubStar(input);
+    },
+});
+//# sourceMappingURL=star.js.map

package/lib/agent/tools/star.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"star.js","sourceRoot":"","sources":["../../../agent/tools/star.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,eAAe,UAAU,CAAwD;IAC/E,WAAW,EAAE,kEAAkE;IAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACxB,CAAC;IACF,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/subscribe.js

@@ -0,0 +1,16 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubSubscribe } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '订阅 GitHub 仓库的 Webhook 事件，事件将推送到当前聊天通道',
+    inputSchema: z.object({
+        repo: z.string().min(1),
+        events: z.string().optional(),
+    }),
+    platforms: ['github'],
+    tags: ['github'],
+    async execute(input) {
+        return executeGithubSubscribe(input);
+    },
+});
+//# sourceMappingURL=subscribe.js.map

package/lib/agent/tools/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../../agent/tools/subscribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,UAAU,CAAoC;IAC3D,WAAW,EAAE,uCAAuC;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC;IACF,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/subscriptions.js

@@ -0,0 +1,13 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubSubscriptions } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '查看当前聊天通道的 GitHub 仓库订阅列表',
+    inputSchema: z.object({}),
+    platforms: ['github'],
+    tags: ['github'],
+    async execute() {
+        return executeGithubSubscriptions({});
+    },
+});
+//# sourceMappingURL=subscriptions.js.map

package/lib/agent/tools/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../../agent/tools/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,eAAe,UAAU,CAAC;IACxB,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,0BAA0B,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/unbind.js

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubUnbind } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '解除你绑定的 GitHub 账号',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute() {
+        return executeGithubUnbind({});
+    },
+});
+//# sourceMappingURL=unbind.js.map

package/lib/agent/tools/unbind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unbind.js","sourceRoot":"","sources":["../../../agent/tools/unbind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAe,UAAU,CAAC;IACxB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/unsubscribe.js

@@ -0,0 +1,15 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubUnsubscribe } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '取消订阅 GitHub 仓库的 Webhook 事件',
+    inputSchema: z.object({
+        repo: z.string().min(1),
+    }),
+    platforms: ['github'],
+    tags: ['github'],
+    async execute(input) {
+        return executeGithubUnsubscribe(input);
+    },
+});
+//# sourceMappingURL=unsubscribe.js.map

package/lib/agent/tools/unsubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe.js","sourceRoot":"","sources":["../../../agent/tools/unsubscribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,eAAe,UAAU,CAAmB;IAC1C,WAAW,EAAE,4BAA4B;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACxB,CAAC;IACF,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC"}

package/lib/agent/tools/whoami.js

@@ -0,0 +1,12 @@
+import { defineTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+import { executeGithubWhoami } from '../../src/github-tool-handlers.js';
+export default defineTool({
+    description: '查看你绑定的 GitHub 账号信息',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute() {
+        return executeGithubWhoami({});
+    },
+});
+//# sourceMappingURL=whoami.js.map

package/lib/agent/tools/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../../agent/tools/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAe,UAAU,CAAC;IACxB,WAAW,EAAE,oBAAoB;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,KAAK,CAAC,OAAO;QACX,OAAO,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACF,CAAC,CAAC"}

package/lib/{adapter.js → src/adapter.js}

@@ -3,7 +3,7 @@
  */
 import { formatCompact, Adapter, OUTBOUND_RICH_SEGMENT_POLICY_TEXT_ONLY } from 'zhin.js';
 import crypto from 'node:crypto';
-import { GitHubEndpoint } from './endpoint.js';
+import { GitHubEndpoint, enrichGithubInboundMessage } from './endpoint.js';
 const VALID_EVENTS = ['push', 'issue', 'star', 'fork', 'unstar', 'pull_request'];
 function safeParseEvents(raw) {
     if (Array.isArray(raw))
@@ -201,22 +201,26 @@ export class GitHubAdapter extends Adapter {
         }
         // 处理消息类事件（Issue/PR 评论）
         if (endpoint && event === 'issue_comment' && payload.action === 'created' && payload.comment) {
-            const message = endpoint.$formatMessage(payload);
+            let message = endpoint.$formatMessage(payload);
+            message = enrichGithubInboundMessage(message, endpoint.$config, endpoint.gh, repo);
             const botUser = endpoint.gh.authenticatedUser;
             if (!(botUser && message.$sender.id === botUser)) {
                 this.emit('message.receive', message);
             }
         }
         if (endpoint && event === 'pull_request_review_comment' && payload.action === 'created' && payload.comment) {
-            const message = endpoint.formatPRReviewComment(payload);
+            let message = endpoint.formatPRReviewComment(payload);
+            message = enrichGithubInboundMessage(message, endpoint.$config, endpoint.gh, repo);
             const botUser = endpoint.gh.authenticatedUser;
             if (!(botUser && message.$sender.id === botUser)) {
                 this.emit('message.receive', message);
             }
         }
         if (endpoint && event === 'pull_request_review' && payload.action === 'submitted') {
-            const message = endpoint.formatPRReview(payload);
-            if (message) {
+            const formatted = endpoint.formatPRReview(payload);
+            if (formatted) {
+                let message = formatted;
+                message = enrichGithubInboundMessage(message, endpoint.$config, endpoint.gh, repo);
                 const botUser = endpoint.gh.authenticatedUser;
                 if (!(botUser && message.$sender.id === botUser)) {
                     this.emit('message.receive', message);
@@ -333,7 +337,8 @@ export class GitHubAdapter extends Adapter {
             }
             // 处理消息类事件（Issue/PR 评论）
             if (endpoint && eventName === 'issue_comment' && ev.payload?.action === 'created' && ev.payload?.comment) {
-                const message = endpoint.$formatMessage(ev.payload);
+                let message = endpoint.$formatMessage(ev.payload);
+                message = enrichGithubInboundMessage(message, endpoint.$config, endpoint.gh, repo);
                 const botUser = endpoint.gh.authenticatedUser;
                 if (!(botUser && message.$sender.id === botUser)) {
                     this.emit('message.receive', message);