superun-ai-cli 0.1.0

package/dist/interactions/parsers/style-selection.d.ts

@@ -0,0 +1,15 @@
+import type { SessionView } from '../../contracts/node-wire.js';
+import type { JsonObject } from '../../contracts/value.js';
+import type { Choice } from '../../contracts/cli-output.js';
+export type StyleWaitTarget = {
+    preReplyMessageId: string;
+    choiceIds: Array<string>;
+};
+/** 根据本次并行创建响应固定等待目标，不能用历史批次替代。 */
+export declare function styleWaitTarget(response: JsonObject): StyleWaitTarget | undefined;
+/** 普通状态查询只判断最新批次，历史失败/运行记录不阻塞新批次。 */
+export declare function latestStyleChoices(choices: Array<Choice>): Array<Choice>;
+export declare function isStyleSelected(view: SessionView, choices?: Array<Choice>): boolean;
+export declare function styleBranchAnchor(view: SessionView): string | undefined;
+export declare function styleBatchState(choices: Array<Choice>): 'RUNNING' | 'NEEDS_SELECTION' | 'FAILED' | 'COMPLETED';
+export declare function projectChoices(response: unknown, anchor: string): Array<Choice>;

package/dist/interactions/parsers/style-selection.js

@@ -0,0 +1,77 @@
+/** Parallel 多批次结果映射为稳定候选 ID。@author xiuyu.yi */
+import { enabled, list, object, text } from '../../contracts/value.js';
+import { currentRound, roundMessage } from '../../conversation/round-selector.js';
+import { CliError } from '../../output/exit-codes.js';
+/** 根据本次并行创建响应固定等待目标，不能用历史批次替代。 */
+export function styleWaitTarget(response) {
+    if (!Array.isArray(response.items))
+        return undefined;
+    const anchor = text(response.preReplyMessageId);
+    const ids = response.items.map((item) => text(object(item).replyMessageId));
+    if (!anchor || !ids.length || ids.some((id) => !id) || new Set(ids).size !== ids.length)
+        throw new CliError('OUTCOME_UNKNOWN', '风格请求已返回，但缺少本批候选标识；请查询后确认，勿重复生成', {
+            sessionId: text(response.sessionId),
+        });
+    return { preReplyMessageId: anchor, choiceIds: ids.filter((id) => !!id) };
+}
+/** 普通状态查询只判断最新批次，历史失败/运行记录不阻塞新批次。 */
+export function latestStyleChoices(choices) {
+    const version = Math.max(...choices.map((choice) => choice.batchVersion ?? 0));
+    return choices.filter((choice) => (choice.batchVersion ?? 0) === version);
+}
+export function isStyleSelected(view, choices = []) {
+    const flag = roundMessage(view, currentRound(view))?.roundExtra?.hasSelectedStyle;
+    // 当前轮明确回到未选态时，不能被旧批次的已选记录覆盖。
+    return flag !== undefined ? enabled(flag) : latestStyleChoices(choices).some((choice) => choice.selected);
+}
+export function styleBranchAnchor(view) {
+    if (view.session.pendingBranch)
+        return view.session.pendingBranch.preReplyMessageId;
+    if (!isStyleSelected(view))
+        return undefined;
+    // 选择成功后未决标记会被清除，已选批次仍可通过主链风格卡的真实锚点查询。
+    return (view.pipeline.render?.rounds ?? [])
+        .filter((round) => !round.meta?.consult && !round.meta?.passive && !round.meta?.subAgentReport)
+        .sort((a, b) => b.time.timestamp - a.time.timestamp)
+        .find((round) => round.agentItems.some((item) => item.kind === 'card' && item.variant === 'style_card'))
+        ?.anchorUserMessageId;
+}
+export function styleBatchState(choices) {
+    if (choices.some((choice) => choice.selected))
+        return 'COMPLETED';
+    if (!choices.length ||
+        choices.some((choice) => choice.status === 'running' || (choice.status === 'success' && !choice.screenshotUrl)))
+        return 'RUNNING';
+    return choices.some((choice) => choice.status === 'success') ? 'NEEDS_SELECTION' : 'FAILED';
+}
+export function projectChoices(response, anchor) {
+    return list(object(response).items).flatMap((batch) => {
+        const entry = object(batch);
+        const info = object(entry.parallelInfo);
+        return list(info.items).map((value) => {
+            const item = object(value);
+            const reply = text(item.replyMessageId);
+            if (!reply || typeof item.index !== 'number')
+                throw new CliError('PROTOCOL_ERROR', '风格候选缺少稳定 ID');
+            const errorType = object(item.roundExtra).finish_reason === 'content_filter' ? 'content_filter' : text(item.errorType);
+            return {
+                choiceId: reply,
+                batchVersion: typeof entry.version === 'number' ? entry.version : undefined,
+                index: item.index,
+                preReplyMessageId: anchor,
+                replyMessageId: reply,
+                lastReplyMessageId: text(item.lastReplyMessageId),
+                status: errorType || item.status === -1
+                    ? 'failed'
+                    : item.status === 1
+                        ? 'success'
+                        : 'running',
+                // 风格阶段只返回截图，不推导页面快照链接。
+                screenshotUrl: text(item.snapshotUrl)?.trim() || undefined,
+                errorType,
+                selected: info.selectedReplyMessageId === reply,
+            };
+        });
+    });
+}
+//# sourceMappingURL=style-selection.js.map

package/dist/interactions/parsers/style-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-selection.js","sourceRoot":"","sources":["../../../src/interactions/parsers/style-selection.ts"],"names":[],"mappings":"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"}

package/dist/interactions/parsers/universal-ask-user.d.ts

@@ -0,0 +1,2 @@
+import type { InteractionParser } from '../context.js';
+export declare const parseUniversalAsk: InteractionParser;

package/dist/interactions/parsers/universal-ask-user.js

@@ -0,0 +1,15 @@
+/** 将结构化提问转换为普通对话回答。@author xiuyu.yi */
+import { bind } from '../context.js';
+import { ANSWER_JSON_SCHEMA, projectQuestions } from '../questions.js';
+import { CliError } from '../../output/exit-codes.js';
+export const parseUniversalAsk = (context) => {
+    if (!context.current || context.round.status !== 'completed')
+        return undefined;
+    if (context.item.payload.malformed === true)
+        throw new CliError('UNSUPPORTED_INTERACTION', '当前提问的结构不完整');
+    const questions = projectQuestions(context.item.payload.questions, true);
+    if (!questions.length)
+        throw new CliError('UNSUPPORTED_INTERACTION', '当前提问没有有效问题');
+    return bind(context, 'ASK_USER_MESSAGE', { questions, actions: ['SUBMIT'], schema: ANSWER_JSON_SCHEMA });
+};
+//# sourceMappingURL=universal-ask-user.js.map

package/dist/interactions/parsers/universal-ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-ask-user.js","sourceRoot":"","sources":["../../../src/interactions/parsers/universal-ask-user.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,OAAO,EAAE,EAAE;IAC9D,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IAC/E,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI;QACzC,MAAM,IAAI,QAAQ,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC3G,CAAC,CAAC"}

package/dist/interactions/questions.d.ts

@@ -0,0 +1,46 @@
+import type { Question } from '../contracts/cli-output.js';
+export declare function projectQuestions(raw: unknown, preserveIds?: boolean): Array<Question>;
+export declare function resolveAnswers(questions: Array<Question>, input: unknown): Array<{
+    question: Question;
+    selectedIndices: Array<number>;
+    selectedOptions: Array<string>;
+    otherValue: string;
+}>;
+export declare const ANSWER_JSON_SCHEMA: {
+    type: string;
+    required: string[];
+    additionalProperties: boolean;
+    properties: {
+        action: {
+            type: string;
+        };
+        styleCount: {
+            type: string;
+            minimum: number;
+            maximum: number;
+        };
+        answers: {
+            type: string;
+            items: {
+                type: string;
+                required: string[];
+                additionalProperties: boolean;
+                properties: {
+                    questionId: {
+                        type: string;
+                    };
+                    selectedIndices: {
+                        type: string;
+                        items: {
+                            type: string;
+                            minimum: number;
+                        };
+                    };
+                    otherValue: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+};

package/dist/interactions/questions.js

@@ -0,0 +1,95 @@
+/** 题目投影与按索引校验回答。@author xiuyu.yi */
+import { z } from 'zod';
+import { list, object, text } from '../contracts/value.js';
+import { CliError } from '../output/exit-codes.js';
+export function projectQuestions(raw, preserveIds = false) {
+    return list(raw).map((value, index) => {
+        const question = object(value);
+        const label = text(question.question);
+        if (!label?.trim())
+            throw new CliError('UNSUPPORTED_INTERACTION', '交互缺少有效问题文本');
+        const options = list(question.options).map((entry, optionIndex) => {
+            const fields = object(entry);
+            const optionLabel = text(entry) ?? text(fields.label);
+            if (!optionLabel?.trim())
+                throw new CliError('UNSUPPORTED_INTERACTION', '交互包含无法识别的选项');
+            return {
+                index: optionIndex,
+                label: optionLabel,
+                description: text(fields.description),
+                preview: text(fields.preview),
+            };
+        });
+        const recommended = question.recommended_index;
+        return {
+            id: preserveIds ? (text(question.id) ?? `q${index}`) : `q${index}`,
+            question: label,
+            header: text(question.header),
+            multiSelect: question.multiSelect === true,
+            allowOther: true,
+            options,
+            ...(typeof recommended === 'number' &&
+                Number.isInteger(recommended) &&
+                recommended >= 0 &&
+                recommended < options.length
+                ? { recommendedIndices: [recommended] }
+                : {}),
+        };
+    });
+}
+const answerSchema = z
+    .object({
+    questionId: z.string(),
+    selectedIndices: z.array(z.number().int().nonnegative()).default([]),
+    otherValue: z.string().default(''),
+})
+    .strict();
+export function resolveAnswers(questions, input) {
+    const parsed = z.array(answerSchema).safeParse(input);
+    if (!parsed.success)
+        throw new CliError('INVALID_ARGUMENT', 'answers 必须包含 questionId、selectedIndices 和可选 otherValue');
+    if (parsed.data.length !== questions.length ||
+        new Set(parsed.data.map((a) => a.questionId)).size !== questions.length) {
+        throw new CliError('INVALID_ARGUMENT', '每道问题必须且只能回答一次');
+    }
+    return questions.map((question) => {
+        const answer = parsed.data.find((item) => item.questionId === question.id);
+        if (!answer || new Set(answer.selectedIndices).size !== answer.selectedIndices.length)
+            throw new CliError('INVALID_ARGUMENT', '问题 ID 或选项下标重复/无效');
+        const otherValue = answer.otherValue.trim();
+        if (!answer.selectedIndices.length && !otherValue)
+            throw new CliError('INVALID_ARGUMENT', `请回答：${question.question}`);
+        if (!question.multiSelect && answer.selectedIndices.length + (otherValue ? 1 : 0) > 1)
+            throw new CliError('INVALID_ARGUMENT', `该题只允许单选：${question.question}`);
+        const selectedOptions = answer.selectedIndices.map((index) => {
+            const option = question.options[index];
+            if (!option)
+                throw new CliError('INVALID_ARGUMENT', '选项下标超出当前问题范围');
+            return option.label;
+        });
+        return { question, selectedIndices: answer.selectedIndices, selectedOptions, otherValue };
+    });
+}
+export const ANSWER_JSON_SCHEMA = {
+    type: 'object',
+    required: ['answers'],
+    additionalProperties: false,
+    properties: {
+        action: { type: 'string' },
+        styleCount: { type: 'integer', minimum: 1, maximum: 4 },
+        answers: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['questionId'],
+                additionalProperties: false,
+                properties: {
+                    questionId: { type: 'string' },
+                    selectedIndices: { type: 'array', items: { type: 'integer', minimum: 0 } },
+                    otherValue: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=questions.js.map

package/dist/interactions/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.js","sourceRoot":"","sources":["../../src/interactions/questions.ts"],"names":[],"mappings":"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"}

package/dist/interactions/registry.d.ts

@@ -0,0 +1,4 @@
+/** 交互类型到纯解析器的注册表。@author xiuyu.yi */
+import type { SessionView } from '../contracts/node-wire.js';
+import type { InteractionBinding } from './context.js';
+export declare function collectInteractions(view: SessionView, styleSelected?: boolean): Array<InteractionBinding>;

package/dist/interactions/registry.js

@@ -0,0 +1,64 @@
+import { currentRound, roundMessage } from '../conversation/round-selector.js';
+import { hasPendingCreationWork } from '../conversation/state-resolver.js';
+import { parsePrd } from './parsers/prd-clarification.js';
+import { parseAskTool } from './parsers/ask-user-tool.js';
+import { parseUniversalAsk } from './parsers/universal-ask-user.js';
+import { parseSecret } from './parsers/secret-input.js';
+import { parsePlugin } from './parsers/plugin-action.js';
+import { parseDdl } from './parsers/ddl-approval.js';
+import { semanticInteraction } from './parsers/semantic-action.js';
+import { isStyleSelected } from './parsers/style-selection.js';
+import { pendingTool, toolId } from './context.js';
+import { CliError } from '../output/exit-codes.js';
+const parsers = {
+    prd_questions: parsePrd,
+    ask_user_question: parseAskTool,
+    universal_ask_user: parseUniversalAsk,
+    tool_secrets_create: parseSecret,
+    tool_plugin_secrets_create: parseSecret,
+    tool_plugin: parsePlugin,
+    tool_execute_ddl: parseDdl,
+};
+export function collectInteractions(view, styleSelected = isStyleSelected(view)) {
+    const latest = currentRound(view);
+    const bindings = [];
+    for (const round of view.pipeline.render?.rounds ?? []) {
+        if (round.meta?.consult || round.meta?.passive)
+            continue;
+        for (const item of round.agentItems) {
+            if (pendingTool(item) &&
+                !toolId(item) &&
+                !(item.variant === 'tool_execute_ddl' && item.payload.autoApprove === true)) {
+                throw new CliError('UNSUPPORTED_INTERACTION', '等待中的工具缺少可回复标识', {
+                    variant: item.variant,
+                    sessionId: view.session.sessionId,
+                });
+            }
+            const parser = parsers[item.variant];
+            if (!parser) {
+                if (pendingTool(item))
+                    throw new CliError('UNSUPPORTED_INTERACTION', '当前 CLI 尚未支持该阻断交互', {
+                        variant: item.variant,
+                        sessionId: view.session.sessionId,
+                    });
+                continue;
+            }
+            const binding = parser({
+                item,
+                round,
+                view,
+                current: round.roundId === latest?.roundId,
+                message: roundMessage(view, round),
+            });
+            if (binding)
+                bindings.push(binding);
+        }
+    }
+    if (bindings.length === 0 && (!view.session.pendingBranch || styleSelected)) {
+        const semantic = semanticInteraction(view, latest, roundMessage(view, latest));
+        if (semantic && !(semantic.interaction.kind === 'SELECT_FEATURES' && hasPendingCreationWork(view)))
+            bindings.push(semantic);
+    }
+    return [...new Map(bindings.map((binding) => [binding.interaction.interactionId, binding])).values()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/interactions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/interactions/registry.ts"],"names":[],"mappings":"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"}

package/dist/output/exit-codes.d.ts

@@ -0,0 +1,22 @@
+/** 对外错误与退出码。@author xiuyu.yi */
+export declare const EXIT_CODES: {
+    readonly INVALID_ARGUMENT: 2;
+    readonly AUTH_REQUIRED: 3;
+    readonly UPDATE_REQUIRED: 4;
+    readonly UPDATE_FAILED: 4;
+    readonly VERSION_CHECK_FAILED: 4;
+    readonly BUSINESS_ERROR: 5;
+    readonly STALE_INTERACTION: 5;
+    readonly AMBIGUOUS_INTERACTION: 5;
+    readonly OUTCOME_UNKNOWN: 5;
+    readonly UNSUPPORTED_INTERACTION: 6;
+    readonly LOCAL_WAIT_TIMEOUT: 7;
+    readonly PROTOCOL_ERROR: 8;
+    readonly INTERRUPTED: 130;
+};
+export type ErrorCode = keyof typeof EXIT_CODES;
+export declare class CliError extends Error {
+    readonly code: ErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown>);
+}

package/dist/output/exit-codes.js

@@ -0,0 +1,27 @@
+/** 对外错误与退出码。@author xiuyu.yi */
+export const EXIT_CODES = {
+    INVALID_ARGUMENT: 2,
+    AUTH_REQUIRED: 3,
+    UPDATE_REQUIRED: 4,
+    UPDATE_FAILED: 4,
+    VERSION_CHECK_FAILED: 4,
+    BUSINESS_ERROR: 5,
+    STALE_INTERACTION: 5,
+    AMBIGUOUS_INTERACTION: 5,
+    OUTCOME_UNKNOWN: 5,
+    UNSUPPORTED_INTERACTION: 6,
+    LOCAL_WAIT_TIMEOUT: 7,
+    PROTOCOL_ERROR: 8,
+    INTERRUPTED: 130,
+};
+export class CliError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'CliError';
+    }
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/output/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/output/exit-codes.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,oBAAoB,EAAE,CAAC;IACvB,cAAc,EAAE,CAAC;IACjB,iBAAiB,EAAE,CAAC;IACpB,qBAAqB,EAAE,CAAC;IACxB,eAAe,EAAE,CAAC;IAClB,uBAAuB,EAAE,CAAC;IAC1B,kBAAkB,EAAE,CAAC;IACrB,cAAc,EAAE,CAAC;IACjB,WAAW,EAAE,GAAG;CACR,CAAC;AAIX,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEtB;IAEA;IAHX,YACW,IAAe,EACxB,OAAe,EACN,UAAmC,EAAE;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAW;QAEf,YAAO,GAAP,OAAO,CAA8B;QAG9C,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/output/writer.d.ts

@@ -0,0 +1,13 @@
+export declare class OutputWriter {
+    private readonly stdout;
+    private readonly stderr;
+    private written;
+    private readonly secrets;
+    constructor(stdout?: (text: string) => void, stderr?: (text: string) => void);
+    registerSecret(secret: string): void;
+    redact(text: string): string;
+    log(text: string): void;
+    write(data: unknown): void;
+    fail(error: unknown): number;
+    private emit;
+}

package/dist/output/writer.js

@@ -0,0 +1,53 @@
+/** stdout 单结果输出，敏感值统一脱敏。@author xiuyu.yi */
+import { SCHEMA_VERSION } from '../config/constants.js';
+import { CliError, EXIT_CODES } from './exit-codes.js';
+const SENSITIVE_KEY = /^(?:pat|token|access[-_]?token|private[-_]?token|gatewayToken|authorization|password|secret|secrets|secretValues|apiKey|api_key|rowKey|authToken)$/i;
+export class OutputWriter {
+    stdout;
+    stderr;
+    written = false;
+    secrets = new Set();
+    constructor(stdout = (text) => process.stdout.write(text), stderr = (text) => process.stderr.write(text)) {
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+    registerSecret(secret) {
+        if (secret)
+            this.secrets.add(secret);
+    }
+    redact(text) {
+        let safe = text.replace(/sup_pat_[A-Za-z0-9_-]+/g, '[已隐藏]');
+        for (const secret of this.secrets)
+            safe = safe.split(secret).join('[已隐藏]');
+        return safe;
+    }
+    log(text) {
+        this.stderr(`${this.redact(text)}\n`);
+    }
+    write(data) {
+        this.emit({ schemaVersion: SCHEMA_VERSION, ok: true, data });
+    }
+    fail(error) {
+        const failure = error instanceof CliError
+            ? error
+            : new CliError('PROTOCOL_ERROR', '命令执行失败，请检查网络与接口契约');
+        this.emit({
+            schemaVersion: SCHEMA_VERSION,
+            ok: false,
+            error: {
+                ...failure.details,
+                code: failure.code,
+                message: failure.message,
+            },
+        });
+        return EXIT_CODES[failure.code];
+    }
+    emit(value) {
+        if (this.written)
+            return;
+        this.written = true;
+        const serialized = JSON.stringify(value, (key, item) => SENSITIVE_KEY.test(key) ? undefined : typeof item === 'string' ? this.redact(item) : item);
+        this.stdout(`${this.redact(serialized)}\n`);
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/output/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/output/writer.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,aAAa,GACjB,qJAAqJ,CAAC;AAExJ,MAAM,OAAO,YAAY;IAKJ;IACA;IALX,OAAO,GAAG,KAAK,CAAC;IACP,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YACmB,SAAiC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EACrE,SAAiC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QADrE,WAAM,GAAN,MAAM,CAA+D;QACrE,WAAM,GAAN,MAAM,CAA+D;IACrF,CAAC;IAEJ,cAAc,CAAC,MAAc;QAC3B,IAAI,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;QAC5D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAa;QACjB,IAAI,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,KAAc;QACjB,MAAM,OAAO,GACX,KAAK,YAAY,QAAQ;YACvB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC;YACR,aAAa,EAAE,cAAc;YAC7B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB;SACF,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,IAAI,CAAC,KAAc;QACzB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAa,EAAE,EAAE,CAC9D,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAC1F,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/program.d.ts

@@ -0,0 +1,9 @@
+/** 命令树与公共选项。@author xiuyu.yi */
+import { Command } from 'commander';
+import type { CommandContext } from './commands/shared.js';
+export declare function createProgram(context: CommandContext, hooks: {
+    beforeBusiness: () => Promise<void>;
+    update: () => Promise<{
+        version: string;
+    }>;
+}): Command;

package/dist/program.js

@@ -0,0 +1,39 @@
+/** 命令树与公共选项。@author xiuyu.yi */
+import { Command } from 'commander';
+import { COMMAND_NAME, PACKAGE_VERSION } from './config/constants.js';
+import { requireCredentials } from './commands/shared.js';
+import { registerAuth } from './commands/auth/index.js';
+import { registerSession } from './commands/session/index.js';
+import { registerChat } from './commands/chat/index.js';
+import { registerUpdate } from './commands/system/update.js';
+import { registerVersion } from './commands/system/version.js';
+export function createProgram(context, hooks) {
+    const program = new Command()
+        .name(COMMAND_NAME)
+        .description('superun-ai 项目管理、对话创作和应用发布')
+        .version(PACKAGE_VERSION)
+        .option('--endpoint <URL>', 'API 地址')
+        .option('--locale <language>', '回复语言', 'zh-CN')
+        .exitOverride()
+        .configureOutput({ writeErr: () => undefined });
+    program.hook('preAction', async (_root, action) => {
+        context.connection = undefined;
+        const rootCommand = action.parent === program;
+        const authCommand = action.parent?.name() === 'auth' && action.parent.parent === program;
+        const offline = (rootCommand && (action.name() === 'version' || action.name() === 'update')) ||
+            (authCommand && action.name() === 'logout');
+        if (offline || action === program)
+            return;
+        await hooks.beforeBusiness();
+        if (!(authCommand && action.name() === 'login'))
+            await requireCredentials(context, action, !authCommand && Boolean(process.stdin.isTTY));
+    });
+    registerAuth(program, context);
+    registerSession(program, context);
+    registerChat(program, context);
+    registerUpdate(program, context.output, hooks.update);
+    registerVersion(program, context.output);
+    program.action(() => program.help());
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,UAAU,aAAa,CAC3B,OAAuB,EACvB,KAGC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,2BAA2B,CAAC;SACxC,OAAO,CAAC,eAAe,CAAC;SACxB,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC;SACpC,MAAM,CAAC,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC;SAC9C,YAAY,EAAE;SACd,eAAe,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC;QAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC;QACzF,MAAM,OAAO,GACX,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC;YAC5E,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC;QAC9C,IAAI,OAAO,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO;QAC1C,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;YAC7C,MAAM,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,11 @@
+import { OutputWriter } from './output/writer.js';
+import { PatStore } from './auth/pat-store.js';
+import { versionGate } from './update/version-gate.js';
+import type { CommandContext } from './commands/shared.js';
+export type RunnerOptions = {
+    output?: OutputWriter;
+    patStore?: PatStore;
+    makeRuntime?: CommandContext['makeRuntime'];
+    checkVersion?: typeof versionGate;
+};
+export declare function runCli(argv: Array<string>, options?: RunnerOptions): Promise<number>;

package/dist/runner.js

@@ -0,0 +1,54 @@
+/** 进程生命周期与统一错误出口。@author xiuyu.yi */
+import { CommanderError } from 'commander';
+import { createProgram } from './program.js';
+import { OutputWriter } from './output/writer.js';
+import { CliError } from './output/exit-codes.js';
+import { PatStore } from './auth/pat-store.js';
+import { versionGate } from './update/version-gate.js';
+class Reexecuted extends Error {
+    exitCode;
+    constructor(exitCode) {
+        super('reexecuted');
+        this.exitCode = exitCode;
+    }
+}
+export async function runCli(argv, options = {}) {
+    const output = options.output ?? new OutputWriter(), controller = new AbortController();
+    const interrupt = () => controller.abort();
+    process.once('SIGINT', interrupt);
+    process.once('SIGTERM', interrupt);
+    const checkVersion = options.checkVersion ?? versionGate;
+    const context = {
+        output,
+        signal: controller.signal,
+        patStore: options.patStore ?? new PatStore(),
+        makeRuntime: options.makeRuntime,
+    };
+    try {
+        const program = createProgram(context, {
+            beforeBusiness: async () => {
+                const result = await checkVersion(argv, output);
+                if (result.reexecuted)
+                    throw new Reexecuted(result.exitCode ?? 0);
+            },
+            update: () => versionGate(argv, output, true),
+        });
+        await program.parseAsync(argv, { from: 'user' });
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof Reexecuted)
+            return error.exitCode;
+        if (error instanceof CommanderError) {
+            if (error.exitCode === 0)
+                return 0;
+            return output.fail(new CliError('INVALID_ARGUMENT', error.message));
+        }
+        return output.fail(error);
+    }
+    finally {
+        process.off('SIGINT', interrupt);
+        process.off('SIGTERM', interrupt);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,UAAW,SAAQ,KAAK;IACP;IAArB,YAAqB,QAAgB;QACnC,KAAK,CAAC,YAAY,CAAC,CAAC;QADD,aAAQ,GAAR,QAAQ,CAAQ;IAErC,CAAC;CACF;AAOD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAmB,EAAE,UAAyB,EAAE;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,YAAY,EAAE,EACjD,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,WAAW,CAAC;IACzD,MAAM,OAAO,GAAmB;QAC9B,MAAM;QACN,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,QAAQ,EAAE;QAC5C,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;IACF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE;YACrC,cAAc,EAAE,KAAK,IAAI,EAAE;gBACzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAChD,IAAI,MAAM,CAAC,UAAU;oBAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,UAAU;YAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;QACvD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}