@zenalexa/unicli 0.225.1 → 0.225.3

package/dist/discovery/core-catalog.js

@@ -5,6 +5,7 @@
  * @feeds   src/discovery/search.ts, src/fast-path/handlers/discovery.ts, src/mcp/handler.ts, src/cli.ts
  * @breaks  Missing core rows make built-in capabilities executable but undiscoverable through search/list/MCP.
  */
+import { getComputeCommandContract, } from "../compute/contracts.js";
 const CORE_COMMAND_SOURCE_PATHS = {
     agents: "src/commands/agents.ts",
     architecture: "src/commands/architecture.ts",
@@ -14,53 +15,495 @@ const CORE_COMMAND_SOURCE_PATHS = {
     mcp: "src/commands/mcp.ts",
     operate: "src/commands/operate.ts",
     runs: "src/commands/runs.ts",
+    scholar: "src/commands/scholar.ts",
 };
-const COMPUTE_CAPTURE_ARGS = [
-    {
-        name: "app",
-        type: "str",
-        description: "Application name to scope snapshot and screenshot capture",
-    },
-    {
-        name: "format",
-        type: "str",
-        default: "compact",
-        choices: ["compact", "json", "tree"],
-        description: "Snapshot encoding for accessibility refs",
-    },
-    {
-        name: "include",
-        type: "str",
-        default: "snapshot,screenshot",
-        description: "Comma-separated capture parts: snapshot,screenshot",
-    },
-    {
-        name: "maxDepth",
-        type: "int",
-        description: "Maximum accessibility tree depth",
-    },
-    {
-        name: "screenshotPath",
-        type: "str",
-        description: "Optional screenshot output path",
-    },
-    {
-        name: "saveReference",
-        type: "bool",
-        description: "Persist app-shot handoff artifacts",
-    },
-    {
-        name: "copyReference",
-        type: "bool",
-        description: "Persist and copy app-shot handoff markup",
-    },
+const CORE_DISCOVERY_COMMANDS = [
     {
-        name: "referenceRoot",
-        type: "str",
-        description: "Directory for saved app-shot artifacts",
+        site: "scholar",
+        command: "availability",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Audit one academic paper from DOI, arXiv id, PMID, OpenReview id, source-local id, or title, then report source-backed metadata, PDF, full-text, code, dataset/model, citation, reference, and review availability plus next commands without downloading artifacts.",
+        capabilities: [
+            "http.fetch",
+            "scholar.get",
+            "scholar.pdf",
+            "scholar.fulltext",
+            "scholar.code",
+            "scholar.datasets",
+            "scholar.citations",
+            "scholar.references",
+            "scholar.review",
+        ],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include evidence URLs, errors, and next commands",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "evidence",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Classify one academic paper's source-backed evidence from DOI, arXiv id, PMID, OpenReview id, source-local id, or title into citation safety, reading readiness, missing evidence, primary anchors, and next commands without downloading artifacts.",
+        capabilities: [
+            "http.fetch",
+            "scholar.get",
+            "scholar.pdf",
+            "scholar.fulltext",
+            "scholar.code",
+            "scholar.datasets",
+            "scholar.citations",
+            "scholar.references",
+            "scholar.review",
+        ],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include source errors and command timestamp",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "sources",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Show a per-source provenance matrix for one academic paper from DOI, arXiv id, PMID, OpenReview id, source-local id, or title, including source status, evidence types, candidate capabilities, next commands, and source errors without downloading artifacts.",
+        capabilities: [
+            "http.fetch",
+            "scholar.get",
+            "scholar.pdf",
+            "scholar.fulltext",
+            "scholar.code",
+            "scholar.datasets",
+            "scholar.citations",
+            "scholar.references",
+            "scholar.review",
+        ],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include source capabilities, errors, and next commands",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "workflow",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Build a source-backed agent runbook for one academic paper from DOI, arXiv id, PMID, OpenReview id, source-local id, or title, ordering evidence classification, source reading, artifact download, citation/reference graph audit, peer-review audit, and reproducibility planning without downloading, cloning, installing, executing, or summarizing claims.",
+        capabilities: [
+            "http.fetch",
+            "scholar.get",
+            "scholar.pdf",
+            "scholar.fulltext",
+            "scholar.code",
+            "scholar.datasets",
+            "scholar.citations",
+            "scholar.references",
+            "scholar.review",
+        ],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include runbook steps, source errors, and timestamp",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "reproduce",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Plan one academic paper's source-backed code, data, model, and Space reproducibility path from DOI, arXiv id, OpenReview id, source-local id, or title, including installation readiness and safety boundaries without cloning, installing, or executing remote code.",
+        capabilities: [
+            "http.fetch",
+            "scholar.get",
+            "scholar.pdf",
+            "scholar.fulltext",
+            "scholar.code",
+            "scholar.datasets",
+        ],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include source errors, download command, and timestamp",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "coverage",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Compare registered academic and scholarly sources by discovery, metadata, PDF, full-text, code, dataset/model, citation, reference, and review coverage, then report missing closed-loop capabilities and next commands for agent routing without network I/O.",
+        capabilities: [
+            "scholar.search",
+            "scholar.get",
+            "scholar.pdf",
+            "scholar.fulltext",
+            "scholar.code",
+            "scholar.datasets",
+            "scholar.citations",
+            "scholar.references",
+            "scholar.review",
+            "scholar.venue",
+            "scholar.author",
+        ],
+        args: [
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "gaps",
+                type: "bool",
+                description: "Show only sources with missing closed-loop capabilities",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include source command names and next commands",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "reviews",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Fetch source-backed peer-review, decision, rebuttal, and comment rows for a scholarly paper review thread such as an OpenReview forum, with note ids, source URLs, ratings, confidence, text truncation, and agent-auditable anchors.",
+        capabilities: ["http.fetch", "scholar.review"],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "OpenReview forum id, forum URL, or review-thread id",
+            },
+            {
+                name: "source",
+                type: "str",
+                description: "Force one review-capable source",
+            },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated review-capable sources, or all",
+            },
+            {
+                name: "max-length",
+                type: "int",
+                default: 4000,
+                description: "Per-row review text truncation length",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include reviewer/signature and text size fields",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "code",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Resolve an academic paper from DOI, arXiv id, OpenReview id, source-local id, or title across scholarly resource-capable adapters, then return linked code repositories and project pages.",
+        capabilities: ["http.fetch", "scholar.code"],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include richer resource metadata columns",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "datasets",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Resolve an academic paper from DOI, arXiv id, OpenReview id, source-local id, or title across scholarly resource-capable adapters, then return linked datasets, models, and Spaces.",
+        capabilities: ["http.fetch", "scholar.datasets"],
+        minimum_capability: "http.fetch",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "detailed",
+                type: "bool",
+                description: "Include richer resource metadata columns",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "read",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Resolve an academic paper from DOI, arXiv id, OpenReview id, PubMed id, source-local id, or title across scholarly sources, prefer source-direct full text, then download the open PDF and extract capped text for agent reading.",
+        capabilities: [
+            "http.fetch",
+            "http.download",
+            "subprocess.exec",
+            "scholar.fulltext",
+            "scholar.pdf",
+        ],
+        minimum_capability: "subprocess.exec",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "venue",
+                type: "str",
+                description: "Source-local venue scope, e.g. CVPR or ICCV",
+            },
+            {
+                name: "year",
+                type: "str",
+                description: "Source-local proceedings year",
+            },
+            {
+                name: "volume",
+                type: "str",
+                description: "Source-local proceedings volume, e.g. PMLR v235",
+            },
+            {
+                name: "output",
+                type: "str",
+                default: "./scholar-downloads",
+                description: "Output directory",
+            },
+            { name: "first-page", type: "int", default: 1 },
+            { name: "last-page", type: "int", default: 20 },
+            {
+                name: "max-chars",
+                type: "int",
+                description: "Maximum extracted/read text characters",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+        ],
+    },
+    {
+        site: "scholar",
+        command: "download",
+        category: "scholarly",
+        type: "web-api",
+        target_surface: "web",
+        source_path: "src/commands/scholar.ts",
+        description: "Resolve an academic paper from DOI, arXiv id, OpenReview id, source-local id, or title across scholarly sources, download the open PDF, and return artifact metadata.",
+        capabilities: ["http.download", "scholar.pdf"],
+        minimum_capability: "http.download",
+        args: [
+            {
+                name: "ref",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "DOI, arXiv id, OpenReview id, source-local id, or title",
+            },
+            { name: "source", type: "str", description: "Force one source" },
+            {
+                name: "sources",
+                type: "str",
+                description: "Comma-separated sources, or all",
+            },
+            {
+                name: "venue",
+                type: "str",
+                description: "Source-local venue scope, e.g. CVPR or ICCV",
+            },
+            {
+                name: "year",
+                type: "str",
+                description: "Source-local proceedings year",
+            },
+            {
+                name: "volume",
+                type: "str",
+                description: "Source-local proceedings volume, e.g. PMLR v235",
+            },
+            {
+                name: "output",
+                type: "str",
+                default: "./scholar-downloads",
+                description: "Output directory",
+            },
+            {
+                name: "unpaywall-email",
+                type: "str",
+                description: "Requester email for Unpaywall DOI lookup",
+            },
+        ],
     },
-];
-const CORE_DISCOVERY_COMMANDS = [
     {
         site: "browser",
         command: "evidence",
@@ -214,7 +657,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "List installed and visible desktop applications for local computer-use workflows.",
+        ...computeCommandFields("apps"),
     },
     {
         site: "compute",
@@ -222,7 +665,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "List visible desktop windows for local computer-use workflows.",
+        ...computeCommandFields("windows"),
     },
     {
         site: "compute",
@@ -230,7 +673,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Capture compact accessibility snapshots, refs, app state, and native UI structure for local computer-use agents.",
+        ...computeCommandFields("snapshot"),
     },
     {
         site: "compute",
@@ -238,13 +681,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        args: COMPUTE_CAPTURE_ARGS,
-        channels: {
-            shell: "unicli compute capture [--app <name>] [--include snapshot,screenshot] [--format compact] [--copy-reference]",
-            args_file: "unicli compute capture --args-file <path.json>",
-            stdin: "echo '{...}' | unicli compute capture",
-        },
-        description: "Capture local computer-use context by combining accessibility refs, app state, screenshot evidence, image metadata, app-shot reference artifacts, clipboard handoff markup, and replayable capture trajectory.",
+        ...computeCommandFields("capture"),
     },
     {
         site: "compute",
@@ -252,7 +689,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Find a desktop UI element by query and return stable refs for local computer-use actions.",
+        ...computeCommandFields("find"),
     },
     {
         site: "compute",
@@ -260,7 +697,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Click a desktop UI ref through the local computer-use cascade with action evidence.",
+        ...computeCommandFields("click"),
     },
     {
         site: "compute",
@@ -268,7 +705,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Type text into a desktop UI ref through native, browser, or visual computer-use transports.",
+        ...computeCommandFields("type"),
     },
     {
         site: "compute",
@@ -276,7 +713,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Press a keyboard shortcut through local computer-use transports.",
+        ...computeCommandFields("press"),
     },
     {
         site: "compute",
@@ -284,7 +721,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Scroll a desktop UI ref through local computer-use transports.",
+        ...computeCommandFields("scroll"),
     },
     {
         site: "compute",
@@ -292,7 +729,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Launch a desktop app before local computer-use control.",
+        ...computeCommandFields("launch"),
     },
     {
         site: "compute",
@@ -300,7 +737,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Capture a desktop screenshot for local computer-use observation and visual fallback.",
+        ...computeCommandFields("screenshot"),
     },
     {
         site: "compute",
@@ -308,7 +745,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Attach to a desktop app or browser-backed local runtime for computer-use actions.",
+        ...computeCommandFields("attach"),
     },
     {
         site: "compute",
@@ -316,7 +753,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Evaluate JavaScript in an attached browser-backed local runtime.",
+        ...computeCommandFields("eval"),
     },
     {
         site: "compute",
@@ -324,7 +761,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Wait for a local computer-use target to reach a stable or expected state.",
+        ...computeCommandFields("wait"),
     },
     {
         site: "compute",
@@ -332,7 +769,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Observe desktop state against a natural-language goal using local computer-use transports.",
+        ...computeCommandFields("observe"),
     },
     {
         site: "compute",
@@ -340,7 +777,7 @@ const CORE_DISCOVERY_COMMANDS = [
         category: "desktop",
         type: "desktop",
         target_surface: "desktop",
-        description: "Assert desktop state for a local computer-use workflow and return structured evidence.",
+        ...computeCommandFields("assert"),
     },
 ];
 export function listCoreDiscoveryCommands() {
@@ -380,4 +817,26 @@ function withCoreSourcePath(command) {
         source_path: command.source_path ?? CORE_COMMAND_SOURCE_PATHS[command.site],
     };
 }
+function computeCommandFields(command) {
+    const contract = getComputeCommandContract(command);
+    if (!contract) {
+        throw new Error(`missing compute command contract for ${command}`);
+    }
+    return {
+        description: contract.description,
+        args: contract.args.map(toCoreDiscoveryArg),
+        ...(contract.channels ? { channels: contract.channels } : {}),
+    };
+}
+function toCoreDiscoveryArg(arg) {
+    return {
+        name: arg.name,
+        ...(arg.type === undefined ? {} : { type: arg.type }),
+        ...(arg.default === undefined ? {} : { default: arg.default }),
+        ...(arg.required === undefined ? {} : { required: arg.required }),
+        ...(arg.positional === undefined ? {} : { positional: arg.positional }),
+        ...(arg.choices === undefined ? {} : { choices: [...arg.choices] }),
+        ...(arg.description === undefined ? {} : { description: arg.description }),
+    };
+}
 //# sourceMappingURL=core-catalog.js.map