@elizaos/plugin-x 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/chunk-VU26ZOMZ.js

@@ -0,0 +1,176 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/lifeops-message-adapter.ts
+import {
+  BaseMessageAdapter,
+  NotYetImplementedError
+} from "@elizaos/core/node";
+function record(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function stringField(value, fallback = "") {
+  return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function firstStringField(...values) {
+  for (const value of values) {
+    const normalized = stringField(value);
+    if (normalized) return normalized;
+  }
+  return "";
+}
+function getXRuntimeService(runtime) {
+  const service = runtime.getService("x") ?? runtime.getService("twitter");
+  return service && typeof service === "object" ? service : null;
+}
+function encodeDraftBody(body) {
+  return Buffer.from(body, "utf8").toString("base64url");
+}
+function decodeDraftBody(encoded) {
+  return Buffer.from(encoded, "base64url").toString("utf8");
+}
+function memoryToMessageRef(memory) {
+  const metadata = record(memory.metadata);
+  const content = record(memory.content);
+  const x = record(metadata.x);
+  const sender = record(metadata.sender);
+  const receivedAtMs = Number(memory.createdAt);
+  const senderId = firstStringField(x.senderId, sender.id, memory.entityId) || "unknown";
+  const senderHandle = firstStringField(x.senderUsername, sender.username);
+  const body = stringField(content.text);
+  const externalId = firstStringField(
+    x.dmEventId,
+    metadata.messageIdFull,
+    memory.id
+  );
+  const threadId = firstStringField(x.conversationId, memory.roomId, senderId);
+  return {
+    id: `twitter:${externalId}`,
+    source: "twitter",
+    externalId,
+    threadId,
+    from: {
+      identifier: senderId,
+      displayName: senderHandle
+    },
+    to: [],
+    snippet: body.slice(0, 200),
+    body,
+    receivedAtMs: Number.isFinite(receivedAtMs) ? receivedAtMs : Date.now(),
+    hasAttachments: false,
+    isRead: false,
+    channelId: threadId,
+    metadata
+  };
+}
+function normalizeListLimit(limit) {
+  if (limit === void 0) return 25;
+  if (!Number.isFinite(limit)) return 25;
+  return Math.min(100, Math.max(1, Math.floor(limit)));
+}
+function parseDraftId(draftId) {
+  const parts = draftId.split(":");
+  if (parts.length !== 4 || parts[0] !== "twitter") {
+    throw new Error(`[XDmAdapter] malformed draftId ${draftId}`);
+  }
+  const participantId = parts[1] ? decodeURIComponent(parts[1]) : "";
+  const text = parts[3] ? decodeDraftBody(parts[3]) : "";
+  if (!participantId) {
+    throw new Error(
+      `[XDmAdapter] cannot resolve recipient from draftId ${draftId}`
+    );
+  }
+  if (!text) {
+    throw new Error(`[XDmAdapter] cannot resolve body from draftId ${draftId}`);
+  }
+  return { participantId, text };
+}
+var XDmAdapter = class extends BaseMessageAdapter {
+  constructor() {
+    super(...arguments);
+    this.source = "twitter";
+  }
+  isAvailable(runtime) {
+    return Boolean(getXRuntimeService(runtime));
+  }
+  capabilities() {
+    return {
+      list: true,
+      search: false,
+      manage: {},
+      send: { reply: true, new: true, schedule: false },
+      worlds: "single",
+      channels: "implicit"
+    };
+  }
+  async listMessagesImpl(runtime, opts) {
+    const service = getXRuntimeService(runtime);
+    if (typeof service?.fetchDirectMessagesForAccount !== "function") {
+      return [];
+    }
+    const limit = normalizeListLimit(opts.limit);
+    const sinceMs = opts.sinceMs;
+    const memories = await service.fetchDirectMessagesForAccount("default", {
+      participantId: void 0,
+      limit
+    });
+    const refs = memories.map(memoryToMessageRef);
+    return refs.filter((ref) => {
+      if (sinceMs !== void 0 && Number.isFinite(ref.receivedAtMs) && ref.receivedAtMs < sinceMs) {
+        return false;
+      }
+      return true;
+    });
+  }
+  async getMessageImpl(runtime, id) {
+    const all = await this.listMessages(runtime, { limit: 100 });
+    return all.find((ref) => ref.id === id) ?? null;
+  }
+  async createDraftImpl(_runtime, draft) {
+    const recipient = draft.to[0]?.identifier;
+    if (!recipient) {
+      throw new Error(
+        "[XDmAdapter] createDraft requires a recipient identifier"
+      );
+    }
+    if (!draft.body.trim()) {
+      throw new Error("[XDmAdapter] createDraft requires non-empty body");
+    }
+    const draftId = `twitter:${encodeURIComponent(recipient)}:${Date.now()}:${encodeDraftBody(draft.body)}`;
+    const preview = draft.body.length > 200 ? `${draft.body.slice(0, 197)}...` : draft.body;
+    return { draftId, preview };
+  }
+  async sendDraftImpl(runtime, draftId) {
+    const service = getXRuntimeService(runtime);
+    if (typeof service?.sendDirectMessageForAccount !== "function") {
+      throw new Error("[XDmAdapter] X runtime service is unavailable");
+    }
+    const { participantId, text } = parseDraftId(draftId);
+    const sent = await service.sendDirectMessageForAccount("default", {
+      participantId,
+      text
+    });
+    if (sent.ok === false) {
+      throw new Error(
+        `[XDmAdapter] failed to send direct message${sent.status ? ` (status ${sent.status})` : ""}`
+      );
+    }
+    return {
+      externalId: sent.messageId ?? `${participantId}:${Date.now()}`
+    };
+  }
+  scheduleSendImpl(_runtime, _draftId, _sendAtMs) {
+    throw new NotYetImplementedError(
+      "x_dm adapter: native scheduleSend (use core's local timer fallback)"
+    );
+  }
+};
+
+export {
+  __export,
+  XDmAdapter
+};
+//# sourceMappingURL=chunk-VU26ZOMZ.js.map

package/dist/chunk-VU26ZOMZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lifeops-message-adapter.ts"],"sourcesContent":["import {\n  BaseMessageAdapter,\n  type DraftRequest,\n  type IAgentRuntime,\n  type ListOptions,\n  type Memory,\n  type MessageAdapterCapabilities,\n  type MessageRef,\n  type MessageSource,\n  NotYetImplementedError,\n} from \"@elizaos/core/node\";\n\ntype XRuntimeServiceLike = {\n  sendDirectMessageForAccount?: (\n    accountId: string,\n    params: { participantId: string; text: string },\n  ) => Promise<{ ok?: boolean; status?: number; messageId?: string | null }>;\n  fetchDirectMessagesForAccount?: (\n    accountId: string,\n    params?: { participantId?: string; limit?: number },\n  ) => Promise<Memory[]>;\n};\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value && typeof value === \"object\"\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction stringField(value: unknown, fallback = \"\"): string {\n  return typeof value === \"string\" && value.length > 0 ? value : fallback;\n}\n\nfunction firstStringField(...values: unknown[]): string {\n  for (const value of values) {\n    const normalized = stringField(value);\n    if (normalized) return normalized;\n  }\n  return \"\";\n}\n\nfunction getXRuntimeService(\n  runtime: IAgentRuntime,\n): XRuntimeServiceLike | null {\n  const service = runtime.getService(\"x\") ?? runtime.getService(\"twitter\");\n  return service && typeof service === \"object\"\n    ? (service as XRuntimeServiceLike)\n    : null;\n}\n\nfunction encodeDraftBody(body: string): string {\n  return Buffer.from(body, \"utf8\").toString(\"base64url\");\n}\n\nfunction decodeDraftBody(encoded: string): string {\n  return Buffer.from(encoded, \"base64url\").toString(\"utf8\");\n}\n\nfunction memoryToMessageRef(memory: Memory): MessageRef {\n  const metadata = record(memory.metadata);\n  const content = record(memory.content);\n  const x = record(metadata.x);\n  const sender = record(metadata.sender);\n  const receivedAtMs = Number(memory.createdAt);\n  const senderId =\n    firstStringField(x.senderId, sender.id, memory.entityId) || \"unknown\";\n  const senderHandle = firstStringField(x.senderUsername, sender.username);\n  const body = stringField(content.text);\n  const externalId = firstStringField(\n    x.dmEventId,\n    metadata.messageIdFull,\n    memory.id,\n  );\n  const threadId = firstStringField(x.conversationId, memory.roomId, senderId);\n  return {\n    id: `twitter:${externalId}`,\n    source: \"twitter\",\n    externalId,\n    threadId,\n    from: {\n      identifier: senderId,\n      displayName: senderHandle,\n    },\n    to: [],\n    snippet: body.slice(0, 200),\n    body,\n    receivedAtMs: Number.isFinite(receivedAtMs) ? receivedAtMs : Date.now(),\n    hasAttachments: false,\n    isRead: false,\n    channelId: threadId,\n    metadata,\n  };\n}\n\nfunction normalizeListLimit(limit: number | undefined): number {\n  if (limit === undefined) return 25;\n  if (!Number.isFinite(limit)) return 25;\n  return Math.min(100, Math.max(1, Math.floor(limit)));\n}\n\nfunction parseDraftId(draftId: string): {\n  participantId: string;\n  text: string;\n} {\n  const parts = draftId.split(\":\");\n  if (parts.length !== 4 || parts[0] !== \"twitter\") {\n    throw new Error(`[XDmAdapter] malformed draftId ${draftId}`);\n  }\n  const participantId = parts[1] ? decodeURIComponent(parts[1]) : \"\";\n  const text = parts[3] ? decodeDraftBody(parts[3]) : \"\";\n  if (!participantId) {\n    throw new Error(\n      `[XDmAdapter] cannot resolve recipient from draftId ${draftId}`,\n    );\n  }\n  if (!text) {\n    throw new Error(`[XDmAdapter] cannot resolve body from draftId ${draftId}`);\n  }\n  return { participantId, text };\n}\n\nexport class XDmAdapter extends BaseMessageAdapter {\n  readonly source: MessageSource = \"twitter\";\n\n  isAvailable(runtime: IAgentRuntime): boolean {\n    return Boolean(getXRuntimeService(runtime));\n  }\n\n  capabilities(): MessageAdapterCapabilities {\n    return {\n      list: true,\n      search: false,\n      manage: {},\n      send: { reply: true, new: true, schedule: false },\n      worlds: \"single\",\n      channels: \"implicit\",\n    };\n  }\n\n  protected async listMessagesImpl(\n    runtime: IAgentRuntime,\n    opts: ListOptions,\n  ): Promise<MessageRef[]> {\n    const service = getXRuntimeService(runtime);\n    if (typeof service?.fetchDirectMessagesForAccount !== \"function\") {\n      return [];\n    }\n\n    const limit = normalizeListLimit(opts.limit);\n    const sinceMs = opts.sinceMs;\n    const memories = await service.fetchDirectMessagesForAccount(\"default\", {\n      participantId: undefined,\n      limit,\n    });\n    const refs = memories.map(memoryToMessageRef);\n    return refs.filter((ref) => {\n      if (\n        sinceMs !== undefined &&\n        Number.isFinite(ref.receivedAtMs) &&\n        ref.receivedAtMs < sinceMs\n      ) {\n        return false;\n      }\n      return true;\n    });\n  }\n\n  protected async getMessageImpl(\n    runtime: IAgentRuntime,\n    id: string,\n  ): Promise<MessageRef | null> {\n    const all = await this.listMessages(runtime, { limit: 100 });\n    return all.find((ref) => ref.id === id) ?? null;\n  }\n\n  protected async createDraftImpl(\n    _runtime: IAgentRuntime,\n    draft: DraftRequest,\n  ): Promise<{ draftId: string; preview: string }> {\n    const recipient = draft.to[0]?.identifier;\n    if (!recipient) {\n      throw new Error(\n        \"[XDmAdapter] createDraft requires a recipient identifier\",\n      );\n    }\n    if (!draft.body.trim()) {\n      throw new Error(\"[XDmAdapter] createDraft requires non-empty body\");\n    }\n    const draftId = `twitter:${encodeURIComponent(recipient)}:${Date.now()}:${encodeDraftBody(draft.body)}`;\n    const preview =\n      draft.body.length > 200 ? `${draft.body.slice(0, 197)}...` : draft.body;\n    return { draftId, preview };\n  }\n\n  protected async sendDraftImpl(\n    runtime: IAgentRuntime,\n    draftId: string,\n  ): Promise<{ externalId: string }> {\n    const service = getXRuntimeService(runtime);\n    if (typeof service?.sendDirectMessageForAccount !== \"function\") {\n      throw new Error(\"[XDmAdapter] X runtime service is unavailable\");\n    }\n\n    const { participantId, text } = parseDraftId(draftId);\n    const sent = await service.sendDirectMessageForAccount(\"default\", {\n      participantId,\n      text,\n    });\n    if (sent.ok === false) {\n      throw new Error(\n        `[XDmAdapter] failed to send direct message${\n          sent.status ? ` (status ${sent.status})` : \"\"\n        }`,\n      );\n    }\n    return {\n      externalId: sent.messageId ?? `${participantId}:${Date.now()}`,\n    };\n  }\n\n  protected scheduleSendImpl(\n    _runtime: IAgentRuntime,\n    _draftId: string,\n    _sendAtMs: number,\n  ): Promise<{ scheduledId: string }> {\n    throw new NotYetImplementedError(\n      \"x_dm adapter: native scheduleSend (use core's local timer fallback)\",\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { Provider, Plugin } from '@elizaos/core';
+export { XDmAdapter } from './lifeops-message-adapter.js';
+import '@elizaos/core/node';
+
+/**
+ * X (Twitter) identity provider.
+ *
+ * Makes the agent aware of its own X account: `@username`, screen name
+ * (the human-readable display name), bio/description, and any configured
+ * nicknames. Without this provider the agent only had a vague sense of its
+ * handle (via the `{{twitterUserName}}` template variable) and no awareness of
+ * its bio, display name, or nicknames at all.
+ *
+ * Reads the already-loaded profile from `XService.getActiveProfile()`; it never
+ * triggers a network call and returns empty context when the X client has not
+ * finished authenticating.
+ */
+
+declare const xIdentityProvider: Provider;
+
+declare const XPlugin: Plugin;
+
+export { XPlugin, XPlugin as default, xIdentityProvider };