feat: add status and delete capabilities to X platform

Author: vkop007

skills/autocli/references/providers/x.md

@@ -26,7 +26,7 @@ Interact with X/Twitter using an imported browser session and browser-backed wri
 
 - `autocli social x login`
 - `autocli social x login --cookies ./x.cookies.json`
-- `autocli social x post "Launching AutoCLI"`
+- `autocli social x status`
 - `autocli social x capabilities --json`
 
 ## Default Command
@@ -59,6 +59,19 @@ Options:
 - `--browser`: Open a real browser, wait for manual login, then save the extracted session (default when no cookie flags are provided)
 - `--browser-timeout <seconds>`: Maximum seconds to wait for manual browser login (default: 600)
 
+### `status`
+
+Usage:
+```bash
+autocli social x status [options]
+```
+
+Show the saved X session status
+
+Options:
+
+- `--account <name>`: Optional override for a specific saved X session
+
 ### `post`
 
 Usage:
@@ -135,6 +148,23 @@ Options:
 - `--limit <number>`: Maximum number of posts to return (1-25, default: 5)
 - `--account <name>`: Optional override for a specific saved X session
 
+### `delete`
+
+Usage:
+```bash
+autocli social x delete [options] <target>
+```
+
+Aliases: `remove`
+
+Delete your own X post by URL or tweet ID through a browser-backed action flow
+
+Options:
+
+- `--account <name>`: Optional override for a specific saved X session
+- `--browser`: Force the delete through the shared AutoCLI browser profile instead of the invisible browser-backed path
+- `--browser-timeout <seconds>`: Maximum seconds to allow the browser action to complete
+
 ### `like`
 
 Usage:

src/platforms/social/x/__tests__/write-capabilities.test.ts

@@ -5,12 +5,21 @@ import { buildPlatformCommand } from "../../../../core/runtime/build-platform-co
 import { xPlatformDefinition } from "../manifest.js";
 
 describe("x write capability command surface", () => {
+  test("exposes a status command for saved-session health checks", () => {
+    const command = buildPlatformCommand(xPlatformDefinition);
+    const byName = new Map(command.commands.map((entry) => [entry.name(), entry]));
+    const subcommand = byName.get("status");
+
+    expect(subcommand).toBeDefined();
+    expect(subcommand!.options.map((option) => option.flags)).toContain("--account <name>");
+  });
+
   test("keeps browser-backed flags on all write commands", () => {
     const command = buildPlatformCommand(xPlatformDefinition);
 
     const byName = new Map(command.commands.map((entry) => [entry.name(), entry]));
 
-    for (const name of ["post", "comment", "like", "unlike"] as const) {
+    for (const name of ["post", "comment", "delete", "like", "unlike"] as const) {
       const subcommand = byName.get(name);
       expect(subcommand).toBeDefined();
 

src/platforms/social/x/capabilities/delete.ts

@@ -0,0 +1,41 @@
+import type { Command } from "commander";
+
+import { Logger } from "../../../../logger.js";
+import { printActionResult, resolveCommandContext, runCommandAction } from "../../../../utils/cli.js";
+import { parseBrowserTimeoutSeconds } from "../../../shared/cookie-login.js";
+
+import { xAdapter } from "../adapter.js";
+
+import type { PlatformCapability } from "../../../../core/runtime/platform-definition.js";
+
+export const xDeleteCapability: PlatformCapability = {
+  id: "delete",
+  register(command: Command) {
+    command
+      .command("delete <target>")
+      .alias("remove")
+      .description("Delete your own X post by URL or tweet ID through a browser-backed action flow")
+      .option("--account <name>", "Optional override for a specific saved X session")
+      .option("--browser", "Force the delete through the shared AutoCLI browser profile instead of the invisible browser-backed path")
+      .option("--browser-timeout <seconds>", "Maximum seconds to allow the browser action to complete", parseBrowserTimeoutSeconds)
+      .action(async (target, options, cmd) => {
+        const ctx = resolveCommandContext(cmd);
+        const logger = new Logger(ctx);
+        const spinner = logger.spinner("Deleting X post...");
+        await runCommandAction({
+          spinner,
+          successMessage: "X post deleted.",
+          action: () =>
+            xAdapter.deleteTweet({
+              account: options.account,
+              target,
+              browser: Boolean(options.browser),
+              browserTimeoutSeconds: options.browserTimeout as number | undefined,
+            }),
+          onSuccess: (result) => {
+            printActionResult(result, ctx.json);
+          },
+        });
+      });
+  },
+};

src/platforms/social/x/capabilities/index.ts

@@ -1,9 +1,11 @@
 import { xCommentCapability } from "./comment.js";
+import { xDeleteCapability } from "./delete.js";
 import { xLikeCapability } from "./like.js";
 import { xLoginCapability } from "./login.js";
 import { xPostCapability } from "./post.js";
 import { xProfileIdCapability } from "./profileid.js";
 import { xSearchCapability } from "./search.js";
+import { xStatusCapability } from "./status.js";
 import { xTweetIdCapability } from "./tweetid.js";
 import { xTweetsCapability } from "./tweets.js";
 import { xUnlikeCapability } from "./unlike.js";
@@ -12,11 +14,13 @@ import type { PlatformCapability } from "../../../../core/runtime/platform-defin
 
 export const xCapabilities: readonly PlatformCapability[] = [
   xLoginCapability,
+  xStatusCapability,
   xPostCapability,
   xSearchCapability,
   xTweetIdCapability,
   xProfileIdCapability,
   xTweetsCapability,
+  xDeleteCapability,
   xLikeCapability,
   xUnlikeCapability,
   xCommentCapability,

src/platforms/social/x/capabilities/status.ts

@@ -0,0 +1,15 @@
+import { createAdapterActionCapability } from "../../../../core/runtime/capability-helpers.js";
+
+import { xAdapter } from "../adapter.js";
+import { printXStatusResult } from "../output.js";
+
+export const xStatusCapability = createAdapterActionCapability({
+  id: "status",
+  command: "status",
+  description: "Show the saved X session status",
+  spinnerText: "Checking X session...",
+  successMessage: "X session checked.",
+  options: [{ flags: "--account <name>", description: "Optional override for a specific saved X session" }],
+  action: ({ options }) => xAdapter.statusAction(options.account as string | undefined),
+  onSuccess: printXStatusResult,
+});

src/platforms/social/x/manifest.ts

@@ -15,12 +15,14 @@ export const xPlatformDefinition: PlatformDefinition = {
   examples: [
     "autocli social x login",
     "autocli social x login --cookies ./x.cookies.json",
+    "autocli social x status",
     'autocli social x post "Launching AutoCLI"',
     'autocli social x post "Launching AutoCLI" --browser',
     'autocli social x search "openai" --limit 5',
     "autocli social x tweetid https://x.com/user/status/1234567890",
     "autocli social x profileid @OpenAI",
     "autocli social x tweets @OpenAI --limit 5",
+    "autocli social x delete https://x.com/user/status/1234567890",
     "autocli social x like https://x.com/user/status/1234567890",
     "autocli social x unlike 1234567890",
   ],

src/platforms/social/x/output.ts

@@ -147,3 +147,32 @@ export function printXProfileResult(result: AdapterActionResult, json: boolean):
     console.log(preview);
   }
 }
+
+export function printXStatusResult(result: AdapterActionResult, json: boolean): void {
+  if (json) {
+    printJson(result);
+    return;
+  }
+
+  printActionResult(result, false);
+  const data = result.data;
+  if (!data || typeof data !== "object") {
+    return;
+  }
+
+  if (typeof data.status === "string") {
+    console.log(`status: ${data.status}`);
+  }
+
+  if (typeof data.connected === "boolean") {
+    console.log(`connected: ${data.connected ? "yes" : "no"}`);
+  }
+
+  if (typeof data.lastValidatedAt === "string") {
+    console.log(`lastValidatedAt: ${data.lastValidatedAt}`);
+  }
+
+  if (typeof data.details === "string" && data.details.length > 0) {
+    console.log(`details: ${data.details}`);
+  }
+}