figmanage 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Danny Keane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,338 @@
+# figmanage
+
+MCP server for managing your Figma workspace.
+
+Manages Figma workspaces through AI assistants. 76 tools covering files, projects, teams, permissions, comments, versions, components, webhooks, org admin, and more. Works with Claude Code, Claude Desktop, ChatGPT, and any MCP-compatible client.
+
+## quick start
+
+```bash
+npx figmanage            # starts MCP server (stdio)
+npx figmanage --http 3333  # starts MCP server (HTTP, for ChatGPT etc.)
+```
+
+## setup
+
+```bash
+git clone https://github.com/dannykeane/figmanage.git
+cd figmanage
+npm install
+npm run build
+npm run setup    # extracts Chrome cookie, configures your MCP client
+```
+
+The setup script:
+- Reads your Figma session cookie from Chrome (macOS, Linux, Windows)
+- Detects your org ID via Figma's redirect behavior
+- Prompts for a Personal Access Token
+- Stores all credentials in MCP server config (env vars)
+- Auto-detects Claude Code, or prints config for other clients
+
+## configuration
+
+| Env var | Description |
+|---------|-------------|
+| `FIGMA_PAT` | Personal access token |
+| `FIGMA_AUTH_COOKIE` | Session cookie value |
+| `FIGMA_USER_ID` | Your Figma user ID |
+| `FIGMA_ORG_ID` | Your org ID |
+| `FIGMA_TOOLSETS` | Toolset filter or preset name |
+| `FIGMA_READ_ONLY` | Set to `1` to disable mutations |
+
+The setup script stores credentials as env vars in the MCP server config. You can also set them manually.
+
+### toolset presets
+
+Use `FIGMA_TOOLSETS` to expose only the tool groups you need. Presets bundle common combinations:
+
+| Preset | Toolsets included |
+|--------|-------------------|
+| `starter` | navigate, reading, comments, export |
+| `admin` | navigate, org, permissions, analytics, teams, libraries |
+| `readonly` | navigate, reading, comments, export, components, versions |
+| `full` | everything (default) |
+
+Or pass individual toolsets:
+
+```bash
+FIGMA_TOOLSETS=navigate,reading,comments
+```
+
+Available toolsets: `navigate`, `files`, `projects`, `permissions`, `org`, `versions`, `branching`, `comments`, `export`, `analytics`, `reading`, `components`, `webhooks`, `variables`, `compound`, `teams`, `libraries`.
+
+### multi-org support
+
+`list_orgs` discovers all available orgs. `switch_org` changes the active workspace for the session. 12 tools accept an `org_id` override parameter for one-off cross-org queries without switching.
+
+## auth
+
+figmanage uses two API clients targeting different Figma endpoints:
+
+| Client | Base URL | Auth | Capabilities |
+|--------|----------|------|-------------|
+| Internal API | `www.figma.com` | Session cookie | Workspace management, search, permissions, org admin, file lifecycle |
+| Public API | `api.figma.com` | Personal Access Token | Comments, export, file reading, components, versions, webhooks, variables |
+
+Each tool declares its auth requirement:
+
+| Requirement | Meaning |
+|-------------|---------|
+| `cookie` | Internal API only. Needs `FIGMA_AUTH_COOKIE` + `FIGMA_USER_ID`. |
+| `pat` | Public API only. Needs `FIGMA_PAT`. |
+| `either` | Works with whichever auth is available. Prefers public API when PAT present. |
+
+Tools are automatically filtered at startup based on available credentials. If you only have a PAT, cookie-only tools are not registered.
+
+## tools
+
+### navigate (10 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `check_auth` | either | Validate PAT and cookie authentication |
+| `list_orgs` | cookie | List available Figma workspaces (orgs) with names |
+| `switch_org` | cookie | Switch active workspace for this session |
+| `list_teams` | cookie | List teams in your org |
+| `list_projects` | either | List projects in a team |
+| `list_files` | either | List files in a project (paginated) |
+| `list_recent_files` | cookie | Recently viewed/edited files across teams |
+| `search` | cookie | Search files across the workspace |
+| `get_file_info` | either | File metadata: name, project, team, link access |
+| `list_favorites` | cookie | List favorited files (broken -- see known limitations) |
+
+### files (8 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `create_file` | cookie | Create design, whiteboard, slides, or sites file |
+| `rename_file` | cookie | Rename a file |
+| `move_files` | cookie | Move files between projects (batch) |
+| `duplicate_file` | cookie | Copy a file, optionally to another project |
+| `trash_files` | cookie | Move files to trash (batch) |
+| `restore_files` | cookie | Restore files from trash (batch) |
+| `favorite_file` | cookie | Add/remove file from sidebar favorites |
+| `set_link_access` | cookie | Set link sharing level (inherit/view/edit/org_view/org_edit) |
+
+### projects (6 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `create_project` | cookie | Create a project in a team |
+| `rename_project` | cookie | Rename a project |
+| `move_project` | cookie | Move a project to another team |
+| `trash_project` | cookie | Move a project to trash |
+| `restore_project` | cookie | Restore a project from trash |
+| `set_project_description` | cookie | Set or update project description |
+
+### permissions (7 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `get_permissions` | cookie | List who has access to a file/project/team with roles |
+| `set_permissions` | cookie | Change a user's access level |
+| `share` | cookie | Invite someone by email (viewer or editor) |
+| `revoke_access` | cookie | Remove someone's access |
+| `list_role_requests` | cookie | List pending file access requests |
+| `approve_role_request` | cookie | Accept an access request |
+| `deny_role_request` | cookie | Decline an access request |
+
+### reading (2 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `get_file` | pat | Read file contents as a node tree with depth control |
+| `get_nodes` | pat | Read specific nodes by ID from a file |
+
+### components (4 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_file_components` | pat | List components published from a file |
+| `list_file_styles` | pat | List styles in a file |
+| `list_team_components` | pat | List published components across a team (paginated) |
+| `list_team_styles` | pat | List published styles across a team (paginated) |
+
+### versions (2 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_versions` | pat | List version history (named checkpoints and auto-saves) |
+| `create_version` | cookie | Create a named version checkpoint |
+
+### branching (3 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_branches` | either | List branches of a file |
+| `create_branch` | cookie | Create a branch from a file |
+| `delete_branch` | cookie | Archive (delete) a branch |
+
+### comments (4 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_comments` | pat | List comments with thread structure (optional markdown format) |
+| `post_comment` | pat | Post a comment, optionally pinned to a node or as a reply |
+| `delete_comment` | pat | Permanently delete a comment |
+| `list_comment_reactions` | pat | List emoji reactions on a comment |
+
+### export (2 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `export_nodes` | pat | Export nodes as PNG, SVG, PDF, or JPG (returns temporary URLs) |
+| `get_image_fills` | pat | Get URLs for all images used as fills in a file |
+
+### webhooks (4 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_webhooks` | pat | List webhooks for a team |
+| `create_webhook` | pat | Create a webhook subscription for a team |
+| `update_webhook` | pat | Update a webhook (endpoint, event type, status) |
+| `delete_webhook` | pat | Delete a webhook |
+
+### variables (3 tools, Enterprise only)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_local_variables` | pat | List local variables and collections in a file |
+| `list_published_variables` | pat | List published variables from a library file |
+| `update_variables` | pat | Bulk create, update, or delete variables, collections, modes, and values |
+
+### analytics (2 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `library_usage` | cookie | Team-level library adoption metrics over a lookback period |
+| `component_usage` | cookie | Per-file component usage analytics |
+
+### org (9 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_admins` | cookie | Org admins with permission levels and seat status |
+| `list_org_teams` | cookie | All teams with member counts, project counts, access levels |
+| `seat_usage` | cookie | Seat breakdown: permissions, seat types, activity, account types |
+| `list_team_members` | cookie | Team members with name, email, role, last active date |
+| `billing_overview` | cookie | Invoice history, billing status, amounts, billing periods |
+| `list_invoices` | cookie | Open and upcoming invoices |
+| `org_domains` | cookie | Domain configuration and SSO/SAML settings |
+| `ai_credit_usage` | cookie | AI credit usage summary for a billing plan |
+| `export_members` | cookie | Trigger async CSV export of all org members (emailed to admin) |
+
+### teams (3 tools)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `create_team` | cookie | Create a new team in the org |
+| `rename_team` | cookie | Rename an existing team |
+| `delete_team` | cookie | Delete a team (destructive, cannot be undone) |
+
+### libraries (1 tool)
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `list_org_libraries` | cookie | All design system libraries in the org with sharing group info |
+
+### compound (6 tools)
+
+Multi-step operations that aggregate data from several API calls.
+
+| Tool | Auth | Description |
+|------|------|-------------|
+| `file_summary` | pat | Quick overview: pages, components, styles, comment counts |
+| `workspace_overview` | cookie | Full org snapshot: teams, seats, billing in one call |
+| `open_comments` | pat | Aggregated unresolved comments across all files in a project |
+| `cleanup_stale_files` | either | Find files not modified in N days, optionally trash them (dry run by default) |
+| `organize_project` | cookie | Batch-move files into a target project |
+| `setup_project_structure` | cookie | Create multiple projects in a team from a plan |
+
+## transport modes
+
+| Mode | Flag | Use case |
+|------|------|----------|
+| stdio | (default) | Claude Code, Claude Desktop, most MCP clients |
+| HTTP | `--http <port>` | ChatGPT, web-based clients |
+
+```bash
+npx figmanage              # stdio
+npx figmanage --http 3333  # HTTP on port 3333
+```
+
+## security
+
+### ID validation
+
+All tool parameters that accept Figma IDs (file keys, team IDs, project IDs, node IDs) are validated against a strict regex (`/^[\w.:-]+$/`) before use. This blocks path traversal in URL templates.
+
+### safe retry policy
+
+Both API clients retry on transient errors with exponential backoff. Rate limit responses (429) are only retried for safe methods (`GET`, `HEAD`, `OPTIONS`). Mutations are never retried on 429 to prevent duplicate writes. Auth failures (401, 403) are never retried.
+
+### response shaping
+
+Org admin tools extract documented fields and strip PII (e.g., `shipping_address` is removed from billing responses).
+
+## architecture
+
+```
+src/
+  index.ts              MCP server entry point (stdio transport, toolset parsing)
+  setup.ts              Chrome cookie extraction + Claude MCP config
+  auth/
+    client.ts           AuthConfig, env var loading
+    health.ts           Auth validation
+  clients/
+    internal-api.ts     Axios client for www.figma.com (cookie auth, safe retry)
+    public-api.ts       Axios client for api.figma.com (PAT auth, safe retry)
+  tools/
+    register.ts         defineTool() pattern, toolset filtering, read-only mode, figmaId validation
+    navigate.ts         Browse and search (10 tools)
+    files.ts            File lifecycle (8 tools)
+    projects.ts         Project management (6 tools)
+    permissions.ts      Sharing, access control, role requests (7 tools)
+    reading.ts          File and node reading via public API (2 tools)
+    components.ts       Components and styles via public API (4 tools)
+    versions.ts         Version history (2 tools)
+    branching.ts        Branch CRUD (3 tools)
+    comments.ts         Comments and reactions via public API (4 tools)
+    export.ts           Image export and fills via public API (2 tools)
+    webhooks.ts         Webhook CRUD via V2 public API (4 tools)
+    variables.ts        Variables via public API, Enterprise only (3 tools)
+    analytics.ts        Library and component analytics via internal API (2 tools)
+    org.ts              Org admin, billing, seats, domains via internal API (9 tools)
+    teams.ts            Team CRUD (3 tools)
+    libraries.ts        Design system libraries via internal API (1 tool)
+    compound.ts         Multi-step aggregation tools (6 tools)
+  types/
+    figma.ts            Shared types (Toolset, AuthConfig, etc.)
+```
+
+Tools self-register via `defineTool()` side-effect imports. Each tool declares its toolset, auth requirement, and whether it mutates. `registerTools()` filters at startup based on available credentials, enabled toolsets, and read-only mode.
+
+## known limitations
+
+- **list_favorites**: Figma's server has a BigInt overflow bug on large user IDs. The `favorite_file` tool for adding/removing favorites works fine.
+- **Branch merging**: Figma merges branches through its real-time multiplayer protocol, not a REST endpoint. Must be done in the Figma UI.
+- **Cookie expiry**: Session cookies expire roughly every 30 days. Re-run `npm run setup` to refresh.
+- **Windows cookie extraction**: Best-effort via DPAPI/PowerShell. Falls back to PAT-only setup if extraction fails.
+- **Variables require Enterprise**: The `file_variables:read` and `file_variables:write` scopes are not available in the standard PAT UI. Variables tools return a clear error on non-Enterprise plans.
+- **No org-level member list**: There is no single REST endpoint to list all org members. Use `list_admins` + `list_team_members` per team, or `export_members` for a full CSV.
+- **No activity log API**: Figma's activity log is SSR only with no REST endpoint.
+- **get_file returns full tree**: Without a `depth` parameter, `get_file` returns the entire document. Use `depth` or `get_nodes` for large files.
+
+## development
+
+```bash
+npm install
+npm run build    # compile
+npm run setup    # configure auth + MCP client
+npm run dev      # watch mode
+npm run lint     # type-check
+npm test         # run tests
+```
+
+## license
+
+MIT

package/dist/auth/client.d.ts

@@ -0,0 +1,15 @@
+export interface OrgEntry {
+    id: string;
+    name: string;
+}
+export interface AuthConfig {
+    pat?: string;
+    cookie?: string;
+    userId?: string;
+    orgId?: string;
+    orgs?: OrgEntry[];
+}
+export declare function loadAuthConfig(): AuthConfig;
+export declare function hasPat(config: AuthConfig): boolean;
+export declare function hasCookie(config: AuthConfig): boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/auth/client.js

@@ -0,0 +1,29 @@
+function parseOrgs(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return undefined;
+        return parsed.filter((o) => o.id && o.name);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function loadAuthConfig() {
+    return {
+        pat: process.env.FIGMA_PAT,
+        cookie: process.env.FIGMA_AUTH_COOKIE,
+        userId: process.env.FIGMA_USER_ID,
+        orgId: process.env.FIGMA_ORG_ID,
+        orgs: parseOrgs(process.env.FIGMA_ORGS),
+    };
+}
+export function hasPat(config) {
+    return !!config.pat;
+}
+export function hasCookie(config) {
+    return !!config.cookie && !!config.userId;
+}
+//# sourceMappingURL=client.js.map

package/dist/auth/health.d.ts

@@ -0,0 +1,5 @@
+import type { AuthConfig } from './client.js';
+import type { AuthStatus } from '../types/figma.js';
+export declare function checkAuth(config: AuthConfig): Promise<AuthStatus>;
+export declare function formatAuthStatus(status: AuthStatus, config?: AuthConfig): string;
+//# sourceMappingURL=health.d.ts.map

package/dist/auth/health.js

@@ -0,0 +1,93 @@
+import { publicClient } from '../clients/public-api.js';
+import { internalClient } from '../clients/internal-api.js';
+export async function checkAuth(config) {
+    const status = {
+        pat: { valid: false },
+        cookie: { valid: false },
+    };
+    if (config.pat) {
+        try {
+            const res = await publicClient(config).get('/v1/me');
+            status.pat = { valid: true, user: res.data.handle || res.data.email };
+        }
+        catch (e) {
+            status.pat = {
+                valid: false,
+                error: e.response?.status === 403
+                    ? 'PAT invalid or expired. Generate a new one at figma.com/developers'
+                    : `PAT check failed: ${e.message}`,
+            };
+        }
+    }
+    else {
+        status.pat = { valid: false, error: 'No PAT configured (env or Keychain)' };
+    }
+    if (config.cookie && config.userId) {
+        try {
+            const res = await internalClient(config).get('/api/user/state');
+            const user = res.data?.user;
+            status.cookie = { valid: true, user: user?.handle || user?.email || 'authenticated' };
+            // Populate org registry from user/state response
+            const orgs = (res.data?.meta?.orgs || []).map((o) => ({
+                id: String(o.id),
+                name: o.name,
+            }));
+            if (orgs.length > 0)
+                config.orgs = orgs;
+        }
+        catch (e) {
+            const code = e.response?.status;
+            if (code === 401 || code === 403) {
+                status.cookie = {
+                    valid: false,
+                    error: 'Session cookie expired. Extract a new one from browser DevTools: Application > Cookies > __Host-figma.authn',
+                };
+            }
+            else {
+                status.cookie = { valid: false, error: `Cookie check failed: ${e.message}` };
+            }
+        }
+    }
+    else {
+        const missing = [];
+        if (!config.cookie)
+            missing.push('FIGMA_AUTH_COOKIE');
+        if (!config.userId)
+            missing.push('FIGMA_USER_ID');
+        status.cookie = { valid: false, error: `${missing.join(', ')} not set` };
+    }
+    return status;
+}
+export function formatAuthStatus(status, config) {
+    const lines = [];
+    lines.push(`PAT: ${status.pat.valid ? `valid (${status.pat.user})` : status.pat.error}`);
+    lines.push(`Session: ${status.cookie.valid ? `valid (${status.cookie.user})` : status.cookie.error}`);
+    if (!status.pat.valid && !status.cookie.valid) {
+        lines.push('\nNo valid auth. Set FIGMA_PAT for public API access or FIGMA_AUTH_COOKIE + FIGMA_USER_ID for full access.');
+    }
+    else if (!status.cookie.valid) {
+        lines.push('\nPublic API only. Internal API tools (file CRUD, team management) unavailable.');
+    }
+    // Org context
+    if (config) {
+        if (config.orgId) {
+            const currentOrg = config.orgs?.find(o => o.id === config.orgId);
+            const orgLabel = currentOrg ? `${currentOrg.name} (${config.orgId})` : config.orgId;
+            lines.push(`\nWorkspace: ${orgLabel}`);
+            const others = (config.orgs || []).filter(o => o.id !== config.orgId);
+            if (others.length > 0) {
+                lines.push(`Other workspaces: ${others.map(o => `${o.name} (${o.id})`).join(', ')}`);
+                lines.push('Use switch_org to change workspace.');
+            }
+        }
+        else if (config.orgs && config.orgs.length > 0) {
+            lines.push(`\nWorkspaces available: ${config.orgs.map(o => `${o.name} (${o.id})`).join(', ')}`);
+            lines.push('Use switch_org to select a workspace.');
+        }
+        else {
+            lines.push('\nWorkspace: not configured');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=health.js.map

package/dist/clients/internal-api.d.ts

@@ -0,0 +1,4 @@
+import { type AxiosInstance } from 'axios';
+import type { AuthConfig } from '../auth/client.js';
+export declare function internalClient(config: AuthConfig): AxiosInstance;
+//# sourceMappingURL=internal-api.d.ts.map

package/dist/clients/internal-api.js

@@ -0,0 +1,50 @@
+import axios from 'axios';
+import axiosRetry from 'axios-retry';
+import { Agent as HttpsAgent } from 'https';
+const httpsAgent = new HttpsAgent({ keepAlive: true });
+const instances = new WeakMap();
+export function internalClient(config) {
+    const existing = instances.get(config);
+    if (existing)
+        return existing;
+    const client = axios.create({
+        baseURL: 'https://www.figma.com',
+        httpsAgent,
+        headers: {
+            'Cookie': `__Host-figma.authn=${config.cookie || ''}`,
+            'X-CSRF-Bypass': 'yes',
+            'X-Figma-User-Id': config.userId || '',
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        },
+        timeout: 30000,
+    });
+    axiosRetry(client, {
+        retries: 3,
+        retryDelay: (retryCount, error) => {
+            const retryAfter = error.response?.headers?.['retry-after'];
+            if (retryAfter) {
+                const delay = parseInt(retryAfter, 10) * 1000;
+                if (delay > 0 && delay < 300000)
+                    return delay;
+            }
+            // Exponential backoff with jitter: 1s, 2s, 4s + random jitter
+            const base = Math.pow(2, retryCount - 1) * 1000;
+            const jitter = base * 0.5 * Math.random();
+            return base + jitter;
+        },
+        retryCondition: (error) => {
+            const status = error.response?.status;
+            if (status === 401 || status === 403)
+                return false;
+            if (status === 429) {
+                const method = error.config?.method?.toUpperCase();
+                return ['GET', 'HEAD', 'OPTIONS'].includes(method || '');
+            }
+            return axiosRetry.isNetworkOrIdempotentRequestError(error);
+        },
+    });
+    instances.set(config, client);
+    return client;
+}
+//# sourceMappingURL=internal-api.js.map

package/dist/clients/public-api.d.ts

@@ -0,0 +1,4 @@
+import { type AxiosInstance } from 'axios';
+import type { AuthConfig } from '../auth/client.js';
+export declare function publicClient(config: AuthConfig): AxiosInstance;
+//# sourceMappingURL=public-api.d.ts.map

package/dist/clients/public-api.js

@@ -0,0 +1,47 @@
+import axios from 'axios';
+import axiosRetry from 'axios-retry';
+import { Agent as HttpsAgent } from 'https';
+const httpsAgent = new HttpsAgent({ keepAlive: true });
+const instances = new WeakMap();
+export function publicClient(config) {
+    const existing = instances.get(config);
+    if (existing)
+        return existing;
+    const client = axios.create({
+        baseURL: 'https://api.figma.com',
+        httpsAgent,
+        headers: {
+            'X-Figma-Token': config.pat || '',
+            'Accept': 'application/json',
+        },
+        timeout: 30000,
+    });
+    axiosRetry(client, {
+        retries: 3,
+        retryDelay: (retryCount, error) => {
+            const retryAfter = error.response?.headers?.['retry-after'];
+            if (retryAfter) {
+                const delay = parseInt(retryAfter, 10) * 1000;
+                if (delay > 0 && delay < 300000)
+                    return delay;
+            }
+            // Exponential backoff with jitter: 1s, 2s, 4s + random jitter
+            const base = Math.pow(2, retryCount - 1) * 1000;
+            const jitter = base * 0.5 * Math.random();
+            return base + jitter;
+        },
+        retryCondition: (error) => {
+            const status = error.response?.status;
+            if (status === 401 || status === 403)
+                return false;
+            if (status === 429) {
+                const method = error.config?.method?.toUpperCase();
+                return ['GET', 'HEAD', 'OPTIONS'].includes(method || '');
+            }
+            return axiosRetry.isNetworkOrIdempotentRequestError(error);
+        },
+    });
+    instances.set(config, client);
+    return client;
+}
+//# sourceMappingURL=public-api.js.map

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import './tools/navigate.js';
+import './tools/files.js';
+import './tools/projects.js';
+import './tools/permissions.js';
+import './tools/comments.js';
+import './tools/export.js';
+import './tools/versions.js';
+import './tools/branching.js';
+import './tools/components.js';
+import './tools/webhooks.js';
+import './tools/reading.js';
+import './tools/analytics.js';
+import './tools/variables.js';
+import './tools/org.js';
+import './tools/libraries.js';
+import './tools/teams.js';
+import './tools/compound.js';
+//# sourceMappingURL=index.d.ts.map