@github-tools/sdk 1.3.0 → 1.4.0

package/README.md

@@ -9,7 +9,7 @@
 
 GitHub tools for the [AI SDK](https://ai-sdk.dev) — wrap GitHub's REST API as ready-to-use tools for any agent or `generateText` / `streamText` call.
 
-36 tools covering repositories, branches, pull requests, issues, commits, search, gists, and workflows. Write operations support granular approval control out of the box.
+42 tools covering repositories, branches, pull requests, issues, commits, search, gists, and workflows. Write operations support granular approval control out of the box.
 
 ## Installation
 
@@ -62,11 +62,11 @@ createGithubTools({ token, preset: ['code-review', 'issue-triage'] })
 
 | Preset | Tools included |
 |---|---|
-| `code-review` | `getPullRequest`, `listPullRequests`, `getFileContent`, `listCommits`, `getCommit`, `getBlame`, `getRepository`, `listBranches`, `searchCode`, `addPullRequestComment` |
-| `issue-triage` | `listIssues`, `getIssue`, `createIssue`, `addIssueComment`, `closeIssue`, `getRepository`, `searchRepositories`, `searchCode` |
+| `code-review` | `getPullRequest`, `listPullRequests`, `listPullRequestFiles`, `listPullRequestReviews`, `getFileContent`, `listCommits`, `getCommit`, `getBlame`, `getRepository`, `listBranches`, `searchCode`, `addPullRequestComment`, `createPullRequestReview` |
+| `issue-triage` | `listIssues`, `getIssue`, `createIssue`, `addIssueComment`, `closeIssue`, `listLabels`, `addLabels`, `removeLabel`, `getRepository`, `searchRepositories`, `searchCode` |
 | `repo-explorer` | All read-only tools including gists and workflows (no write operations) |
 | `ci-ops` | `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`, `getRepository`, `listBranches`, `listCommits`, `getCommit` |
-| `maintainer` | All 36 tools |
+| `maintainer` | All 42 tools |
 
 Omit `preset` to get all tools (same as `maintainer`).
 
@@ -113,10 +113,34 @@ createGithubTools({
 })
 ```
 
-Write tools: `createOrUpdateFile`, `createPullRequest`, `mergePullRequest`, `addPullRequestComment`, `createIssue`, `addIssueComment`, `closeIssue`, `createGist`, `updateGist`, `deleteGist`, `createGistComment`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`.
+Write tools: `createOrUpdateFile`, `createPullRequest`, `mergePullRequest`, `addPullRequestComment`, `createPullRequestReview`, `createIssue`, `addIssueComment`, `closeIssue`, `addLabels`, `removeLabel`, `createGist`, `updateGist`, `deleteGist`, `createGistComment`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`.
 
 All other tools are read-only and never require approval.
 
+### Tool overrides
+
+The `overrides` option lets you customize any AI SDK [`tool()`](https://ai-sdk.dev/docs/ai-sdk-core/tools-and-tool-calling) property on a per-tool basis, keyed by tool name.
+
+```ts
+import type { ToolOverrides } from "@github-tools/sdk";
+```
+
+Supported override properties:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `description` | `string` | Custom tool description for the model |
+| `title` | `string` | Human-readable title |
+| `strict` | `boolean` | Strict mode for input generation |
+| `needsApproval` | `boolean \| function` | Gate execution behind approval |
+| `providerOptions` | `ProviderOptions` | Provider-specific metadata |
+| `onInputStart` | `function` | Callback when argument streaming starts |
+| `onInputDelta` | `function` | Callback on each streaming delta |
+| `onInputAvailable` | `function` | Callback when full input is available |
+| `toModelOutput` | `function` | Custom mapping of tool result to model output |
+
+Core properties (`execute`, `inputSchema`, `outputSchema`) cannot be overridden.
+
 ## Tool Selection with toolpick
 
 With dozens of tools, context window usage adds up. [toolpick](https://github.com/pontusab/toolpick) selects only the most relevant tools per step so the model sees what it needs:
@@ -181,9 +205,12 @@ All presets work with `createDurableGithubAgent`.
 |---|---|
 | `listPullRequests` | List PRs filtered by state |
 | `getPullRequest` | Get a PR's full details (diff stats, body, merge status) |
+| `listPullRequestFiles` | List files changed in a PR with diff status and patches |
+| `listPullRequestReviews` | List reviews on a PR (approvals, change requests, comments) |
 | `createPullRequest` | Open a new PR |
 | `mergePullRequest` | Merge a PR (merge, squash, or rebase) |
 | `addPullRequestComment` | Post a comment on a PR |
+| `createPullRequestReview` | Submit a formal review (approve, request changes, or comment) with inline comments |
 
 ### Issues
 
@@ -194,6 +221,9 @@ All presets work with `createDurableGithubAgent`.
 | `createIssue` | Open a new issue |
 | `addIssueComment` | Post a comment on an issue |
 | `closeIssue` | Close an issue (completed or not planned) |
+| `listLabels` | List labels available in a repository |
+| `addLabels` | Add labels to an issue or pull request |
+| `removeLabel` | Remove a label from an issue or pull request |
 
 ### Gists
 
@@ -247,10 +277,10 @@ Create one at **GitHub → Settings → Developer settings → Personal access t
 | **Metadata** | Read-only | Always required (auto-included) |
 | **Contents** | Read-only | `getRepository`, `listBranches`, `getFileContent`, `listCommits`, `getCommit`, `getBlame` |
 | **Contents** | Read and write | `createOrUpdateFile` |
-| **Pull requests** | Read-only | `listPullRequests`, `getPullRequest` |
-| **Pull requests** | Read and write | `createPullRequest`, `mergePullRequest`, `addPullRequestComment` |
-| **Issues** | Read-only | `listIssues`, `getIssue` |
-| **Issues** | Read and write | `createIssue`, `addIssueComment`, `closeIssue` |
+| **Pull requests** | Read-only | `listPullRequests`, `getPullRequest`, `listPullRequestFiles`, `listPullRequestReviews` |
+| **Pull requests** | Read and write | `createPullRequest`, `mergePullRequest`, `addPullRequestComment`, `createPullRequestReview` |
+| **Issues** | Read-only | `listIssues`, `getIssue`, `listLabels` |
+| **Issues** | Read and write | `createIssue`, `addIssueComment`, `closeIssue`, `addLabels`, `removeLabel` |
 
 | **Gists** | Read-only | `listGists`, `getGist`, `listGistComments` |
 | **Gists** | Read and write | `createGist`, `updateGist`, `deleteGist`, `createGistComment` |

package/dist/{agents-CnwdZ0Wk.d.mts → agents-C6nqZiYp.d.mts}

@@ -1,15 +1,20 @@
 import { ApprovalConfig, GithubToolPreset } from "./index.mjs";
 import * as ai from "ai";
-import { ToolLoopAgent, ToolLoopAgentSettings } from "ai";
+import { Tool, ToolLoopAgent, ToolLoopAgentSettings } from "ai";
 import { Octokit, Octokit as Octokit$1 } from "octokit";
 
-//#region src/client.d.ts
-declare function createOctokit(token: string): Octokit;
-//#endregion
 //#region src/types.d.ts
 type ToolOptions = {
   needsApproval?: boolean;
 };
+/**
+ * Per-tool overrides for customizing tool behavior without changing the underlying implementation.
+ * Properties like `execute`, `inputSchema`, and `outputSchema` are intentionally excluded.
+ */
+type ToolOverrides = Partial<Pick<Tool, 'description' | 'needsApproval' | 'onInputAvailable' | 'onInputDelta' | 'onInputStart' | 'providerOptions' | 'strict' | 'title' | 'toModelOutput'>>;
+//#endregion
+//#region src/client.d.ts
+declare function createOctokit(token: string): Octokit;
 //#endregion
 //#region src/tools/repository.d.ts
 declare const getRepository: (token: string) => ai.Tool<{
@@ -227,6 +232,56 @@ declare const addPullRequestComment: (token: string, {
   author: string | undefined;
   createdAt: string;
 }>;
+declare const listPullRequestFiles: (token: string) => ai.Tool<{
+  owner: string;
+  repo: string;
+  pullNumber: number;
+  perPage: number;
+  page: number;
+}, {
+  filename: string;
+  status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
+  additions: number;
+  deletions: number;
+  changes: number;
+  patch: string | undefined;
+}[]>;
+declare const listPullRequestReviews: (token: string) => ai.Tool<{
+  owner: string;
+  repo: string;
+  pullNumber: number;
+  perPage: number;
+  page: number;
+}, {
+  id: number;
+  state: string;
+  body: string;
+  author: string | undefined;
+  url: string;
+  submittedAt: string | undefined;
+}[]>;
+declare const createPullRequestReview: (token: string, {
+  needsApproval
+}?: ToolOptions) => ai.Tool<{
+  owner: string;
+  repo: string;
+  pullNumber: number;
+  event: "APPROVE" | "REQUEST_CHANGES" | "COMMENT";
+  body?: string | undefined;
+  comments?: {
+    path: string;
+    body: string;
+    line?: number | undefined;
+    side?: "LEFT" | "RIGHT" | undefined;
+  }[] | undefined;
+}, {
+  id: number;
+  state: string;
+  body: string;
+  url: string;
+  author: string | undefined;
+  submittedAt: string | undefined;
+}>;
 //#endregion
 //#region src/tools/issues.d.ts
 declare const listIssues: (token: string) => ai.Tool<{
@@ -307,6 +362,40 @@ declare const closeIssue: (token: string, {
   url: string;
   closedAt: string | null;
 }>;
+declare const listLabels: (token: string) => ai.Tool<{
+  owner: string;
+  repo: string;
+  perPage: number;
+  page: number;
+}, {
+  name: string;
+  color: string;
+  description: string | null;
+}[]>;
+declare const addLabels: (token: string, {
+  needsApproval
+}?: ToolOptions) => ai.Tool<{
+  owner: string;
+  repo: string;
+  issueNumber: number;
+  labels: string[];
+}, {
+  name: string;
+  color: string;
+  description: string | null;
+}[]>;
+declare const removeLabel: (token: string, {
+  needsApproval
+}?: ToolOptions) => ai.Tool<{
+  owner: string;
+  repo: string;
+  issueNumber: number;
+  label: string;
+}, {
+  removed: boolean;
+  label: string;
+  issueNumber: number;
+}>;
 //#endregion
 //#region src/tools/search.d.ts
 declare const searchCode: (token: string) => ai.Tool<{
@@ -688,5 +777,5 @@ declare function createGithubAgent({
   ...agentOptions
 }: CreateGithubAgentOptions): ToolLoopAgent<never, {}, never>;
 //#endregion
-export { listPullRequests as A, ToolOptions as B, closeIssue as C, addPullRequestComment as D, listIssues as E, forkRepository as F, getFileContent as I, getRepository as L, createBranch as M, createOrUpdateFile as N, createPullRequest as O, createRepository as P, listBranches as R, addIssueComment as S, getIssue as T, createOctokit as V, getBlame as _, listWorkflowJobs as a, searchCode as b, rerunWorkflowRun as c, createGistComment as d, deleteGist as f, updateGist as g, listGists as h, getWorkflowRun as i, mergePullRequest as j, getPullRequest as k, triggerWorkflow as l, listGistComments as m, createGithubAgent as n, listWorkflowRuns as o, getGist as p, cancelWorkflowRun as r, listWorkflows as s, CreateGithubAgentOptions as t, createGist as u, getCommit as v, createIssue as w, searchRepositories as x, listCommits as y, Octokit$1 as z };
-//# sourceMappingURL=agents-CnwdZ0Wk.d.mts.map
+export { addPullRequestComment as A, createRepository as B, addLabels as C, listIssues as D, getIssue as E, listPullRequestReviews as F, createOctokit as G, getFileContent as H, listPullRequests as I, ToolOverrides as J, Octokit$1 as K, mergePullRequest as L, createPullRequestReview as M, getPullRequest as N, listLabels as O, listPullRequestFiles as P, createBranch as R, addIssueComment as S, createIssue as T, getRepository as U, forkRepository as V, listBranches as W, getBlame as _, listWorkflowJobs as a, searchCode as b, rerunWorkflowRun as c, createGistComment as d, deleteGist as f, updateGist as g, listGists as h, getWorkflowRun as i, createPullRequest as j, removeLabel as k, triggerWorkflow as l, listGistComments as m, createGithubAgent as n, listWorkflowRuns as o, getGist as p, ToolOptions as q, cancelWorkflowRun as r, listWorkflows as s, CreateGithubAgentOptions as t, createGist as u, getCommit as v, closeIssue as w, searchRepositories as x, listCommits as y, createOrUpdateFile as z };
+//# sourceMappingURL=agents-C6nqZiYp.d.mts.map

package/dist/agents-C6nqZiYp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-C6nqZiYp.d.mts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/tools/repository.ts","../src/tools/pull-requests.ts","../src/tools/issues.ts","../src/tools/search.ts","../src/tools/commits.ts","../src/tools/gists.ts","../src/tools/workflows.ts","../src/agents.ts"],"mappings":";;;;;;KAIY,WAAA;EAAgB,aAAA;AAAA;;AAA5B;;;KAMY,aAAA,GAAgB,OAAA,CAC1B,IAAA,CACE,IAAA;;;iBCVY,aAAA,CAAc,KAAA,WAAgB,OAAA;;;cCuBjC,aAAA,GAAiB,KAAA,aAQ1B,EAAA,CARuC,IAAA;;;;;;;;;;;;;;;;;cAqB9B,YAAA,GAAgB,KAAA,aASzB,EAAA,CATsC,IAAA;;;;;;;;;cA+B7B,cAAA,GAAkB,KAAA,aAU3B,EAAA,CAVwC,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqC/B,YAAA,GAAgB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;cAkCzE,cAAA,GAAkB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;;;;;;;cA0C3E,gBAAA,GAAoB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;;;;;;;;cAqC7E,kBAAA,GAAsB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;;;;;cC5M/E,gBAAA,GAAoB,KAAA,aAU7B,EAAA,CAV0C,IAAA;;;;;;;;;;;;;;;;;cAqCjC,cAAA,GAAkB,KAAA,aAS3B,EAAA,CATwC,IAAA;;;;;;;;;;;;;;;;;;;;;;;cA0B/B,iBAAA,GAAqB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;;;;;;cAkC9E,gBAAA,GAAoB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;cA4B7E,qBAAA,GAAyB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;cA2BlF,oBAAA,GAAwB,KAAA,aAWjC,EAAA,CAX8C,IAAA;;;;;;;;;;;;;;cA2BrC,sBAAA,GAA0B,KAAA,aAWnC,EAAA,CAXgD,IAAA;;;;;;;;;;;;;;cAkCvC,uBAAA,GAA2B,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;;;;;;;;;;;cC/MpF,UAAA,GAAc,KAAA,aAWvB,EAAA,CAXoC,IAAA;;;;;;;;;;;;;;;;cAiC3B,QAAA,GAAY,KAAA,aASrB,EAAA,CATkC,IAAA;;;;;;;;;;;;;;;;;;cAwBzB,WAAA,GAAe,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;;;cA4BxE,eAAA,GAAmB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;cAgC5E,UAAA,GAAc,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;cAwBvE,UAAA,GAAc,KAAA,aAUvB,EAAA,CAVoC,IAAA;;;;;;;;;;cAuB3B,SAAA,GAAa,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;cAoBtE,WAAA,GAAe,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;cCjMxE,UAAA,GAAc,KAAA,aAQvB,EAAA,CARoC,IAAA;;;;;;;;;;;;;cA6B3B,kBAAA,GAAsB,KAAA,aAU/B,EAAA,CAV4C,IAAA;;;;;;;;;;;;;;;;;;;;cCsCnC,WAAA,GAAe,KAAA,aAexB,EAAA,CAfqC,IAAA;;;;;;;;;;;;;;;;;cA2C5B,SAAA,GAAa,KAAA,aAStB,EAAA,CATmC,IAAA;;;;;;;;;;;;;;;;;;;;;;;;cAwE1B,QAAA,GAAY,KAAA,aAgCrB,EAAA,CAhCkC,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cClLzB,SAAA,GAAa,KAAA,aAStB,EAAA,CATmC,IAAA;;;;;;;;;;;;;;;cAiC1B,OAAA,GAAW,KAAA,aAOpB,EAAA,CAPiC,IAAA;;;;;;;;;;;;;;;;;;cAuBxB,gBAAA,GAAoB,KAAA,aAS7B,EAAA,CAT0C,IAAA;;;;;;;;;;;;cA6BjC,UAAA,GAAc,KAAA;EAAe;AAAA,IAA0B,WAAA,QAAgB,IAAA;;;;;;;;;;;;;;cAkCvE,UAAA,GAAc,KAAA;EAAe;AAAA,IAA0B,WAAA,QAAgB,IAAA;;;;;;;;;;;;;cAqBvE,UAAA,GAAc,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;cAuBvE,iBAAA,GAAqB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;cCpK9E,aAAA,GAAiB,KAAA,aAU1B,EAAA,CAVuC,IAAA;;;;;;;;;;;;;;;;;cAwC9B,gBAAA,GAAoB,KAAA,aAc7B,EAAA,CAd0C,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;cAsCjC,cAAA,GAAkB,KAAA,aAS3B,EAAA,CATwC,IAAA;;;;;;;;;;;;;;;;;;;;cAsC/B,gBAAA,GAAoB,KAAA,aAY7B,EAAA,CAZ0C,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2BjC,eAAA,GAAmB,KAAA;EAAe;AAAA,IAA0B,WAAA,QAAgB,IAAA;;;;;;;;;;;cAqB5E,iBAAA,GAAqB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;cAuB9E,gBAAA,GAAoB,KAAA;EAAe;AAAA,IAA0B,WAAA,KAAgB,EAAA,CAAA,IAAA;;;;;;;;;;;;KC1HrF,YAAA,GAAe,IAAA,CAAK,qBAAA;AAAA,KAEb,wBAAA,GAA2B,YAAA;EACrC,KAAA,EAAO,qBAAA;ETjFG;;;;ESsFV,KAAA;EACA,MAAA,GAAS,gBAAA,GAAmB,gBAAA;EAC5B,eAAA,GAAkB,cAAA;EAClB,YAAA;EACA,sBAAA;AAAA;;;;;;;ARlGF;;;;;;;;ACuBA;;;;iBOgGgB,iBAAA,CAAA;EACd,KAAA;EACA,MAAA;EACA,eAAA;EACA,YAAA;EACA,sBAAA;EAAA,GACG;AAAA,GACF,wBAAA,GAAwB,aAAA"}

package/dist/{agents-Cdb0a8CP.mjs → agents-D9aKsd_7.mjs}

@@ -451,6 +451,114 @@ const addPullRequestComment = (token, { needsApproval = true } = {}) => tool({
 		...args
 	})
 });
+async function listPullRequestFilesStep({ token, owner, repo, pullNumber, perPage, page }) {
+	"use step";
+	const { data } = await createOctokit(token).rest.pulls.listFiles({
+		owner,
+		repo,
+		pull_number: pullNumber,
+		per_page: perPage,
+		page
+	});
+	return data.map((file) => ({
+		filename: file.filename,
+		status: file.status,
+		additions: file.additions,
+		deletions: file.deletions,
+		changes: file.changes,
+		patch: file.patch
+	}));
+}
+const listPullRequestFiles = (token) => tool({
+	description: "List files changed in a pull request, including diff status and patch content",
+	inputSchema: z.object({
+		owner: z.string().describe("Repository owner"),
+		repo: z.string().describe("Repository name"),
+		pullNumber: z.number().describe("Pull request number"),
+		perPage: z.number().optional().default(30).describe("Number of results to return (max 100)"),
+		page: z.number().optional().default(1).describe("Page number for pagination")
+	}),
+	execute: async (args) => listPullRequestFilesStep({
+		token,
+		...args
+	})
+});
+async function listPullRequestReviewsStep({ token, owner, repo, pullNumber, perPage, page }) {
+	"use step";
+	const { data } = await createOctokit(token).rest.pulls.listReviews({
+		owner,
+		repo,
+		pull_number: pullNumber,
+		per_page: perPage,
+		page
+	});
+	return data.map((review) => ({
+		id: review.id,
+		state: review.state,
+		body: review.body,
+		author: review.user?.login,
+		url: review.html_url,
+		submittedAt: review.submitted_at
+	}));
+}
+const listPullRequestReviews = (token) => tool({
+	description: "List reviews on a pull request (approvals, change requests, and comments)",
+	inputSchema: z.object({
+		owner: z.string().describe("Repository owner"),
+		repo: z.string().describe("Repository name"),
+		pullNumber: z.number().describe("Pull request number"),
+		perPage: z.number().optional().default(30).describe("Number of results to return (max 100)"),
+		page: z.number().optional().default(1).describe("Page number for pagination")
+	}),
+	execute: async (args) => listPullRequestReviewsStep({
+		token,
+		...args
+	})
+});
+async function createPullRequestReviewStep({ token, owner, repo, pullNumber, body, event, comments }) {
+	"use step";
+	const { data } = await createOctokit(token).rest.pulls.createReview({
+		owner,
+		repo,
+		pull_number: pullNumber,
+		body,
+		event,
+		comments
+	});
+	return {
+		id: data.id,
+		state: data.state,
+		body: data.body,
+		url: data.html_url,
+		author: data.user?.login,
+		submittedAt: data.submitted_at
+	};
+}
+const createPullRequestReview = (token, { needsApproval = true } = {}) => tool({
+	description: "Submit a pull request review — approve, request changes, or comment with optional inline comments on specific lines",
+	needsApproval,
+	inputSchema: z.object({
+		owner: z.string().describe("Repository owner"),
+		repo: z.string().describe("Repository name"),
+		pullNumber: z.number().describe("Pull request number"),
+		body: z.string().optional().describe("Review body text (supports Markdown)"),
+		event: z.enum([
+			"APPROVE",
+			"REQUEST_CHANGES",
+			"COMMENT"
+		]).describe("Review action: approve, request changes, or comment"),
+		comments: z.array(z.object({
+			path: z.string().describe("File path relative to the repository root"),
+			body: z.string().describe("Inline comment text"),
+			line: z.number().optional().describe("Line number in the file to comment on"),
+			side: z.enum(["LEFT", "RIGHT"]).optional().describe("Which side of the diff to comment on (LEFT = base, RIGHT = head)")
+		})).optional().describe("Inline review comments on specific files and lines")
+	}),
+	execute: async (args) => createPullRequestReviewStep({
+		token,
+		...args
+	})
+});
 
 //#endregion
 //#region src/tools/issues.ts
@@ -621,6 +729,89 @@ const closeIssue = (token, { needsApproval = true } = {}) => tool({
 		...args
 	})
 });
+async function listLabelsStep({ token, owner, repo, perPage, page }) {
+	"use step";
+	const { data } = await createOctokit(token).rest.issues.listLabelsForRepo({
+		owner,
+		repo,
+		per_page: perPage,
+		page
+	});
+	return data.map((label) => ({
+		name: label.name,
+		color: label.color,
+		description: label.description
+	}));
+}
+const listLabels = (token) => tool({
+	description: "List labels available in a GitHub repository",
+	inputSchema: z.object({
+		owner: z.string().describe("Repository owner"),
+		repo: z.string().describe("Repository name"),
+		perPage: z.number().optional().default(30).describe("Number of results to return (max 100)"),
+		page: z.number().optional().default(1).describe("Page number for pagination")
+	}),
+	execute: async (args) => listLabelsStep({
+		token,
+		...args
+	})
+});
+async function addLabelsStep({ token, owner, repo, issueNumber, labels }) {
+	"use step";
+	const { data } = await createOctokit(token).rest.issues.addLabels({
+		owner,
+		repo,
+		issue_number: issueNumber,
+		labels
+	});
+	return data.map((label) => ({
+		name: label.name,
+		color: label.color,
+		description: label.description
+	}));
+}
+const addLabels = (token, { needsApproval = true } = {}) => tool({
+	description: "Add labels to an issue or pull request",
+	needsApproval,
+	inputSchema: z.object({
+		owner: z.string().describe("Repository owner"),
+		repo: z.string().describe("Repository name"),
+		issueNumber: z.number().describe("Issue or pull request number"),
+		labels: z.array(z.string()).describe("Label names to add")
+	}),
+	execute: async (args) => addLabelsStep({
+		token,
+		...args
+	})
+});
+async function removeLabelStep({ token, owner, repo, issueNumber, label }) {
+	"use step";
+	await createOctokit(token).rest.issues.removeLabel({
+		owner,
+		repo,
+		issue_number: issueNumber,
+		name: label
+	});
+	return {
+		removed: true,
+		label,
+		issueNumber
+	};
+}
+const removeLabel = (token, { needsApproval = true } = {}) => tool({
+	description: "Remove a label from an issue or pull request",
+	needsApproval,
+	inputSchema: z.object({
+		owner: z.string().describe("Repository owner"),
+		repo: z.string().describe("Repository name"),
+		issueNumber: z.number().describe("Issue or pull request number"),
+		label: z.string().describe("Label name to remove")
+	}),
+	execute: async (args) => removeLabelStep({
+		token,
+		...args
+	})
+});
 
 //#endregion
 //#region src/tools/search.ts
@@ -1363,6 +1554,8 @@ When reviewing a PR:
 - Check for bugs, logic errors, and edge cases
 - Suggest improvements when you spot issues
 - Be constructive — explain why something is a problem and how to fix it
+- Use listPullRequestFiles to see exactly which files changed before diving into details
+- Use createPullRequestReview to submit a formal review with inline comments on specific lines
 - Post your review as PR comments when asked
 
 ${SHARED_RULES}`,
@@ -1373,6 +1566,7 @@ When triaging issues:
 - Identify duplicates when possible
 - Help categorize and prioritize issues
 - Respond to users with clear, helpful information
+- Use listLabels to see available labels, then addLabels and removeLabel to categorize issues
 - Create new issues when asked, with clear titles and descriptions
 
 ${SHARED_RULES}`,
@@ -1451,5 +1645,5 @@ function createGithubAgent({ token, preset, requireApproval, instructions, addit
 }
 
 //#endregion
-export { listPullRequests as A, closeIssue as C, addPullRequestComment as D, listIssues as E, forkRepository as F, getFileContent as I, getRepository as L, createBranch as M, createOrUpdateFile as N, createPullRequest as O, createRepository as P, listBranches as R, addIssueComment as S, getIssue as T, getBlame as _, listWorkflowJobs as a, searchCode as b, rerunWorkflowRun as c, createGistComment as d, deleteGist as f, updateGist as g, listGists as h, getWorkflowRun as i, mergePullRequest as j, getPullRequest as k, triggerWorkflow as l, listGistComments as m, resolveInstructions as n, listWorkflowRuns as o, getGist as p, cancelWorkflowRun as r, listWorkflows as s, createGithubAgent as t, createGist as u, getCommit as v, createIssue as w, searchRepositories as x, listCommits as y, createOctokit as z };
-//# sourceMappingURL=agents-Cdb0a8CP.mjs.map
+export { addPullRequestComment as A, createRepository as B, addLabels as C, listIssues as D, getIssue as E, listPullRequestReviews as F, createOctokit as G, getFileContent as H, listPullRequests as I, mergePullRequest as L, createPullRequestReview as M, getPullRequest as N, listLabels as O, listPullRequestFiles as P, createBranch as R, addIssueComment as S, createIssue as T, getRepository as U, forkRepository as V, listBranches as W, getBlame as _, listWorkflowJobs as a, searchCode as b, rerunWorkflowRun as c, createGistComment as d, deleteGist as f, updateGist as g, listGists as h, getWorkflowRun as i, createPullRequest as j, removeLabel as k, triggerWorkflow as l, listGistComments as m, resolveInstructions as n, listWorkflowRuns as o, getGist as p, cancelWorkflowRun as r, listWorkflows as s, createGithubAgent as t, createGist as u, getCommit as v, closeIssue as w, searchRepositories as x, listCommits as y, createOrUpdateFile as z };
+//# sourceMappingURL=agents-D9aKsd_7.mjs.map