@xquik/tweetclaw 1.6.5 → 1.6.6

package/dist/mpp.js

@@ -0,0 +1,39 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isCallable(value) {
+    return typeof value === 'function';
+}
+async function loadDynamicModule(name) {
+    const mod = await import(name);
+    if (!isRecord(mod)) {
+        throw new Error(`Failed to load ${name}`);
+    }
+    return mod;
+}
+function createModuleLoader() {
+    return loadDynamicModule;
+}
+async function initMpp(tempoSigningKey, loadModule) {
+    const load = loadModule ?? createModuleLoader();
+    const mppxMod = await load('mppx/client').catch(() => {
+        throw new Error('MPP requires mppx package. Run: npm i mppx viem');
+    });
+    const viemMod = await load('viem/accounts').catch(() => {
+        throw new Error('MPP requires viem package. Run: npm i mppx viem');
+    });
+    if (!isCallable(viemMod.privateKeyToAccount))
+        throw new Error('viem missing privateKeyToAccount');
+    if (!isCallable(mppxMod.tempo))
+        throw new Error('mppx missing tempo');
+    if (!isRecord(mppxMod.Mppx))
+        throw new Error('mppx missing Mppx');
+    const createMethod = mppxMod.Mppx.create;
+    if (!isCallable(createMethod))
+        throw new Error('mppx Mppx.create is not a function');
+    const account = viemMod.privateKeyToAccount(tempoSigningKey);
+    const method = mppxMod.tempo({ account });
+    createMethod({ methods: [method] });
+}
+export { createModuleLoader, initMpp, isCallable, isRecord };
+//# sourceMappingURL=mpp.js.map

package/dist/mpp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp.js","sourceRoot":"","sources":["../src/mpp.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,eAAuB,EAAE,UAAyB;IACvE,MAAM,IAAI,GAAG,UAAU,IAAI,kBAAkB,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAU,EAAE;QAC1D,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAU,EAAE;QAC5D,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACtE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAClE,MAAM,YAAY,GAAY,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrF,MAAM,OAAO,GAAY,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,MAAM,GAAY,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC"}

package/dist/request.d.ts

@@ -0,0 +1,7 @@
+import type { FetchFunction, RequestFunction } from './types.js';
+declare function buildAuthHeader(credential: string): Record<string, string>;
+declare function buildFetchHeaders(credential: string, hasBody: boolean): Record<string, string>;
+declare function buildFetchUrl(baseUrl: string, path: string, query?: Readonly<Record<string, string>>): string;
+declare function isProhibitedRequest(method: string, path: string): boolean;
+declare function createProxiedRequest(baseUrl: string, apiKey: string, fetchFunction?: FetchFunction): RequestFunction;
+export { buildAuthHeader, buildFetchHeaders, buildFetchUrl, createProxiedRequest, isProhibitedRequest };

package/dist/request.js

@@ -0,0 +1,88 @@
+const FETCH_TIMEOUT_MS = 30_000;
+const CONTENT_TYPE_HEADER = 'content-type';
+const API_KEY_HEADER = 'x-api-key';
+const AUTHORIZATION_HEADER = 'authorization';
+const BEARER_PREFIX = 'Bearer ';
+const API_KEY_PREFIX = 'xq_';
+const API_V1_PREFIX = '/api/v1/';
+const SUPPORT_TICKETS_PREFIX = '/api/v1/support/tickets';
+function buildAuthHeader(credential) {
+    if (credential.startsWith(API_KEY_PREFIX)) {
+        return { [API_KEY_HEADER]: credential };
+    }
+    return { [AUTHORIZATION_HEADER]: `${BEARER_PREFIX}${credential}` };
+}
+function buildFetchHeaders(credential, hasBody) {
+    const auth = credential === '' ? {} : buildAuthHeader(credential);
+    if (hasBody) {
+        return { ...auth, [CONTENT_TYPE_HEADER]: 'application/json' };
+    }
+    return auth;
+}
+function buildFetchUrl(baseUrl, path, query) {
+    const url = new URL(path, baseUrl);
+    if (query !== undefined) {
+        for (const [key, value] of Object.entries(query)) {
+            url.searchParams.set(key, value);
+        }
+    }
+    return url.toString();
+}
+const PROHIBITED_PATHS = [
+    ['PATCH', '/api/v1/account'],
+    ['PUT', '/api/v1/account/x-identity'],
+    ['GET', '/api/v1/api-keys'],
+    ['POST', '/api/v1/api-keys'],
+    ['POST', '/api/v1/credits/topup'],
+    ['GET', '/api/v1/credits/topup/status'],
+    ['POST', '/api/v1/credits/quick-topup'],
+    ['POST', '/api/v1/subscribe'],
+    ['POST', '/api/v1/x/accounts'],
+    ['POST', '/api/v1/x/accounts/'],
+    ['POST', '/api/v1/x/accounts/bulk-retry'],
+];
+const PROHIBITED_PATH_PATTERNS = [
+    ['DELETE', /^\/api\/v1\/api-keys\/[^/]+\/?$/u],
+    ['DELETE', /^\/api\/v1\/x\/accounts\/[^/]+\/?$/u],
+    ['GET', /^\/api\/v1\/x\/accounts\/[^/]+\/?$/u],
+    ['POST', /^\/api\/v1\/x\/accounts\/[^/]+\/reauth\/?$/u],
+];
+const SUPPORT_TICKET_METHODS = new Set(['GET', 'PATCH', 'POST']);
+function isSupportTicketPath(method, path) {
+    return SUPPORT_TICKET_METHODS.has(method)
+        && (path === SUPPORT_TICKETS_PREFIX || path.startsWith(`${SUPPORT_TICKETS_PREFIX}/`));
+}
+function isProhibitedRequest(method, path) {
+    const upperMethod = method.toUpperCase();
+    const matchesStaticPath = PROHIBITED_PATHS.some(([blockedMethod, blockedPath]) => upperMethod === blockedMethod && path === blockedPath);
+    const matchesPattern = PROHIBITED_PATH_PATTERNS.some(([blockedMethod, pattern]) => upperMethod === blockedMethod && pattern.test(path));
+    return matchesStaticPath || matchesPattern || isSupportTicketPath(upperMethod, path);
+}
+function validateRequestPath(method, path) {
+    if (!path.startsWith(API_V1_PREFIX)) {
+        throw new Error(`Path must start with /api/v1/ but got: ${path}`);
+    }
+    if (isProhibitedRequest(method, path)) {
+        throw new Error('Agent-prohibited endpoint. Account connection and re-authentication must be done through the Xquik dashboard at dashboard.xquik.com, not through the agent.');
+    }
+}
+function createProxiedRequest(baseUrl, apiKey, fetchFunction = fetch) {
+    return async (path, options) => {
+        const method = options?.method ?? 'GET';
+        validateRequestPath(method, path);
+        const hasBody = options?.body !== undefined;
+        const response = await fetchFunction(buildFetchUrl(baseUrl, path, options?.query), {
+            ...(hasBody ? { body: JSON.stringify(options.body) } : {}),
+            headers: buildFetchHeaders(apiKey, hasBody),
+            method,
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        const json = await response.json();
+        if (!response.ok) {
+            throw new Error(`API request failed: ${String(response.status)} ${response.statusText} - ${JSON.stringify(json)}`);
+        }
+        return json;
+    };
+}
+export { buildAuthHeader, buildFetchHeaders, buildFetchUrl, createProxiedRequest, isProhibitedRequest };
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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

package/dist/services/event-poller.d.ts

@@ -0,0 +1,7 @@
+import type { EventPollerOptions } from '../types.js';
+interface EventPollerHandle {
+    readonly start: () => void;
+    readonly stop: () => void;
+}
+declare function createEventPoller(options: EventPollerOptions): EventPollerHandle;
+export { createEventPoller };

package/dist/services/event-poller.js

@@ -0,0 +1,69 @@
+const MAX_BACKOFF_SECONDS = 300;
+const BACKOFF_BASE = 2;
+const MS_PER_SECOND = 1000;
+function isEventsResponse(value) {
+    return typeof value === 'object' && value !== null && 'events' in value;
+}
+function extractCursor(events) {
+    const lastEvent = events.at(-1);
+    return typeof lastEvent?.id === 'string' ? lastEvent.id : undefined;
+}
+function createEventPoller(options) {
+    let timer = undefined;
+    let cursor = undefined;
+    let consecutiveErrors = 0;
+    let stopped = false;
+    async function poll() {
+        try {
+            const query = {};
+            if (cursor !== undefined) {
+                query.after = cursor;
+            }
+            const hasQuery = Object.keys(query).length > 0;
+            const result = await options.request('/api/v1/events', hasQuery ? { query } : undefined);
+            if (!isEventsResponse(result)) {
+                return;
+            }
+            if (result.events.length > 0) {
+                options.onEvents(result.events);
+                const newCursor = extractCursor(result.events);
+                if (newCursor !== undefined) {
+                    cursor = newCursor;
+                }
+            }
+            consecutiveErrors = 0;
+        }
+        catch {
+            consecutiveErrors += 1;
+        }
+    }
+    function getNextInterval() {
+        if (consecutiveErrors === 0) {
+            return options.intervalSeconds * MS_PER_SECOND;
+        }
+        const backoffSeconds = Math.min(Math.pow(BACKOFF_BASE, consecutiveErrors) * options.intervalSeconds, MAX_BACKOFF_SECONDS);
+        return backoffSeconds * MS_PER_SECOND;
+    }
+    async function loop() {
+        await poll();
+        if (stopped) {
+            return;
+        }
+        timer = setTimeout(() => { void loop(); }, getNextInterval());
+    }
+    return {
+        start() {
+            stopped = false;
+            timer = setTimeout(() => { void loop(); }, options.intervalSeconds * MS_PER_SECOND);
+        },
+        stop() {
+            stopped = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+        },
+    };
+}
+export { createEventPoller };
+//# sourceMappingURL=event-poller.js.map

package/dist/services/event-poller.js.map

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

package/dist/tools/catalog.d.ts

@@ -0,0 +1,17 @@
+import type { EndpointInfo, ExploreParams, TweetclawParams } from '../types.js';
+declare const specEndpoints: readonly EndpointInfo[];
+declare function normalizeMethod(method?: string): string;
+declare function matchesEndpointPath(endpointPath: string, requestPath: string): boolean;
+declare function findEndpoint(method: string, path: string): EndpointInfo | undefined;
+declare function requestNeedsApproval(method: string, path: string): boolean;
+declare function resolveCatalogRequest(params: Readonly<TweetclawParams>, options?: Readonly<{
+    mppMode?: boolean;
+}>): {
+    readonly body?: unknown;
+    readonly endpoint: EndpointInfo;
+    readonly method: string;
+    readonly path: string;
+    readonly query?: Readonly<Record<string, string>>;
+};
+declare function exploreCatalog(params?: Readonly<ExploreParams>): readonly EndpointInfo[];
+export { exploreCatalog, findEndpoint, matchesEndpointPath, normalizeMethod, requestNeedsApproval, resolveCatalogRequest, specEndpoints, };

package/dist/tools/catalog.js

@@ -0,0 +1,110 @@
+import { API_SPEC } from '../api-spec.js';
+const API_V1_PREFIX = '/api/v1/';
+const DEFAULT_EXPLORE_LIMIT = 25;
+const MAX_EXPLORE_LIMIT = 100;
+const specEndpoints = API_SPEC.filter((endpoint) => endpoint.agentProhibited !== true);
+function normalizeMethod(method) {
+    return (method ?? 'GET').toUpperCase();
+}
+function normalizeLimit(limit) {
+    if (limit === undefined || !Number.isFinite(limit)) {
+        return DEFAULT_EXPLORE_LIMIT;
+    }
+    return Math.min(Math.max(Math.trunc(limit), 1), MAX_EXPLORE_LIMIT);
+}
+function pathSegments(path) {
+    const normalized = path.endsWith('/') ? path.slice(0, -1) : path;
+    return normalized.split('/');
+}
+function matchesEndpointPath(endpointPath, requestPath) {
+    if (endpointPath === requestPath)
+        return true;
+    const endpointSegments = pathSegments(endpointPath);
+    const requestSegments = pathSegments(requestPath);
+    if (endpointSegments.length !== requestSegments.length)
+        return false;
+    return endpointSegments.every((segment, index) => {
+        const requestSegment = String(requestSegments.at(index));
+        return segment.startsWith(':') ? requestSegment.length > 0 : segment === requestSegment;
+    });
+}
+function assertSafePath(path) {
+    if (!path.startsWith(API_V1_PREFIX)) {
+        throw new Error(`Path must start with /api/v1/ but got: ${path}`);
+    }
+    if (path.includes('?') || path.includes('#')) {
+        throw new Error('Pass query parameters through the query object, not in the path.');
+    }
+}
+function findEndpoint(method, path) {
+    return specEndpoints.find((endpoint) => endpoint.method === method && matchesEndpointPath(endpoint.path, path));
+}
+function normalizeQuery(query) {
+    if (query === undefined)
+        return undefined;
+    return Object.fromEntries(Object.entries(query).map(([key, value]) => [key, String(value)]));
+}
+function requestNeedsApproval(method, path) {
+    if (method !== 'GET') {
+        return true;
+    }
+    return path.startsWith('/api/v1/events')
+        || path.startsWith('/api/v1/webhooks')
+        || path === '/api/v1/x/accounts'
+        || path.startsWith('/api/v1/x/accounts/')
+        || path.startsWith('/api/v1/x/bookmarks')
+        || path.startsWith('/api/v1/x/dm/')
+        || path.startsWith('/api/v1/x/notifications')
+        || path.startsWith('/api/v1/x/timeline');
+}
+function resolveCatalogRequest(params, options) {
+    const method = normalizeMethod(params.method);
+    const { body, path } = params;
+    assertSafePath(path);
+    const endpoint = findEndpoint(method, path);
+    if (endpoint === undefined) {
+        throw new Error(`Endpoint is not in the TweetClaw catalog: ${method} ${path}`);
+    }
+    if (options?.mppMode === true && endpoint.mpp === undefined) {
+        throw new Error(`Endpoint is not available in MPP mode: ${method} ${endpoint.path}`);
+    }
+    const query = normalizeQuery(params.query);
+    if (query === undefined) {
+        return { body, endpoint, method, path };
+    }
+    return { body, endpoint, method, path, query };
+}
+function endpointMatchesQuery(endpoint, query) {
+    const normalized = query.toLowerCase();
+    const { category, method, parameters, path, responseShape, summary } = endpoint;
+    const haystack = [
+        category,
+        method,
+        path,
+        responseShape,
+        summary,
+        ...(parameters ?? []).flatMap((parameter) => [
+            parameter.description,
+            parameter.name,
+            parameter.type,
+        ]),
+    ].join(' ').toLowerCase();
+    return haystack.includes(normalized);
+}
+function exploreCatalog(params = {}) {
+    const method = params.method === undefined ? undefined : normalizeMethod(params.method);
+    const query = params.query?.trim();
+    const category = params.category?.trim().toLowerCase();
+    const path = params.path?.trim();
+    const limit = normalizeLimit(params.limit);
+    return specEndpoints
+        .filter((endpoint) => method === undefined || endpoint.method === method)
+        .filter((endpoint) => category === undefined || endpoint.category.toLowerCase() === category)
+        .filter((endpoint) => params.free === undefined || endpoint.free === params.free)
+        .filter((endpoint) => params.mpp === undefined || (endpoint.mpp !== undefined) === params.mpp)
+        .filter((endpoint) => path === undefined || matchesEndpointPath(endpoint.path, path) || endpoint.path.includes(path))
+        .filter((endpoint) => query === undefined || query.length === 0 || endpointMatchesQuery(endpoint, query))
+        .slice(0, limit);
+}
+export { exploreCatalog, findEndpoint, matchesEndpointPath, normalizeMethod, requestNeedsApproval, resolveCatalogRequest, specEndpoints, };
+//# sourceMappingURL=catalog.js.map

package/dist/tools/catalog.js.map

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

package/dist/tools/explore.d.ts

@@ -0,0 +1,5 @@
+import type { EndpointInfo, ExploreParams, ToolResult } from '../types.js';
+declare const SEARCH_DESCRIPTION: string;
+declare function handleExplore(params?: Readonly<ExploreParams>): Promise<ToolResult>;
+export { handleExplore, SEARCH_DESCRIPTION };
+export type { EndpointInfo };

package/dist/tools/explore.js

@@ -0,0 +1,28 @@
+import { exploreCatalog, specEndpoints } from './catalog.js';
+import { errorResult, successResult } from './result.js';
+const categories = [...new Set(specEndpoints.map((endpoint) => endpoint.category))]
+    .toSorted((a, b) => a.localeCompare(b))
+    .join(', ');
+const SEARCH_DESCRIPTION = `Search the X (Twitter) API endpoint catalog. No network calls and no code execution.
+
+Use structured filters:
+- query: keyword search across summaries, paths, response shapes, and parameters
+- category: one of ${categories}
+- method: GET, POST, PATCH, PUT, or DELETE
+- path: exact or partial API path
+- free: true for free endpoints, false for paid endpoints
+- mpp: true for MPP-eligible endpoints only
+- limit: 1-100 results, default 25
+
+Returns endpoint descriptors with method, path, summary, category, parameters, cost, and response shape.`;
+async function handleExplore(params = {}) {
+    try {
+        const result = await Promise.resolve(exploreCatalog(params));
+        return successResult(result);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+}
+export { handleExplore, SEARCH_DESCRIPTION };
+//# sourceMappingURL=explore.js.map

package/dist/tools/explore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.js","sourceRoot":"","sources":["../../src/tools/explore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;KAChF,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;KACtC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEd,MAAM,kBAAkB,GAAG;;;;qBAIN,UAAU;;;;;;;yGAO0E,CAAC;AAE1G,KAAK,UAAU,aAAa,CAAC,SAAkC,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/tools/result.d.ts

@@ -0,0 +1,5 @@
+import type { ToolResult } from '../types.js';
+declare function extractErrorMessage(error: unknown): string;
+declare function successResult(content: unknown): ToolResult;
+declare function errorResult(error: unknown): ToolResult;
+export { errorResult, extractErrorMessage, successResult };

package/dist/tools/result.js

@@ -0,0 +1,15 @@
+import { truncateResponse } from '../truncate.js';
+function extractErrorMessage(error) {
+    if (error instanceof Error) {
+        return `${error.constructor.name}: ${error.message}`;
+    }
+    return String(error);
+}
+function successResult(content) {
+    return { content: [{ text: truncateResponse(content), type: 'text' }] };
+}
+function errorResult(error) {
+    return { content: [{ text: extractErrorMessage(error), type: 'text' }], isError: true };
+}
+export { errorResult, extractErrorMessage, successResult };
+//# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC"}

package/dist/tools/tweetclaw.d.ts

@@ -0,0 +1,13 @@
+import { specEndpoints } from './catalog.js';
+import type { FetchFunction, ToolResult, TweetclawParams } from '../types.js';
+declare const EXECUTE_DESCRIPTION = "Invoke one Xquik API endpoint from the bundled TweetClaw catalog.\n\nUse \"explore\" first to find the endpoint, then call this tool with structured parameters:\n- path: concrete /api/v1/... path\n- method: GET, POST, PATCH, PUT, or DELETE\n- query: query parameters as an object\n- body: JSON request body\n\nAuth is injected automatically. Never pass API keys, signing keys, passwords, cookies, or TOTP secrets.\n\n## Important rules\n- Only endpoints listed in the bundled catalog can be invoked. Unknown paths are rejected.\n- The plugin only calls the configured Xquik API base URL and only /api/v1 paths.\n- Account connection, re-authentication, API-key administration, subscription checkout, credit top-up, and support-ticket actions are dashboard-only.\n- TWEET ACTIONS: SENDING a tweet (\"tweet this\", \"post this\") uses POST /api/v1/x/tweets. DRAFTING a tweet (\"help me write\", \"compose\") uses the compose flow.\n- WRITE ACTIONS: Show the exact endpoint and payload to the user before approval. All write-like calls trigger an OpenClaw approval prompt.\n- MPP MODE: When configured with a signing key and no API key, only MPP-eligible read endpoints are allowed.\n- CURRENT EVENTS: Use /api/v1/radar for curated trends.\n\n## Example: Send a tweet\n{\n  \"path\": \"/api/v1/x/tweets\",\n  \"method\": \"POST\",\n  \"body\": { \"account\": \"@myaccount\", \"text\": \"Hello world!\" }\n}\n\n## Example: Search tweets\n{\n  \"path\": \"/api/v1/x/tweets/search\",\n  \"method\": \"GET\",\n  \"query\": { \"q\": \"AI agents\", \"limit\": 50 }\n}";
+interface TweetclawOptions {
+    readonly apiKey: string;
+    readonly baseUrl: string;
+    readonly fetchFunction?: FetchFunction | undefined;
+    readonly mppMode?: boolean | undefined;
+    readonly params: Readonly<TweetclawParams>;
+    readonly timeoutMs?: number | undefined;
+}
+declare function handleTweetclaw(options: Readonly<TweetclawOptions>): Promise<ToolResult>;
+export { EXECUTE_DESCRIPTION, handleTweetclaw, specEndpoints };

package/dist/tools/tweetclaw.js

@@ -0,0 +1,62 @@
+import { createProxiedRequest } from '../request.js';
+import { resolveCatalogRequest, specEndpoints } from './catalog.js';
+import { errorResult, successResult } from './result.js';
+const EXECUTE_DESCRIPTION = `Invoke one Xquik API endpoint from the bundled TweetClaw catalog.
+
+Use "explore" first to find the endpoint, then call this tool with structured parameters:
+- path: concrete /api/v1/... path
+- method: GET, POST, PATCH, PUT, or DELETE
+- query: query parameters as an object
+- body: JSON request body
+
+Auth is injected automatically. Never pass API keys, signing keys, passwords, cookies, or TOTP secrets.
+
+## Important rules
+- Only endpoints listed in the bundled catalog can be invoked. Unknown paths are rejected.
+- The plugin only calls the configured Xquik API base URL and only /api/v1 paths.
+- Account connection, re-authentication, API-key administration, subscription checkout, credit top-up, and support-ticket actions are dashboard-only.
+- TWEET ACTIONS: SENDING a tweet ("tweet this", "post this") uses POST /api/v1/x/tweets. DRAFTING a tweet ("help me write", "compose") uses the compose flow.
+- WRITE ACTIONS: Show the exact endpoint and payload to the user before approval. All write-like calls trigger an OpenClaw approval prompt.
+- MPP MODE: When configured with a signing key and no API key, only MPP-eligible read endpoints are allowed.
+- CURRENT EVENTS: Use /api/v1/radar for curated trends.
+
+## Example: Send a tweet
+{
+  "path": "/api/v1/x/tweets",
+  "method": "POST",
+  "body": { "account": "@myaccount", "text": "Hello world!" }
+}
+
+## Example: Search tweets
+{
+  "path": "/api/v1/x/tweets/search",
+  "method": "GET",
+  "query": { "q": "AI agents", "limit": 50 }
+}`;
+const EXECUTION_TIMEOUT_MS = 30_000;
+const MS_PER_SECOND = 1000;
+async function handleTweetclaw(options) {
+    const { apiKey, baseUrl, fetchFunction, mppMode = false, params, timeoutMs = EXECUTION_TIMEOUT_MS, } = options;
+    try {
+        const requestInfo = resolveCatalogRequest(params, { mppMode });
+        const request = createProxiedRequest(baseUrl, apiKey, fetchFunction);
+        const result = await Promise.race([
+            request(requestInfo.path, {
+                ...(requestInfo.body === undefined ? {} : { body: requestInfo.body }),
+                method: requestInfo.method,
+                ...(requestInfo.query === undefined ? {} : { query: requestInfo.query }),
+            }),
+            new Promise((_resolve, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`Execution timed out after ${String(timeoutMs / MS_PER_SECOND)}s`));
+                }, timeoutMs);
+            }),
+        ]);
+        return successResult(result);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+}
+export { EXECUTE_DESCRIPTION, handleTweetclaw, specEndpoints };
+//# sourceMappingURL=tweetclaw.js.map

package/dist/tools/tweetclaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweetclaw.js","sourceRoot":"","sources":["../../src/tools/tweetclaw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B1B,CAAC;AAEH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,aAAa,GAAG,IAAI,CAAC;AAW3B,KAAK,UAAU,eAAe,CAAC,OAAmC;IAChE,MAAM,EACJ,MAAM,EACN,OAAO,EACP,aAAa,EACb,OAAO,GAAG,KAAK,EACf,MAAM,EACN,SAAS,GAAG,oBAAoB,GACjC,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAoB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QACtF,MAAM,MAAM,GAAY,MAAM,OAAO,CAAC,IAAI,CAAC;YACzC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE;gBACxB,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;gBACrE,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,GAAG,CAAC,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;aACzE,CAAC;YACF,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBACtC,UAAU,CAAC,GAAG,EAAE;oBACd,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvF,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC,CAAC;SACH,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}

package/dist/truncate.d.ts

@@ -0,0 +1,3 @@
+declare function truncateText(text: string): string;
+declare function truncateResponse(content: unknown): string;
+export { truncateResponse, truncateText };

package/dist/truncate.js

@@ -0,0 +1,25 @@
+const MAX_RESPONSE_CHARS = 24_000;
+const CHARS_PER_TOKEN = 4;
+const MAX_TOKENS = 6000;
+function truncateText(text) {
+    if (text.length <= MAX_RESPONSE_CHARS) {
+        return text;
+    }
+    const approximateTokens = Math.ceil(text.length / CHARS_PER_TOKEN);
+    const formatted = approximateTokens.toLocaleString('en-US');
+    return `${text.slice(0, MAX_RESPONSE_CHARS)}\n\n--- TRUNCATED ---\nResponse was ~${formatted} tokens (limit: ${MAX_TOKENS.toLocaleString('en-US')}). Use more specific queries or filters to reduce response size.`;
+}
+function stringifyContent(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (content === undefined) {
+        return 'undefined';
+    }
+    return JSON.stringify(content, undefined, 2);
+}
+function truncateResponse(content) {
+    return truncateText(stringifyContent(content));
+}
+export { truncateResponse, truncateText };
+//# sourceMappingURL=truncate.js.map

package/dist/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../src/truncate.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,IAAI,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,iBAAiB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,wCAAwC,SAAS,mBAAmB,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,kEAAkE,CAAC;AACtN,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,OAAO,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+interface EndpointParameter {
+    readonly description: string;
+    readonly in: 'body' | 'path' | 'query';
+    readonly name: string;
+    readonly required: boolean;
+    readonly type: string;
+}
+interface EndpointInfo {
+    readonly agentProhibited?: true;
+    readonly category: string;
+    readonly free: boolean;
+    readonly method: string;
+    readonly mpp?: {
+        readonly intent: string;
+        readonly price: string;
+    };
+    readonly parameters?: readonly EndpointParameter[];
+    readonly path: string;
+    readonly responseShape?: string;
+    readonly sensitive?: true;
+    readonly summary: string;
+}
+interface RequestOptions {
+    readonly body?: unknown;
+    readonly method?: string;
+    readonly query?: Readonly<Record<string, string>>;
+}
+type RequestFunction = (path: string, options?: Readonly<RequestOptions>) => Promise<unknown>;
+type FetchFunction = typeof fetch;
+interface ExploreParams {
+    readonly category?: string;
+    readonly free?: boolean;
+    readonly limit?: number;
+    readonly method?: string;
+    readonly mpp?: boolean;
+    readonly path?: string;
+    readonly query?: string;
+}
+interface TweetclawParams {
+    readonly body?: unknown;
+    readonly method?: string;
+    readonly path: string;
+    readonly query?: Readonly<Record<string, boolean | number | string>>;
+}
+interface ToolResult {
+    readonly content: ReadonlyArray<{
+        readonly text: string;
+        readonly type: 'text';
+    }>;
+    readonly isError?: true;
+}
+interface PluginConfig {
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly pollingEnabled?: boolean;
+    readonly pollingInterval?: number;
+    readonly tempoSigningKey?: string;
+}
+interface EventPollerOptions {
+    readonly intervalSeconds: number;
+    readonly onEvents: (events: ReadonlyArray<Readonly<Record<string, unknown>>>) => void;
+    readonly request: RequestFunction;
+}
+export type { EndpointInfo, EndpointParameter, EventPollerOptions, ExploreParams, FetchFunction, PluginConfig, RequestFunction, RequestOptions, TweetclawParams, ToolResult, };

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}