@helixlife-ai/xiantao 0.1.16 → 0.1.17

package/README.md

@@ -75,6 +75,7 @@ For agent workflows, do not use `xt tool run`. Treat `xt tool run` as the human-
 - `xt tool resolve`
 - `xt tool menu`
 - `xt tool menus`
+- `xt tool menus-raw`
 - `xt tool fetch-all`
 
 ## Notes
@@ -83,7 +84,7 @@ For the common Xiantao tool product, `tool search`, `tool inspect`, `tool run`,
 
 The CLI also loads a project-root `.env` file on startup. You can set `XIANTAO_BASE_URL=https://agent.helixlife.cn` there to switch the API base URL without prefixing each command manually.
 
-`xt tool search <keyword>` searches remote tool menus by tool id, title, path, and route. `xt tool inspect <tool_id>` prints resolved metadata together with the dynamic `args_main` schema used by the tool. `xt tool run <tool_id>` runs a Xiantao bioinformatics tool in the human-first path. `xt tool exec <tool_id>` is the agent-safe submit command and also supports `--download <path>` when a local artifact is needed. `xt tool resolve <tool_id>` remains available as the low-level UUID and route lookup. `--demo` reuses the demo file metadata returned by `tool fetch-all`; otherwise `tool run` uploads the local file first and therefore also needs token auth. Run `xt login` first to authorize the stored token. When a tool exposes multiple downloadable results, `--download <path>` uses the output file extension to select the matching artifact.
+`xt tool search <keyword>` searches remote tool menus by tool id, title, path, and route. `xt tool inspect <tool_id>` prints resolved metadata together with the dynamic `args_main` schema used by the tool. `xt tool run <tool_id>` runs a Xiantao bioinformatics tool in the human-first path. `xt tool exec <tool_id>` is the agent-safe submit command and also supports `--download <path>` when a local artifact is needed. `xt tool resolve <tool_id>` remains available as the low-level UUID and route lookup. `xt tool menus` returns a concise catalog with each tool title, `module_id`, `path`, and `route`, which is useful when `tool search` finds nothing helpful or when you want to shortlist tools for recommendation. `--demo` reuses the demo file metadata returned by `tool fetch-all`; otherwise `tool run` uploads the local file first and therefore also needs token auth. Run `xt login` first to authorize the stored token. When a tool exposes multiple downloadable results, `--download <path>` uses the output file extension to select the matching artifact.
 
 `xt tool run <tool_id> ... --interactive` prompts for dynamic `args_main` values before the final submit, prints reusable `--set` flags, and supports `<` for the previous item plus `/skip` for the current section.
 

package/dist/commands/plot/menus-raw.js

@@ -0,0 +1,31 @@
+import { Flags } from '@oclif/core';
+import { XtzCommand } from '../../base-command.js';
+import { getAuthContext } from '../../lib/auth.js';
+import { globalFlags } from '../../lib/flags.js';
+import { resolveXiantaoToolProductUuid } from '../../lib/storage.js';
+import { fetchToolMenus } from '../../lib/xiantao.js';
+export default class PlotMenusRaw extends XtzCommand {
+    static description = 'Fetch all raw Xiantao menu metadata for a tool product';
+    static flags = {
+        ...globalFlags,
+        token: Flags.string({
+            description: 'Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token',
+        }),
+        toolProductUuid: Flags.string({
+            description: 'tool_product_uuid used in the menu filter payload; defaults to the main Xiantao product UUID',
+        }),
+    };
+    async run() {
+        this.warnIfLegacyPlotCommand();
+        const { flags } = await this.parse(PlotMenusRaw);
+        const agent = await this.getProfile(flags.profile);
+        const auth = await getAuthContext(agent, flags.token);
+        const toolProductUuid = await resolveXiantaoToolProductUuid(flags.toolProductUuid);
+        const menus = await fetchToolMenus(auth, toolProductUuid);
+        this.print(flags, {
+            agent,
+            menus,
+            tool_product_uuid: toolProductUuid,
+        }, JSON.stringify(menus, null, 2), { profile: agent });
+    }
+}

package/dist/commands/plot/menus.js

@@ -3,9 +3,9 @@ import { XtzCommand } from '../../base-command.js';
 import { getAuthContext } from '../../lib/auth.js';
 import { globalFlags } from '../../lib/flags.js';
 import { resolveXiantaoToolProductUuid } from '../../lib/storage.js';
-import { fetchToolMenus } from '../../lib/xiantao.js';
+import { fetchToolMenus, listToolMenuSummaries } from '../../lib/xiantao.js';
 export default class PlotMenus extends XtzCommand {
-    static description = 'Fetch all Xiantao menu metadata for a tool product';
+    static description = 'List Xiantao tools with title, tool id, path, and route for a product';
     static flags = {
         ...globalFlags,
         token: Flags.string({
@@ -21,11 +21,27 @@ export default class PlotMenus extends XtzCommand {
         const agent = await this.getProfile(flags.profile);
         const auth = await getAuthContext(agent, flags.token);
         const toolProductUuid = await resolveXiantaoToolProductUuid(flags.toolProductUuid);
-        const menus = await fetchToolMenus(auth, toolProductUuid);
+        const menus = listToolMenuSummaries(await fetchToolMenus(auth, toolProductUuid));
         this.print(flags, {
             agent,
             menus,
             tool_product_uuid: toolProductUuid,
-        }, JSON.stringify(menus, null, 2), { profile: agent });
+        }, this.formatMenusText(menus), { profile: agent });
+    }
+    formatMenusText(menus) {
+        if (menus.length === 0) {
+            return '未找到可用工具';
+        }
+        const lines = [`共 ${menus.length} 个工具`];
+        for (const menu of menus) {
+            lines.push('');
+            lines.push(`${menu.title}`);
+            lines.push(`  ${menu.module_id}`);
+            if (menu.path) {
+                lines.push(`  ${menu.path}`);
+            }
+            lines.push(`  ${menu.route}`);
+        }
+        return lines.join('\n');
     }
 }

package/dist/commands/tool/menus-raw.js

@@ -0,0 +1,3 @@
+import PlotMenusRaw from '../plot/menus-raw.js';
+export default class ToolMenusRaw extends PlotMenusRaw {
+}

package/dist/lib/xiantao.js

@@ -48,6 +48,14 @@ export async function resolveToolMenuByCode(auth, toolProductUuid, code) {
 export function listResolvedToolMenus(menus) {
     return collectToolMenuMatches(menus);
 }
+export function listToolMenuSummaries(menus) {
+    return listResolvedToolMenus(menus).map((menu) => ({
+        module_id: menu.code,
+        path: menu.path,
+        route: menu.route,
+        title: menu.title,
+    }));
+}
 export function searchResolvedToolMenus(menus, keyword) {
     const normalizedKeyword = keyword.trim().toLowerCase();
     return listResolvedToolMenus(menus)

package/dist/xtz-help.js

@@ -73,7 +73,8 @@ export default class XtzHelp extends Help {
             ['xt history --help', 'Show the history command set'],
             ['xt tool resolve', 'Resolve a tool id to UUID and route'],
             ['xt tool menu', 'Fetch one raw tool menu by UUID'],
-            ['xt tool menus', 'Fetch all raw tool menus for a product'],
+            ['xt tool menus', 'List tool titles and ids for a product'],
+            ['xt tool menus-raw', 'Fetch all raw tool menus for a product'],
             ['xt tool fetch-all', 'Fetch raw dynamic args for a tool'],
             ['xt tool prepare', 'Resolve upload-dependent dynamic schema for agent workflows'],
             ['xt auth ...', 'Legacy auth topic kept for compatibility'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helixlife-ai/xiantao",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "CLI for Xiantao bioinformatics tools",
   "type": "module",
   "main": "dist/index.js",