@exileum/meta-mcp 5.0.0 → 7.0.0

package/dist/services/meta-client.d.ts

@@ -1,24 +1,120 @@
 import { MetaConfig } from "../config.js";
+export declare const DEFAULT_META_API_VERSION = "v25.0";
+export declare const DEFAULT_THREADS_API_VERSION = "v1.0";
+export declare const DEFAULT_MAX_RETRIES = 3;
+export declare const DEFAULT_RETRY_BASE_DELAY_MS = 1000;
+export declare const MAX_RETRY_DELAY_MS = 60000;
+/**
+ * Parse a `Retry-After` response header value (RFC 7231 §7.1.3) into
+ * milliseconds. Returns `undefined` for missing or unparseable values so the
+ * caller falls back to the exponential-backoff schedule. Past dates and
+ * negative seconds clamp to `0` to absorb server time skew.
+ */
+export declare function parseRetryAfter(value: string | null, nowMs: number): number | undefined;
+/**
+ * Exponential backoff `base * 2^attempt` with 0–25% jitter to spread
+ * concurrent clients and avoid thundering-herd reconnects. Capped at
+ * {@link MAX_RETRY_DELAY_MS}. `rand` is injectable for deterministic tests.
+ */
+export declare function computeBackoffDelay(attempt: number, baseDelayMs: number, rand?: () => number): number;
+export interface MetaClientOptions {
+    metaApiVersion?: string;
+    threadsApiVersion?: string;
+    /**
+     * Maximum number of retry attempts after the initial request fails with a
+     * transient error (HTTP 429/500/502/503/504 or a thrown network error).
+     * Total request count is `maxRetries + 1`. Set to `0` to disable retries
+     * entirely (matches pre-#61 behavior). Defaults to {@link DEFAULT_MAX_RETRIES}.
+     */
+    maxRetries?: number;
+    /**
+     * Base delay (ms) used by the exponential-backoff schedule between retries.
+     * Attempt N waits `baseDelayMs * 2^N` plus 0–25% jitter (capped at
+     * {@link MAX_RETRY_DELAY_MS}). Defaults to {@link DEFAULT_RETRY_BASE_DELAY_MS}.
+     * Tests pass `0` to make retries fire immediately without real waiting.
+     */
+    retryBaseDelayMs?: number;
+    /**
+     * @internal — testing-only seam, not part of the stable API. Injection point
+     * for the sleep primitive used between retries. Defaults to a
+     * `setTimeout`-backed `Promise`.
+     */
+    sleep?: (ms: number) => Promise<void>;
+    /**
+     * @internal — testing-only seam, not part of the stable API. Injection point
+     * for the current-time source used when parsing the HTTP-date form of the
+     * `Retry-After` header. Defaults to `Date.now`.
+     */
+    now?: () => number;
+}
 export interface RateLimit {
     callCount?: number;
     totalCpuTime?: number;
     totalTime?: number;
 }
+export declare const RATE_LIMIT_SLOWDOWN_THRESHOLD = 80;
+export declare const RATE_LIMIT_BACKOFF_THRESHOLD = 90;
+export declare const RATE_LIMIT_SLOWDOWN_MS = 1000;
+export declare const RATE_LIMIT_BACKOFF_MS = 5000;
+export declare const RATE_LIMIT_SNAPSHOT_TTL_MS: number;
 export interface ClientResponse {
     data: Record<string, unknown>;
     rateLimit?: RateLimit;
 }
+/**
+ * Allowed value types for form-encoded query string and request body parameters.
+ * Non-primitive values (arrays, objects) must be serialized by the caller (JSON.stringify, .join(",") etc.)
+ * before being assigned — the form-encoded path uses String(v) which produces "[object Object]" / "1,2,3"
+ * for objects/arrays and silently corrupts the request.
+ */
+export type FormParamValue = string | number | boolean | undefined | null;
+export type FormParams = Record<string, FormParamValue>;
 export interface RequestOptions {
-    json?: boolean;
+    /**
+     * Sends the value as an `application/json` request body instead of the default
+     * `application/x-www-form-urlencoded`. The `access_token` is moved to the query
+     * string (never embedded in the JSON body) and `params` must be omitted —
+     * combining them is rejected at runtime so callers don't accidentally route
+     * data into both transports.
+     *
+     * **When to use:** only when Meta's documentation explicitly requires
+     * `Content-Type: application/json` for the endpoint. Currently the
+     * Instagram Messaging Send API (`POST /{ig-user-id}/messages`, used by
+     * `ig_send_message`) is the only such endpoint — it accepts nested
+     * `recipient` / `message` objects that would be flattened to
+     * `[object Object]` if sent through the form path. See
+     * https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/messaging-api
+     *
+     * **When not to use:** every other Graph API endpoint (Threads publish,
+     * Instagram media/comments/collaboration, Meta App Subscriptions, etc.)
+     * accepts form-urlencoded with flat string/number/boolean parameters and
+     * works correctly through the default path. Nested objects required by the
+     * API (`poll_attachment`, `gif_attachment`, `text_attachment`, `user_tags`)
+     * must be `JSON.stringify`-ed by the caller into a single form field — the
+     * runtime guard in `appendFormParams` rejects raw objects/arrays so this
+     * convention is enforced (see #81). Audited in #104.
+     */
+    jsonBody?: Record<string, unknown>;
 }
 export declare class MetaClient {
     private config;
-    constructor(config: MetaConfig);
+    private igBase;
+    private fbBase;
+    private threadsBase;
+    private lastRateLimit?;
+    private lastRateLimitAt?;
+    private maxRetries;
+    private retryBaseDelayMs;
+    private sleep;
+    private now;
+    constructor(config: MetaConfig, options?: MetaClientOptions);
     private parseRateLimit;
+    private maybeThrottle;
+    private appendFormParams;
     private request;
-    ig(method: string, path: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<ClientResponse>;
-    threads(method: string, path: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<ClientResponse>;
-    meta(method: string, path: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<ClientResponse>;
+    ig(method: string, path: string, params?: FormParams, options?: RequestOptions): Promise<ClientResponse>;
+    threads(method: string, path: string, params?: FormParams, options?: RequestOptions): Promise<ClientResponse>;
+    meta(method: string, path: string, params?: FormParams, options?: RequestOptions): Promise<ClientResponse>;
     /** Exchange short-lived Instagram token for long-lived token (60 days) */
     igExchangeToken(shortToken: string): Promise<ClientResponse>;
     /** Refresh a long-lived Instagram token (must be at least 24h old and not expired) */

package/dist/services/meta-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-client.d.ts","sourceRoot":"","sources":["../../src/services/meta-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAW1C,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA4BD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;IAI9B,OAAO,CAAC,cAAc;YAeR,OAAO;IAyFf,EAAE,CACN,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC;IAOpB,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC;IAOpB,IAAI,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC;IAQ1B,0EAA0E;IACpE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUlE,sFAAsF;IAChF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMhE,wEAAwE;IAClE,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUvE,oFAAoF;IAC9E,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMrE,oBAAoB;IACd,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAU7D,IAAI,QAAQ,IAAI,MAAM,CAKrB;IAED,IAAI,aAAa,IAAI,MAAM,CAK1B;CACF"}
+{"version":3,"file":"meta-client.d.ts","sourceRoot":"","sources":["../../src/services/meta-client.ts"],"names":[],"mappings":"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"}

package/dist/services/meta-client.js

@@ -1,10 +1,93 @@
 import { MetaApiError } from "../utils/errors.js";
-const IG_BASE = "https://graph.instagram.com/v25.0";
-const FB_BASE = "https://graph.facebook.com/v25.0";
-const THREADS_BASE = "https://graph.threads.net/v1.0";
-// Unversioned bases for OAuth token endpoints
+// Default Meta Graph API and Threads API versions — last verified 2026-05-06.
+// The Graph API ships a new minor version every ~4 months and supports each
+// for ~2 years; Threads runs a separate single-major-version track (v1.0 since
+// launch) and is intentionally not bumped in lockstep with the Graph API.
+// Operators can override either default at runtime via `META_API_VERSION` /
+// `THREADS_API_VERSION` to buy time when Meta deprecates a version before a
+// new meta-mcp release ships. OAuth token endpoints
+// (`graph.instagram.com/access_token`, `graph.threads.net/refresh_access_token`,
+// etc.) are unversioned by Meta — `IG_TOKEN_BASE` / `THREADS_TOKEN_BASE` stay
+// unversioned regardless of the version env vars.
+export const DEFAULT_META_API_VERSION = "v25.0";
+export const DEFAULT_THREADS_API_VERSION = "v1.0";
+const API_VERSION_PATTERN = /^v\d+\.\d+$/;
+// Unversioned bases for OAuth token endpoints (deliberate — Meta's OAuth
+// surface has no version segment; piping META_API_VERSION here would 404).
 const IG_TOKEN_BASE = "https://graph.instagram.com";
 const THREADS_TOKEN_BASE = "https://graph.threads.net";
+// Retry policy for transient Meta API failures (#61). 429 is the explicit
+// rate-limit signal; 502/503/504 are canonical gateway/availability errors;
+// 500 is included because Meta's infrastructure routinely returns transient
+// 500s during brief overloads alongside the more canonical 5xx codes. Every
+// other 4xx is a permanent caller-side error (auth, validation) and fails fast.
+const RETRYABLE_HTTP_STATUSES = new Set([429, 500, 502, 503, 504]);
+export const DEFAULT_MAX_RETRIES = 3;
+export const DEFAULT_RETRY_BASE_DELAY_MS = 1000;
+// Cap so a malformed `Retry-After: 999999` (≈11 days) can't hang a tool.
+export const MAX_RETRY_DELAY_MS = 60_000;
+/**
+ * Parse a `Retry-After` response header value (RFC 7231 §7.1.3) into
+ * milliseconds. Returns `undefined` for missing or unparseable values so the
+ * caller falls back to the exponential-backoff schedule. Past dates and
+ * negative seconds clamp to `0` to absorb server time skew.
+ */
+export function parseRetryAfter(value, nowMs) {
+    if (value === null)
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === "")
+        return undefined;
+    if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+        const seconds = Number(trimmed);
+        if (Number.isFinite(seconds))
+            return Math.max(0, seconds * 1000);
+    }
+    const dateMs = Date.parse(trimmed);
+    if (!Number.isNaN(dateMs)) {
+        return Math.max(0, dateMs - nowMs);
+    }
+    return undefined;
+}
+/**
+ * Exponential backoff `base * 2^attempt` with 0–25% jitter to spread
+ * concurrent clients and avoid thundering-herd reconnects. Capped at
+ * {@link MAX_RETRY_DELAY_MS}. `rand` is injectable for deterministic tests.
+ */
+export function computeBackoffDelay(attempt, baseDelayMs, rand = Math.random) {
+    const exponential = baseDelayMs * Math.pow(2, attempt);
+    const jitter = exponential * 0.25 * rand();
+    return Math.min(exponential + jitter, MAX_RETRY_DELAY_MS);
+}
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function resolveApiVersion(envName, fallback, explicit) {
+    // Explicit MetaClientOptions value, if any, takes precedence over the env
+    // var; both go through the same regex check + warn-fallback so a malformed
+    // option (e.g., `{ metaApiVersion: "v25-0" }`) can't silently build a
+    // broken URL. Empty string on either path falls through to the default.
+    const source = explicit !== undefined ? `MetaClientOptions.${envName}` : envName;
+    const raw = explicit ?? process.env[envName];
+    if (!raw)
+        return fallback;
+    if (!API_VERSION_PATTERN.test(raw)) {
+        console.error(`[meta-mcp] Warning: ${source}="${raw}" is not in vX.Y format — falling back to ${fallback}.`);
+        return fallback;
+    }
+    return raw;
+}
+// Pre-request throttle thresholds — Meta throttles at 100% usage on any of
+// callCount / totalCpuTime / totalTime per
+// https://developers.facebook.com/docs/graph-api/overview/rate-limiting/,
+// so we back off well before the cliff.
+export const RATE_LIMIT_SLOWDOWN_THRESHOLD = 80;
+export const RATE_LIMIT_BACKOFF_THRESHOLD = 90;
+export const RATE_LIMIT_SLOWDOWN_MS = 1000;
+export const RATE_LIMIT_BACKOFF_MS = 5000;
+// Meta's rate-limit window is rolling 1h — discard the snapshot after that so
+// a long-idle client doesn't pay a spurious backoff on its first post-idle call.
+export const RATE_LIMIT_SNAPSHOT_TTL_MS = 60 * 60 * 1000;
 function parseMetaErrorBody(text) {
     if (!text)
         return undefined;
@@ -27,8 +110,34 @@ function parseMetaErrorBody(text) {
 }
 export class MetaClient {
     config;
-    constructor(config) {
+    igBase;
+    fbBase;
+    threadsBase;
+    lastRateLimit;
+    lastRateLimitAt;
+    maxRetries;
+    retryBaseDelayMs;
+    sleep;
+    now;
+    constructor(config, options) {
         this.config = config;
+        const metaVersion = resolveApiVersion("META_API_VERSION", DEFAULT_META_API_VERSION, options?.metaApiVersion);
+        const threadsVersion = resolveApiVersion("THREADS_API_VERSION", DEFAULT_THREADS_API_VERSION, options?.threadsApiVersion);
+        this.igBase = `https://graph.instagram.com/${metaVersion}`;
+        this.fbBase = `https://graph.facebook.com/${metaVersion}`;
+        this.threadsBase = `https://graph.threads.net/${threadsVersion}`;
+        // `Math.max(0, Infinity)` is `Infinity` (infinite loop) and `0 <= NaN` is
+        // `false` (loop body never runs); reject non-finite values and fall back.
+        const rawMaxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.maxRetries = Number.isFinite(rawMaxRetries)
+            ? Math.max(0, rawMaxRetries)
+            : DEFAULT_MAX_RETRIES;
+        const rawBaseDelay = options?.retryBaseDelayMs ?? DEFAULT_RETRY_BASE_DELAY_MS;
+        this.retryBaseDelayMs = Number.isFinite(rawBaseDelay)
+            ? Math.max(0, rawBaseDelay)
+            : DEFAULT_RETRY_BASE_DELAY_MS;
+        this.sleep = options?.sleep ?? defaultSleep;
+        this.now = options?.now ?? Date.now;
     }
     parseRateLimit(headers) {
         const usage = headers.get("x-app-usage");
@@ -36,111 +145,206 @@ export class MetaClient {
             return undefined;
         try {
             const raw = JSON.parse(usage);
+            // `Number(undefined)` is NaN, `Number("92")` is 92 — coerce defensively
+            // so a future Meta API tweak (numbers shipped as strings) still produces
+            // a usable RateLimit instead of silently leaving fields `undefined`.
+            const num = (v) => {
+                if (v === undefined || v === null)
+                    return undefined;
+                const n = Number(v);
+                return Number.isFinite(n) ? n : undefined;
+            };
             return {
-                callCount: raw.call_count,
-                totalCpuTime: raw.total_cpu_time,
-                totalTime: raw.total_time,
+                callCount: num(raw.call_count),
+                totalCpuTime: num(raw.total_cpu_time),
+                totalTime: num(raw.total_time),
             };
         }
         catch {
             return undefined;
         }
     }
+    // Take `max(callCount, totalCpuTime, totalTime)` because Meta throttles on
+    // whichever quota hits 100% first. Concurrent calls at high usage both
+    // sleep their full delay and then fire together — acceptable for MCP's
+    // typically sequential call pattern, still safer than no throttling.
+    async maybeThrottle() {
+        const rl = this.lastRateLimit;
+        if (!rl)
+            return;
+        if (this.lastRateLimitAt !== undefined && Date.now() - this.lastRateLimitAt > RATE_LIMIT_SNAPSHOT_TTL_MS) {
+            this.lastRateLimit = undefined;
+            this.lastRateLimitAt = undefined;
+            return;
+        }
+        const max = Math.max(rl.callCount ?? 0, rl.totalCpuTime ?? 0, rl.totalTime ?? 0);
+        let delay;
+        if (max >= RATE_LIMIT_BACKOFF_THRESHOLD) {
+            delay = RATE_LIMIT_BACKOFF_MS;
+        }
+        else if (max >= RATE_LIMIT_SLOWDOWN_THRESHOLD) {
+            delay = RATE_LIMIT_SLOWDOWN_MS;
+        }
+        else {
+            return;
+        }
+        console.error(`[meta-mcp] x-app-usage at ${max}% (callCount=${rl.callCount ?? "?"}, ` +
+            `totalTime=${rl.totalTime ?? "?"}, totalCpuTime=${rl.totalCpuTime ?? "?"}); ` +
+            `delaying next request by ${delay}ms to stay under Meta's per-app quota.`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+    // Used for both form bodies (POST/PUT) and query strings (GET/DELETE) — every
+    // entry ends up URL-encoded in `qs`. Skipping `""` must precede the typeof
+    // check so the type narrowing below stays correct after the filter.
+    appendFormParams(qs, params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v === undefined || v === null || v === "")
+                continue;
+            if (typeof v !== "string" && typeof v !== "number" && typeof v !== "boolean") {
+                const kind = Array.isArray(v) ? "array" : typeof v;
+                throw new Error(`MetaClient: form parameter "${k}" has unsupported type "${kind}". ` +
+                    `Form-encoded params must be string | number | boolean — serialize arrays/objects ` +
+                    `explicitly with JSON.stringify(...) or .join(",") before assigning.`);
+            }
+            qs.set(k, String(v));
+        }
+    }
     async request(baseUrl, token, method, path, params, options) {
         let url = `${baseUrl}${path}`;
-        const init = { method, signal: AbortSignal.timeout(30_000) };
         const isWrite = method !== "GET" && method !== "DELETE";
-        const useJson = isWrite && options?.json;
+        const useJson = isWrite && options?.jsonBody !== undefined;
+        // `params` always lands in the URL query string (form body for POST/PUT,
+        // query string for GET/DELETE/JSON-mode). Combining `params` with
+        // `jsonBody` is rejected so that callers don't accidentally route data
+        // intended for the body into the query string when the JSON-mode wrapper
+        // overrides the body.
+        if (useJson && params !== undefined) {
+            throw new Error("MetaClient: `params` cannot be combined with `options.jsonBody`. Pass either form-encoded `params` or a JSON `jsonBody`, not both.");
+        }
         const qs = new URLSearchParams();
         qs.set("access_token", token);
+        if (params)
+            this.appendFormParams(qs, params);
+        // Body/headers are stable strings reusable across retry attempts; only
+        // `signal` must be fresh per attempt — sharing an exhausted
+        // `AbortSignal.timeout` would silently abort every subsequent retry.
+        const baseInit = { method };
         if (useJson) {
             url += (url.includes("?") ? "&" : "?") + qs.toString();
-            init.headers = { "Content-Type": "application/json" };
-            init.body = JSON.stringify(params ?? {});
+            baseInit.headers = { "Content-Type": "application/json" };
+            baseInit.body = JSON.stringify(options.jsonBody);
         }
         else if (isWrite) {
-            if (params) {
-                for (const [k, v] of Object.entries(params)) {
-                    if (v !== undefined && v !== null && v !== "") {
-                        qs.set(k, String(v));
-                    }
-                }
-            }
-            init.headers = { "Content-Type": "application/x-www-form-urlencoded" };
-            init.body = qs.toString();
+            baseInit.headers = { "Content-Type": "application/x-www-form-urlencoded" };
+            baseInit.body = qs.toString();
         }
         else {
-            if (params) {
-                for (const [k, v] of Object.entries(params)) {
-                    if (v !== undefined && v !== null && v !== "") {
-                        qs.set(k, String(v));
-                    }
-                }
-            }
             url += (url.includes("?") ? "&" : "?") + qs.toString();
         }
-        const res = await fetch(url, init);
-        if (!res.ok) {
-            const text = await res.text().catch(() => "");
-            const parsed = parseMetaErrorBody(text);
-            const detail = parsed?.message ?? text;
-            throw new MetaApiError({
-                message: `Meta API ${method} ${path} (${res.status}): ${detail}`,
-                httpStatus: res.status,
-                apiCode: parsed?.code,
-                apiSubcode: parsed?.subcode,
-                apiType: parsed?.type,
-                fbtraceId: parsed?.fbtraceId,
-                endpoint: path,
-                method,
-                body: text,
-            });
-        }
-        const rateLimit = this.parseRateLimit(res.headers);
-        const contentType = res.headers.get("content-type") || "";
-        if (contentType.includes("application/json")) {
-            const data = (await res.json());
-            if (data.error) {
-                const err = data.error;
-                const apiCode = typeof err.code === "number" ? err.code : undefined;
-                const apiSubcode = typeof err.error_subcode === "number" ? err.error_subcode : undefined;
-                const apiType = typeof err.type === "string" ? err.type : undefined;
-                const apiMessage = typeof err.message === "string" ? err.message : String(err.message ?? "");
-                const fbtraceId = typeof err.fbtrace_id === "string" ? err.fbtrace_id : undefined;
+        // Retry loop (#61): total request count is `maxRetries + 1`. `attempt` is
+        // 0-based — `attempt = 0` is the initial request, `attempt = N` is the Nth
+        // retry. `computeBackoffDelay(attempt, …)` therefore produces the correct
+        // 1s / 2s / 4s schedule on attempts 0 / 1 / 2 before retries 1 / 2 / 3.
+        // The trailing `throw` after the loop is for TS control-flow narrowing.
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            // Pre-request throttle from #60 — runs before every attempt so a retry
+            // after a 429 still consults the most recent x-app-usage snapshot.
+            await this.maybeThrottle();
+            // Arm the 30s abort timer *after* the throttle sleep so a backoff at
+            // high x-app-usage doesn't eat into the actual network window (#60 review).
+            const init = { ...baseInit, signal: AbortSignal.timeout(30_000) };
+            let res;
+            try {
+                res = await fetch(url, init);
+            }
+            catch (err) {
+                if (attempt < this.maxRetries) {
+                    await this.sleep(computeBackoffDelay(attempt, this.retryBaseDelayMs));
+                    continue;
+                }
+                throw err;
+            }
+            // Parse rate-limit on every response (a 429 still carries `x-app-usage`);
+            // header-less responses (OAuth token endpoints) leave state intact.
+            const rateLimit = this.parseRateLimit(res.headers);
+            if (rateLimit) {
+                this.lastRateLimit = rateLimit;
+                this.lastRateLimitAt = Date.now();
+            }
+            if (!res.ok &&
+                RETRYABLE_HTTP_STATUSES.has(res.status) &&
+                attempt < this.maxRetries) {
+                const retryAfterMs = parseRetryAfter(res.headers.get("retry-after"), this.now());
+                const delay = retryAfterMs !== undefined
+                    ? Math.min(retryAfterMs, MAX_RETRY_DELAY_MS)
+                    : computeBackoffDelay(attempt, this.retryBaseDelayMs);
+                // Release the connection — `cancel()` rejects on already-consumed bodies.
+                res.body?.cancel().catch(() => { });
+                await this.sleep(delay);
+                continue;
+            }
+            if (!res.ok) {
+                const text = await res.text().catch(() => "");
+                const parsed = parseMetaErrorBody(text);
+                const detail = parsed?.message ?? text;
                 throw new MetaApiError({
-                    message: `Meta API error: ${apiMessage} (code ${apiCode ?? "?"})`,
-                    apiCode,
-                    apiSubcode,
-                    apiType,
-                    fbtraceId,
+                    message: `Meta API ${method} ${path} (${res.status}): ${detail}`,
+                    httpStatus: res.status,
+                    apiCode: parsed?.code,
+                    apiSubcode: parsed?.subcode,
+                    apiType: parsed?.type,
+                    fbtraceId: parsed?.fbtraceId,
                     endpoint: path,
                     method,
-                    body: JSON.stringify(err),
+                    body: text,
                 });
             }
-            return { data, rateLimit };
+            const contentType = res.headers.get("content-type") || "";
+            if (contentType.includes("application/json")) {
+                const data = (await res.json());
+                if (data.error) {
+                    const err = data.error;
+                    const apiCode = typeof err.code === "number" ? err.code : undefined;
+                    const apiSubcode = typeof err.error_subcode === "number" ? err.error_subcode : undefined;
+                    const apiType = typeof err.type === "string" ? err.type : undefined;
+                    const apiMessage = typeof err.message === "string" ? err.message : String(err.message ?? "");
+                    const fbtraceId = typeof err.fbtrace_id === "string" ? err.fbtrace_id : undefined;
+                    throw new MetaApiError({
+                        message: `Meta API error: ${apiMessage} (code ${apiCode ?? "?"})`,
+                        apiCode,
+                        apiSubcode,
+                        apiType,
+                        fbtraceId,
+                        endpoint: path,
+                        method,
+                        body: JSON.stringify(err),
+                    });
+                }
+                return { data, rateLimit };
+            }
+            const text = await res.text();
+            return { data: { raw: text, success: true }, rateLimit };
         }
-        const text = await res.text();
-        return { data: { raw: text, success: true }, rateLimit };
+        throw new Error("MetaClient: retry loop exited without resolution (unreachable)");
     }
     async ig(method, path, params, options) {
         if (!this.config.instagramAccessToken) {
             throw new Error("INSTAGRAM_ACCESS_TOKEN is not configured.");
         }
-        return this.request(IG_BASE, this.config.instagramAccessToken, method, path, params, options);
+        return this.request(this.igBase, this.config.instagramAccessToken, method, path, params, options);
     }
     async threads(method, path, params, options) {
         if (!this.config.threadsAccessToken) {
             throw new Error("THREADS_ACCESS_TOKEN is not configured.");
         }
-        return this.request(THREADS_BASE, this.config.threadsAccessToken, method, path, params, options);
+        return this.request(this.threadsBase, this.config.threadsAccessToken, method, path, params, options);
     }
     async meta(method, path, params, options) {
         if (!this.config.appId || !this.config.appSecret) {
             throw new Error("META_APP_ID and META_APP_SECRET are required.");
         }
         const appToken = `${this.config.appId}|${this.config.appSecret}`;
-        return this.request(FB_BASE, appToken, method, path, params, options);
+        return this.request(this.fbBase, appToken, method, path, params, options);
     }
     /** Exchange short-lived Instagram token for long-lived token (60 days) */
     async igExchangeToken(shortToken) {
@@ -180,7 +384,7 @@ export class MetaClient {
             throw new Error("META_APP_ID and META_APP_SECRET are required for token debug.");
         }
         const appToken = `${this.config.appId}|${this.config.appSecret}`;
-        return this.request(FB_BASE, appToken, "GET", "/debug_token", {
+        return this.request(this.fbBase, appToken, "GET", "/debug_token", {
             input_token: inputToken,
         });
     }

package/dist/services/meta-client.js.map

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

package/dist/tools/annotations.d.ts

@@ -0,0 +1,6 @@
+import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
+export declare const READ_ONLY_TOOL: ToolAnnotations;
+export declare const DESTRUCTIVE_TOOL: ToolAnnotations;
+export declare const WRITE_TOOL: ToolAnnotations;
+export declare const WRITE_IDEMPOTENT_TOOL: ToolAnnotations;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/tools/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/tools/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAO1E,eAAO,MAAM,cAAc,EAAE,eAG5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAKxB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eAKnC,CAAC"}

package/dist/tools/annotations.js

@@ -0,0 +1,27 @@
+// Every tool in this project calls the Meta Graph API (Instagram + Threads),
+// so openWorldHint is always true. The four presets below cover every Meta
+// endpoint shape we expose; see https://modelcontextprotocol.io for the
+// canonical hint semantics.
+export const READ_ONLY_TOOL = {
+    readOnlyHint: true,
+    openWorldHint: true,
+};
+export const DESTRUCTIVE_TOOL = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+export const WRITE_TOOL = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+export const WRITE_IDEMPOTENT_TOOL = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+//# sourceMappingURL=annotations.js.map