@elizaos/plugin-xai 2.0.0-alpha.1

package/dist/client/api-types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Common types for X plugin API responses
+ */
+/**
+ * Generic API result container
+ * Defined here to avoid circular dependency with profile.ts and posts.ts
+ */
+export type RequestApiResult<T> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    err: Error;
+};
+/**
+ * Options for request transformation
+ */
+export interface FetchTransformOptions {
+    /**
+     * Transforms the request options before a request is made.
+     */
+    request: (...args: [input: RequestInfo | URL, init?: RequestInit]) => [input: RequestInfo | URL, init?: RequestInit] | Promise<[input: RequestInfo | URL, init?: RequestInit]>;
+    /**
+     * Transforms the response after a request completes.
+     */
+    response: (response: Response) => Response | Promise<Response>;
+}
+//# sourceMappingURL=api-types.d.ts.map

package/dist/client/api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.d.ts","sourceRoot":"","sources":["../../client/api-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,KAAK,CAAA;CAAE,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,CACP,GAAG,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,KAErD,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,GAC9C,OAAO,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAE5D;;OAEG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAChE"}

package/dist/client/auth-providers/broker.d.ts

@@ -0,0 +1,19 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { XAuthProvider } from "./types";
+/**
+ * Broker-ready scaffolding (stub only).
+ *
+ * Future contract idea (v1):
+ * - GET {X_BROKER_URL}/v1/x/access-token
+ *   -> { access_token: string, expires_at: number }
+ *
+ * This plugin intentionally ships NO secrets. The broker would handle client secrets
+ * and user sessions, returning short-lived access tokens to the agent.
+ */
+export declare class BrokerAuthProvider implements XAuthProvider {
+    private readonly runtime;
+    readonly mode: "broker";
+    constructor(runtime: IAgentRuntime);
+    getAccessToken(): Promise<string>;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/client/auth-providers/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAG1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;gBAEL,OAAO,EAAE,aAAa;IAE7C,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAUxC"}

package/dist/client/auth-providers/env.d.ts

@@ -0,0 +1,20 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { OAuth1Credentials, XOAuth1Provider } from "./types";
+/**
+ * Env-var auth provider (OAuth 1.0a user context).
+ *
+ * Configuration:
+ * - X_API_KEY
+ * - X_API_SECRET
+ * - X_ACCESS_TOKEN
+ * - X_ACCESS_TOKEN_SECRET
+ */
+export declare class EnvAuthProvider implements XOAuth1Provider {
+    private readonly runtime?;
+    private readonly state?;
+    readonly mode: "env";
+    constructor(runtime?: IAgentRuntime | undefined, state?: Record<string, unknown> | undefined);
+    getOAuth1Credentials(): Promise<OAuth1Credentials>;
+    getAccessToken(): Promise<string>;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/client/auth-providers/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,eAAe;IAInD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;gBAGZ,OAAO,CAAC,EAAE,aAAa,YAAA,EACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAG5C,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAkClD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAIxC"}

package/dist/client/auth-providers/factory.d.ts

@@ -0,0 +1,5 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { XAuthMode, XAuthProvider } from "./types";
+export declare function getXAuthMode(runtime?: IAgentRuntime, state?: Record<string, unknown>): XAuthMode;
+export declare function createXAuthProvider(runtime: IAgentRuntime, state?: Record<string, unknown>): XAuthProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/client/auth-providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQxD,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAIhG;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,aAAa,CAUf"}

package/dist/client/auth-providers/interactive.d.ts

@@ -0,0 +1,7 @@
+export interface OAuthCallbackResult {
+    code: string;
+    state?: string;
+}
+export declare function promptForRedirectedUrl(promptText: string): Promise<string>;
+export declare function waitForLoopbackCallback(redirectUri: string, expectedState: string, timeoutMs?: number): Promise<OAuthCallbackResult>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/client/auth-providers/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/interactive.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBhF;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAsF9B"}

package/dist/client/auth-providers/oauth2-pkce.d.ts

@@ -0,0 +1,24 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { StoredOAuth2Tokens, TokenStore } from "./token-store";
+import type { XAuthProvider } from "./types";
+export declare class OAuth2PKCEAuthProvider implements XAuthProvider {
+    private readonly runtime;
+    private readonly tokenStore;
+    private readonly fetchImpl;
+    private readonly interactiveLoginFn?;
+    readonly mode: "oauth";
+    private tokens;
+    constructor(runtime: IAgentRuntime, tokenStore?: TokenStore, fetchImpl?: typeof fetch, interactiveLoginFn?: (() => Promise<StoredOAuth2Tokens>) | undefined);
+    private get clientId();
+    private get redirectUri();
+    private get scopes();
+    private loadTokens;
+    private saveTokens;
+    private buildAuthorizeUrl;
+    private exchangeCodeForToken;
+    private refreshAccessToken;
+    private interactiveLogin;
+    getAccessToken(): Promise<string>;
+}
+export declare const OAUTH2_DEFAULT_SCOPES: string;
+//# sourceMappingURL=oauth2-pkce.d.ts.map

package/dist/client/auth-providers/oauth2-pkce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth2-pkce.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/oauth2-pkce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAqB7C,qBAAa,sBAAuB,YAAW,aAAa;IAMxD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IARtC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,MAAM,CAAmC;gBAG9B,OAAO,EAAE,aAAa,EACtB,UAAU,GAAE,UAA6C,EACzD,SAAS,GAAE,OAAO,KAAa,EAC/B,kBAAkB,CAAC,GAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,aAAA;IAGzE,OAAO,KAAK,QAAQ,GAInB;IAED,OAAO,KAAK,WAAW,GAItB;IAED,OAAO,KAAK,MAAM,GAEjB;YAEa,UAAU;YAMV,UAAU;IAKxB,OAAO,CAAC,iBAAiB;YAYX,oBAAoB;YA2CpB,kBAAkB;YAsClB,gBAAgB;IAwCxB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CA6BxC;AAED,eAAO,MAAM,qBAAqB,QAAiB,CAAC"}

package/dist/client/auth-providers/pkce.d.ts

@@ -0,0 +1,5 @@
+export declare function base64UrlEncode(input: Buffer): string;
+export declare function createCodeVerifier(byteLength?: number): string;
+export declare function createCodeChallenge(verifier: string): string;
+export declare function createState(byteLength?: number): string;
+//# sourceMappingURL=pkce.d.ts.map

package/dist/client/auth-providers/pkce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkce.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/pkce.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,SAAK,GAAG,MAAM,CAG1D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,WAAW,CAAC,UAAU,SAAK,GAAG,MAAM,CAEnD"}

package/dist/client/auth-providers/token-store.d.ts

@@ -0,0 +1,31 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export interface StoredOAuth2Tokens {
+    access_token: string;
+    refresh_token?: string;
+    expires_at: number;
+    scope?: string;
+    token_type?: string;
+}
+export interface TokenStore {
+    load(): Promise<StoredOAuth2Tokens | null>;
+    save(tokens: StoredOAuth2Tokens): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare class RuntimeCacheTokenStore implements TokenStore {
+    private readonly runtime;
+    private readonly key;
+    constructor(runtime: IAgentRuntime, key?: string);
+    load(): Promise<StoredOAuth2Tokens | null>;
+    save(tokens: StoredOAuth2Tokens): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare class FileTokenStore implements TokenStore {
+    private readonly path;
+    constructor(path: string);
+    static defaultPath(): string;
+    load(): Promise<StoredOAuth2Tokens | null>;
+    save(tokens: StoredOAuth2Tokens): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare function chooseDefaultTokenStore(runtime: IAgentRuntime | undefined): TokenStore;
+//# sourceMappingURL=token-store.d.ts.map

package/dist/client/auth-providers/token-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/token-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,sBAAuB,YAAW,UAAU;IAGrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEV,OAAO,EAAE,aAAa,EACvC,GAAG,CAAC,EAAE,MAAM;IAKR,IAAI,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAS1C,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED,qBAAa,cAAe,YAAW,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC,MAAM,CAAC,WAAW,IAAI,MAAM;IAKtB,IAAI,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAa1C,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,UAAU,CAUtF"}

package/dist/client/auth-providers/types.d.ts

@@ -0,0 +1,35 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export type XAuthMode = "env" | "oauth" | "broker";
+/**
+ * Primary abstraction: obtain a valid access token for X API calls.
+ *
+ * - For OAuth2 PKCE mode, this is the OAuth2 user access token (Bearer).
+ * - For env mode (OAuth1.0a), this returns the OAuth1 access token string
+ *   (and the provider may expose additional fields via `getOAuth1Credentials()`).
+ */
+export interface XAuthProvider {
+    readonly mode: XAuthMode;
+    /**
+     * Returns a valid access token string.
+     * Implementations should refresh/reauth as needed.
+     */
+    getAccessToken(): Promise<string>;
+}
+export interface OAuth1Credentials {
+    appKey: string;
+    appSecret: string;
+    accessToken: string;
+    accessSecret: string;
+}
+/**
+ * Optional capability for OAuth1.0a flow.
+ * Consumers should not depend on this unless they need OAuth1 signing.
+ */
+export interface XOAuth1Provider extends XAuthProvider {
+    getOAuth1Credentials(): Promise<OAuth1Credentials>;
+}
+export interface XAuthProviderFactoryOptions {
+    runtime: IAgentRuntime;
+    state?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/auth-providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../client/auth-providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/dist/client/auth.d.ts

@@ -0,0 +1,38 @@
+import { TwitterApi } from "twitter-api-v2";
+import type { XAuthProvider } from "./auth-providers/types";
+import type { Profile } from "./profile";
+/**
+ * X API v2 authentication using developer credentials
+ */
+export declare class XAuth {
+    private readonly provider;
+    private v2Client;
+    private authenticated;
+    private profile?;
+    private loggedOut;
+    private lastAccessToken?;
+    constructor(provider: XAuthProvider);
+    private isOAuth1Provider;
+    private ensureClientInitialized;
+    /**
+     * Get the X API v2 client
+     */
+    getV2Client(): Promise<TwitterApi>;
+    /**
+     * Check if authenticated
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Get current user profile
+     */
+    me(): Promise<Profile | undefined>;
+    /**
+     * Logout (clear credentials)
+     */
+    logout(): Promise<void>;
+    /**
+     * For compatibility - always returns true since we use API keys
+     */
+    hasToken(): boolean;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../client/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,qBAAa,KAAK;IAQJ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAPrC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,eAAe,CAAC,CAAS;gBAEJ,QAAQ,EAAE,aAAa;IAOpD,OAAO,CAAC,gBAAgB;YAIV,uBAAuB;IA2BrC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC;IAQxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAoBpC;;OAEG;IACG,EAAE,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IA6CxC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB"}