@zenalexa/unicli 0.225.0 → 0.225.1

package/src/adapters/codex/extra.ts

@@ -1,12 +1,20 @@
 import { cli, Strategy } from "../../registry.js";
-import { connectElectronApp } from "../_electron/shared.js";
+import {
+  connectElectronApp,
+  electronAppCommandMeta,
+} from "../_electron/shared.js";
 import { intArg } from "../_shared/browser-tools.js";
 
+const CODEX_EXTRA_COMMAND_META = electronAppCommandMeta(
+  "src/adapters/codex/extra.ts",
+);
+
 cli({
   site: "codex",
   name: "history",
   description: "List Codex desktop conversation threads",
   strategy: Strategy.PUBLIC,
+  ...CODEX_EXTRA_COMMAND_META,
   args: [{ name: "limit", type: "int", default: 20 }],
   columns: ["title"],
   func: async (_page, kwargs) => {
@@ -27,6 +35,7 @@ cli({
   name: "export",
   description: "Export the current Codex desktop thread as Markdown text",
   strategy: Strategy.PUBLIC,
+  ...CODEX_EXTRA_COMMAND_META,
   columns: ["content"],
   func: async () => {
     const page = await connectElectronApp("codex");

package/src/adapters/codex/projects.ts

@@ -7,7 +7,14 @@
  */
 
 import { cli, Strategy } from "../../registry.js";
-import { connectElectronApp } from "../_electron/shared.js";
+import {
+  connectElectronApp,
+  electronAppCommandMeta,
+} from "../_electron/shared.js";
+
+const CODEX_PROJECTS_COMMAND_META = electronAppCommandMeta(
+  "src/adapters/codex/projects.ts",
+);
 
 interface CodexConversation {
   index: number;
@@ -141,6 +148,7 @@ cli({
   description: "List Codex projects and visible conversations from the sidebar",
   domain: "localhost",
   strategy: Strategy.PUBLIC,
+  ...CODEX_PROJECTS_COMMAND_META,
   browser: false,
   args: [
     {

package/src/adapters/cursor/cursor.ts

@@ -9,9 +9,14 @@ import { writeFileSync } from "node:fs";
 import {
   registerAIChatCommands,
   connectElectronApp,
+  electronAppCommandMeta,
 } from "../_electron/shared.js";
 import { cli, Strategy } from "../../registry.js";
 
+const CURSOR_COMMAND_META = electronAppCommandMeta(
+  "src/adapters/cursor/cursor.ts",
+);
+
 registerAIChatCommands("cursor", {
   inputSelector:
     ".chat-input textarea, [data-testid='chat-input'] textarea, .composer-input textarea",
@@ -28,6 +33,7 @@ cli({
   name: "composer",
   description: "Open Cursor Composer mode with a prompt",
   strategy: Strategy.PUBLIC,
+  ...CURSOR_COMMAND_META,
   args: [
     {
       name: "prompt",
@@ -52,6 +58,7 @@ cli({
   name: "extract-code",
   description: "Extract code blocks from the last Cursor response",
   strategy: Strategy.PUBLIC,
+  ...CURSOR_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("cursor");
     const code = await p.evaluate(`
@@ -75,6 +82,7 @@ cli({
   name: "export",
   description: "Export the current Cursor conversation to a Markdown file",
   strategy: Strategy.PUBLIC,
+  ...CURSOR_COMMAND_META,
   args: [
     {
       name: "output",
@@ -117,6 +125,7 @@ cli({
   name: "history",
   description: "List recent chat sessions from the Cursor sidebar",
   strategy: Strategy.PUBLIC,
+  ...CURSOR_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("cursor");
     const items = (await p.evaluate(`

package/src/adapters/discord-app/discord-app.ts

@@ -4,15 +4,23 @@
  * Commands: servers, channels, read, send, search, members, delete, status
  */
 
-import { connectElectronApp } from "../_electron/shared.js";
+import {
+  connectElectronApp,
+  electronAppCommandMeta,
+} from "../_electron/shared.js";
 import { cli, Strategy } from "../../registry.js";
 
+const DISCORD_APP_COMMAND_META = electronAppCommandMeta(
+  "src/adapters/discord-app/discord-app.ts",
+);
+
 // servers -- List Discord servers
 cli({
   site: "discord-app",
   name: "servers",
   description: "List Discord servers",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("discord-app");
     const servers = await p.evaluate(`
@@ -35,6 +43,7 @@ cli({
   name: "channels",
   description: "List channels in current server",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("discord-app");
     const channels = await p.evaluate(`
@@ -55,6 +64,7 @@ cli({
   name: "read",
   description: "Read recent messages",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("discord-app");
     const messages = await p.evaluate(`
@@ -79,6 +89,7 @@ cli({
   name: "send",
   description: "Send message in current channel",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   args: [
     {
       name: "message",
@@ -105,6 +116,7 @@ cli({
   name: "search",
   description: "Search Discord messages",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   args: [
     {
       name: "query",
@@ -138,6 +150,7 @@ cli({
   name: "members",
   description: "List server members",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("discord-app");
     const members = await p.evaluate(`
@@ -159,6 +172,7 @@ cli({
   name: "delete",
   description: "Delete a message by its ID in the active Discord channel",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   args: [
     {
       name: "message_id",
@@ -257,6 +271,7 @@ cli({
   name: "status",
   description: "Discord app status",
   strategy: Strategy.PUBLIC,
+  ...DISCORD_APP_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("discord-app");
     const title = await p.title();

package/src/adapters/macos/brightness.yaml

@@ -15,11 +15,14 @@ pipeline:
         - |
           const app = Application.currentApplication();
           app.includeStandardAdditions = true;
-          const result = app.doShellScript('ioreg -c AppleBacklightDisplay | grep brightness');
-          JSON.stringify({ brightness: result });
+          const raw = app.doShellScript('ioreg -r -c AppleBacklightDisplay -k brightness 2>/dev/null || true');
+          const current = (raw.match(/"brightness"\\s*=\\s*(\\d+)/) || [])[1] || '';
+          const max = (raw.match(/"max-brightness"\\s*=\\s*(\\d+)/) || [])[1] || '';
+          const percent = current && max ? Math.round(Number(current) / Number(max) * 100) : null;
+          JSON.stringify([{ brightness: percent, raw: raw ? raw.split('\\n').slice(0, 8).join('\\n') : '', status: percent === null ? 'unavailable' : 'ok' }]);
       parse: json
 
-columns: [brightness]
+columns: [brightness, status]
 
 # schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["subprocess.exec"]

package/src/adapters/macos/calendar-list.yaml

@@ -28,20 +28,18 @@ pipeline:
           var calendars = cal.calendars();
           var result = [];
           for (var c = 0; c < calendars.length; c++) {
-            var events = calendars[c].events();
+            var events = calendars[c].events.whose({startDate: {_greaterThan: now, _lessThan: end}})();
             for (var e = 0; e < events.length; e++) {
               var ev = events[e];
               var start = ev.startDate();
-              if (start >= now && start <= end) {
-                result.push({
-                  calendar: calendars[c].name(),
-                  title: ev.summary(),
-                  start: start.toISOString(),
-                  end: ev.endDate().toISOString(),
-                  location: ev.location() || '',
-                  notes: (ev.description() || '').substring(0, 200)
-                });
-              }
+              result.push({
+                calendar: calendars[c].name(),
+                title: ev.summary(),
+                start: start.toISOString(),
+                end: ev.endDate().toISOString(),
+                location: ev.location() || '',
+                notes: (ev.description() || '').substring(0, 200)
+              });
             }
           }
           result.sort(function(a, b) { return a.start < b.start ? -1 : 1; });

package/src/adapters/macos/calendar-today.yaml

@@ -19,7 +19,7 @@ pipeline:
           const end = new Date(start.getTime() + 86400000);
           const out = [];
           for (const cal of app.calendars()) {
-            const evts = cal.events.whose({startDate: {_greaterThan: start}, startDate: {_lessThan: end}})();
+            const evts = cal.events.whose({startDate: {_greaterThan: start, _lessThan: end}})();
             for (const e of evts) {
               out.push({ calendar: cal.name(), summary: e.summary(), start: e.startDate().toISOString(), end: e.endDate().toISOString(), location: e.location() || '' });
             }

package/src/adapters/macos/safari-url.yaml

@@ -14,12 +14,16 @@ pipeline:
         - "-e"
         - |
           const app = Application('Safari');
-          const win = app.windows[0];
-          const tab = win.currentTab();
-          JSON.stringify([{ url: tab.url(), title: tab.name() }]);
+          const windows = app.windows();
+          if (windows.length === 0) {
+            JSON.stringify([{ state: 'no_window', url: '', title: '' }]);
+          } else {
+            const tab = windows[0].currentTab();
+            JSON.stringify([{ state: 'ok', url: tab.url(), title: tab.name() }]);
+          }
       parse: json
 
-columns: [url, title]
+columns: [state, url, title]
 
 # schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["subprocess.exec"]

package/src/adapters/maoyan/hot.yaml

@@ -19,7 +19,7 @@ pipeline:
       headers:
         Referer: https://piaofang.maoyan.com/dashboard
 
-  - select: movieList.data.list
+  - select: movieList.list
 
   - map:
       rank: ${{ index + 1 }}

package/src/adapters/notion-app/notion-app.ts

@@ -7,15 +7,23 @@
  * Commands: search, read, write, new, status, sidebar, favorites, export, screenshot
  */
 
-import { connectElectronApp } from "../_electron/shared.js";
+import {
+  connectElectronApp,
+  electronAppCommandMeta,
+} from "../_electron/shared.js";
 import { cli, Strategy } from "../../registry.js";
 
+const NOTION_COMMAND_META = electronAppCommandMeta(
+  "src/adapters/notion-app/notion-app.ts",
+);
+
 // search -- Quick-find via Cmd+K
 cli({
   site: "notion",
   name: "search",
   description: "Search in Notion (Cmd+K)",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   args: [
     {
       name: "query",
@@ -50,6 +58,7 @@ cli({
   name: "read",
   description: "Read current Notion page content",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("notion");
     const content = await p.evaluate(`
@@ -66,6 +75,7 @@ cli({
   name: "write",
   description: "Append text to current Notion page",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   args: [
     {
       name: "text",
@@ -97,6 +107,7 @@ cli({
   name: "new",
   description: "Create new Notion page",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   args: [
     {
       name: "title",
@@ -121,6 +132,7 @@ cli({
   name: "status",
   description: "Notion workspace status",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("notion");
     const title = await p.title();
@@ -134,6 +146,7 @@ cli({
   name: "sidebar",
   description: "Read Notion sidebar navigation",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("notion");
     const items = await p.evaluate(`
@@ -156,6 +169,7 @@ cli({
   name: "favorites",
   description: "List Notion favorites",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("notion");
     const items = await p.evaluate(`
@@ -180,6 +194,7 @@ cli({
   name: "export",
   description: "Export current Notion page as markdown",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   func: async () => {
     const p = await connectElectronApp("notion");
     const content = await p.evaluate(`
@@ -195,6 +210,7 @@ cli({
   name: "screenshot",
   description: "Screenshot current Notion page",
   strategy: Strategy.PUBLIC,
+  ...NOTION_COMMAND_META,
   args: [
     {
       name: "path",

package/src/adapters/spotify/api.ts

@@ -16,6 +16,12 @@ interface SpotifyConfig {
   SPOTIFY_REDIRECT_URI?: string;
 }
 
+interface SpotifyTrack {
+  uri: string;
+  name: string;
+  artist: string;
+}
+
 const TOKEN_PATH = join(homedir(), ".unicli", "spotify-tokens.json");
 const ENV_PATH = join(homedir(), ".unicli", "spotify.env");
 
@@ -113,13 +119,26 @@ async function spotifyApi(
   return response.json();
 }
 
-async function searchTrack(query: string): Promise<string> {
+async function searchTrack(query: string): Promise<SpotifyTrack> {
   const data = (await spotifyApi(
     `/search?type=track&limit=1&q=${encodeURIComponent(query)}`,
-  )) as { tracks?: { items?: Array<{ uri?: string }> } };
-  const uri = data.tracks?.items?.[0]?.uri;
-  if (!uri) throw new Error(`No Spotify track found for query: ${query}`);
-  return uri;
+  )) as {
+    tracks?: {
+      items?: Array<{
+        uri?: string;
+        name?: string;
+        artists?: Array<{ name?: string }>;
+      }>;
+    };
+  };
+  const track = data.tracks?.items?.[0];
+  if (!track?.uri)
+    throw new Error(`No Spotify track found for query: ${query}`);
+  return {
+    uri: track.uri,
+    name: track.name ?? "",
+    artist: track.artists?.map((artist) => artist.name).join(", ") ?? "",
+  };
 }
 
 cli({
@@ -235,11 +254,38 @@ cli({
   args: [{ name: "query", type: "str", required: true, positional: true }],
   columns: ["ok", "uri"],
   func: async (_page, kwargs) => {
-    const uri = await searchTrack(str(kwargs.query));
-    await spotifyApi(`/me/player/queue?uri=${encodeURIComponent(uri)}`, {
+    const track = await searchTrack(str(kwargs.query));
+    await spotifyApi(`/me/player/queue?uri=${encodeURIComponent(track.uri)}`, {
       method: "POST",
     });
-    return [{ ok: true, uri }];
+    return [{ ok: true, uri: track.uri }];
+  },
+});
+
+cli({
+  site: "spotify",
+  name: "play-track",
+  description: "Search Spotify for a track query and start playback",
+  domain: "api.spotify.com",
+  strategy: Strategy.COOKIE,
+  args: [{ name: "query", type: "str", required: true, positional: true }],
+  columns: ["ok", "query", "track", "artist", "uri"],
+  func: async (_page, kwargs) => {
+    const query = str(kwargs.query);
+    const track = await searchTrack(query);
+    await spotifyApi("/me/player/play", {
+      method: "PUT",
+      body: JSON.stringify({ uris: [track.uri] }),
+    });
+    return [
+      {
+        ok: true,
+        query,
+        track: track.name,
+        artist: track.artist,
+        uri: track.uri,
+      },
+    ];
   },
 });
 

package/src/adapters/weibo/trending.yaml

@@ -14,6 +14,8 @@ args:
 pipeline:
   - fetch:
       url: https://weibo.com/ajax/side/hotSearch
+      headers:
+        Referer: https://weibo.com/
 
   - select: data.realtime
 

package/src/adapters/xiaohongshu/browser-state.ts

@@ -2,7 +2,7 @@
  * @owner   Xiaohongshu browser adapters.
  * @does    Detects login, risk-control, and rendered-feed state in XHS web pages.
  * @needs   Browser-backed IPage from Uni-CLI runtime.
- * @feeds   xiaohongshu.search and xiaohongshu.trending.
+ * @feeds   xiaohongshu.feed, xiaohongshu.search, and xiaohongshu.trending.
  * @breaks  XHS copy or route changes can require updating page-state detection.
  */
 
@@ -62,7 +62,7 @@ export async function assertXhsReadable(
   assertXhsReadableState(command, await readXhsPageState(page));
 }
 
-export async function fetchXhsFeedItems(page: IPage): Promise<unknown[]> {
+async function fetchXhsStoreFeedItems(page: IPage): Promise<unknown[]> {
   const raw = await page.evaluate(`
     (async () => {
       const app = document.querySelector('#app')?.__vue_app__;
@@ -93,3 +93,60 @@ export async function fetchXhsFeedItems(page: IPage): Promise<unknown[]> {
   `);
   return Array.isArray(raw) ? raw : [];
 }
+
+export async function fetchXhsVisibleFeedItems(
+  page: IPage,
+): Promise<unknown[]> {
+  const raw = await page.evaluate(`
+    (() => {
+      const cleanText = (value) => String(value || '').replace(/\\s+/g, ' ').trim();
+      const normalizeUrl = (href) => {
+        if (!href) return '';
+        if (href.startsWith('http://') || href.startsWith('https://')) return href;
+        if (href.startsWith('/')) return 'https://www.xiaohongshu.com' + href;
+        return '';
+      };
+      const noteIdFromUrl = (url) => {
+        const match = url.match(/\\/(?:explore|search_result|note)\\/([^?#/]+)/i);
+        return match ? match[1] : '';
+      };
+      const rows = [];
+      const seen = new Set();
+      document.querySelectorAll('section.note-item, .note-item').forEach((el) => {
+        const link =
+          el.querySelector('a[href*="/explore/"]') ||
+          el.querySelector('a[href*="/search_result/"]') ||
+          el.querySelector('a[href*="/note/"]');
+        const url = normalizeUrl(link?.getAttribute('href') || '');
+        const id = noteIdFromUrl(url);
+        if (!id || seen.has(id)) return;
+        seen.add(id);
+
+        const titleEl = el.querySelector('.title, .note-title, a.title, .footer .title span');
+        const authorEl = el.querySelector('a.author .name, .name, .author-name, .nick-name, a.author');
+        const likesEl = el.querySelector('.count, .like-count, .like-wrapper .count');
+        const isVideo =
+          !!el.querySelector('video, .play-icon, .video-icon') ||
+          /视频/.test(cleanText(el.textContent));
+
+        rows.push({
+          id,
+          note_card: {
+            display_title: cleanText(titleEl?.textContent || link?.textContent || ''),
+            type: isVideo ? 'video' : 'normal',
+            user: { nickname: cleanText(authorEl?.textContent || '') },
+            interact_info: { liked_count: cleanText(likesEl?.textContent || '0') },
+          },
+        });
+      });
+      return rows;
+    })()
+  `);
+  return Array.isArray(raw) ? raw : [];
+}
+
+export async function fetchXhsFeedItems(page: IPage): Promise<unknown[]> {
+  const storeItems = await fetchXhsStoreFeedItems(page).catch(() => []);
+  if (storeItems.length > 0) return storeItems;
+  return fetchXhsVisibleFeedItems(page);
+}

package/src/adapters/xiaohongshu/feed.ts

@@ -0,0 +1,103 @@
+/**
+ * @owner   src/adapters/xiaohongshu/feed.ts
+ * @does    Register Xiaohongshu home-feed extraction over a logged-in browser page.
+ * @needs   Browser-backed IPage, XHS readable-state checks, visible/store feed extraction.
+ * @feeds   xiaohongshu.feed command.
+ * @breaks  XHS feed route or note-card DOM drift returns structured empty_result.
+ * @invariants Rows expose stable note title, author, likes, type, and canonical note URL.
+ * @side-effects Performs authenticated read navigation to Xiaohongshu explore.
+ * @perf     One page navigation plus at most one visible DOM extraction per invocation.
+ * @concurrency Stateless per invocation.
+ * @test     tests/unit/xiaohongshu-feed.test.ts
+ * @stability stable
+ * @since    2026-06-02
+ */
+
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { socialEmptyError } from "../../social/browser-errors.js";
+import { assertXhsReadable, fetchXhsFeedItems } from "./browser-state.js";
+
+export interface XhsFeedRow {
+  id: string;
+  title: string;
+  author: string;
+  likes: string;
+  type: string;
+  url: string;
+}
+
+function asRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === "object"
+    ? (value as Record<string, unknown>)
+    : {};
+}
+
+function cleanText(value: unknown): string {
+  return String(value ?? "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+export function normalizeXhsFeedRows(
+  items: unknown[],
+  limit: number,
+): XhsFeedRow[] {
+  return items
+    .map((item) => {
+      const root = asRecord(item);
+      const note = asRecord(root.note_card);
+      const user = asRecord(note.user);
+      const interact = asRecord(note.interact_info);
+      const id = cleanText(root.id);
+      const title = cleanText(note.display_title);
+      if (!id || !title) return null;
+      return {
+        id,
+        title,
+        type: cleanText(note.type) || "normal",
+        author: cleanText(user.nickname),
+        likes: cleanText(interact.liked_count),
+        url: `https://www.xiaohongshu.com/explore/${id}`,
+      };
+    })
+    .filter((row): row is XhsFeedRow => row !== null)
+    .slice(0, limit);
+}
+
+cli({
+  site: "xiaohongshu",
+  name: "feed",
+  description: "Xiaohongshu home feed",
+  domain: "www.xiaohongshu.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  browserSession: "user",
+  args: [
+    {
+      name: "limit",
+      type: "int",
+      default: 20,
+      description: "Number of items to return",
+    },
+  ],
+  columns: ["title", "author", "likes", "type", "url"],
+  capabilities: ["cdp-browser.navigate", "cdp-browser.evaluate"],
+  minimum_capability: "cdp-browser.evaluate",
+  async func(page, kwargs) {
+    const p = page as IPage;
+    const limit = Number(kwargs.limit) || 20;
+    await p.goto("https://www.xiaohongshu.com/explore", { settleMs: 2500 });
+    await p.wait(2);
+    await assertXhsReadable(p, "feed");
+
+    const rows = normalizeXhsFeedRows(await fetchXhsFeedItems(p), limit);
+    if (rows.length > 0) return rows;
+
+    throw socialEmptyError(
+      "xiaohongshu",
+      "feed",
+      "Xiaohongshu explore loaded no parseable feed rows.",
+    );
+  },
+});