@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/apps/app-lifeops/src/lifeops/x-poster.d.ts

@@ -16,4 +16,26 @@ export declare function postToX(args: {
     text: string;
     credentials: XPosterCredentials;
 }): Promise<XPostResult>;
+export interface XDmResult {
+    ok: boolean;
+    status: number | null;
+    dmConversationId?: string;
+    dmEventId?: string;
+    error?: string;
+    category: "success" | "auth" | "rate_limit" | "network" | "unknown";
+}
+/**
+ * Send a Direct Message on X (Twitter) via the v2 DM API.
+ *
+ * `participantId` must be the numeric Twitter user ID of the recipient
+ * (not a @handle — the API requires the ID).
+ *
+ * Requires OAuth 1.0a access token and secret with the `dm.write` scope
+ * granted for the app.
+ */
+export declare function sendXDm(args: {
+    participantId: string;
+    text: string;
+    credentials: XPosterCredentials;
+}): Promise<XDmResult>;
 //# sourceMappingURL=x-poster.d.ts.map

package/apps/app-lifeops/src/lifeops/x-poster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x-poster.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/x-poster.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;CACrE;AA0ED,wBAAgB,6BAA6B,CAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,kBAAkB,GAAG,IAAI,CAgB3B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,CAAC,CA+FvB"}
+{"version":3,"file":"x-poster.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/x-poster.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;CACrE;AA+ED,wBAAgB,6BAA6B,CAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,kBAAkB,GAAG,IAAI,CAgB3B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;CACjC,GAAG,OAAO,CAAC,WAAW,CAAC,CA+FvB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;CACrE;AAID;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;CACjC,GAAG,OAAO,CAAC,SAAS,CAAC,CAgErB"}

package/apps/app-lifeops/src/lifeops/x-poster.js

@@ -1,14 +1,15 @@
 import crypto from "node:crypto";
 import { logger } from "@elizaos/core";
 import { createIntegrationTelemetrySpan } from "@elizaos/agent/diagnostics/integration-observability";
-const X_POST_URL = "https://api.twitter.com/2/tweets";
+const X_BASE_URL = process.env.MILADY_MOCK_X_BASE ?? "https://api.twitter.com";
+const X_POST_URL = `${X_BASE_URL}/2/tweets`;
 function percentEncode(value) {
     return encodeURIComponent(value).replace(/[!'()*]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
 }
 function buildSignatureBaseString(method, url, params) {
     const sorted = Object.keys(params)
         .sort()
-        .map((key) => `${percentEncode(key)}=${percentEncode(params[key])}`)
+        .map((key) => `${percentEncode(key)}=${percentEncode(params[key] ?? "")}`)
         .join("&");
     return `${method.toUpperCase()}&${percentEncode(url)}&${percentEncode(sorted)}`;
 }
@@ -36,7 +37,7 @@ function buildOAuth1AuthorizationHeader(args) {
     oauthParams.oauth_signature = signOAuth1(baseString, signingKey);
     const header = Object.keys(oauthParams)
         .sort()
-        .map((key) => `${percentEncode(key)}="${percentEncode(oauthParams[key])}"`)
+        .map((key) => `${percentEncode(key)}="${percentEncode(oauthParams[key] ?? "")}"`)
         .join(", ");
     return `OAuth ${header}`;
 }
@@ -146,3 +147,66 @@ export async function postToX(args) {
         };
     }
 }
+const X_DM_URL_TEMPLATE = `${X_BASE_URL}/2/dm_conversations/with/{participantId}/messages`;
+/**
+ * Send a Direct Message on X (Twitter) via the v2 DM API.
+ *
+ * `participantId` must be the numeric Twitter user ID of the recipient
+ * (not a @handle — the API requires the ID).
+ *
+ * Requires OAuth 1.0a access token and secret with the `dm.write` scope
+ * granted for the app.
+ */
+export async function sendXDm(args) {
+    const { participantId, text, credentials } = args;
+    const url = X_DM_URL_TEMPLATE.replace("{participantId}", encodeURIComponent(participantId));
+    const nonce = crypto.randomBytes(16).toString("hex");
+    const timestamp = String(Math.floor(Date.now() / 1000));
+    const authorization = buildOAuth1AuthorizationHeader({
+        method: "POST",
+        url,
+        credentials,
+        nonce,
+        timestamp,
+    });
+    const span = createIntegrationTelemetrySpan({
+        boundary: "lifeops",
+        operation: "x_dm_send",
+        timeoutMs: 12_000,
+    });
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: authorization,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ text }),
+            signal: AbortSignal.timeout(12_000),
+        });
+        const payload = (await response.json().catch(() => ({})));
+        const category = classifyStatus(response.status);
+        if (!response.ok) {
+            const errorMessage = payload.errors?.[0]?.detail ??
+                payload.errors?.[0]?.message ??
+                payload.detail ??
+                payload.title ??
+                `HTTP ${response.status}`;
+            span.failure({ statusCode: response.status, errorKind: category });
+            return { ok: false, status: response.status, error: errorMessage, category };
+        }
+        span.success({ statusCode: response.status });
+        return {
+            ok: true,
+            status: response.status,
+            dmConversationId: payload.data?.dm_conversation_id,
+            dmEventId: payload.data?.dm_event_id,
+            category: "success",
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        span.failure({ error, errorKind: "network" });
+        return { ok: false, status: null, error: errorMessage, category: "network" };
+    }
+}

package/apps/app-lifeops/src/lifeops/x-reader.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Read-side credentials for the X/Twitter API v2. Mirrors the shape used by
+ * {@link ./x-poster.ts} but accepts the canonical `apiSecret` naming; both
+ * `apiSecret` and `apiSecretKey` (the poster's name) are accepted via the
+ * helper below so a caller can pass either without adaptation.
+ */
+export interface XReaderCredentials {
+    apiKey: string;
+    apiSecret: string;
+    accessToken: string;
+    accessTokenSecret: string;
+    userId?: string;
+}
+export interface XReadPageOptions {
+    limit?: number;
+    cursor?: string;
+}
+export interface XFeedPageOptions extends XReadPageOptions {
+    query?: string;
+}
+export type XFeedType = "home_timeline" | "mentions" | "search";
+export interface XRawDm {
+    id: string;
+    conversationId: string;
+    senderId: string;
+    senderHandle: string;
+    text: string;
+    createdAt: string;
+    isInbound: boolean;
+    metadata: Record<string, unknown>;
+}
+export interface XRawFeedItem {
+    id: string;
+    authorId: string;
+    authorHandle: string;
+    text: string;
+    createdAt: string;
+    metadata: Record<string, unknown>;
+}
+export interface XReadPage<T> {
+    items: T[];
+    nextCursor: string | null;
+}
+export declare class XReadError extends Error {
+    readonly status: number | null;
+    readonly category: "auth" | "not_found" | "rate_limit" | "network" | "unknown";
+    readonly retryAfterSeconds: number | null;
+    constructor(message: string, options: {
+        status: number | null;
+        category: XReadError["category"];
+        retryAfterSeconds?: number | null;
+    });
+}
+/**
+ * Read DM events for the authenticated user via Twitter API v2.
+ * Returns raw DM objects and a forward pagination cursor.
+ */
+export declare function readXDms(credentials: XReaderCredentials, options?: XReadPageOptions): Promise<XReadPage<XRawDm>>;
+/**
+ * Read the authenticated user's feed (home timeline, mentions, or recent search).
+ */
+export declare function pullXFeed(credentials: XReaderCredentials, feedType: XFeedType, options?: XFeedPageOptions): Promise<XReadPage<XRawFeedItem>>;
+/**
+ * Alias for {@link pullXFeed} with `feedType: "search"`.
+ */
+export declare function searchX(credentials: XReaderCredentials, query: string, options?: {
+    limit?: number;
+    cursor?: string;
+}): Promise<XReadPage<XRawFeedItem>>;
+//# sourceMappingURL=x-reader.d.ts.map

package/apps/app-lifeops/src/lifeops/x-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x-reader.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/x-reader.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhE,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC;CAQJ;AAyOD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,kBAAkB,EAC/B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CA6B5B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,EAAE,SAAS,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAsDlC;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAElC"}

package/apps/app-lifeops/src/lifeops/x-reader.js

@@ -0,0 +1,260 @@
+import crypto from "node:crypto";
+import { logger } from "@elizaos/core";
+const X_BASE_URL = process.env.MILADY_MOCK_X_BASE ?? "https://api.twitter.com";
+export class XReadError extends Error {
+    status;
+    category;
+    retryAfterSeconds;
+    constructor(message, options) {
+        super(message);
+        this.name = "XReadError";
+        this.status = options.status;
+        this.category = options.category;
+        this.retryAfterSeconds = options.retryAfterSeconds ?? null;
+    }
+}
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 100;
+const REQUEST_TIMEOUT_MS = 12_000;
+function percentEncode(value) {
+    return encodeURIComponent(value).replace(/[!'()*]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+function buildSignatureBaseString(method, url, params) {
+    const sorted = Object.keys(params)
+        .sort()
+        .map((key) => `${percentEncode(key)}=${percentEncode(params[key] ?? "")}`)
+        .join("&");
+    return `${method.toUpperCase()}&${percentEncode(url)}&${percentEncode(sorted)}`;
+}
+function buildSigningKey(apiSecret, tokenSecret) {
+    return `${percentEncode(apiSecret)}&${percentEncode(tokenSecret)}`;
+}
+function signOAuth1(baseString, signingKey) {
+    return crypto
+        .createHmac("sha1", signingKey)
+        .update(baseString)
+        .digest("base64");
+}
+/**
+ * Build an OAuth 1.0a `Authorization` header for a GET request, merging any
+ * query parameters into the signature base string (required by Twitter).
+ */
+function buildOAuth1GetHeader(args) {
+    const oauthParams = {
+        oauth_consumer_key: args.credentials.apiKey,
+        oauth_nonce: crypto.randomBytes(16).toString("hex"),
+        oauth_signature_method: "HMAC-SHA1",
+        oauth_timestamp: String(Math.floor(Date.now() / 1000)),
+        oauth_token: args.credentials.accessToken,
+        oauth_version: "1.0",
+    };
+    const combined = { ...args.queryParams, ...oauthParams };
+    const baseString = buildSignatureBaseString("GET", args.url, combined);
+    const signingKey = buildSigningKey(args.credentials.apiSecret, args.credentials.accessTokenSecret);
+    oauthParams.oauth_signature = signOAuth1(baseString, signingKey);
+    return ("OAuth " +
+        Object.keys(oauthParams)
+            .sort()
+            .map((key) => `${percentEncode(key)}="${percentEncode(oauthParams[key] ?? "")}"`)
+            .join(", "));
+}
+function categorizeStatus(status) {
+    if (status === 401 || status === 403)
+        return "auth";
+    if (status === 404)
+        return "not_found";
+    if (status === 429)
+        return "rate_limit";
+    return "unknown";
+}
+function parseRetryAfter(headers) {
+    const value = headers.get("retry-after");
+    if (!value)
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : null;
+}
+function clampLimit(value) {
+    if (!value || !Number.isFinite(value) || value <= 0)
+        return DEFAULT_LIMIT;
+    return Math.min(MAX_LIMIT, Math.floor(value));
+}
+async function xFetch(args) {
+    const query = new URLSearchParams(args.queryParams).toString();
+    const fullUrl = query.length > 0 ? `${args.url}?${query}` : args.url;
+    const authorization = buildOAuth1GetHeader({
+        url: args.url,
+        queryParams: args.queryParams,
+        credentials: args.credentials,
+    });
+    let response;
+    try {
+        response = await fetch(fullUrl, {
+            method: "GET",
+            headers: {
+                Authorization: authorization,
+                Accept: "application/json",
+            },
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn({
+            boundary: "lifeops",
+            integration: "x",
+            operation: args.operation,
+        }, `[lifeops] X read network failure: ${message}`);
+        throw new XReadError(message, { status: null, category: "network" });
+    }
+    const payload = (await response.json().catch(() => ({})));
+    if (!response.ok) {
+        const category = categorizeStatus(response.status);
+        const errorMessage = payload.errors?.[0]?.detail ??
+            payload.errors?.[0]?.message ??
+            payload.errors?.[0]?.title ??
+            payload.detail ??
+            payload.title ??
+            `HTTP ${response.status}`;
+        const retryAfterSeconds = category === "rate_limit" ? parseRetryAfter(response.headers) : null;
+        throw new XReadError(errorMessage, {
+            status: response.status,
+            category,
+            retryAfterSeconds,
+        });
+    }
+    return payload;
+}
+function buildHandleIndex(users) {
+    const index = new Map();
+    for (const user of users ?? []) {
+        if (user.id && user.username) {
+            index.set(user.id, user.username);
+        }
+    }
+    return index;
+}
+function parseDmEvent(event, selfUserId, handleIndex) {
+    if (event.event_type && event.event_type !== "MessageCreate")
+        return null;
+    const senderId = event.sender_id ?? "";
+    const handle = handleIndex.get(senderId) ?? "";
+    return {
+        id: event.id,
+        conversationId: event.dm_conversation_id ?? "",
+        senderId,
+        senderHandle: handle,
+        text: event.text ?? "",
+        createdAt: event.created_at ?? new Date().toISOString(),
+        isInbound: selfUserId ? senderId !== selfUserId : true,
+        metadata: { raw: event },
+    };
+}
+function parseTweet(tweet, handleIndex) {
+    const authorId = tweet.author_id ?? "";
+    return {
+        id: tweet.id,
+        authorId,
+        authorHandle: handleIndex.get(authorId) ?? "",
+        text: tweet.text ?? "",
+        createdAt: tweet.created_at ?? new Date().toISOString(),
+        metadata: { raw: tweet },
+    };
+}
+/**
+ * Read DM events for the authenticated user via Twitter API v2.
+ * Returns raw DM objects and a forward pagination cursor.
+ */
+export async function readXDms(credentials, options = {}) {
+    const limit = clampLimit(options.limit);
+    const url = `${X_BASE_URL}/2/dm_events`;
+    const queryParams = {
+        max_results: String(limit),
+        "dm_event.fields": "id,event_type,text,sender_id,dm_conversation_id,created_at",
+        expansions: "sender_id",
+        "user.fields": "username",
+    };
+    if (options.cursor)
+        queryParams.pagination_token = options.cursor;
+    const payload = await xFetch({
+        url,
+        queryParams,
+        credentials,
+        operation: "x_read_dms",
+    });
+    const handleIndex = buildHandleIndex(payload.includes?.users);
+    const events = Array.isArray(payload.data) ? payload.data : [];
+    const items = [];
+    for (const event of events) {
+        const parsed = parseDmEvent(event, credentials.userId, handleIndex);
+        if (parsed)
+            items.push(parsed);
+    }
+    return {
+        items,
+        nextCursor: payload.meta?.next_token ?? payload.meta?.pagination_token ?? null,
+    };
+}
+/**
+ * Read the authenticated user's feed (home timeline, mentions, or recent search).
+ */
+export async function pullXFeed(credentials, feedType, options = {}) {
+    const limit = clampLimit(options.limit);
+    const baseQuery = {
+        max_results: String(limit),
+        "tweet.fields": "id,text,author_id,created_at,conversation_id,referenced_tweets",
+        expansions: "author_id",
+        "user.fields": "username",
+    };
+    if (options.cursor)
+        baseQuery.pagination_token = options.cursor;
+    let url;
+    if (feedType === "home_timeline") {
+        if (!credentials.userId) {
+            throw new XReadError("home_timeline requires credentials.userId", {
+                status: null,
+                category: "unknown",
+            });
+        }
+        url = `${X_BASE_URL}/2/users/${encodeURIComponent(credentials.userId)}/timelines/reverse_chronological`;
+    }
+    else if (feedType === "mentions") {
+        if (!credentials.userId) {
+            throw new XReadError("mentions requires credentials.userId", {
+                status: null,
+                category: "unknown",
+            });
+        }
+        url = `${X_BASE_URL}/2/users/${encodeURIComponent(credentials.userId)}/mentions`;
+    }
+    else {
+        const query = (options.query ?? "").trim();
+        if (query.length === 0) {
+            throw new XReadError("search requires a non-empty query", {
+                status: null,
+                category: "unknown",
+            });
+        }
+        url = `${X_BASE_URL}/2/tweets/search/recent`;
+        baseQuery.query = query;
+    }
+    const payload = await xFetch({
+        url,
+        queryParams: baseQuery,
+        credentials,
+        operation: `x_read_feed_${feedType}`,
+    });
+    const handleIndex = buildHandleIndex(payload.includes?.users);
+    const tweets = Array.isArray(payload.data) ? payload.data : [];
+    const items = tweets.map((tweet) => parseTweet(tweet, handleIndex));
+    return {
+        items,
+        nextCursor: payload.meta?.next_token ?? null,
+    };
+}
+/**
+ * Alias for {@link pullXFeed} with `feedType: "search"`.
+ */
+export function searchX(credentials, query, options = {}) {
+    return pullXFeed(credentials, "search", { ...options, query });
+}

package/apps/app-lifeops/src/plugin.d.ts

@@ -10,13 +10,24 @@ export { gmailAction } from "./actions/gmail.js";
 export { inboxAction } from "./actions/inbox.js";
 export { lifeAction } from "./actions/life.js";
 export { updateOwnerProfileAction } from "./actions/update-owner-profile.js";
+export { checkAvailabilityAction, proposeMeetingTimesAction, schedulingAction, updateMeetingPreferencesAction, } from "./actions/scheduling.js";
 export { inboxTriageProvider } from "./providers/inbox-triage.js";
 export { lifeOpsProvider } from "./providers/lifeops.js";
+export { runMorningCheckinAction, runNightCheckinAction, } from "./actions/checkin.js";
+export { CheckinService } from "./lifeops/checkin/checkin-service.js";
+export type { CheckinKind, CheckinReport, EscalationLevel, MeetingEntry, OverdueTodo, RecentWin, RecordAcknowledgementRequest, RunCheckinRequest, } from "./lifeops/checkin/types.js";
+export { resolveCheckinSchedule } from "./lifeops/checkin/schedule-resolver.js";
+export type { CheckinSchedule } from "./lifeops/checkin/schedule-resolver.js";
 export { handleLifeOpsRoutes } from "./routes/lifeops-routes.js";
 export type { LifeOpsRouteContext } from "./routes/lifeops-routes.js";
 export { handleWebsiteBlockerRoutes } from "./routes/website-blocker-routes.js";
 export type { WebsiteBlockerRouteContext } from "./routes/website-blocker-routes.js";
 export { ensureLifeOpsSchedulerTask, registerLifeOpsTaskWorker, executeLifeOpsSchedulerTask, resolveLifeOpsTaskIntervalMs, LIFEOPS_TASK_NAME, LIFEOPS_TASK_TAGS, LIFEOPS_TASK_INTERVAL_MS, LIFEOPS_TASK_JITTER_MS, } from "./lifeops/runtime.js";
-export * from "./selfcontrol/index.ts";
+export * from "./website-blocker/public.ts";
+export { blockAppsAction, unblockAppsAction, getAppBlockStatusAction } from "./actions/app-blocker.js";
+export { appBlockerProvider } from "./providers/app-blocker.js";
+export { getAppBlockerStatus, getCachedAppBlockerStatus, getAppBlockerPermissionState, requestAppBlockerPermission, getInstalledApps, selectAppsForBlocking, startAppBlock, stopAppBlock, } from "./app-blocker/engine.js";
+export { listOverdueFollowupsAction, markFollowupDoneAction, setFollowupThresholdAction, registerFollowupTrackerWorker, reconcileFollowupsOnce, computeOverdueFollowups, writeOverdueDigestMemory, getFollowupTrackerRoomId, FOLLOWUP_TRACKER_TASK_NAME, FOLLOWUP_TRACKER_TASK_TAGS, FOLLOWUP_TRACKER_INTERVAL_MS, FOLLOWUP_DEFAULT_THRESHOLD_DAYS, FOLLOWUP_MEMORY_TABLE, } from "./followup/index.js";
+export type { OverdueDigest, OverdueFollowup, } from "./followup/index.js";
 export default appLifeOpsPlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/apps/app-lifeops/src/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-lifeops/src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAkG3D,eAAO,MAAM,gBAAgB,EAAE,MAG9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,GAC3B,CAAC;AAGF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,wBAAwB,CAAC;AAEvC,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../../apps/app-lifeops/src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAGxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AA8X3D,eAAO,MAAM,gBAAgB,EAAE,MAA4B,CAAC;AAE5D,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,GAC3B,CAAC;AAGF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,YAAY,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,SAAS,EACT,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,6BAA6B,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,YAAY,GACb,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,4BAA4B,EAC5B,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,eAAe,gBAAgB,CAAC"}