memory-journal-mcp 4.4.2 → 5.0.0

package/dist/handlers/tools/github/milestone-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/github/milestone-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AA2D1E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAoU9E"}

package/dist/handlers/tools/github/milestone-tools.js

@@ -0,0 +1,302 @@
+/**
+ * GitHub Milestone Tools - 5 tools
+ *
+ * Tools: get_github_milestones, get_github_milestone,
+ *        create_github_milestone, update_github_milestone, delete_github_milestone
+ */
+import { z } from 'zod';
+import { formatHandlerError } from '../../../utils/error-helpers.js';
+import { GitHubMilestonesListOutputSchema, GitHubMilestoneResultOutputSchema, CreateMilestoneOutputSchema, UpdateMilestoneOutputSchema, DeleteMilestoneOutputSchema, } from './schemas.js';
+// ============================================================================
+// Helper: owner/repo resolution
+// ============================================================================
+async function resolveOwnerRepo(context, input, entityLabel) {
+    if (!context.github) {
+        return { error: true, response: { error: 'GitHub integration not available' } };
+    }
+    const repoInfo = await context.github.getRepoInfo();
+    const detectedOwner = repoInfo.owner;
+    const detectedRepo = repoInfo.repo;
+    const owner = input.owner ?? detectedOwner ?? undefined;
+    const repo = input.repo ?? detectedRepo ?? undefined;
+    if (!owner || !repo) {
+        return {
+            error: true,
+            response: {
+                error: 'STOP: Could not auto-detect repository. DO NOT GUESS. You MUST ask the user to provide the GitHub owner and repository name.',
+                requiresUserInput: true,
+                detectedOwner,
+                detectedRepo,
+                instruction: `Ask the user: "${entityLabel}"`,
+            },
+        };
+    }
+    return { owner, repo, detectedOwner, detectedRepo, github: context.github };
+}
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+export function getGitHubMilestoneTools(context) {
+    return [
+        {
+            name: 'get_github_milestones',
+            title: 'List GitHub Milestones',
+            description: 'List GitHub milestones for the repository with completion percentages and due dates.',
+            group: 'github',
+            inputSchema: z.object({
+                state: z
+                    .string()
+                    .optional()
+                    .default('open')
+                    .describe('Filter by state (default: open)'),
+                limit: z
+                    .number()
+                    .optional()
+                    .default(20)
+                    .describe('Max milestones to return (default: 20)'),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+            }),
+            outputSchema: GitHubMilestonesListOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        state: z.enum(['open', 'closed', 'all']).optional().default('open'),
+                        limit: z.number().optional().default(20),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'What GitHub repository should I list milestones for? Please provide the owner and repo name (e.g., owner/repo).');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const milestones = await resolved.github.getMilestones(resolved.owner, resolved.repo, input.state, input.limit);
+                    const milestonesWithPercentage = milestones.map((ms) => {
+                        const total = ms.openIssues + ms.closedIssues;
+                        const completionPercentage = total > 0 ? Math.round((ms.closedIssues / total) * 100) : 0;
+                        return { ...ms, completionPercentage };
+                    });
+                    return {
+                        milestones: milestonesWithPercentage,
+                        count: milestonesWithPercentage.length,
+                        owner: resolved.owner,
+                        repo: resolved.repo,
+                        detectedOwner: resolved.detectedOwner,
+                        detectedRepo: resolved.detectedRepo,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'get_github_milestone',
+            title: 'Get GitHub Milestone Details',
+            description: 'Get detailed information about a specific GitHub milestone including progress and linked issue counts.',
+            group: 'github',
+            inputSchema: z.object({
+                milestone_number: z.number().describe('Milestone number'),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+            }),
+            outputSchema: GitHubMilestoneResultOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        milestone_number: z.number(),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'What GitHub repository is this milestone from? Please provide the owner and repo name (e.g., owner/repo).');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const milestone = await resolved.github.getMilestone(resolved.owner, resolved.repo, input.milestone_number);
+                    if (!milestone) {
+                        return {
+                            error: `Milestone #${String(input.milestone_number)} not found`,
+                            owner: resolved.owner,
+                            repo: resolved.repo,
+                            detectedOwner: resolved.detectedOwner,
+                            detectedRepo: resolved.detectedRepo,
+                        };
+                    }
+                    const total = milestone.openIssues + milestone.closedIssues;
+                    const completionPercentage = total > 0 ? Math.round((milestone.closedIssues / total) * 100) : 0;
+                    return {
+                        milestone: { ...milestone, completionPercentage },
+                        owner: resolved.owner,
+                        repo: resolved.repo,
+                        detectedOwner: resolved.detectedOwner,
+                        detectedRepo: resolved.detectedRepo,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'create_github_milestone',
+            title: 'Create GitHub Milestone',
+            description: 'Create a new GitHub milestone for tracking progress toward a project goal.',
+            group: 'github',
+            inputSchema: z.object({
+                title: z.string().min(1).describe('Milestone title'),
+                description: z.string().optional().describe('Milestone description'),
+                due_on: z.string().optional().describe('Due date in YYYY-MM-DD format (optional)'),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
+            }),
+            outputSchema: CreateMilestoneOutputSchema,
+            annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        title: z.string().min(1),
+                        description: z.string().optional(),
+                        due_on: z.string().optional(),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'What GitHub repository should I create the milestone in?');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const dueOn = input.due_on ? `${input.due_on}T08:00:00Z` : undefined;
+                    const milestone = await resolved.github.createMilestone(resolved.owner, resolved.repo, input.title, input.description, dueOn);
+                    if (!milestone) {
+                        return {
+                            success: false,
+                            error: 'Failed to create milestone. Check GITHUB_TOKEN permissions.',
+                        };
+                    }
+                    return {
+                        success: true,
+                        milestone: { ...milestone, completionPercentage: 0 },
+                        message: `Created milestone #${String(milestone.number)}: ${milestone.title}`,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'update_github_milestone',
+            title: 'Update GitHub Milestone',
+            description: 'Update a GitHub milestone (title, description, due date, or state). Use state "closed" to close a completed milestone.',
+            group: 'github',
+            inputSchema: z.object({
+                milestone_number: z.number().describe('Milestone number to update'),
+                title: z.string().optional().describe('New title'),
+                description: z.string().optional().describe('New description'),
+                due_on: z.string().optional().describe('New due date in YYYY-MM-DD format'),
+                state: z.string().optional().describe('Set to "closed" to close the milestone'),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
+            }),
+            outputSchema: UpdateMilestoneOutputSchema,
+            annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        milestone_number: z.number(),
+                        title: z.string().optional(),
+                        description: z.string().optional(),
+                        due_on: z.string().optional(),
+                        state: z.enum(['open', 'closed']).optional(),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'What GitHub repository is this milestone in?');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const dueOn = input.due_on ? `${input.due_on}T08:00:00Z` : undefined;
+                    const milestone = await resolved.github.updateMilestone(resolved.owner, resolved.repo, input.milestone_number, {
+                        title: input.title,
+                        description: input.description,
+                        dueOn,
+                        state: input.state,
+                    });
+                    if (!milestone) {
+                        return {
+                            success: false,
+                            error: `Failed to update milestone #${String(input.milestone_number)}. Check that it exists and GITHUB_TOKEN has permissions.`,
+                        };
+                    }
+                    const total = milestone.openIssues + milestone.closedIssues;
+                    const completionPercentage = total > 0 ? Math.round((milestone.closedIssues / total) * 100) : 0;
+                    return {
+                        success: true,
+                        milestone: { ...milestone, completionPercentage },
+                        message: `Updated milestone #${String(milestone.number)}: ${milestone.title}`,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'delete_github_milestone',
+            title: 'Delete GitHub Milestone',
+            description: 'Permanently delete a GitHub milestone. Issues assigned to the milestone will be un-assigned but not deleted.',
+            group: 'github',
+            inputSchema: z.object({
+                milestone_number: z.number().describe('Milestone number to delete'),
+                confirm: z.literal(true).describe('Must be set to true to confirm deletion'),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect'),
+            }),
+            outputSchema: DeleteMilestoneOutputSchema,
+            annotations: {
+                readOnlyHint: false,
+                idempotentHint: false,
+                destructiveHint: true,
+                openWorldHint: true,
+            },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        milestone_number: z.number(),
+                        confirm: z.literal(true),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'What GitHub repository is this milestone in?');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const result = await resolved.github.deleteMilestone(resolved.owner, resolved.repo, input.milestone_number);
+                    if (!result.success) {
+                        return {
+                            success: false,
+                            milestoneNumber: input.milestone_number,
+                            message: `Failed to delete milestone #${String(input.milestone_number)}`,
+                            error: result.error ?? undefined,
+                        };
+                    }
+                    return {
+                        success: true,
+                        milestoneNumber: input.milestone_number,
+                        message: `Deleted milestone #${String(input.milestone_number)}`,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=milestone-tools.js.map

package/dist/handlers/tools/github/milestone-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-tools.js","sourceRoot":"","sources":["../../../../src/handlers/tools/github/milestone-tools.ts"],"names":[],"mappings":"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"}

package/dist/handlers/tools/github/mutation-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GitHub Mutation Tools - Barrel file
+ *
+ * Composes kanban tools and issue tools into a single export
+ * for backward compatibility with existing imports.
+ */
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+/**
+ * Get all GitHub mutation tools (kanban + issue management)
+ */
+export declare function getGitHubMutationTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=mutation-tools.d.ts.map

package/dist/handlers/tools/github/mutation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/github/mutation-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAI1E;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAE7E"}

package/dist/handlers/tools/github/mutation-tools.js

@@ -0,0 +1,15 @@
+/**
+ * GitHub Mutation Tools - Barrel file
+ *
+ * Composes kanban tools and issue tools into a single export
+ * for backward compatibility with existing imports.
+ */
+import { getKanbanTools } from './kanban-tools.js';
+import { getGitHubIssueTools } from './issue-tools.js';
+/**
+ * Get all GitHub mutation tools (kanban + issue management)
+ */
+export function getGitHubMutationTools(context) {
+    return [...getKanbanTools(context), ...getGitHubIssueTools(context)];
+}
+//# sourceMappingURL=mutation-tools.js.map

package/dist/handlers/tools/github/mutation-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-tools.js","sourceRoot":"","sources":["../../../../src/handlers/tools/github/mutation-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACvD,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAA;AACxE,CAAC"}

package/dist/handlers/tools/github/read-tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GitHub Read Tools - 5 tools
+ *
+ * Tools: get_github_issues, get_github_prs, get_github_issue, get_github_pr, get_github_context
+ */
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getGitHubReadTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=read-tools.d.ts.map

package/dist/handlers/tools/github/read-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/github/read-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AA4D1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAoQzE"}

package/dist/handlers/tools/github/read-tools.js

@@ -0,0 +1,260 @@
+/**
+ * GitHub Read Tools - 5 tools
+ *
+ * Tools: get_github_issues, get_github_prs, get_github_issue, get_github_pr, get_github_context
+ */
+import { z } from 'zod';
+import { formatHandlerError } from '../../../utils/error-helpers.js';
+import { GitHubIssuesListOutputSchema, GitHubIssueResultOutputSchema, GitHubPRsListOutputSchema, GitHubPRResultOutputSchema, GitHubContextOutputSchema, } from './schemas.js';
+// ============================================================================
+// Helper: owner/repo resolution with "STOP" pattern
+// ============================================================================
+async function resolveOwnerRepo(context, input, entityLabel) {
+    if (!context.github) {
+        return { error: true, response: { error: 'GitHub integration not available' } };
+    }
+    const repoInfo = await context.github.getRepoInfo();
+    const detectedOwner = repoInfo.owner;
+    const detectedRepo = repoInfo.repo;
+    const owner = input.owner ?? detectedOwner ?? undefined;
+    const repo = input.repo ?? detectedRepo ?? undefined;
+    if (!owner || !repo) {
+        return {
+            error: true,
+            response: {
+                error: `STOP: Could not auto-detect repository. DO NOT GUESS. You MUST ask the user to provide the GitHub owner and repository name.`,
+                requiresUserInput: true,
+                detectedOwner,
+                detectedRepo,
+                instruction: `Ask the user: "What GitHub repository ${entityLabel}? Please provide the owner and repo name (e.g., owner/repo)."`,
+            },
+        };
+    }
+    return { owner, repo, detectedOwner, detectedRepo, github: context.github };
+}
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+export function getGitHubReadTools(context) {
+    return [
+        {
+            name: 'get_github_issues',
+            title: 'Get GitHub Issues',
+            description: 'List issues from a GitHub repository. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
+            group: 'github',
+            inputSchema: z.object({
+                owner: z
+                    .string()
+                    .optional()
+                    .describe('Repository owner - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'),
+                repo: z
+                    .string()
+                    .optional()
+                    .describe('Repository name - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'),
+                state: z.string().optional().default('open'),
+                limit: z.number().optional().default(20),
+            }),
+            outputSchema: GitHubIssuesListOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                        state: z.enum(['open', 'closed', 'all']).optional().default('open'),
+                        limit: z.number().optional().default(20),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'would you like to query');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const issues = await resolved.github.getIssues(resolved.owner, resolved.repo, input.state, input.limit);
+                    return {
+                        owner: resolved.owner,
+                        repo: resolved.repo,
+                        detectedOwner: resolved.detectedOwner,
+                        detectedRepo: resolved.detectedRepo,
+                        issues,
+                        count: issues.length,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'get_github_prs',
+            title: 'Get GitHub Pull Requests',
+            description: 'List pull requests from a GitHub repository. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
+            group: 'github',
+            inputSchema: z.object({
+                owner: z
+                    .string()
+                    .optional()
+                    .describe('Repository owner - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'),
+                repo: z
+                    .string()
+                    .optional()
+                    .describe('Repository name - LEAVE EMPTY to auto-detect from git. Only specify if user explicitly provides.'),
+                state: z.string().optional().default('open'),
+                limit: z.number().optional().default(20),
+            }),
+            outputSchema: GitHubPRsListOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                        state: z.enum(['open', 'closed', 'all']).optional().default('open'),
+                        limit: z.number().optional().default(20),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'would you like to query');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const pullRequests = await resolved.github.getPullRequests(resolved.owner, resolved.repo, input.state, input.limit);
+                    return {
+                        owner: resolved.owner,
+                        repo: resolved.repo,
+                        detectedOwner: resolved.detectedOwner,
+                        detectedRepo: resolved.detectedRepo,
+                        pullRequests,
+                        count: pullRequests.length,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'get_github_issue',
+            title: 'Get GitHub Issue Details',
+            description: 'Get detailed information about a specific GitHub issue. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
+            group: 'github',
+            inputSchema: z.object({
+                issue_number: z.number(),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+            }),
+            outputSchema: GitHubIssueResultOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        issue_number: z.number(),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'is this issue from');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const issue = await resolved.github.getIssue(resolved.owner, resolved.repo, input.issue_number);
+                    if (!issue) {
+                        return {
+                            error: `Issue #${String(input.issue_number)} not found`,
+                            owner: resolved.owner,
+                            repo: resolved.repo,
+                            detectedOwner: resolved.detectedOwner,
+                            detectedRepo: resolved.detectedRepo,
+                        };
+                    }
+                    return {
+                        issue,
+                        owner: resolved.owner,
+                        repo: resolved.repo,
+                        detectedOwner: resolved.detectedOwner,
+                        detectedRepo: resolved.detectedRepo,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'get_github_pr',
+            title: 'Get GitHub PR Details',
+            description: 'Get detailed information about a specific GitHub pull request. IMPORTANT: Do NOT guess owner/repo values - leave them empty to auto-detect from the current git repository.',
+            group: 'github',
+            inputSchema: z.object({
+                pr_number: z.number(),
+                owner: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+                repo: z.string().optional().describe('LEAVE EMPTY to auto-detect from git'),
+            }),
+            outputSchema: GitHubPRResultOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (params) => {
+                try {
+                    const input = z
+                        .object({
+                        pr_number: z.number(),
+                        owner: z.string().optional(),
+                        repo: z.string().optional(),
+                    })
+                        .parse(params);
+                    const resolved = await resolveOwnerRepo(context, input, 'is this PR from');
+                    if ('error' in resolved)
+                        return resolved.response;
+                    const pullRequest = await resolved.github.getPullRequest(resolved.owner, resolved.repo, input.pr_number);
+                    if (!pullRequest) {
+                        return {
+                            error: `PR #${String(input.pr_number)} not found`,
+                            owner: resolved.owner,
+                            repo: resolved.repo,
+                            detectedOwner: resolved.detectedOwner,
+                            detectedRepo: resolved.detectedRepo,
+                        };
+                    }
+                    return {
+                        pullRequest,
+                        owner: resolved.owner,
+                        repo: resolved.repo,
+                        detectedOwner: resolved.detectedOwner,
+                        detectedRepo: resolved.detectedRepo,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+        {
+            name: 'get_github_context',
+            title: 'Get GitHub Repository Context',
+            description: 'Get current repository context including branch, open issues, and open PRs. Only counts OPEN items (closed items excluded).',
+            group: 'github',
+            inputSchema: z.object({}),
+            outputSchema: GitHubContextOutputSchema,
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+            handler: async (_params) => {
+                try {
+                    if (!context.github) {
+                        return { error: 'GitHub integration not available' };
+                    }
+                    const ctx = await context.github.getRepoContext();
+                    return {
+                        repoName: ctx.repoName,
+                        branch: ctx.branch,
+                        commit: ctx.commit,
+                        remoteUrl: ctx.remoteUrl,
+                        issues: ctx.issues,
+                        pullRequests: ctx.pullRequests,
+                        issueCount: ctx.issues.length,
+                        prCount: ctx.pullRequests.length,
+                    };
+                }
+                catch (err) {
+                    return formatHandlerError(err);
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=read-tools.js.map