@helixlife-ai/xiantao 0.1.19 → 0.1.21

package/README.md

@@ -42,6 +42,11 @@ xt tool exec gsea_analysis --demo --profile opencode --json
 xt tool prepare gsea_plot --profile opencode --json
 xt tool exec gsea_plot --profile opencode --json --download ./gsea_plot.pdf
 xt tool exec gsea_customize --file gene_set=./gene_set.gmt --file data=./rank.xlsx --profile opencode --json
+
+xt tool cloud km_plot_gene --profile opencode --json --filter '胆管癌'
+xt tool exec km_plot_gene --profile opencode --json --cloudFilter '胆管癌'
+xt tool exec km_plot_gene --profile opencode --json --cloudFilter '胆管癌' --cloudIndex 1
+xt tool exec km_plot_gene --profile opencode --json --cloudDataId tcga-chol-2
 ```
 
 For machine callers, use `xt tool prepare` to fetch the final schema, then `xt tool exec` to submit. Keep `--json`, pass an explicit profile with `--profile`, and avoid interactive-only flows.
@@ -52,11 +57,15 @@ The examples below illustrate command shapes, not a fixed allowlist of tools. Ap
 - multi-upload modules: repeat `--file key=path`, for example `--file gene_set=./gene_set.gmt --file data=./rank.xlsx`
 - demo-capable upload modules: pass `--demo`
 - history-record modules such as `gsea_plot`: pass neither `--file` nor `--demo`; the CLI reuses the default `XTRecord` returned by `tool inspect` / `tool prepare`
+- cloud-capable modules: use `--cloudFilter <keyword>` to narrow cloud records, then retry with `--cloudIndex <n>` or `--cloudDataId <id>` when multiple matches exist
 
 Current operational notes for agent-style callers:
 - serialize `xt tool exec` submits per profile; Xiantao may reject overlapping or too-frequent submits with `NETWORK_ERROR`
 - `tool inspect` now includes the full `args_data` payload in JSON output and summarizes every detected `XTUpload` field
+- `tool inspect` also reports `inputs.cloud_available` and `inputs.cloud_default` for `XTCloud` modules
 - for multi-upload modules, pass keyed uploads in the same field names returned by `tool inspect`
+- `tool cloud --json --filter <keyword>` returns structured cloud candidates via `data.choices`
+- if `tool prepare` or `tool exec` returns `code=TOOL_AMBIGUOUS` with `data.selection_type=cloud_record`, do not auto-pick; ask the user which item to use, then retry with `--cloudIndex` or `--cloudDataId`
 - `gsea_customize` has been validated through `tool prepare` and `tool exec` with repeated `--file gene_set=... --file data=...`
 
 For agent workflows, do not use `xt tool run`. Treat `xt tool run` as the human-first path and `xt tool exec` as the machine path.
@@ -83,6 +92,7 @@ For agent workflows, do not use `xt tool run`. Treat `xt tool run` as the human-
 
 - `xt tool search`
 - `xt tool inspect`
+- `xt tool cloud`
 - `xt tool prepare`
 - `xt tool run`
 - `xt tool exec`
@@ -102,7 +112,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, the full `args_data` payload in JSON mode, and the detected input source summary, including per-field `XTUpload` defaults and `XTRecord` defaults. `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`; `--file` uploads a local file first; multi-upload modules accept repeated `--file key=path`; for `XTRecord` modules the CLI can submit directly from the default history record returned by `fetch-all`. 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, the full `args_data` payload in JSON mode, and the detected input source summary, including `XTCloud`, per-field `XTUpload`, and `XTRecord` defaults. `xt tool cloud <tool_id>` fetches paginated cloud candidates and returns a machine-friendly `data.choices` list when `--json` is used. `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`; `--file` uploads a local file first; multi-upload modules accept repeated `--file key=path`; for `XTRecord` modules the CLI can submit directly from the default history record returned by `fetch-all`; for `XTCloud` modules use `--cloudFilter`, then `--cloudIndex` or `--cloudDataId` to pin one cloud record before submit. Run `xt login` first to authorize the stored token. When cloud filtering matches multiple records, `tool prepare` and `tool exec` return `code=TOOL_AMBIGUOUS` plus `data.selection_type=cloud_record` and `data.choices`; callers should ask the user which record to use before retrying. When a tool exposes multiple downloadable results, `--download <path>` uses the output file extension to select the matching artifact.
 
 For the current GSEA tool family, `gsea_plot`, `gsea_plot2`, `gsea_bar`, `gsea_point`, `gsea_ridge`, `gsea_emapplot`, `gsea_tree`, and `gsea_path_cluster` are record-backed visual modules that reuse the default `gsea_analysis` history record. `gsea_analysis` itself is an upload/demo analysis module. `gsea_customize` is a custom gene-set upload module whose frontend expects two uploads, `gene_set` and `data`; submit it with `--file gene_set=... --file data=...`. A real CLI submit path has been verified with the sample files in [`docs/GSEA-基因集.csv`](/Users/chenyunjie/Desktop/xtz-cli/xiantao/docs/GSEA-基因集.csv) and [`docs/GSEA-分子.xlsx`](/Users/chenyunjie/Desktop/xtz-cli/xiantao/docs/GSEA-分子.xlsx).
 

package/dist/base-command.js

@@ -1,103 +1 @@
-import { Command } from '@oclif/core';
-import { createErrorEnvelope, createSuccessEnvelope } from './lib/envelope.js';
-import { XtzError } from './lib/errors.js';
-import { resolveAgent } from './lib/storage.js';
-import { getUpdateReminder } from './lib/update.js';
-export class XtzCommand extends Command {
-    async init() {
-        await super.init();
-        await this.warnIfUpdateAvailable();
-    }
-    async getProfile(profileFlag) {
-        return resolveAgent(profileFlag);
-    }
-    async getAgent(agentFlag) {
-        return this.getProfile(agentFlag);
-    }
-    print(flags, data, text, context) {
-        if (flags.json) {
-            if (context) {
-                this.log(JSON.stringify(createSuccessEnvelope(context.profile, context.command ?? this.getCommandName(), data), null, 2));
-                return;
-            }
-            this.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        this.log(text);
-    }
-    async catch(error) {
-        if (this.isJsonOutputRequested()) {
-            const profile = await this.getProfile(this.readProfileFlagFromArgv());
-            this.log(JSON.stringify(createErrorEnvelope(profile, this.getCommandName(), error), null, 2));
-            this.exit(1);
-        }
-        if (error instanceof XtzError) {
-            this.error(error.message, { exit: 1 });
-        }
-        throw error;
-    }
-    warnIfLegacyPlotCommand() {
-        if (!this.id?.startsWith('plot:') || this.argv.includes('--json')) {
-            return;
-        }
-        const command = this.id.replaceAll(':', ' ');
-        const replacement = command.replace(/^plot\b/, 'tool');
-        this.warn(`\`xt ${command}\` 已兼容保留，建议改用 \`xt ${replacement}\``);
-    }
-    warnIfLegacyAuthCommand() {
-        if (!this.id?.startsWith('auth:') || this.argv.includes('--json')) {
-            return;
-        }
-        const command = this.id.replaceAll(':', ' ');
-        const replacement = command.replace(/^auth /, '');
-        this.warn(`\`xt ${command}\` 已兼容保留，建议改用 \`xt ${replacement}\``);
-    }
-    async warnIfUpdateAvailable() {
-        if (this.argv.includes('--json') || !process.stdout.isTTY || this.shouldSkipUpdateReminder()) {
-            return;
-        }
-        const reminder = await getUpdateReminder(this.config.version);
-        if (!reminder) {
-            return;
-        }
-        this.warn(reminder);
-    }
-    getCommandName() {
-        return this.id?.replaceAll(':', ' ') ?? 'unknown';
-    }
-    isJsonOutputRequested() {
-        return this.argv.includes('--json');
-    }
-    readProfileFlagFromArgv() {
-        for (let index = 0; index < this.argv.length; index += 1) {
-            const token = this.argv[index];
-            if ((token === '--profile' || token === '--agent') && this.argv[index + 1]) {
-                return this.argv[index + 1];
-            }
-            if (token.startsWith('--profile=')) {
-                return token.slice('--profile='.length);
-            }
-            if (token.startsWith('--agent=')) {
-                return token.slice('--agent='.length);
-            }
-        }
-        return undefined;
-    }
-    shouldSkipUpdateReminder() {
-        const commandId = this.id ?? '';
-        return [
-            'login',
-            'logout',
-            'status',
-            'auth:login',
-            'auth:logout',
-            'auth:status',
-            'plot:login',
-            'plot:run',
-            'tool:exec',
-            'tool:login',
-            'tool:prepare',
-            'tool:run',
-        ].includes(commandId);
-    }
-}
+import{Command as n}from"@oclif/core";import{createErrorEnvelope as s,createSuccessEnvelope as o}from"./lib/envelope.js";import{XtzError as a}from"./lib/errors.js";import{resolveAgent as l}from"./lib/storage.js";import{getUpdateReminder as h}from"./lib/update.js";class f extends n{async init(){await super.init(),await this.warnIfUpdateAvailable()}async getProfile(t){return l(t)}async getAgent(t){return this.getProfile(t)}print(t,e,r,i){if(t.json){if(i){this.log(JSON.stringify(o(i.profile,i.command??this.getCommandName(),e),null,2));return}this.log(JSON.stringify(e,null,2));return}this.log(r)}async catch(t){if(this.isJsonOutputRequested()){const e=await this.getProfile(this.readProfileFlagFromArgv());this.log(JSON.stringify(s(e,this.getCommandName(),t),null,2)),this.exit(1)}throw t instanceof a&&this.error(t.message,{exit:1}),t}warnIfLegacyPlotCommand(){if(!this.id?.startsWith("plot:")||this.argv.includes("--json"))return;const t=this.id.replaceAll(":"," "),e=t.replace(/^plot\b/,"tool");this.warn(`\`xt ${t}\` \u5DF2\u517C\u5BB9\u4FDD\u7559\uFF0C\u5EFA\u8BAE\u6539\u7528 \`xt ${e}\``)}warnIfLegacyAuthCommand(){if(!this.id?.startsWith("auth:")||this.argv.includes("--json"))return;const t=this.id.replaceAll(":"," "),e=t.replace(/^auth /,"");this.warn(`\`xt ${t}\` \u5DF2\u517C\u5BB9\u4FDD\u7559\uFF0C\u5EFA\u8BAE\u6539\u7528 \`xt ${e}\``)}async warnIfUpdateAvailable(){if(this.argv.includes("--json")||!process.stdout.isTTY||this.shouldSkipUpdateReminder())return;const t=await h(this.config.version);t&&this.warn(t)}getCommandName(){return this.id?.replaceAll(":"," ")??"unknown"}isJsonOutputRequested(){return this.argv.includes("--json")}readProfileFlagFromArgv(){for(let t=0;t<this.argv.length;t+=1){const e=this.argv[t];if((e==="--profile"||e==="--agent")&&this.argv[t+1])return this.argv[t+1];if(e.startsWith("--profile="))return e.slice(10);if(e.startsWith("--agent="))return e.slice(8)}}shouldSkipUpdateReminder(){const t=this.id??"";return["login","logout","status","auth:login","auth:logout","auth:status","plot:login","plot:run","tool:exec","tool:login","tool:prepare","tool:run"].includes(t)}}export{f as XtzCommand};

package/dist/commands/auth/login.js

@@ -1,76 +1,2 @@
-import { Flags } from '@oclif/core';
-import { XtzCommand } from '../../base-command.js';
-import { globalFlags } from '../../lib/flags.js';
-import { loginAuth } from '../../lib/auth.js';
-import { loginAll } from '../../lib/login-flow.js';
-import { getTokenPath } from '../../lib/storage.js';
-export default class AuthLogin extends XtzCommand {
-    static description = 'Authorize the current profile token';
-    static flags = {
-        ...globalFlags,
-        open: Flags.boolean({
-            allowNo: true,
-            default: true,
-            description: 'Open the authorization link in the browser',
-        }),
-        wait: Flags.boolean({
-            allowNo: true,
-            default: true,
-            description: 'Wait until the browser authorization is confirmed before exiting',
-        }),
-    };
-    async run() {
-        this.warnIfLegacyAuthCommand();
-        const { flags } = await this.parse(AuthLogin);
-        const agent = await this.getProfile(flags.profile);
-        const waitForAuthorization = this.shouldWait(flags);
-        const result = waitForAuthorization
-            ? await loginAll(agent, flags.open, ({ auth, phase }) => {
-                if (flags.json) {
-                    return;
-                }
-                if (phase === 'auth_started') {
-                    this.log(auth.browserOpened ? '浏览器已打开授权链接，等待授权完成...' : `请先在浏览器中打开授权链接: ${auth.linkUrl}`);
-                    return;
-                }
-                this.log('授权已确认。');
-            })
-            : { auth: await loginAuth(agent, flags.open) };
-        const authorized = waitForAuthorization;
-        this.print(flags, {
-            agent,
-            authorization_pending: !authorized,
-            authorized,
-            browser_opened: result.auth.browserOpened,
-            link_url: result.auth.linkUrl,
-            token_path: result.auth.tokenPath,
-            wait: waitForAuthorization,
-        }, this.formatLoginText({
-            agent,
-            authorized,
-            browserOpened: result.auth.browserOpened,
-            linkUrl: result.auth.linkUrl,
-        }), { profile: agent });
-    }
-    shouldWait(flags) {
-        if (!this.hasExplicitWaitFlag()) {
-            return !flags.json;
-        }
-        return flags.wait;
-    }
-    hasExplicitWaitFlag() {
-        return this.argv.includes('--wait') || this.argv.includes('--no-wait');
-    }
-    formatLoginText(input) {
-        const lines = [
-            `profile: ${input.agent}`,
-            `token: ${getTokenPath(input.agent)}`,
-            `authorized: ${input.authorized}`,
-        ];
-        if (input.authorized) {
-            return lines.join('\n');
-        }
-        lines.push(input.browserOpened ? '浏览器已打开授权链接，请完成授权后运行 `xt status`。' : `请在浏览器中打开: ${input.linkUrl}`);
-        return lines.join('\n');
-    }
-}
+import{Flags as s}from"@oclif/core";import{XtzCommand as h}from"../../base-command.js";import{globalFlags as u}from"../../lib/flags.js";import{loginAuth as d}from"../../lib/auth.js";import{loginAll as p}from"../../lib/login-flow.js";import{getTokenPath as f}from"../../lib/storage.js";class a extends h{static description="Authorize the current profile token";static flags={...u,open:s.boolean({allowNo:!0,default:!0,description:"Open the authorization link in the browser"}),wait:s.boolean({allowNo:!0,default:!0,description:"Wait until the browser authorization is confirmed before exiting"})};async run(){this.warnIfLegacyAuthCommand();const{flags:t}=await this.parse(a),o=await this.getProfile(t.profile),i=this.shouldWait(t),e=i?await p(o,t.open,({auth:n,phase:l})=>{if(!t.json){if(l==="auth_started"){this.log(n.browserOpened?"\u6D4F\u89C8\u5668\u5DF2\u6253\u5F00\u6388\u6743\u94FE\u63A5\uFF0C\u7B49\u5F85\u6388\u6743\u5B8C\u6210...":`\u8BF7\u5148\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00\u6388\u6743\u94FE\u63A5: ${n.linkUrl}`);return}this.log("\u6388\u6743\u5DF2\u786E\u8BA4\u3002")}}):{auth:await d(o,t.open)},r=i;this.print(t,{agent:o,authorization_pending:!r,authorized:r,browser_opened:e.auth.browserOpened,link_url:e.auth.linkUrl,token_path:e.auth.tokenPath,wait:i},this.formatLoginText({agent:o,authorized:r,browserOpened:e.auth.browserOpened,linkUrl:e.auth.linkUrl}),{profile:o})}shouldWait(t){return this.hasExplicitWaitFlag()?t.wait:!t.json}hasExplicitWaitFlag(){return this.argv.includes("--wait")||this.argv.includes("--no-wait")}formatLoginText(t){const o=[`profile: ${t.agent}`,`token: ${f(t.agent)}`,`authorized: ${t.authorized}`];return t.authorized||o.push(t.browserOpened?"\u6D4F\u89C8\u5668\u5DF2\u6253\u5F00\u6388\u6743\u94FE\u63A5\uFF0C\u8BF7\u5B8C\u6210\u6388\u6743\u540E\u8FD0\u884C `xt status`\u3002":`\u8BF7\u5728\u6D4F\u89C8\u5668\u4E2D\u6253\u5F00: ${t.linkUrl}`),o.join(`
+`)}}export{a as default};

package/dist/commands/auth/logout.js

@@ -1,20 +1 @@
-import { XtzCommand } from '../../base-command.js';
-import { globalFlags } from '../../lib/flags.js';
-import { deleteToken, getTokenPath } from '../../lib/storage.js';
-export default class AuthLogout extends XtzCommand {
-    static description = 'Delete the stored token for the current profile';
-    static flags = {
-        ...globalFlags,
-    };
-    async run() {
-        this.warnIfLegacyAuthCommand();
-        const { flags } = await this.parse(AuthLogout);
-        const agent = await this.getProfile(flags.profile);
-        const removed = await deleteToken(agent);
-        this.print(flags, {
-            agent,
-            removed,
-            token_path: getTokenPath(agent),
-        }, removed ? `已删除 token: ${getTokenPath(agent)}` : `未找到 token: ${getTokenPath(agent)}`, { profile: agent });
-    }
-}
+import{XtzCommand as i}from"../../base-command.js";import{globalFlags as n}from"../../lib/flags.js";import{deleteToken as s,getTokenPath as e}from"../../lib/storage.js";class o extends i{static description="Delete the stored token for the current profile";static flags={...n};async run(){this.warnIfLegacyAuthCommand();const{flags:a}=await this.parse(o),t=await this.getProfile(a.profile),r=await s(t);this.print(a,{agent:t,removed:r,token_path:e(t)},r?`\u5DF2\u5220\u9664 token: ${e(t)}`:`\u672A\u627E\u5230 token: ${e(t)}`,{profile:t})}}export{o as default};

package/dist/commands/auth/status.js

@@ -1,60 +1,2 @@
-import { XtzCommand } from '../../base-command.js';
-import { XtzError } from '../../lib/errors.js';
-import { checkToken } from '../../lib/auth.js';
-import { globalFlags } from '../../lib/flags.js';
-import { getTokenPath, loadToken } from '../../lib/storage.js';
-export default class AuthStatus extends XtzCommand {
-    static description = 'Show token auth status for the current profile';
-    static flags = {
-        ...globalFlags,
-    };
-    async run() {
-        this.warnIfLegacyAuthCommand();
-        const { flags } = await this.parse(AuthStatus);
-        const agent = await this.getProfile(flags.profile);
-        const tokenPath = getTokenPath(agent);
-        const token = await loadToken(agent);
-        const status = !token
-            ? {
-                authorized: false,
-                reason: 'missing_token',
-            }
-            : await this.resolveAuthorization(agent, token);
-        this.print(flags, {
-            agent,
-            authorized: status.authorized,
-            reason: status.reason,
-            token_path: tokenPath,
-        }, this.formatStatusText(agent, tokenPath, status), { profile: agent });
-    }
-    async resolveAuthorization(agent, token) {
-        try {
-            await checkToken(agent, token);
-            return {
-                authorized: true,
-                reason: null,
-            };
-        }
-        catch (error) {
-            if (!(error instanceof XtzError) || !error.message.includes('授权已过期')) {
-                throw error;
-            }
-            return {
-                authorized: false,
-                reason: 'expired_token',
-            };
-        }
-    }
-    formatStatusText(agent, tokenPath, status) {
-        const lines = [
-            `profile: ${agent}`,
-            `authorized: ${status.authorized}`,
-            `token: ${tokenPath}`,
-        ];
-        if (!status.authorized && status.reason) {
-            lines.push(`reason: ${status.reason}`);
-            lines.push(`run: xt login --profile ${agent}`);
-        }
-        return lines.join('\n');
-    }
-}
+import{XtzCommand as n}from"../../base-command.js";import{XtzError as s}from"../../lib/errors.js";import{checkToken as h}from"../../lib/auth.js";import{globalFlags as u}from"../../lib/flags.js";import{getTokenPath as f,loadToken as l}from"../../lib/storage.js";class i extends n{static description="Show token auth status for the current profile";static flags={...u};async run(){this.warnIfLegacyAuthCommand();const{flags:e}=await this.parse(i),o=await this.getProfile(e.profile),t=f(o),r=await l(o),a=r?await this.resolveAuthorization(o,r):{authorized:!1,reason:"missing_token"};this.print(e,{agent:o,authorized:a.authorized,reason:a.reason,token_path:t},this.formatStatusText(o,t,a),{profile:o})}async resolveAuthorization(e,o){try{return await h(e,o),{authorized:!0,reason:null}}catch(t){if(!(t instanceof s)||!t.message.includes("\u6388\u6743\u5DF2\u8FC7\u671F"))throw t;return{authorized:!1,reason:"expired_token"}}}formatStatusText(e,o,t){const r=[`profile: ${e}`,`authorized: ${t.authorized}`,`token: ${o}`];return!t.authorized&&t.reason&&(r.push(`reason: ${t.reason}`),r.push(`run: xt login --profile ${e}`)),r.join(`
+`)}}export{i as default};

package/dist/commands/history/delete.js

@@ -1,38 +1 @@
-import { Args, Flags } from '@oclif/core';
-import { XtzCommand } from '../../base-command.js';
-import { getAuthContext } from '../../lib/auth.js';
-import { deleteXiantaoHistoryRecord, findXiantaoHistoryRecordByFuid } from '../../lib/history.js';
-import { globalFlags } from '../../lib/flags.js';
-export default class HistoryDelete extends XtzCommand {
-    static description = 'Delete a Xiantao history record';
-    static args = {
-        fuid: Args.string({
-            description: 'History record fuid',
-            required: true,
-        }),
-    };
-    static flags = {
-        ...globalFlags,
-        token: Flags.string({
-            description: 'Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token',
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(HistoryDelete);
-        const agent = await this.getProfile(flags.profile);
-        const auth = await getAuthContext(agent, flags.token);
-        const before = await findXiantaoHistoryRecordByFuid(auth, args.fuid);
-        await deleteXiantaoHistoryRecord(auth, { fuid: args.fuid });
-        const output = {
-            agent,
-            fuid: args.fuid,
-            module_id: before?.module_id?.trim() ?? '',
-            module_name: before?.module_name?.trim() ?? '',
-            name: before?.name?.trim() ?? '',
-        };
-        this.print(flags, output, args.fuid, {
-            command: 'history delete',
-            profile: agent,
-        });
-    }
-}
+import{Args as n,Flags as d}from"@oclif/core";import{XtzCommand as m}from"../../base-command.js";import{getAuthContext as f}from"../../lib/auth.js";import{deleteXiantaoHistoryRecord as l,findXiantaoHistoryRecordByFuid as u}from"../../lib/history.js";import{globalFlags as c}from"../../lib/flags.js";class r extends m{static description="Delete a Xiantao history record";static args={fuid:n.string({description:"History record fuid",required:!0})};static flags={...c,token:d.string({description:"Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token"})};async run(){const{args:t,flags:i}=await this.parse(r),e=await this.getProfile(i.profile),a=await f(e,i.token),o=await u(a,t.fuid);await l(a,{fuid:t.fuid});const s={agent:e,fuid:t.fuid,module_id:o?.module_id?.trim()??"",module_name:o?.module_name?.trim()??"",name:o?.name?.trim()??""};this.print(i,s,t.fuid,{command:"history delete",profile:e})}}export{r as default};

package/dist/commands/history/download.js

@@ -1,149 +1,5 @@
-import { Args, Flags } from '@oclif/core';
-import { XtzCommand } from '../../base-command.js';
-import { getAuthContext } from '../../lib/auth.js';
-import { XIANTAO_HISTORY_UUID } from '../../lib/constants.js';
-import { downloadToPath } from '../../lib/download.js';
-import { XtzError } from '../../lib/errors.js';
-import { fetchXiantaoHistoryDownloadButtons, findXiantaoHistoryRecordByFuid } from '../../lib/history.js';
-import { globalFlags } from '../../lib/flags.js';
-import { resolveXiantaoDownload } from '../../lib/xiantao-plot.js';
-export default class HistoryDownload extends XtzCommand {
-    static description = 'Download a file from a Xiantao history record';
-    static args = {
-        fuid: Args.string({
-            description: 'History record fuid',
-            required: true,
-        }),
-    };
-    static flags = {
-        ...globalFlags,
-        device: Flags.string({
-            description: 'Preferred device/format, e.g. pdf, xlsx, zip',
-        }),
-        item: Flags.integer({
-            description: 'Select a download item by its 1-based index from the listed results',
-        }),
-        label: Flags.string({
-            description: 'Select a download item by its label',
-        }),
-        output: Flags.string({
-            char: 'o',
-            description: 'Destination path; defaults to ~/Downloads/<file name>',
-        }),
-        token: Flags.string({
-            description: 'Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token',
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(HistoryDownload);
-        const agent = await this.getProfile(flags.profile);
-        const auth = await getAuthContext(agent, flags.token);
-        const record = await findXiantaoHistoryRecordByFuid(auth, args.fuid);
-        if (flags.item !== undefined && flags.label) {
-            throw new XtzError('`--item` 与 `--label` 不能同时使用。');
-        }
-        if (!record?.module_id?.trim()) {
-            throw new XtzError(`未找到 fuid 为 ${args.fuid} 的历史记录。`);
-        }
-        const result = await fetchXiantaoHistoryDownloadButtons(auth, { fuid: args.fuid });
-        const item = this.pickDownloadItem(result.downloads, {
-            device: flags.device,
-            item: flags.item,
-            label: flags.label,
-            outputPath: flags.output,
-        });
-        if (!item) {
-            throw new XtzError(this.buildMultipleDownloadsMessage(result.downloads));
-        }
-        const resolved = await resolveXiantaoDownload(auth, {
-            item,
-            moduleId: record.module_id.trim(),
-            uuid: XIANTAO_HISTORY_UUID,
-        });
-        const filePath = await downloadToPath(resolved.url, flags.output);
-        const output = {
-            agent,
-            device: item.device,
-            endpoint: item.endpoint,
-            file_name: resolved.fileName ?? item.label,
-            fuid: args.fuid,
-            module_id: record.module_id.trim(),
-            output: filePath,
-            url: resolved.url,
-        };
-        this.print(flags, output, filePath, {
-            command: 'history download',
-            profile: agent,
-        });
-    }
-    pickDownloadItem(downloads, input) {
-        if (input.item !== undefined) {
-            return this.pickDownloadItemByIndex(downloads, input.item);
-        }
-        if (input.label) {
-            return this.pickDownloadItemByLabel(downloads, input.label);
-        }
-        const normalizedExpectedDevice = this.normalizeDevice(input.device ?? this.inferDeviceFromOutputPath(input.outputPath));
-        if (normalizedExpectedDevice) {
-            const matched = downloads.filter((item) => this.normalizeDevice(item.device) === normalizedExpectedDevice);
-            if (matched.length === 1) {
-                return matched[0];
-            }
-        }
-        const results = downloads.filter((item) => item.endpoint === 'public.output.download-result');
-        if (results.length === 1) {
-            return results[0];
-        }
-        if (downloads.length === 1) {
-            return downloads[0];
-        }
-        return undefined;
-    }
-    pickDownloadItemByIndex(downloads, itemIndex) {
-        if (!Number.isInteger(itemIndex) || itemIndex < 1 || itemIndex > downloads.length) {
-            throw new XtzError(`下载项序号 ${itemIndex} 无效，可选范围为 1-${downloads.length}。\n${this.buildMultipleDownloadsMessage(downloads)}`);
-        }
-        return downloads[itemIndex - 1];
-    }
-    pickDownloadItemByLabel(downloads, expectedLabel) {
-        const normalizedExpectedLabel = expectedLabel.trim().toLowerCase();
-        if (!normalizedExpectedLabel) {
-            return undefined;
-        }
-        const matched = downloads.filter((item) => item.label.trim().toLowerCase() === normalizedExpectedLabel);
-        if (matched.length === 1) {
-            return matched[0];
-        }
-        if (matched.length > 1) {
-            throw new XtzError(`下载项名称 ${expectedLabel} 匹配到多个结果，请改用 \`--item\` 精确选择。\n${this.buildMultipleDownloadsMessage(downloads)}`);
-        }
-        return undefined;
-    }
-    inferDeviceFromOutputPath(outputPath) {
-        const extension = outputPath?.trim().split('.').pop()?.toLowerCase();
-        return extension ? this.normalizeDevice(extension) : undefined;
-    }
-    normalizeDevice(device) {
-        const normalized = device?.trim().toLowerCase();
-        if (!normalized) {
-            return undefined;
-        }
-        if (normalized === 'tif') {
-            return 'tiff';
-        }
-        if (normalized === 'jpg') {
-            return 'jpeg';
-        }
-        return normalized;
-    }
-    buildMultipleDownloadsMessage(downloads) {
-        const lines = [
-            '当前历史记录返回多个可下载结果，请传入 `--item`、`--label`、`--device`，或将 `--output` 改为带目标扩展名的文件名。',
-            '可选下载项：',
-        ];
-        downloads.forEach((item, index) => {
-            lines.push(`${index + 1}. ${item.label} (device=${item.device}, endpoint=${item.endpoint})`);
-        });
-        return lines.join('\n');
-    }
-}
+import{Args as m,Flags as l}from"@oclif/core";import{XtzCommand as p}from"../../base-command.js";import{getAuthContext as h}from"../../lib/auth.js";import{XIANTAO_HISTORY_UUID as g}from"../../lib/constants.js";import{downloadToPath as w}from"../../lib/download.js";import{XtzError as n}from"../../lib/errors.js";import{fetchXiantaoHistoryDownloadButtons as b,findXiantaoHistoryRecordByFuid as D}from"../../lib/history.js";import{globalFlags as v}from"../../lib/flags.js";import{resolveXiantaoDownload as y}from"../../lib/xiantao-plot.js";class d extends p{static description="Download a file from a Xiantao history record";static args={fuid:m.string({description:"History record fuid",required:!0})};static flags={...v,device:l.string({description:"Preferred device/format, e.g. pdf, xlsx, zip"}),item:l.integer({description:"Select a download item by its 1-based index from the listed results"}),label:l.string({description:"Select a download item by its label"}),output:l.string({char:"o",description:"Destination path; defaults to ~/Downloads/<file name>"}),token:l.string({description:"Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token"})};async run(){const{args:t,flags:e}=await this.parse(d),i=await this.getProfile(e.profile),o=await h(i,e.token),r=await D(o,t.fuid);if(e.item!==void 0&&e.label)throw new n("`--item` \u4E0E `--label` \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528\u3002");if(!r?.module_id?.trim())throw new n(`\u672A\u627E\u5230 fuid \u4E3A ${t.fuid} \u7684\u5386\u53F2\u8BB0\u5F55\u3002`);const u=await b(o,{fuid:t.fuid}),a=this.pickDownloadItem(u.downloads,{device:e.device,item:e.item,label:e.label,outputPath:e.output});if(!a)throw new n(this.buildMultipleDownloadsMessage(u.downloads));const s=await y(o,{item:a,moduleId:r.module_id.trim(),uuid:g}),f=await w(s.url,e.output),c={agent:i,device:a.device,endpoint:a.endpoint,file_name:s.fileName??a.label,fuid:t.fuid,module_id:r.module_id.trim(),output:f,url:s.url};this.print(e,c,f,{command:"history download",profile:i})}pickDownloadItem(t,e){if(e.item!==void 0)return this.pickDownloadItemByIndex(t,e.item);if(e.label)return this.pickDownloadItemByLabel(t,e.label);const i=this.normalizeDevice(e.device??this.inferDeviceFromOutputPath(e.outputPath));if(i){const o=t.filter(r=>this.normalizeDevice(r.device)===i);if(o.length===1)return o[0];if(o.length>1)throw new n(`\u4E0B\u8F7D\u683C\u5F0F ${i} \u5339\u914D\u5230\u591A\u4E2A\u7ED3\u679C\uFF0C\u8BF7\u6539\u7528 \`--item\` \u6216 \`--label\` \u7CBE\u786E\u9009\u62E9\u3002
+${this.buildMultipleDownloadsMessage(t)}`)}if(t.length===1)return t[0]}pickDownloadItemByIndex(t,e){if(!Number.isInteger(e)||e<1||e>t.length)throw new n(`\u4E0B\u8F7D\u9879\u5E8F\u53F7 ${e} \u65E0\u6548\uFF0C\u53EF\u9009\u8303\u56F4\u4E3A 1-${t.length}\u3002
+${this.buildMultipleDownloadsMessage(t)}`);return t[e-1]}pickDownloadItemByLabel(t,e){const i=e.trim().toLowerCase();if(!i)return;const o=t.filter(r=>r.label.trim().toLowerCase()===i);if(o.length===1)return o[0];if(o.length>1)throw new n(`\u4E0B\u8F7D\u9879\u540D\u79F0 ${e} \u5339\u914D\u5230\u591A\u4E2A\u7ED3\u679C\uFF0C\u8BF7\u6539\u7528 \`--item\` \u7CBE\u786E\u9009\u62E9\u3002
+${this.buildMultipleDownloadsMessage(t)}`)}inferDeviceFromOutputPath(t){const e=t?.trim().split(".").pop()?.toLowerCase();return e?this.normalizeDevice(e):void 0}normalizeDevice(t){const e=t?.trim().toLowerCase();if(e)return e==="tif"?"tiff":e==="jpg"?"jpeg":e}buildMultipleDownloadsMessage(t){const e=["\u5F53\u524D\u5386\u53F2\u8BB0\u5F55\u5305\u542B\u591A\u4E2A\u53EF\u4E0B\u8F7D\u6587\u4EF6\uFF0C\u8BF7\u4F7F\u7528 `--item`\u3001`--label` \u6216 `--device` \u660E\u786E\u9009\u62E9\u3002","\u53EF\u9009\u4E0B\u8F7D\u9879\uFF1A"];return t.forEach((i,o)=>{e.push(`${o+1}. ${i.label} (device=${i.device}, endpoint=${i.endpoint})`)}),e.join(`
+`)}}export{d as default};

package/dist/commands/history/list.js

@@ -1,72 +1,3 @@
-import { Flags } from '@oclif/core';
-import { XtzCommand } from '../../base-command.js';
-import { getAuthContext } from '../../lib/auth.js';
-import { fetchXiantaoHistoryRecords, getXiantaoHistoryRecordStatus } from '../../lib/history.js';
-import { globalFlags } from '../../lib/flags.js';
-export default class HistoryList extends XtzCommand {
-    static description = 'List Xiantao history records';
-    static flags = {
-        ...globalFlags,
-        page: Flags.integer({
-            default: 1,
-            description: 'History page number',
-            min: 1,
-        }),
-        token: Flags.string({
-            description: 'Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token',
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(HistoryList);
-        const agent = await this.getProfile(flags.profile);
-        const auth = await getAuthContext(agent, flags.token);
-        const page = await fetchXiantaoHistoryRecords(auth, { currentPage: flags.page });
-        const records = page.records.map((record) => ({
-            fuid: record.fuid?.trim() ?? '',
-            id: typeof record.id === 'number' ? record.id : null,
-            module_id: record.module_id?.trim() ?? '',
-            module_name: record.module_name?.trim() ?? '',
-            name: record.name?.trim() ?? '',
-            status: getXiantaoHistoryRecordStatus(record),
-            time: record.time?.trim() ?? '',
-            type: record.type?.trim() ?? '',
-        }));
-        const output = {
-            agent,
-            current_page: page.currentPage,
-            info: page.info,
-            last_page: page.lastPage,
-            per_page: page.perPage,
-            records,
-            total: page.total,
-        };
-        this.print(flags, output, this.formatHistoryText(page.currentPage, page.lastPage, page.total, records, page.info), {
-            command: 'history list',
-            profile: agent,
-        });
-    }
-    formatHistoryText(currentPage, lastPage, total, records, info) {
-        const lines = [`历史记录 ${total} 条，第 ${currentPage}/${lastPage} 页`];
-        if (records.length === 0) {
-            lines.push('');
-            lines.push('暂无历史记录');
-            return lines.join('\n');
-        }
-        for (const record of records) {
-            lines.push('');
-            lines.push(`${record.module_id || '-'}  ${record.module_name || '-'}`);
-            lines.push(`  status: ${record.status}`);
-            lines.push(`  time: ${record.time || '-'}`);
-            lines.push(`  type: ${record.type || '-'}`);
-            lines.push(`  fuid: ${record.fuid || '-'}`);
-            if (record.name) {
-                lines.push(`  name: ${record.name}`);
-            }
-        }
-        if (info) {
-            lines.push('');
-            lines.push(info);
-        }
-        return lines.join('\n');
-    }
-}
+import{Flags as m}from"@oclif/core";import{XtzCommand as u}from"../../base-command.js";import{getAuthContext as p}from"../../lib/auth.js";import{fetchXiantaoHistoryRecords as l,getXiantaoHistoryRecordStatus as f}from"../../lib/history.js";import{globalFlags as g}from"../../lib/flags.js";class r extends u{static description="List Xiantao history records";static flags={...g,page:m.integer({default:1,description:"History page number",min:1}),token:m.string({description:"Bearer token for agent.helixlife.cn xiantao APIs; falls back to the stored agent token"})};async run(){const{flags:i}=await this.parse(r),s=await this.getProfile(i.profile),n=await p(s,i.token),a=await l(n,{currentPage:i.page}),o=a.records.map(t=>({fuid:t.fuid?.trim()??"",id:typeof t.id=="number"?t.id:null,module_id:t.module_id?.trim()??"",module_name:t.module_name?.trim()??"",name:t.name?.trim()??"",status:f(t),time:t.time?.trim()??"",type:t.type?.trim()??""})),e={agent:s,current_page:a.currentPage,info:a.info,last_page:a.lastPage,per_page:a.perPage,records:o,total:a.total};this.print(i,e,this.formatHistoryText(a.currentPage,a.lastPage,a.total,o,a.info),{command:"history list",profile:s})}formatHistoryText(i,s,n,a,o){const e=[`\u5386\u53F2\u8BB0\u5F55 ${n} \u6761\uFF0C\u7B2C ${i}/${s} \u9875`];if(a.length===0)return e.push(""),e.push("\u6682\u65E0\u5386\u53F2\u8BB0\u5F55"),e.join(`
+`);for(const t of a)e.push(""),e.push(`${t.module_id||"-"}  ${t.module_name||"-"}`),e.push(`  status: ${t.status}`),e.push(`  time: ${t.time||"-"}`),e.push(`  type: ${t.type||"-"}`),e.push(`  fuid: ${t.fuid||"-"}`),t.name&&e.push(`  name: ${t.name}`);return o&&(e.push(""),e.push(o)),e.join(`
+`)}}export{r as default};