@zenalexa/unicli 0.224.0 → 0.224.1

package/dist/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.224.0",
+  "version": "0.224.1",
   "sites": {
     "1688": {
       "commands": [
@@ -26661,6 +26661,251 @@
       ],
       "category": "shopping"
     },
+    "marxists-cn": {
+      "commands": [
+        {
+          "name": "authors",
+          "description": "List people, authors, organizations, and topic directories in the Chinese Marxists archive",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "rank",
+            "title",
+            "latinName",
+            "kind",
+            "path",
+            "url"
+          ],
+          "args": [
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 120,
+              "description": "Max rows"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "index",
+          "description": "List Chinese Marxists Internet Archive top-level people, topics, and library links",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "rank",
+            "title",
+            "latinName",
+            "kind",
+            "path",
+            "url"
+          ],
+          "args": [
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 80,
+              "description": "Max rows"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "read",
+          "description": "Read a Chinese Marxists archive HTML page as clean plain text",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "title",
+            "author",
+            "date",
+            "chars",
+            "text",
+            "url"
+          ],
+          "args": [
+            {
+              "name": "path",
+              "type": "str",
+              "required": true,
+              "positional": true,
+              "description": "Archive path or URL under /chinese/"
+            },
+            {
+              "name": "max-length",
+              "type": "int",
+              "default": 30000,
+              "description": "Max text characters"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "reading-list",
+          "description": "Return curated Chinese Marxists archive reading lists with directly readable paths",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "rank",
+            "preset",
+            "author",
+            "title",
+            "year",
+            "theme",
+            "path",
+            "url",
+            "readCommand",
+            "note"
+          ],
+          "args": [
+            {
+              "name": "preset",
+              "type": "str",
+              "required": true,
+              "positional": true,
+              "description": "Reading list preset, currently western-marxism"
+            },
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 40,
+              "description": "Max rows"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "search",
+          "description": "Search Chinese Marxists archive people, books, works, and scoped full text",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "rank",
+            "type",
+            "scope",
+            "section",
+            "title",
+            "snippet",
+            "path",
+            "url",
+            "score"
+          ],
+          "args": [
+            {
+              "name": "query",
+              "type": "str",
+              "required": true,
+              "positional": true,
+              "description": "Chinese or English search text"
+            },
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 20,
+              "description": "Max rows"
+            },
+            {
+              "name": "scope",
+              "type": "str",
+              "default": "",
+              "description": "Optional author/topic path for focused search, e.g. marx"
+            },
+            {
+              "name": "scan-pages",
+              "type": "int",
+              "default": 24,
+              "description": "Top-level index pages to scan when scope is omitted"
+            },
+            {
+              "name": "full-text",
+              "type": "bool",
+              "default": false,
+              "description": "When true, search text inside scoped HTML work pages"
+            },
+            {
+              "name": "content-pages",
+              "type": "int",
+              "default": 40,
+              "description": "Max HTML pages to read for full-text scoped search"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "western-marxism",
+          "description": "List famous Western Marxist authors and works from the Chinese Marxists archive with read commands",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "rank",
+            "preset",
+            "author",
+            "title",
+            "year",
+            "theme",
+            "path",
+            "url",
+            "readCommand",
+            "note"
+          ],
+          "args": [
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 40,
+              "description": "Max rows"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "works",
+          "description": "List works/books/articles under a Chinese Marxists archive author or topic path",
+          "strategy": "public",
+          "type": "web-api",
+          "columns": [
+            "rank",
+            "scope",
+            "section",
+            "title",
+            "note",
+            "format",
+            "path",
+            "url"
+          ],
+          "args": [
+            {
+              "name": "scope",
+              "type": "str",
+              "required": true,
+              "positional": true,
+              "description": "Author/topic path, e.g. marx, lenin, georg-lukacs"
+            },
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 120,
+              "description": "Max rows"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/marxists-cn/archive.ts",
+          "target_surface": ""
+        }
+      ],
+      "category": "reference"
+    },
     "mastodon": {
       "commands": [
         {
@@ -39748,6 +39993,36 @@
           "adapter_path": "src/adapters/twitter/bookmarks.ts",
           "target_surface": ""
         },
+        {
+          "name": "comments",
+          "description": "Get replies/comments for a Twitter/X tweet",
+          "strategy": "cookie",
+          "type": "web-api",
+          "domain": "x.com",
+          "columns": [
+            "id",
+            "parent_id",
+            "author",
+            "text",
+            "likes",
+            "retweets",
+            "views",
+            "url",
+            "depth",
+            "path"
+          ],
+          "args": [
+            {
+              "name": "url",
+              "required": true,
+              "positional": true,
+              "description": "Tweet ID or Twitter/X status URL"
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/twitter/thread.ts",
+          "target_surface": ""
+        },
         {
           "name": "delete",
           "description": "Delete your own tweet",
@@ -39999,14 +40274,18 @@
         },
         {
           "name": "list-tweets",
-          "description": "Read tweets from a Twitter/X list",
+          "description": "Read tweets from a Twitter/X list timeline",
           "strategy": "cookie",
           "type": "web-api",
           "domain": "x.com",
           "browser": true,
           "columns": [
+            "id",
             "author",
             "text",
+            "likes",
+            "retweets",
+            "views",
             "url"
           ],
           "args": [
@@ -40528,7 +40807,7 @@
               "name": "tweet_id",
               "required": true,
               "positional": true,
-              "description": "Tweet ID (numeric)"
+              "description": "Tweet ID or Twitter/X status URL"
             }
           ],
           "pipeline_steps": 0,
@@ -40587,8 +40866,12 @@
           "domain": "x.com",
           "browser": true,
           "columns": [
+            "id",
             "author",
             "text",
+            "likes",
+            "retweets",
+            "views",
             "url"
           ],
           "args": [
@@ -40745,6 +41028,72 @@
           "pipeline_steps": 0,
           "adapter_path": "src/adapters/twitter/tweet-actions.ts",
           "target_surface": ""
+        },
+        {
+          "name": "user-timeline",
+          "description": "Read a Twitter/X user's tweet timeline",
+          "strategy": "cookie",
+          "type": "web-api",
+          "domain": "x.com",
+          "browser": true,
+          "columns": [
+            "id",
+            "author",
+            "text",
+            "likes",
+            "retweets",
+            "views",
+            "url"
+          ],
+          "args": [
+            {
+              "name": "user",
+              "type": "str",
+              "required": true,
+              "positional": true
+            },
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 20
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/twitter/lists-extra.ts",
+          "target_surface": ""
+        },
+        {
+          "name": "user-tweets",
+          "description": "Read recent tweets from a Twitter/X user profile",
+          "strategy": "cookie",
+          "type": "web-api",
+          "domain": "x.com",
+          "browser": true,
+          "columns": [
+            "id",
+            "author",
+            "text",
+            "likes",
+            "retweets",
+            "views",
+            "url"
+          ],
+          "args": [
+            {
+              "name": "user",
+              "type": "str",
+              "required": true,
+              "positional": true
+            },
+            {
+              "name": "limit",
+              "type": "int",
+              "default": 20
+            }
+          ],
+          "pipeline_steps": 0,
+          "adapter_path": "src/adapters/twitter/lists-extra.ts",
+          "target_surface": ""
         }
       ],
       "category": "social"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.224.0",
+  "version": "0.224.1",
   "description": "Operations substrate for agents that use real software: web, browsers, desktop apps, local tools, MCP, policy, evidence, and self-repair.",
   "packageManager": "npm@11.14.0",
   "type": "module",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.olo-dot-io/Uni-CLI",
   "description": "Self-repairing CLI catalog that exposes 311 websites, desktop apps, and external CLIs as one MCP server. 977 declarative YAML adapters and 1753 commands; structured error envelopes let agents fix failing adapters at runtime and retry.",
-  "version": "0.224.0",
+  "version": "0.224.1",
   "repository": {
     "url": "https://github.com/olo-dot-io/Uni-CLI",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@zenalexa/unicli",
-      "version": "0.224.0",
+      "version": "0.224.1",
       "transport": {
         "type": "stdio"
       },

package/skills/unicli/SKILL.md

@@ -11,7 +11,7 @@ description: >
   major platform; run desktop workflows or system tasks; or when the user says
   "unicli", "scrape", "fetch from", "get trending", "check [site]", "find on
   [platform]", "获取", "查询", "抓取".
-version: 0.224.0
+version: 0.224.1
 category: core
 depends-on:
   - talk-normal

package/skills/unicli-claude-code/SKILL.md

@@ -6,7 +6,7 @@ description: >
   newlines, or inline JSON — shell-quoted invocations hit TC0 circuit
   limits and drop to <50% success above ICS=4. Also covers --describe
   introspection and next_actions-driven navigation.
-version: 0.224.0
+version: 0.224.1
 depends-on:
   - talk-normal
 triggers:

package/skills/unicli-hermes/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Use Uni-CLI to interact with 237 websites, desktop apps, and system tools.
   Trigger when: user asks to check a website, fetch data, control a desktop app,
   or interact with social media, news, finance, or AI platforms.
-version: 0.224.0
+version: 0.224.1
 depends-on:
   - talk-normal
 triggers:

package/src/adapters/marxists-cn/archive.test.ts

@@ -0,0 +1,173 @@
+import { describe, expect, it } from "vitest";
+import {
+  decodeMarxistsBuffer,
+  mapMarxistsReadRow,
+  marxistsHtmlToText,
+  marxistsReadingListRows,
+  normalizeMarxistsPath,
+  parseMarxistsIndex,
+  parseMarxistsWorks,
+  requireMarxistsLimit,
+} from "./archive.js";
+
+describe("marxists-cn agent-facing archive adapter", () => {
+  it("normalizes paths and rejects off-archive URLs", () => {
+    expect(normalizeMarxistsPath("marx", { directoryIndex: true })).toBe(
+      "marx/index.htm",
+    );
+    expect(
+      normalizeMarxistsPath("https://www.marxists.org/chinese/marx/01.htm#8"),
+    ).toBe("marx/01.htm");
+    expect(() =>
+      normalizeMarxistsPath("https://example.com/chinese/marx/01.htm"),
+    ).toThrow("must stay on www.marxists.org");
+    expect(() => normalizeMarxistsPath("../index.htm")).toThrow(
+      "must stay under /chinese/",
+    );
+  });
+
+  it("validates bounded integer arguments", () => {
+    expect(requireMarxistsLimit(undefined, 20, 100, "limit")).toBe(20);
+    expect(requireMarxistsLimit("5", 20, 100, "limit")).toBe(5);
+    expect(() => requireMarxistsLimit("0", 20, 100, "limit")).toThrow(
+      "marxists-cn limit must",
+    );
+    expect(() => requireMarxistsLimit("101", 20, 100, "limit")).toThrow(
+      "marxists-cn limit must",
+    );
+  });
+
+  it("parses top-level people and reference links from the Chinese index", () => {
+    const rows = parseMarxistsIndex(`
+      <a title="马克思 Karl Marx" href="marx/index.htm">
+        <img src="images/1-marx.jpg" alt="马克思">
+      </a>
+      <a href="abc/index.htm">马克思主义简介</a>
+      <a href="search/index.html">中文马克思主义文库搜索</a>
+    `);
+
+    expect(rows).toEqual([
+      {
+        title: "马克思",
+        latinName: "Karl Marx",
+        kind: "directory",
+        path: "marx/index.htm",
+        url: "https://www.marxists.org/chinese/marx/index.htm",
+      },
+      {
+        title: "马克思主义简介",
+        latinName: "",
+        kind: "reference",
+        path: "abc/index.htm",
+        url: "https://www.marxists.org/chinese/abc/index.htm",
+      },
+      {
+        title: "中文马克思主义文库搜索",
+        latinName: "",
+        kind: "site-meta",
+        path: "search/index.html",
+        url: "https://www.marxists.org/chinese/search/index.html",
+      },
+    ]);
+  });
+
+  it("parses work links with section, note, and resource format", () => {
+    const rows = parseMarxistsWorks(
+      `
+      <b><font color="#FF0000" size="5">著 作</font></b>
+      <a href="01.htm">共产党宣言</a>（1848年）
+      <a href="../pdf/marx/texts/3.pdf">马克思：黑格尔法哲学批判</a>
+      `,
+      "marx/index.htm",
+      "https://www.marxists.org/chinese/marx/index.htm",
+    );
+
+    expect(rows).toEqual([
+      {
+        scope: "marx/index.htm",
+        section: "著 作",
+        title: "共产党宣言",
+        note: "（1848年）",
+        format: "htm",
+        path: "marx/01.htm",
+        url: "https://www.marxists.org/chinese/marx/01.htm",
+      },
+      {
+        scope: "marx/index.htm",
+        section: "著 作",
+        title: "马克思：黑格尔法哲学批判",
+        note: "",
+        format: "pdf",
+        path: "pdf/marx/texts/3.pdf",
+        url: "https://www.marxists.org/chinese/pdf/marx/texts/3.pdf",
+      },
+    ]);
+  });
+
+  it("extracts readable article metadata and body text", () => {
+    const html = `
+      <html>
+        <head><title>马克思 恩格斯：共产党宣言（1848年）</title></head>
+        <body>
+          <p class="title0">共产党宣言</p>
+          <p class="author">马克思 恩格斯</p>
+          <p class="date">（1848年）</p>
+          <script>ignored()</script>
+          <h3>一、资产者和无产者</h3>
+          &amp;Oslash; 译序<br>
+          至今一切社会的历史&nbsp;都是阶级斗争的历史。<br>
+          <a href="#note">注释</a>
+        </body>
+      </html>
+    `;
+
+    expect(marxistsHtmlToText(html)).toContain(
+      "至今一切社会的历史 都是阶级斗争的历史。",
+    );
+    expect(marxistsHtmlToText(html)).toContain("Ø 译序");
+    expect(
+      mapMarxistsReadRow(
+        html,
+        "https://www.marxists.org/chinese/marx/01.htm",
+        500,
+      ),
+    ).toMatchObject({
+      title: "共产党宣言",
+      author: "马克思 恩格斯",
+      date: "（1848年）",
+      url: "https://www.marxists.org/chinese/marx/01.htm",
+    });
+  });
+
+  it("sniffs UTF-8 pages without forcing GB18030", () => {
+    const html = '<meta charset="UTF-8">中文马克思主义文库搜索';
+    const bytes = new TextEncoder().encode(html);
+    expect(decodeMarxistsBuffer(bytes.buffer)).toContain(
+      "中文马克思主义文库搜索",
+    );
+  });
+
+  it("returns a Western Marxism reading list with directly readable paths", () => {
+    const rows = marxistsReadingListRows("western-marxism");
+
+    expect(rows.map((row) => row.author)).toEqual(
+      expect.arrayContaining(["葛兰西", "卢卡奇", "科尔施", "阿尔都塞"]),
+    );
+    expect(rows).toContainEqual(
+      expect.objectContaining({
+        author: "卢卡奇",
+        title: "《历史与阶级意识》",
+        path: "georg-lukacs/1922/index.htm",
+        readCommand: "unicli marxists-cn read georg-lukacs/1922/index.htm",
+      }),
+    );
+    expect(
+      rows.every((row) =>
+        row.url.startsWith("https://www.marxists.org/chinese/"),
+      ),
+    ).toBe(true);
+    expect(() => marxistsReadingListRows("unknown")).toThrow(
+      "reading-list preset",
+    );
+  });
+});