@elizaos/plugin-xai 2.0.0-alpha.1

package/dist/post.d.ts

@@ -0,0 +1,43 @@
+import { type IAgentRuntime } from "@elizaos/core";
+import type { ClientBase } from "./base";
+/**
+ * Class representing an X post client for generating and posting.
+ */
+export declare class XPostClient {
+    client: ClientBase;
+    runtime: IAgentRuntime;
+    xUsername: string;
+    private isDryRun;
+    private state;
+    private isRunning;
+    private isPosting;
+    /**
+     * Creates an instance of XPostClient.
+     * @param {ClientBase} client - The client instance.
+     * @param {IAgentRuntime} runtime - The runtime instance.
+     * @param {Record<string, unknown>} state - The state object containing configuration settings
+     */
+    constructor(client: ClientBase, runtime: IAgentRuntime, state: Record<string, unknown>);
+    /**
+     * Stops the X post client
+     */
+    stop(): Promise<void>;
+    /**
+     * Starts the X post client, setting up a loop to periodically generate new posts.
+     */
+    start(): Promise<void>;
+    /**
+     * Handles the creation and posting of a post by emitting standardized events.
+     * This approach aligns with our platform-independent architecture.
+     * @returns {Promise<boolean>} true if post was posted successfully
+     */
+    generateNewPost(): Promise<boolean>;
+    /**
+     * Posts content to X
+     * @param {string} text The post text to create
+     * @param {MediaData[]} mediaData Optional media to attach to the post
+     * @returns {Promise<PostResponse | null>} The result from the X API
+     */
+    private postToX;
+}
+//# sourceMappingURL=post.d.ts.map

package/dist/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../post.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAMnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAWzC;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;;;OAKG;gBACS,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAwCtF;;OAEG;IACG,IAAI;IAKV;;OAEG;IACG,KAAK;IA8DX;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IA2OzC;;;;;OAKG;YACW,OAAO;CA6BtB"}

package/dist/services/x.service.d.ts

@@ -0,0 +1,23 @@
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import { ClientBase } from "../base";
+import { XDiscoveryClient } from "../discovery";
+import { XInteractionClient } from "../interactions";
+import { XPostClient } from "../post";
+import { XTimelineClient } from "../timeline";
+import type { IXClient } from "../types";
+export declare class XClientInstance implements IXClient {
+    client: ClientBase;
+    post?: XPostClient;
+    interaction?: XInteractionClient;
+    timeline?: XTimelineClient;
+    discovery?: XDiscoveryClient;
+    constructor(runtime: IAgentRuntime, state: Record<string, unknown>);
+}
+export declare class XService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    xClient?: XClientInstance;
+    static start(runtime: IAgentRuntime): Promise<XService>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=x.service.d.ts.map

package/dist/services/x.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x.service.d.ts","sourceRoot":"","sources":["../../services/x.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAgC,OAAO,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,CAAC;gBAEjB,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA6BnE;AAED,qBAAa,QAAS,SAAQ,OAAO;IACnC,MAAM,CAAC,WAAW,SAAO;IACzB,qBAAqB,SAAoD;IAElE,OAAO,CAAC,EAAE,eAAe,CAAC;WAEpB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkCvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export generated prompt templates
+ * These are auto-generated from ./generated/prompts/typescript/prompts.ts
+ */
+export { GENERATE_POST_TEMPLATE, generatePostTemplate, MESSAGE_HANDLER_TEMPLATE, messageHandlerTemplate, QUOTE_TWEET_TEMPLATE, quoteTweetTemplate, quoteTweetTemplate as quotePostTemplate, REPLY_TWEET_TEMPLATE, replyTweetTemplate, replyTweetTemplate as replyPostTemplate, X_ACTION_TEMPLATE, X_MESSAGE_HANDLER_TEMPLATE, xActionTemplate, xMessageHandlerTemplate, } from "./generated/prompts/typescript/prompts";
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,IAAI,iBAAiB,EACvC,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,GACxB,MAAM,wCAAwC,CAAC"}

package/dist/timeline.d.ts

@@ -0,0 +1,46 @@
+import { ChannelType, type IAgentRuntime } from "@elizaos/core";
+import type { ClientBase } from "./base";
+import type { Client, Post } from "./client/index";
+declare enum TIMELINE_TYPE {
+    ForYou = "foryou",
+    Following = "following"
+}
+export declare class XTimelineClient {
+    client: ClientBase;
+    xClient: Client;
+    runtime: IAgentRuntime;
+    isDryRun: boolean;
+    timelineType: TIMELINE_TYPE;
+    private state;
+    private isRunning;
+    constructor(client: ClientBase, runtime: IAgentRuntime, state: Record<string, unknown>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getTimeline(count: number): Promise<Post[]>;
+    createPostId(runtime: IAgentRuntime, post: Post): `${string}-${string}-${string}-${string}-${string}`;
+    formMessage(runtime: IAgentRuntime, post: Post): {
+        id: `${string}-${string}-${string}-${string}-${string}`;
+        agentId: `${string}-${string}-${string}-${string}-${string}`;
+        content: {
+            text: string | undefined;
+            url: string | undefined;
+            imageUrls: string[];
+            inReplyTo: `${string}-${string}-${string}-${string}-${string}` | undefined;
+            source: string;
+            channelType: ChannelType;
+            post: Record<string, string | number | boolean | null | undefined>;
+        };
+        entityId: `${string}-${string}-${string}-${string}-${string}`;
+        roomId: `${string}-${string}-${string}-${string}-${string}`;
+        createdAt: number;
+    };
+    handleTimeline(): Promise<void>;
+    private processTimelineActions;
+    private ensurePostWorldContext;
+    handleLikeAction(post: Post): Promise<void>;
+    handleRepostAction(post: Post): Promise<void>;
+    handleQuoteAction(post: Post): Promise<void>;
+    handleReplyAction(post: Post): Promise<void>;
+}
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAGX,KAAK,aAAa,EAOnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQnD,aAAK,aAAa;IAChB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,qBAAa,eAAe;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,aAAa,CAAC;IAC5B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmBhF,KAAK;IAiCL,IAAI;IAKJ,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAWjD,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI;IAO/C,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI;;;;;;;;;;kBAuBnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;;;;;;IAQjE,cAAc;YA+HN,sBAAsB;YA0GtB,sBAAsB;IAsB9B,gBAAgB,CAAC,IAAI,EAAE,IAAI;IAoB3B,kBAAkB,CAAC,IAAI,EAAE,IAAI;IAoB7B,iBAAiB,CAAC,IAAI,EAAE,IAAI;IA8E5B,iBAAiB,CAAC,IAAI,EAAE,IAAI;CA2DnC"}

package/dist/types.d.ts

@@ -0,0 +1,150 @@
+import type { IAgentRuntime, Memory } from "@elizaos/core";
+import type { Post as ClientPost } from "./client";
+export type { Post } from "./client";
+type Post = ClientPost;
+export type XServiceStatus = "idle" | "active" | "error";
+export interface XClientConfig {
+    apiKey: string;
+    apiSecret: string;
+    accessToken: string;
+    accessSecret: string;
+}
+export declare enum XEventTypes {
+    MENTION_RECEIVED = "X_MENTION_RECEIVED",
+    THREAD_CREATED = "X_THREAD_CREATED",
+    THREAD_UPDATED = "X_THREAD_UPDATED",
+    LIKE_RECEIVED = "X_LIKE_RECEIVED",
+    REPOST_RECEIVED = "X_REPOST_RECEIVED",
+    QUOTE_RECEIVED = "X_QUOTE_RECEIVED"
+}
+export interface XInteractionPayload {
+    id: string;
+    type: "like" | "repost" | "quote";
+    userId: string;
+    username: string;
+    name: string;
+    targetPostId?: string;
+    targetPost: Post;
+    quotePost?: Post;
+    repostId?: string;
+}
+export interface XInteractionMemory extends Memory {
+    content: {
+        type: string;
+        source: "x";
+    };
+}
+export interface XMemory extends Memory {
+    content: {
+        text: string;
+        source: "x";
+    };
+}
+export interface XLikeReceivedPayload {
+    runtime: IAgentRuntime;
+    post: Post;
+    user: {
+        id: string;
+        username: string;
+        name: string;
+    };
+    source: "x";
+}
+export interface XRepostReceivedPayload {
+    runtime: IAgentRuntime;
+    post: Post;
+    repostId: string;
+    user: {
+        id: string;
+        username: string;
+        name: string;
+    };
+    source: "x";
+}
+export interface XQuoteReceivedPayload {
+    runtime: IAgentRuntime;
+    quotedPost: Post;
+    quotePost: Post;
+    user: {
+        id: string;
+        username: string;
+        name: string;
+    };
+    message: XMemory;
+    callback: () => Promise<Memory[]>;
+    reaction: {
+        type: "quote";
+        entityId: string;
+    };
+    source: "x";
+}
+export interface ActionResponse {
+    text: string;
+    actions: string[];
+    like?: boolean;
+    repost?: boolean;
+    quote?: boolean;
+    reply?: boolean;
+}
+export interface MediaData {
+    data: Buffer | Uint8Array;
+    type: string;
+    filename?: string;
+}
+import type { ClientBase } from "./base";
+import type { XDiscoveryClient } from "./discovery";
+import type { XInteractionClient } from "./interactions";
+import type { XPostClient } from "./post";
+import type { XTimelineClient } from "./timeline";
+export interface IXClient {
+    client: ClientBase;
+    post?: XPostClient;
+    interaction?: XInteractionClient;
+    timeline?: XTimelineClient;
+    discovery?: XDiscoveryClient;
+}
+export interface PostResponse {
+    id?: string;
+    rest_id?: string;
+    data?: PostResponseData;
+}
+export interface PostResponseData {
+    id?: string;
+    data?: {
+        id?: string;
+    };
+    create_post?: {
+        post_results?: {
+            result?: {
+                rest_id?: string;
+            };
+        };
+    };
+}
+export interface XApiResultShape {
+    id?: string;
+    rest_id?: string;
+    data?: {
+        id?: string;
+        data?: {
+            id?: string;
+        };
+        create_post?: {
+            post_results?: {
+                result?: {
+                    rest_id?: string;
+                };
+            };
+        };
+    };
+}
+export interface ResponseLike {
+    json?: () => Promise<Record<string, unknown>>;
+    clone?: () => ResponseLike;
+    bodyUsed?: boolean;
+}
+export declare function isXApiResult(value: unknown): value is XApiResultShape;
+export declare function isResponseLike(value: unknown): value is ResponseLike;
+export declare function extractIdFromResult(result: unknown): string | undefined;
+export declare function extractRestId(result: unknown): string | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,20 @@
+export declare enum XErrorType {
+    AUTH = "AUTH",
+    RATE_LIMIT = "RATE_LIMIT",
+    API = "API",
+    NETWORK = "NETWORK",
+    MEDIA = "MEDIA",
+    VALIDATION = "VALIDATION",
+    UNKNOWN = "UNKNOWN"
+}
+export declare class XError extends Error {
+    type: XErrorType;
+    originalError?: unknown | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(type: XErrorType, message: string, originalError?: unknown | undefined, details?: Record<string, unknown> | undefined);
+}
+export declare function getErrorType(error: unknown): XErrorType;
+export declare function handleXError(context: string, error: unknown, throwError?: boolean): XError | null;
+export declare function isRetryableError(error: XError | unknown): boolean;
+export declare function getRetryDelay(error: XError | unknown, attempt: number): number;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../utils/error-handler.ts"],"names":[],"mappings":"AAEA,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAED,qBAAa,MAAO,SAAQ,KAAK;IAEtB,IAAI,EAAE,UAAU;IAEhB,aAAa,CAAC,EAAE,OAAO;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjC,IAAI,EAAE,UAAU,EACvB,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,OAAO,YAAA,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAkCvD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,MAAM,GAAG,IAAI,CAgC/F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAOjE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS9E"}

package/dist/utils/memory.d.ts

@@ -0,0 +1,21 @@
+import { type IAgentRuntime, type Memory, type UUID } from "@elizaos/core";
+import type { Post as ClientPost } from "../client";
+export interface XContextOptions {
+    post?: ClientPost;
+    userId: string;
+    username: string;
+    name?: string;
+    conversationId?: string;
+}
+export interface XContextResult {
+    worldId: UUID;
+    roomId: UUID;
+    entityId: UUID;
+}
+export declare function ensureXContext(runtime: IAgentRuntime, options: XContextOptions): Promise<XContextResult>;
+export declare function createMemorySafe(runtime: IAgentRuntime, memory: Memory, tableName?: string, maxRetries?: number): Promise<void>;
+export declare function isPostProcessed(runtime: IAgentRuntime, postId: string): Promise<boolean>;
+export declare function getRecentPosts(runtime: IAgentRuntime, username: string, _count?: number): Promise<string[]>;
+export declare function addToRecentPosts(runtime: IAgentRuntime, username: string, postText: string, maxRecent?: number): Promise<void>;
+export declare function isDuplicatePost(runtime: IAgentRuntime, username: string, postText: string, _similarityThreshold?: number): Promise<boolean>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/utils/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../utils/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAElB,KAAK,MAAM,EACX,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAKvB,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAsDzB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAmB,EAC9B,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU9F;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,oBAAoB,GAAE,MAAY,GACjC,OAAO,CAAC,OAAO,CAAC,CA2BlB"}

package/dist/utils/settings.d.ts

@@ -0,0 +1,3 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export declare function getSetting(runtime: IAgentRuntime | null | undefined, key: string, defaultValue?: string): string | undefined;
+//# sourceMappingURL=settings.d.ts.map

package/dist/utils/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../utils/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACzC,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CASpB"}

package/dist/utils/time.d.ts

@@ -0,0 +1,2 @@
+export declare function getEpochMs(ts: number | undefined): number;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../utils/time.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoBzD"}

package/dist/utils.d.ts

@@ -0,0 +1,36 @@
+import type { Media } from "@elizaos/core";
+import { type Content, type Memory, type UUID } from "@elizaos/core";
+import type { ClientBase } from "./base";
+import type { Post } from "./client";
+import type { ActionResponse, MediaData, PostResponse } from "./types";
+export declare const wait: (minTime?: number, maxTime?: number) => Promise<unknown>;
+export declare const isValidPost: (post: Post) => boolean;
+export declare function fetchMediaData(attachments: Media[]): Promise<MediaData[]>;
+export declare function sendStandardPost(client: ClientBase, content: string, postId?: string, mediaData?: MediaData[]): Promise<{
+    ok: boolean;
+    json: () => Promise<import("twitter-api-v2").TweetV2PostTweetResult>;
+    data: import("twitter-api-v2").TweetV2PostTweetResult;
+}>;
+export declare function sendPost(client: ClientBase, text: string, mediaData?: MediaData[], postToReplyTo?: string): Promise<PostResponse | null>;
+/**
+ * Sends a post on X using the given client.
+ *
+ * @param {ClientBase} client The client used to send the post.
+ * @param {Content} content The content of the post.
+ * @param {UUID} roomId The ID of the room where the post will be sent.
+ * @param {string} xUsername The X username of the sender.
+ * @param {string} inReplyTo The ID of the post to which the new post will reply.
+ * @returns {Promise<Memory[]>} An array of memories representing the sent posts.
+ */
+export declare function sendChunkedPost(client: ClientBase, content: Content, roomId: UUID, xUsername: string, inReplyTo: string): Promise<Memory[]>;
+/**
+ * Parses the action response from the given text.
+ *
+ * @param {string} text - The text to parse actions from.
+ * @returns {{ actions: ActionResponse }} The parsed actions with boolean values indicating if each action is present in the text.
+ */
+export declare const parseActionResponseFromText: (text: string) => {
+    actions: ActionResponse;
+};
+export * from "./utils/error-handler";
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,MAAM,EAEX,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvE,eAAO,MAAM,IAAI,GAAI,gBAAc,EAAE,gBAAc,qBAGlD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,MAAM,IAAI,KAAG,OAOxC,CAAC;AAEF,wBAAsB,cAAc,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAoB/E;AAsBD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,EAAE;;;;GAOxB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAAS,EAAO,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyD9B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,IAAI,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CA2DnB;AAmJD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,KAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CA8BnF,CAAC;AAEF,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,193 @@
+{
+  "name": "@elizaos/plugin-xai",
+  "version": "2.0.0-alpha.1",
+  "description": "",
+  "type": "module",
+  "main": "dist/node/index.node.js",
+  "module": "dist/node/index.node.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elizaos-plugins/plugin-xai.git"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": {
+        "types": "./dist/browser/index.d.ts",
+        "import": "./dist/browser/index.browser.js",
+        "default": "./dist/browser/index.browser.js"
+      },
+      "node": {
+        "types": "./dist/node/index.d.ts",
+        "import": "./dist/node/index.node.js",
+        "require": "./dist/cjs/index.node.cjs",
+        "default": "./dist/node/index.node.js"
+      },
+      "bun": {
+        "types": "./dist/node/index.d.ts",
+        "default": "./dist/node/index.node.js"
+      },
+      "require": "./dist/cjs/index.node.cjs",
+      "default": "./dist/node/index.node.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [],
+  "author": "elizaOS",
+  "license": "MIT",
+  "scripts": {
+    "build": "bun run build.ts",
+    "build:ts": "bun run build.ts",
+    "dev": "bun --hot build.ts",
+    "clean": "rm -rf dist .turbo node_modules",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "lint:check": "bunx @biomejs/biome check .",
+    "format": "bunx @biomejs/biome format --write .",
+    "format:check": "bunx @biomejs/biome format ."
+  },
+  "dependencies": {
+    "@elizaos/core": "workspace:*",
+    "twitter-api-v2": "^1.28.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "@biomejs/biome": "^2.3.11"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "workspace:*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "XAI_API_KEY": {
+        "type": "string",
+        "description": "xAI API key for Grok model access and X (formerly Twitter) integration.",
+        "required": true,
+        "sensitive": true
+      },
+      "XAI_MODEL": {
+        "type": "string",
+        "description": "xAI Grok model for text generation (grok-3, grok-3-mini).",
+        "required": false,
+        "default": "grok-3",
+        "sensitive": false
+      },
+      "XAI_SMALL_MODEL": {
+        "type": "string",
+        "description": "xAI Grok model for faster/smaller tasks.",
+        "required": false,
+        "default": "grok-3-mini",
+        "sensitive": false
+      },
+      "XAI_EMBEDDING_MODEL": {
+        "type": "string",
+        "description": "xAI model for text embeddings.",
+        "required": false,
+        "default": "grok-embedding",
+        "sensitive": false
+      },
+      "XAI_BASE_URL": {
+        "type": "string",
+        "description": "xAI API base URL.",
+        "required": false,
+        "default": "https://api.x.ai/v1",
+        "sensitive": false
+      },
+      "X_AUTH_MODE": {
+        "type": "string",
+        "description": "X (formerly Twitter) auth mode: 'env' (API keys), 'oauth' (OAuth2 PKCE), or 'bearer'.",
+        "required": false,
+        "default": "env",
+        "sensitive": false
+      },
+      "X_API_KEY": {
+        "type": "string",
+        "description": "X (formerly Twitter) API key for OAuth 1.0a.",
+        "required": false,
+        "sensitive": true
+      },
+      "X_API_SECRET": {
+        "type": "string",
+        "description": "X (formerly Twitter) API secret key for OAuth 1.0a.",
+        "required": false,
+        "sensitive": true
+      },
+      "X_ACCESS_TOKEN": {
+        "type": "string",
+        "description": "X (formerly Twitter) access token for OAuth 1.0a.",
+        "required": false,
+        "sensitive": true
+      },
+      "X_ACCESS_TOKEN_SECRET": {
+        "type": "string",
+        "description": "X (formerly Twitter) access token secret for OAuth 1.0a.",
+        "required": false,
+        "sensitive": true
+      },
+      "X_BEARER_TOKEN": {
+        "type": "string",
+        "description": "X (formerly Twitter) Bearer token for app-only authentication.",
+        "required": false,
+        "sensitive": true
+      },
+      "X_CLIENT_ID": {
+        "type": "string",
+        "description": "X (formerly Twitter) OAuth2 client ID.",
+        "required": false,
+        "sensitive": false
+      },
+      "X_REDIRECT_URI": {
+        "type": "string",
+        "description": "OAuth2 redirect URI.",
+        "required": false,
+        "sensitive": false
+      },
+      "X_DRY_RUN": {
+        "type": "boolean",
+        "description": "When true, all X actions are simulated.",
+        "required": false,
+        "default": false,
+        "sensitive": false
+      },
+      "X_ENABLE_POST": {
+        "type": "boolean",
+        "description": "Enable autonomous posting.",
+        "required": false,
+        "default": false,
+        "sensitive": false
+      },
+      "X_ENABLE_REPLIES": {
+        "type": "boolean",
+        "description": "Enable reply handling.",
+        "required": false,
+        "default": true,
+        "sensitive": false
+      },
+      "X_ENABLE_ACTIONS": {
+        "type": "boolean",
+        "description": "Enable timeline actions (like, repost).",
+        "required": false,
+        "default": false,
+        "sensitive": false
+      },
+      "X_MAX_POST_LENGTH": {
+        "type": "number",
+        "description": "Maximum post length (up to 4000 for premium).",
+        "required": false,
+        "default": 280,
+        "sensitive": false
+      }
+    }
+  }
+}