@hanhnd/agent-kit 1.0.42 → 1.0.44

package/dist/mcp/integration.d.ts

@@ -1,6 +1,158 @@
 /**
- * Integration Tools - Bitbucket, Jira
- * Tools: kit_get_bitbucket_pr, kit_jira_get_ticket
+ * Integration Tools - Bitbucket, Jira, Confluence
+ * Tools: kit_get_bitbucket_pr, kit_create_bitbucket_pr, kit_find_bitbucket_reviewers, kit_get_bitbucket_pr_comments, kit_jira_get_ticket, kit_confluence_get_page
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Payload size (chars) at or above which a body is spilled to a temp file
+ * instead of inlined into the agent context.
+ */
+export declare const LARGE_PAYLOAD_THRESHOLD = 50000;
+export type ConfluenceIdResolution = {
+    kind: 'id';
+    pageId: string;
+} | {
+    kind: 'tiny';
+} | {
+    kind: 'blog';
+} | {
+    kind: 'unknown';
+};
+export interface AtlassianContext {
+    auth: string;
+    cloudId: string;
+}
+/**
+ * API token scopes each tool needs, from Atlassian's OpenAPI specs (`x-atlassian-oauth2-scopes`).
+ * Used for 401/403 hints; mcp/README.md lists the same scopes for setup.
+ */
+export declare const REQUIRED_SCOPES: {
+    readonly kit_get_bitbucket_pr: readonly ["read:pullrequest:bitbucket", "read:repository:bitbucket"];
+    readonly kit_get_bitbucket_pr_comments: readonly ["read:pullrequest:bitbucket"];
+    readonly kit_create_bitbucket_pr: readonly ["read:pullrequest:bitbucket", "write:pullrequest:bitbucket", "read:workspace:bitbucket", "read:user:bitbucket"];
+    readonly kit_find_bitbucket_reviewers: readonly ["read:workspace:bitbucket", "read:user:bitbucket"];
+    readonly kit_jira_get_ticket: readonly ["read:jira-work"];
+    readonly kit_confluence_get_page: readonly ["read:page:confluence"];
+};
+/** Resolve the shared cloud id plus the product's basic-auth header (shared email, own token). */
+export declare function buildAtlassianContext(product: 'jira' | 'confluence'): AtlassianContext;
+/**
+ * Resolve a user-supplied Confluence reference to a numeric page id.
+ *
+ * The blog branch MUST stay ahead of numeric extraction: a blog URL carries date and
+ * post-id segments that generic extraction would misread as a page id, silently
+ * fetching the wrong content.
+ */
+export declare function resolveConfluencePageId(input: string): ConfluenceIdResolution;
+/**
+ * Handler for kit_confluence_get_page. Exported (rather than living inside the
+ * registerTool closure) so behaviour is unit testable without a transport or network.
+ * Never rejects — every failure path resolves to an actionable mcpText message.
+ */
+export declare function handleConfluenceGetPage(args: {
+    input: string;
+}): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}>;
+/** Safety cap on followed pagination pages (100 items each). */
+export declare const MAX_PAGES = 20;
+export type BitbucketRef<T> = ({
+    ok: true;
+} & T) | {
+    ok: false;
+    error: string;
+};
+/** Resolve a PR URL, or a numeric PR id plus workspace/repoSlug, to its coordinates. */
+export declare function resolveBitbucketPr(input: string, workspace?: string, repoSlug?: string): BitbucketRef<{
+    ws: string;
+    repo: string;
+    prId: number;
+}>;
+/** Resolve a repo URL, `workspace/repo`, or a bare repo slug (plus workspace or default) to its coordinates. */
+export declare function resolveBitbucketRepo(repository: string, workspace?: string): BitbucketRef<{
+    ws: string;
+    repo: string;
+}>;
+export interface BitbucketMember {
+    uuid: string;
+    displayName: string;
+    nickname?: string;
+}
+export interface ReviewerResolution {
+    resolved: Array<{
+        query: string;
+        member: BitbucketMember;
+    }>;
+    ambiguous: Array<{
+        query: string;
+        candidates: BitbucketMember[];
+    }>;
+    unmatched: string[];
+}
+/** Lowercase and strip diacritics so "Dũng" matches "Dung" and "Đức" matches "Duc". */
+export declare function normalizeName(value: string): string;
+/**
+ * Match reviewer queries against workspace members. A query matches a member by exact
+ * display name / nickname first; failing that, when every word of the query is a whole
+ * word of the member's name ("Dung" → "Nguyen Tien Dung"). More than one hit is ambiguous —
+ * never guessed. UUID queries must be resolved by the caller before this runs.
+ */
+export declare function matchReviewers(queries: string[], members: BitbucketMember[]): ReviewerResolution;
+export interface FindBitbucketReviewersArgs {
+    names: string[];
+    workspace?: string;
+}
+/**
+ * Handler for kit_find_bitbucket_reviewers: dry-run of the reviewer resolution that
+ * kit_create_bitbucket_pr performs, so callers can verify names before pushing anything.
+ * Never rejects — every failure path resolves to an actionable mcpText message.
+ */
+export declare function handleFindBitbucketReviewers(args: FindBitbucketReviewersArgs): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}>;
+export interface CreateBitbucketPrArgs {
+    repository: string;
+    workspace?: string;
+    title: string;
+    sourceBranch: string;
+    destinationBranch?: string;
+    description?: string;
+    closeSourceBranch?: boolean;
+    draft?: boolean;
+    reviewers?: string[];
+}
+/**
+ * Handler for kit_create_bitbucket_pr. Exported so it is unit testable without a transport.
+ * Never rejects — every failure path resolves to an actionable mcpText message.
+ */
+export declare function handleCreateBitbucketPr(args: CreateBitbucketPrArgs): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}>;
+export interface GetBitbucketPrCommentsArgs {
+    input: string;
+    workspace?: string;
+    repoSlug?: string;
+    includeResolved?: boolean;
+    includeDeleted?: boolean;
+}
+/**
+ * Handler for kit_get_bitbucket_pr_comments. Follows `next` links (pagelen=100) up to
+ * MAX_PAGES, then renders threads: general comments first, inline ones grouped by file.
+ * Never rejects — every failure path resolves to an actionable mcpText message.
+ */
+export declare function handleGetBitbucketPrComments(args: GetBitbucketPrCommentsArgs): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}>;
 export declare function registerIntegrationTools(server: McpServer): void;