@zhin.js/adapter-github 1.0.1 → 1.1.2

package/agents/github/skills/github-account/handlers.ts

@@ -0,0 +1,136 @@
+import { formatCompact } from '@zhin.js/logger';
+import type { Message } from 'zhin.js';
+import { getCurrentCommMessage } from '@zhin.js/agent/security';
+import { GhClient } from '../../../../src/gh-client.js';
+import type { GithubClient } from '../../../../src/client.js';
+
+function oauthModel(client: GithubClient) {
+  const db = client.database as {
+    models?: Map<string, unknown>;
+  } | null | undefined;
+  return db?.models?.get('github_oauth_users') as {
+    select: () => { where: (q: object) => Promise<any[]> };
+    insert: (row: object) => Promise<void>;
+    delete: () => { where: (q: object) => Promise<void> };
+  } | undefined;
+}
+
+function depsLogger() {
+  return {
+    debug: (...args: unknown[]) => console.debug(...args),
+    warn: (...args: unknown[]) => console.warn(...args),
+    error: (...args: unknown[]) => console.error(...args),
+  };
+}
+
+export async function executeGithubBind(_args: Record<string, never>, client: GithubClient, commMessage?: Message) {
+  const log = depsLogger();
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg?.$adapter || !msg?.$sender?.id) return '❌ 无法获取当前用户信息';
+
+  const clientId = client.clientId;
+  if (!clientId) return '❌ Endpoint 未配置 GitHub App 或 App 无 client_id，无法进行账号绑定';
+
+  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 账号: ${existing.github_login}\n如需重新绑定，请先执行 github_unbind`;
+  }
+
+  try {
+    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 = [
+      '🔗 请在浏览器中打开以下链接进行授权：',
+      `   ${codeResp.verification_uri}`,
+      '',
+      `📋 输入验证码: **${codeResp.user_code}**`,
+      '',
+      `⏳ 等待授权中…（${Math.floor(codeResp.expires_in / 60)} 分钟内有效）`,
+    ].join('\n');
+
+    tokenPromise.then(async (tokenData) => {
+      if (!tokenData) {
+        log.warn(formatCompact({ op: 'device_flow', ok: false, platform: msg.$adapter, sender: msg.$sender.id }));
+        return;
+      }
+
+      const userGh = new GhClient({ host, token: tokenData.access_token });
+      const authResult = await userGh.verifyAuth();
+      const login = authResult.ok ? authResult.user : 'unknown';
+
+      await model.insert({
+        id: Date.now(),
+        platform: msg.$adapter,
+        platform_uid: msg.$sender.id,
+        github_login: login,
+        access_token: tokenData.access_token,
+        created_at: Date.now(),
+      });
+      log.debug(formatCompact({ op: 'bind', platform: msg.$adapter, sender: msg.$sender.id, login }));
+
+      if (msg?.$reply) {
+        await msg.$reply(`✅ GitHub 账号绑定成功！\n👤 ${login}`);
+      }
+    }).catch((err) => {
+      log.error('GitHub Device Flow 错误:', err);
+    });
+
+    return replyMsg;
+  } catch (e: unknown) {
+    return `❌ Device Flow 启动失败: ${e instanceof Error ? e.message : String(e)}`;
+  }
+}
+
+export async function executeGithubUnbind(_args: Record<string, never>, client: GithubClient, commMessage?: Message) {
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg?.$adapter || !msg?.$sender?.id) return '❌ 无法获取当前用户信息';
+
+  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 账号';
+
+  await model.delete().where({ id: existing.id });
+  return `✅ 已解除 GitHub 账号绑定: ${existing.github_login}`;
+}
+
+export async function executeGithubWhoami(_args: Record<string, never>, client: GithubClient, commMessage?: Message) {
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg?.$adapter || !msg?.$sender?.id) return '❌ 无法获取当前用户信息';
+
+  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: 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(client: GithubClient) {
+  const slug = client.appSlug;
+  if (!slug) return '❌ Endpoint 未配置 GitHub App';
+  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}):`;
+    for (const inst of installations) {
+      msg += `\n  • ${inst.account.login} (${inst.account.type})`;
+    }
+  }
+  return msg;
+}

package/agents/github/skills/github-account/tools/bind/index.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubBind } from '../../handlers.js';
+export default defineAgentTool({
+    description: '绑定你的 GitHub 账号 — 使用 Device Flow 授权，无需输入密码',
+    adapter: 'github',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubBind({}, context.$client);
+    },
+});

package/agents/github/skills/github-account/tools/bind/index.ts

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

package/agents/github/skills/github-account/tools/install/index.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubInstall } from '../../handlers.js';
+export default defineAgentTool({
+    description: '获取安装 GitHub App 的链接 — 安装后 Endpoint 可以访问你的仓库，你也可以使用更多功能',
+    adapter: 'github',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubInstall(context.$client);
+    },
+});

package/agents/github/skills/github-account/tools/install/index.ts

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

package/agents/github/skills/github-account/tools/unbind/index.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubUnbind } from '../../handlers.js';
+export default defineAgentTool({
+    description: '解除你绑定的 GitHub 账号',
+    adapter: 'github',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubUnbind({}, context.$client);
+    },
+});

package/agents/github/skills/github-account/tools/unbind/index.ts

@@ -0,0 +1,13 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubUnbind } from '../../handlers.js';
+
+export default defineAgentTool<{}>({
+  description: '解除你绑定的 GitHub 账号',
+  adapter: 'github',
+  inputSchema: z.object({}),
+  tags: ['github'],
+  async execute(input, context) {
+    return executeGithubUnbind({}, context.$client);
+  },
+});

package/agents/github/skills/github-account/tools/whoami/index.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubWhoami } from '../../handlers.js';
+export default defineAgentTool({
+    description: '查看你绑定的 GitHub 账号信息',
+    adapter: 'github',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubWhoami({}, context.$client);
+    },
+});

package/agents/github/skills/github-account/tools/whoami/index.ts

@@ -0,0 +1,13 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubWhoami } from '../../handlers.js';
+
+export default defineAgentTool<{}>({
+  description: '查看你绑定的 GitHub 账号信息',
+  adapter: 'github',
+  inputSchema: z.object({}),
+  tags: ['github'],
+  async execute(input, context) {
+    return executeGithubWhoami({}, context.$client);
+  },
+});

package/agents/github/skills/github-cli/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: github-cli
+platforms:
+  - github
+description: 使用 gh CLI 处理内置 GitHub Tool 未覆盖的 Issue、PR、Release、Workflow、搜索和 API 操作。
+keywords:
+  - "github"
+  - "gh"
+  - "issue"
+  - "pull request"
+  - "release"
+  - "workflow"
+  - "search"
+  - "api"
+---
+
+# GitHub CLI
+
+只有内置 GitHub Skill 不覆盖任务时才加载本 Skill。当前进程通过 `GH_TOKEN` 提供 gh CLI 身份；先执行 `gh auth status` 核对身份和权限。仓库参数统一使用 `owner/repo`。
+
+## 常用命令
+
+```bash
+gh issue list -R owner/repo --state open --limit 20 --json number,title,state,labels,assignees
+gh issue view 123 -R owner/repo --json number,title,body,state,labels,assignees
+gh issue create -R owner/repo --title "标题" --body "正文"
+gh pr list -R owner/repo --state open --limit 20 --json number,title,state,author,mergeable
+gh pr view 456 -R owner/repo --json number,title,body,state,author,mergeable,reviewDecision
+gh pr checks 456 -R owner/repo
+gh pr diff 456 -R owner/repo
+gh release list -R owner/repo --limit 10
+gh run list -R owner/repo --limit 10 --json databaseId,displayTitle,status,conclusion
+gh workflow list -R owner/repo
+gh search issues "关键词" --repo owner/repo --limit 10 --json number,title,state
+gh search code "函数名" --repo owner/repo --limit 10 --json path,textMatches
+```
+
+需要其他 API 时使用 `gh api` 或 `gh api graphql`。任何创建、修改、合并、关闭、重跑或发布操作都属于外部副作用，必须遵守执行工具的审批策略。
+
+## 输出控制
+
+- 列表必须使用 `--limit`，默认不超过 20 条。
+- 使用 `--json` 与 `--jq` 只保留任务需要的字段。
+- 正文最多读取 2000 字符，diff 最多读取 200 行。
+- 单次调用输出应小于 15KB。
+
+遇到 401 检查身份与 Token；404 同时检查资源存在性和权限；422 检查必填参数。不要把命令失败推断成资源不存在。

package/agents/github/skills/github-repository/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: github-repository
+platforms:
+  - github
+description: GitHub 工作区准备、文件补丁、分支推送和 PR 创建能力。
+keywords:
+  - "github"
+  - "repository"
+  - "patch"
+  - "branch"
+  - "pull request"
+tools:
+  - "prepare_workspace"
+  - "patch_file"
+  - "create_pr"
+  - "push_branch"
+---
+
+# github-repository
+
+这些 Tool 使用 GitHub App Installation Token，以 Bot 身份写仓库。按 `prepare_workspace`、`patch_file`、`push_branch`、`create_pr` 的顺序操作，每一步使用上一步返回的稳定引用。Issue 线程创建新分支后开 PR；PR 线程推送到现有 head 分支。不要改用人身份 PAT 的 MCP 工具完成 Bot 写入。推送和创建 PR 前复核仓库、base/head 分支与变更内容，并遵守 HITL 审批。

package/agents/github/skills/github-repository/handlers.js

@@ -0,0 +1,77 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { getCurrentCommMessage } from '@zhin.js/agent/security';
+import { formatChannelContext, parseMessageChannel, resolveWorkspaceBranch, } from "../../../../lib/github-channel-context.js";
+function requireBotGh(client) {
+    const gh = client.api;
+    if (!gh?.isAppAuth) {
+        throw new Error('需要 GitHub App 认证（app_id + private_key），Bot 写操作不可用');
+    }
+    return gh;
+}
+function resolveCommMessage(commMessage) {
+    const msg = commMessage ?? getCurrentCommMessage();
+    if (!msg)
+        throw new Error('无 IM 上下文，请在 Issue/PR 评论线程内调用');
+    return msg;
+}
+function resolveChannel(msg, repo) {
+    const ctx = parseMessageChannel(msg);
+    if (ctx)
+        return ctx;
+    if (repo) {
+        throw new Error(`请从 GitHub Issue/PR 频道调用，或提供完整 channel（当前仅 repo=${repo}）`);
+    }
+    throw new Error('无法解析 GitHub 频道（需要 Issue/PR 评论上下文）');
+}
+export async function executeGithubPrepareWorkspace(args, client, commMessage) {
+    const msg = resolveCommMessage(commMessage);
+    const ctx = resolveChannel(msg, args.repo);
+    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 [
+        `✅ 工作区就绪`,
+        `📁 ${repoPath}`,
+        `🌿 分支 \`${branch}\`（base: \`${base}\`）`,
+        `📍 ${formatChannelContext(ctx)}`,
+    ].join('\n');
+}
+export async function executeGithubPatchFile(args, client, commMessage) {
+    const msg = resolveCommMessage(commMessage);
+    const ctx = resolveChannel(msg, args.repo);
+    const gh = requireBotGh(client);
+    const { branch } = args.branch
+        ? { branch: args.branch }
+        : await resolveWorkspaceBranch(gh, ctx);
+    const existing = await gh.getFileContent(ctx.repo, args.path, branch);
+    const sha = existing.ok ? existing.data.sha : undefined;
+    const r = await gh.createOrUpdateFile(ctx.repo, args.path, args.content, args.message, { branch, sha });
+    if (!r.ok) {
+        return `❌ 更新文件失败: ${JSON.stringify(r.data)}`;
+    }
+    const url = r.data.content?.html_url ?? r.data.commit?.html_url ?? '';
+    return `✅ 已更新 \`${args.path}\` @ \`${branch}\`${url ? `\n🔗 ${url}` : ''}`;
+}
+export async function executeGithubPushBranch(args, client, commMessage) {
+    const msg = resolveCommMessage(commMessage);
+    const ctx = resolveChannel(msg, args.repo);
+    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, client, commMessage) {
+    const msg = resolveCommMessage(commMessage);
+    const ctx = resolveChannel(msg, args.repo);
+    const gh = requireBotGh(client);
+    const resolved = await resolveWorkspaceBranch(gh, ctx);
+    const head = args.head ?? resolved.branch;
+    const base = args.base ?? resolved.base;
+    const r = await gh.createPullRequest(ctx.repo, args.title, head, base, args.body);
+    if (!r.ok) {
+        return `❌ 创建 PR 失败: ${JSON.stringify(r.data)}`;
+    }
+    return `✅ PR #${r.data.number} 已创建\n🔗 ${r.data.html_url}`;
+}

package/agents/github/skills/github-repository/handlers.ts

@@ -0,0 +1,113 @@
+/**
+ * GitHub App Bot workflow handlers (Installation Token identity).
+ */
+import type { Message } from 'zhin.js';
+import { getCurrentCommMessage } from '@zhin.js/agent/security';
+import {
+  formatChannelContext,
+  parseMessageChannel,
+  resolveWorkspaceBranch,
+} from '../../../../src/github-channel-context.js';
+import type { GithubClient } from '../../../../src/client.js';
+
+function requireBotGh(client: GithubClient) {
+  const gh = client.api;
+  if (!gh?.isAppAuth) {
+    throw new Error('需要 GitHub App 认证（app_id + private_key），Bot 写操作不可用');
+  }
+  return gh;
+}
+
+function resolveCommMessage(commMessage?: Message): Message {
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg) throw new Error('无 IM 上下文，请在 Issue/PR 评论线程内调用');
+  return msg;
+}
+
+function resolveChannel(msg: Message, repo?: string) {
+  const ctx = parseMessageChannel(msg);
+  if (ctx) return ctx;
+  if (repo) {
+    throw new Error(`请从 GitHub Issue/PR 频道调用，或提供完整 channel（当前仅 repo=${repo}）`);
+  }
+  throw new Error('无法解析 GitHub 频道（需要 Issue/PR 评论上下文）');
+}
+
+export async function executeGithubPrepareWorkspace(
+  args: { repo?: string },
+  client: GithubClient,
+  commMessage?: Message,
+) {
+  const msg = resolveCommMessage(commMessage);
+  const ctx = resolveChannel(msg, args.repo);
+  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 [
+    `✅ 工作区就绪`,
+    `📁 ${repoPath}`,
+    `🌿 分支 \`${branch}\`（base: \`${base}\`）`,
+    `📍 ${formatChannelContext(ctx)}`,
+  ].join('\n');
+}
+
+export async function executeGithubPatchFile(
+  args: { repo?: string; path: string; content: string; message: string; branch?: string },
+  client: GithubClient,
+  commMessage?: Message,
+) {
+  const msg = resolveCommMessage(commMessage);
+  const ctx = resolveChannel(msg, args.repo);
+  const gh = requireBotGh(client);
+  const { branch } = args.branch
+    ? { branch: args.branch }
+    : await resolveWorkspaceBranch(gh, ctx);
+
+  const existing = await gh.getFileContent(ctx.repo, args.path, branch);
+  const sha = existing.ok ? existing.data.sha : undefined;
+  const r = await gh.createOrUpdateFile(
+    ctx.repo,
+    args.path,
+    args.content,
+    args.message,
+    { branch, sha },
+  );
+  if (!r.ok) {
+    return `❌ 更新文件失败: ${JSON.stringify(r.data)}`;
+  }
+  const url = r.data.content?.html_url ?? r.data.commit?.html_url ?? '';
+  return `✅ 已更新 \`${args.path}\` @ \`${branch}\`${url ? `\n🔗 ${url}` : ''}`;
+}
+
+export async function executeGithubPushBranch(
+  args: { repo?: string; branch?: string; message: string },
+  client: GithubClient,
+  commMessage?: Message,
+) {
+  const msg = resolveCommMessage(commMessage);
+  const ctx = resolveChannel(msg, args.repo);
+  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: { repo?: string; title: string; body?: string; head?: string; base?: string },
+  client: GithubClient,
+  commMessage?: Message,
+) {
+  const msg = resolveCommMessage(commMessage);
+  const ctx = resolveChannel(msg, args.repo);
+  const gh = requireBotGh(client);
+  const resolved = await resolveWorkspaceBranch(gh, ctx);
+  const head = args.head ?? resolved.branch;
+  const base = args.base ?? resolved.base;
+  const r = await gh.createPullRequest(ctx.repo, args.title, head, base, args.body);
+  if (!r.ok) {
+    return `❌ 创建 PR 失败: ${JSON.stringify(r.data)}`;
+  }
+  return `✅ PR #${r.data.number} 已创建\n🔗 ${r.data.html_url}`;
+}

package/agents/github/skills/github-repository/tools/create_pr/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubCreatePr } from '../../handlers.js';
+export default defineAgentTool({
+    description: '以 GitHub App Bot 身份创建 Pull Request（需 HITL 确认；Issue 场景常用）',
+    adapter: 'github',
+    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'],
+    requiresApproval: 'always',
+    async execute(input, context) {
+        return executeGithubCreatePr(input, context.$client);
+    },
+});

package/agents/github/skills/github-repository/tools/create_pr/index.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubCreatePr } from '../../handlers.js';
+
+export default defineAgentTool<{ repo?: string; title: string; body?: string; head?: string; base?: string }>({
+  description: '以 GitHub App Bot 身份创建 Pull Request（需 HITL 确认；Issue 场景常用）',
+  adapter: 'github',
+  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'],
+  requiresApproval: 'always',
+  async execute(input, context) {
+    return executeGithubCreatePr(input, context.$client);
+  },
+});

package/agents/github/skills/github-repository/tools/patch_file/index.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPatchFile } from '../../handlers.js';
+export default defineAgentTool({
+    description: '通过 Contents API 单文件更新（小改；Bot Installation Token 身份）',
+    adapter: 'github',
+    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, context) {
+        return executeGithubPatchFile(input, context.$client);
+    },
+});

package/agents/github/skills/github-repository/tools/patch_file/index.ts

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPatchFile } from '../../handlers.js';
+
+export default defineAgentTool<{ repo?: string; path: string; content: string; message: string; branch?: string }>({
+  description: '通过 Contents API 单文件更新（小改；Bot Installation Token 身份）',
+  adapter: 'github',
+  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, context) {
+    return executeGithubPatchFile(input, context.$client);
+  },
+});

package/agents/github/skills/github-repository/tools/prepare_workspace/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPrepareWorkspace } from '../../handlers.js';
+export default defineAgentTool({
+    description: 'Clone/fetch 托管工作区并 checkout 到 Issue/PR 对应分支（GitHub App Bot 身份）',
+    adapter: 'github',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo，缺省从当前 Issue/PR 频道推断'),
+    }),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubPrepareWorkspace(input, context.$client);
+    },
+});

package/agents/github/skills/github-repository/tools/prepare_workspace/index.ts

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

package/agents/github/skills/github-repository/tools/push_branch/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPushBranch } from '../../handlers.js';
+export default defineAgentTool({
+    description: '在托管工作区 git commit 并 push 到远程分支（需 HITL 确认；Bot 身份）',
+    adapter: 'github',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        branch: z.string().optional().describe('分支名，缺省从上下文推断'),
+        message: z.string().describe('commit message'),
+    }),
+    tags: ['github'],
+    requiresApproval: 'always',
+    async execute(input, context) {
+        return executeGithubPushBranch(input, context.$client);
+    },
+});