@ekho/gitlab-mcp 1.1.0

package/dist/groups/work_items/tools.js

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+import { safe } from '../../shared/handlers.js';
+import { toGlobalId } from '../../shared/ids.js';
+import { WORK_ITEMS_LIST, WORK_ITEM_CREATE, WORK_ITEM_DELETE, WORK_ITEM_GET, WORK_ITEM_TYPES, WORK_ITEM_UPDATE, } from './queries.js';
+/** Resolve a work-item type name ("Issue", "Task", ...) to its global id within a namespace. */
+async function resolveTypeId(ctx, namespace, typeName) {
+    const data = await ctx.graphql.query({
+        query: WORK_ITEM_TYPES,
+        variables: { namespace },
+    });
+    const types = data.namespace?.workItemTypes?.nodes ?? [];
+    const wanted = typeName.toLowerCase();
+    const match = types.find((t) => t.name.toLowerCase() === wanted);
+    if (!match) {
+        const available = types.map((t) => t.name).join(', ');
+        throw new Error(`Work item type "${typeName}" is not available in namespace "${namespace}". Available: ${available || '(none)'}`);
+    }
+    return match.id;
+}
+const NamespaceArg = z
+    .string()
+    .min(1)
+    .describe('Group or project full path, e.g. "my-group/my-project".');
+const SortArg = z
+    .enum([
+    'CREATED_ASC',
+    'CREATED_DESC',
+    'UPDATED_ASC',
+    'UPDATED_DESC',
+    'TITLE_ASC',
+    'TITLE_DESC',
+    'PRIORITY_ASC',
+    'PRIORITY_DESC',
+])
+    .optional();
+// Keep types loose — GitLab adds new ones (TICKET, etc.) over time.
+const TypeArg = z.string().describe('Work item type name (Issue, Task, Incident, Epic, ...).');
+export function registerWorkItemTools(server, ctx) {
+    server.tool('work_item_list', 'List work items (issues, tasks, incidents, epics) in a namespace (group or project full path). Uses GraphQL.', {
+        namespace: NamespaceArg,
+        first: z.number().int().positive().max(100).optional().describe('Page size, max 100.'),
+        after: z.string().optional().describe('Cursor from previous page (pageInfo.endCursor).'),
+        state: z.enum(['opened', 'closed', 'all', 'locked']).optional(),
+        types: z.array(TypeArg).optional().describe('Filter by type names (uppercased internally).'),
+        search: z.string().optional(),
+        assignee_usernames: z.array(z.string()).optional(),
+        author_username: z.string().optional(),
+        milestone_title: z.array(z.string()).optional(),
+        iids: z.array(z.string()).optional(),
+        sort: SortArg,
+    }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: WORK_ITEMS_LIST,
+            variables: {
+                namespace: args.namespace,
+                first: args.first ?? 20,
+                after: args.after,
+                state: args.state,
+                types: args.types?.map((t) => t.toUpperCase()),
+                search: args.search,
+                assigneeUsernames: args.assignee_usernames,
+                authorUsername: args.author_username,
+                milestoneTitle: args.milestone_title,
+                iids: args.iids,
+                sort: args.sort,
+            },
+        });
+        if (!data.namespace) {
+            throw new Error(`Namespace "${args.namespace}" not found or not accessible.`);
+        }
+        return {
+            items: data.namespace.workItems.nodes,
+            page_info: data.namespace.workItems.pageInfo,
+        };
+    }));
+    server.tool('work_item_get', 'Get a single work item by its iid within a namespace.', {
+        namespace: NamespaceArg,
+        iid: z.union([z.string(), z.number()]).describe('Internal id of the work item.'),
+    }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({
+            query: WORK_ITEM_GET,
+            variables: { namespace: args.namespace, iid: String(args.iid) },
+        });
+        if (!data.namespace) {
+            throw new Error(`Namespace "${args.namespace}" not found or not accessible.`);
+        }
+        if (!data.namespace.workItem) {
+            throw new Error(`Work item iid=${args.iid} not found in "${args.namespace}".`);
+        }
+        return data.namespace.workItem;
+    }));
+    server.tool('work_item_types_list', 'List the work item types available in a namespace (returns id and name for each, useful before creating).', { namespace: NamespaceArg }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({ query: WORK_ITEM_TYPES, variables: { namespace: args.namespace } });
+        if (!data.namespace) {
+            throw new Error(`Namespace "${args.namespace}" not found or not accessible.`);
+        }
+        return data.namespace.workItemTypes.nodes;
+    }));
+    server.tool('work_item_create', 'Create a new work item. Type is resolved from name (e.g. "Issue", "Task", "Epic"). Use `parent_id` (numeric WorkItem id, not iid) to nest under a parent — required for tasks/sub-epics.', {
+        namespace: NamespaceArg,
+        type: TypeArg,
+        title: z.string().min(1),
+        description: z.string().optional(),
+        confidential: z.boolean().optional(),
+        assignee_ids: z.array(z.number().int()).optional().describe('Numeric user ids.'),
+        label_ids: z.array(z.number().int()).optional().describe('Numeric label ids.'),
+        milestone_id: z.number().int().optional(),
+        iteration_id: z.number().int().optional(),
+        parent_id: z.number().int().optional().describe('Numeric WorkItem id of the parent.'),
+        start_date: z.string().optional().describe('YYYY-MM-DD'),
+        due_date: z.string().optional(),
+        weight: z.number().int().optional(),
+    }, async (args) => safe(async () => {
+        const workItemTypeId = await resolveTypeId(ctx, args.namespace, args.type);
+        const input = {
+            namespacePath: args.namespace,
+            workItemTypeId,
+            title: args.title,
+        };
+        if (args.confidential !== undefined)
+            input['confidential'] = args.confidential;
+        if (args.description !== undefined) {
+            input['descriptionWidget'] = { description: args.description };
+        }
+        if (args.assignee_ids) {
+            input['assigneesWidget'] = {
+                assigneeIds: args.assignee_ids.map((id) => toGlobalId('User', id)),
+            };
+        }
+        if (args.label_ids) {
+            input['labelsWidget'] = {
+                labelIds: args.label_ids.map((id) => toGlobalId('Label', id)),
+            };
+        }
+        if (args.milestone_id !== undefined) {
+            input['milestoneWidget'] = { milestoneId: toGlobalId('Milestone', args.milestone_id) };
+        }
+        if (args.iteration_id !== undefined) {
+            input['iterationWidget'] = {
+                iterationId: toGlobalId('Iteration', args.iteration_id),
+            };
+        }
+        if (args.parent_id !== undefined) {
+            input['hierarchyWidget'] = { parentId: toGlobalId('WorkItem', args.parent_id) };
+        }
+        if (args.start_date !== undefined || args.due_date !== undefined) {
+            input['startAndDueDateWidget'] = {
+                ...(args.start_date !== undefined ? { startDate: args.start_date } : {}),
+                ...(args.due_date !== undefined ? { dueDate: args.due_date } : {}),
+            };
+        }
+        if (args.weight !== undefined)
+            input['weightWidget'] = { weight: args.weight };
+        const data = await ctx.graphql.query({ query: WORK_ITEM_CREATE, variables: { input } });
+        if (data.workItemCreate.errors.length > 0) {
+            throw new Error(`workItemCreate: ${data.workItemCreate.errors.join('; ')}`);
+        }
+        return data.workItemCreate.workItem;
+    }));
+    server.tool('work_item_update', 'Update an existing work item. Pass the global id (gid://gitlab/WorkItem/<n>).', {
+        id: z.string().describe('Global id: gid://gitlab/WorkItem/<numeric_id>'),
+        title: z.string().optional(),
+        state_event: z.enum(['CLOSE', 'REOPEN']).optional(),
+        description: z.string().optional(),
+        assignee_ids: z.array(z.number().int()).optional().describe('Replaces full list.'),
+        add_assignee_ids: z.array(z.number().int()).optional(),
+        remove_assignee_ids: z.array(z.number().int()).optional(),
+        label_ids: z.array(z.number().int()).optional().describe('Replaces full list.'),
+        add_label_ids: z.array(z.number().int()).optional(),
+        remove_label_ids: z.array(z.number().int()).optional(),
+        milestone_id: z.number().int().nullable().optional(),
+        iteration_id: z.number().int().nullable().optional(),
+        parent_id: z.number().int().nullable().optional(),
+        start_date: z.string().nullable().optional(),
+        due_date: z.string().nullable().optional(),
+        weight: z.number().int().nullable().optional(),
+        confidential: z.boolean().optional(),
+    }, async (args) => safe(async () => {
+        const input = { id: args.id };
+        if (args.title !== undefined)
+            input['title'] = args.title;
+        if (args.state_event !== undefined)
+            input['stateEvent'] = args.state_event;
+        if (args.confidential !== undefined)
+            input['confidential'] = args.confidential;
+        if (args.description !== undefined) {
+            input['descriptionWidget'] = { description: args.description };
+        }
+        const assigneesWidget = {};
+        if (args.assignee_ids) {
+            assigneesWidget['assigneeIds'] = args.assignee_ids.map((id) => toGlobalId('User', id));
+        }
+        if (args.add_assignee_ids) {
+            assigneesWidget['addAssigneeIds'] = args.add_assignee_ids.map((id) => toGlobalId('User', id));
+        }
+        if (args.remove_assignee_ids) {
+            assigneesWidget['removeAssigneeIds'] = args.remove_assignee_ids.map((id) => toGlobalId('User', id));
+        }
+        if (Object.keys(assigneesWidget).length > 0)
+            input['assigneesWidget'] = assigneesWidget;
+        const labelsWidget = {};
+        if (args.label_ids) {
+            labelsWidget['labelIds'] = args.label_ids.map((id) => toGlobalId('Label', id));
+        }
+        if (args.add_label_ids) {
+            labelsWidget['addLabelIds'] = args.add_label_ids.map((id) => toGlobalId('Label', id));
+        }
+        if (args.remove_label_ids) {
+            labelsWidget['removeLabelIds'] = args.remove_label_ids.map((id) => toGlobalId('Label', id));
+        }
+        if (Object.keys(labelsWidget).length > 0)
+            input['labelsWidget'] = labelsWidget;
+        if (args.milestone_id !== undefined) {
+            input['milestoneWidget'] = {
+                milestoneId: args.milestone_id === null ? null : toGlobalId('Milestone', args.milestone_id),
+            };
+        }
+        if (args.iteration_id !== undefined) {
+            input['iterationWidget'] = {
+                iterationId: args.iteration_id === null ? null : toGlobalId('Iteration', args.iteration_id),
+            };
+        }
+        if (args.parent_id !== undefined) {
+            input['hierarchyWidget'] = {
+                parentId: args.parent_id === null ? null : toGlobalId('WorkItem', args.parent_id),
+            };
+        }
+        if (args.start_date !== undefined || args.due_date !== undefined) {
+            input['startAndDueDateWidget'] = {
+                ...(args.start_date !== undefined ? { startDate: args.start_date } : {}),
+                ...(args.due_date !== undefined ? { dueDate: args.due_date } : {}),
+            };
+        }
+        if (args.weight !== undefined)
+            input['weightWidget'] = { weight: args.weight };
+        const data = await ctx.graphql.query({ query: WORK_ITEM_UPDATE, variables: { input } });
+        if (data.workItemUpdate.errors.length > 0) {
+            throw new Error(`workItemUpdate: ${data.workItemUpdate.errors.join('; ')}`);
+        }
+        return data.workItemUpdate.workItem;
+    }));
+    server.tool('work_item_delete', 'Delete a work item by global id.', { id: z.string().describe('gid://gitlab/WorkItem/<numeric_id>') }, async (args) => safe(async () => {
+        const data = await ctx.graphql.query({ query: WORK_ITEM_DELETE, variables: { input: { id: args.id } } });
+        if (data.workItemDelete.errors.length > 0) {
+            throw new Error(`workItemDelete: ${data.workItemDelete.errors.join('; ')}`);
+        }
+        return { ok: true };
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/groups/work_items/tools.js.map

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

package/dist/http/errors.d.ts

@@ -0,0 +1,21 @@
+export interface GitLabApiErrorInit {
+    message: string;
+    status?: number;
+    method?: string;
+    url?: string;
+    requestId?: string;
+    body?: unknown;
+    cause?: unknown;
+}
+export declare class GitLabApiError extends Error {
+    readonly status: number | undefined;
+    readonly method: string | undefined;
+    readonly url: string | undefined;
+    readonly requestId: string | undefined;
+    readonly body: unknown;
+    constructor(init: GitLabApiErrorInit);
+    get isRateLimited(): boolean;
+    get isRetryable(): boolean;
+    toJSON(): Record<string, unknown>;
+}
+export declare function summarizeBody(body: unknown): string;

package/dist/http/errors.js

@@ -0,0 +1,62 @@
+export class GitLabApiError extends Error {
+    status;
+    method;
+    url;
+    requestId;
+    body;
+    constructor(init) {
+        super(init.message, init.cause !== undefined ? { cause: init.cause } : {});
+        this.name = 'GitLabApiError';
+        this.status = init.status;
+        this.method = init.method;
+        this.url = init.url;
+        this.requestId = init.requestId;
+        this.body = init.body;
+    }
+    get isRateLimited() {
+        return this.status === 429;
+    }
+    get isRetryable() {
+        if (this.status === undefined)
+            return true; // network-level
+        if (this.status === 429)
+            return true;
+        if (this.status >= 500 && this.status < 600)
+            return true;
+        return false;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            method: this.method,
+            url: this.url,
+            requestId: this.requestId,
+            body: this.body,
+        };
+    }
+}
+export function summarizeBody(body) {
+    if (body === undefined || body === null)
+        return '';
+    if (typeof body === 'string')
+        return body.slice(0, 500);
+    if (typeof body === 'object') {
+        const obj = body;
+        if (typeof obj['message'] === 'string')
+            return obj['message'];
+        if (typeof obj['error'] === 'string')
+            return obj['error'];
+        if (typeof obj['error_description'] === 'string')
+            return obj['error_description'];
+        try {
+            return JSON.stringify(obj).slice(0, 500);
+        }
+        catch {
+            return '[unserializable body]';
+        }
+    }
+    return String(body);
+}
+//# sourceMappingURL=errors.js.map

package/dist/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,MAAM,CAAqB;IAC3B,MAAM,CAAqB;IAC3B,GAAG,CAAqB;IACxB,SAAS,CAAqB;IAC9B,IAAI,CAAU;IAEvB,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,CAAC,gBAAgB;QAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,IAAI,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACnD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,IAAI,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,OAAO,GAAG,CAAC,mBAAmB,CAAC,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,uBAAuB,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/http/graphql.d.ts

@@ -0,0 +1,29 @@
+import { type Dispatcher } from 'undici';
+import { type Config } from '../config.js';
+export interface GraphQLError {
+    message: string;
+    path?: Array<string | number>;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    extensions?: Record<string, unknown>;
+}
+export interface GraphQLResponse<T> {
+    data: T;
+    errors: GraphQLError[];
+}
+export interface GraphQLRequestOptions<V extends object = object> {
+    query: string;
+    variables?: V;
+    operationName?: string;
+    /** Override default retry count for this call. */
+    maxRetries?: number;
+}
+export declare class GraphQLClient {
+    private readonly cfg;
+    private readonly dispatcher?;
+    constructor(cfg: Config, dispatcher?: Dispatcher | undefined);
+    query<T, V extends object = object>(opts: GraphQLRequestOptions<V>): Promise<T>;
+    private execute;
+}

package/dist/http/graphql.js

@@ -0,0 +1,93 @@
+import { request } from 'undici';
+import { authHeader } from '../config.js';
+import { GitLabApiError, summarizeBody } from './errors.js';
+export class GraphQLClient {
+    cfg;
+    dispatcher;
+    constructor(cfg, dispatcher) {
+        this.cfg = cfg;
+        this.dispatcher = dispatcher;
+    }
+    async query(opts) {
+        const maxRetries = opts.maxRetries ?? this.cfg.maxRetries;
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            try {
+                return await this.execute(opts);
+            }
+            catch (err) {
+                lastError = err;
+                if (!(err instanceof GitLabApiError) || !err.isRetryable || attempt === maxRetries) {
+                    throw err;
+                }
+                await sleep(Math.min(250 * 2 ** attempt + Math.random() * 100, 10_000));
+                attempt += 1;
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('GraphQL request failed');
+    }
+    async execute(opts) {
+        const url = `${this.cfg.baseUrl.replace(/\/$/, '')}/api/graphql`;
+        const headers = {
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+            'User-Agent': this.cfg.userAgent,
+            ...authHeader(this.cfg),
+        };
+        const res = await request(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                query: opts.query,
+                variables: opts.variables ?? {},
+                operationName: opts.operationName,
+            }),
+            signal: AbortSignal.timeout(this.cfg.requestTimeoutMs),
+            ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
+        });
+        const text = await res.body.text();
+        let parsed = null;
+        try {
+            parsed = text ? JSON.parse(text) : null;
+        }
+        catch {
+            parsed = text;
+        }
+        if (res.statusCode >= 400) {
+            throw new GitLabApiError({
+                message: `GitLab GraphQL ${res.statusCode}: ${summarizeBody(parsed)}`,
+                status: res.statusCode,
+                method: 'POST',
+                url,
+                body: parsed,
+            });
+        }
+        if (parsed === null || typeof parsed !== 'object' || !('data' in parsed)) {
+            throw new GitLabApiError({
+                message: `GitLab GraphQL: unexpected response shape`,
+                status: res.statusCode,
+                method: 'POST',
+                url,
+                body: parsed,
+            });
+        }
+        const errors = parsed.errors ?? [];
+        if (errors.length > 0 && parsed.data === null) {
+            throw new GitLabApiError({
+                message: `GitLab GraphQL error: ${errors.map((e) => e.message).join('; ')}`,
+                status: res.statusCode,
+                method: 'POST',
+                url,
+                body: parsed,
+            });
+        }
+        // Partial errors (data present alongside errors) are returned as-is via thrown enrichment
+        // would be heavy-handed; callers can inspect their typed result. We log nothing here.
+        return parsed.data;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=graphql.js.map

package/dist/http/graphql.js.map

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

package/dist/http/rest.d.ts

@@ -0,0 +1,96 @@
+import { type Dispatcher } from 'undici';
+import { type Config } from '../config.js';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RestRequestOptions {
+    method?: HttpMethod;
+    path: string;
+    query?: Record<string, string | number | boolean | undefined | null | Array<string | number>>;
+    body?: unknown;
+    headers?: Record<string, string>;
+    /** Override default retry count for this call. */
+    maxRetries?: number;
+    /** Treat 404 as `null` instead of throwing. */
+    nullOn404?: boolean;
+}
+export interface RestResponse<T> {
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+    /** Parsed `Link` header rel→url, when present. */
+    links: Record<string, string>;
+    /** GitLab pagination headers, parsed. */
+    pagination: PaginationMeta;
+}
+export interface PaginationMeta {
+    page: number | undefined;
+    perPage: number | undefined;
+    total: number | undefined;
+    totalPages: number | undefined;
+    nextPage: number | undefined;
+    prevPage: number | undefined;
+}
+export interface MultipartField {
+    /** Field name. */
+    name: string;
+    /** Plain text value, or use `file*` fields for a file upload. */
+    value?: string;
+    /** Base64-encoded file content (use with `file_name`). */
+    contentBase64?: string;
+    /** UTF-8 file content. */
+    contentText?: string;
+    /** Filename — implies this field is a file upload. */
+    fileName?: string;
+    /** MIME type for the file part. */
+    contentType?: string;
+}
+export interface MultipartRequestOptions {
+    method?: 'POST' | 'PUT' | 'PATCH';
+    path: string;
+    query?: RestRequestOptions['query'];
+    fields: MultipartField[];
+    headers?: Record<string, string>;
+    maxRetries?: number;
+}
+export interface BinaryDownloadOptions {
+    path: string;
+    query?: RestRequestOptions['query'];
+    headers?: Record<string, string>;
+    /** Save body to this absolute path on disk. */
+    saveTo?: string;
+    /** Max bytes returned inline (as base64) when saveTo is not provided. Default 1 MiB. */
+    maxInlineBytes?: number;
+    maxRetries?: number;
+}
+export interface BinaryDownloadResult {
+    status: number;
+    size: number;
+    content_type: string | undefined;
+    /** Set when saveTo was provided. */
+    saved_to?: string;
+    /** Set when saveTo was NOT provided (subject to maxInlineBytes). */
+    content_base64?: string;
+    /** True if the response was truncated because it exceeded maxInlineBytes. */
+    truncated?: boolean;
+}
+export declare class RestClient {
+    private readonly cfg;
+    private readonly dispatcher?;
+    constructor(cfg: Config, dispatcher?: Dispatcher | undefined);
+    request<T>(opts: RestRequestOptions): Promise<RestResponse<T>>;
+    private execute;
+    requestMultipart<T>(opts: MultipartRequestOptions): Promise<RestResponse<T>>;
+    uploadBinary<T>(opts: {
+        method?: 'PUT' | 'POST';
+        path: string;
+        body: Buffer | Uint8Array;
+        contentType: string;
+        query?: RestRequestOptions['query'];
+        headers?: Record<string, string>;
+        maxRetries?: number;
+    }): Promise<RestResponse<T>>;
+    downloadBinary(opts: BinaryDownloadOptions): Promise<BinaryDownloadResult>;
+    private executeRaw;
+    private buildUrl;
+    private backoffDelay;
+}
+export declare function parseLinkHeader(header: string | undefined): Record<string, string>;