superun-ai-cli 0.1.0

package/dist/contracts/node-wire.js

@@ -0,0 +1,102 @@
+/** 会话 API 响应契约；通过运行时校验后再处理。@author xiuyu.yi */
+import { z } from 'zod';
+import { CliError } from '../output/exit-codes.js';
+const extra = z.record(z.unknown());
+export const itemSchema = z
+    .object({
+    id: z.string(),
+    kind: z.string(),
+    variant: z.string(),
+    role: z.string().optional(),
+    intent: z.string().optional(),
+    source: z
+        .object({ messageId: z.string().optional(), contentId: z.string().optional() })
+        .passthrough()
+        .optional(),
+    payload: extra.default({}),
+})
+    .passthrough();
+export const roundSchema = z
+    .object({
+    roundId: z.string(),
+    sessionId: z.string(),
+    anchorUserMessageId: z.string(),
+    status: z.enum(['running', 'completed', 'failed', 'interrupted']),
+    time: z.object({ timestamp: z.number() }).passthrough(),
+    userItems: z.array(itemSchema),
+    agentItems: z.array(itemSchema),
+    activity: extra.optional(),
+    meta: extra.optional(),
+})
+    .passthrough();
+export const messageSchema = z
+    .object({
+    messageId: z.string(),
+    sessionId: z.string(),
+    role: z.number(),
+    createdAt: z.number(),
+    replyMessageId: z.string().optional(),
+    status: z.number().optional(),
+    sessionStatus: z.number().optional(),
+    sessionErrorType: z.string().optional(),
+    extra: extra.optional(),
+    roundExtra: extra.optional(),
+    displayContents: z.array(extra).default([]),
+    meta: extra.optional(),
+})
+    .passthrough();
+export const pipelineSchema = z
+    .object({
+    messages: z.array(messageSchema),
+    render: z
+        .object({ rounds: z.array(roundSchema) })
+        .passthrough()
+        .optional(),
+    roundPatch: z
+        .object({
+        roundId: z.string(),
+        targetMessageId: z.string(),
+        anchorUserMessageId: z.string(),
+        patch: z
+            .object({
+            operation: z.enum(['upsert-round', 'replace-agent-items', 'replace-user-items']),
+            round: roundSchema.optional(),
+            agentItems: z.array(itemSchema).optional(),
+            userItems: z.array(itemSchema).optional(),
+            status: roundSchema.shape.status.optional(),
+            meta: extra.optional(),
+            activity: extra.optional(),
+            time: roundSchema.shape.time.optional(),
+        })
+            .passthrough(),
+    })
+        .passthrough()
+        .optional(),
+    pollingHint: z
+        .object({ nextPollAfterMs: z.number(), bypassIfNoneMatch: z.boolean().optional() })
+        .optional(),
+})
+    .passthrough();
+export const recentlySchema = z.object({
+    session: z
+        .object({
+        sessionId: z.string(),
+        topic: z.string(),
+        status: z.number(),
+        errorType: z.string().optional(),
+        pendingBranch: z.object({ preReplyMessageId: z.string() }).optional(),
+        everDeployed: z.boolean().optional(),
+        publicStatus: z.number().optional(),
+    })
+        .passthrough(),
+    pipeline: pipelineSchema,
+});
+export function parseWire(schema, data) {
+    const parsed = schema.safeParse(data);
+    if (!parsed.success)
+        throw new CliError('PROTOCOL_ERROR', 'API 响应与当前 CLI 契约不兼容', {
+            fields: parsed.error.issues.map((issue) => issue.path.join('.')),
+        });
+    return parsed.data;
+}
+//# sourceMappingURL=node-wire.js.map

package/dist/contracts/node-wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-wire.js","sourceRoot":"","sources":["../../src/contracts/node-wire.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;SAC9E,WAAW,EAAE;SACb,QAAQ,EAAE;IACb,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3B,CAAC;KACD,WAAW,EAAE,CAAC;AACjB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE;IACvD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC9B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;IAC1B,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE;CACvB,CAAC;KACD,WAAW,EAAE,CAAC;AACjB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;IACvB,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE;CACvB,CAAC;KACD,WAAW,EAAE,CAAC;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;SACxC,WAAW,EAAE;SACb,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC/B,KAAK,EAAE,CAAC;aACL,MAAM,CAAC;YACN,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;YAChF,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC7B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;YAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;YACzC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC3C,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YAC1B,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;SACxC,CAAC;aACD,WAAW,EAAE;KACjB,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;IACb,WAAW,EAAE,CAAC;SACX,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;SAClF,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;QACrE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC;SACD,WAAW,EAAE;IAChB,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC;AAYH,MAAM,UAAU,SAAS,CAAI,MAA2C,EAAE,IAAa;IACrF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO;QACjB,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,EAAE;YAC1D,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACjE,CAAC,CAAC;IACL,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/contracts/value.d.ts

@@ -0,0 +1,6 @@
+export type JsonObject = Record<string, unknown>;
+export declare function object(value: unknown): JsonObject;
+export declare function text(value: unknown): string | undefined;
+export declare function list(value: unknown): Array<unknown>;
+export declare function requiredText(value: unknown, field: string): string;
+export declare function enabled(value: unknown): boolean;

package/dist/contracts/value.js

@@ -0,0 +1,20 @@
+/** 未知接口字段的窄化工具。@author xiuyu.yi */
+import { CliError } from '../output/exit-codes.js';
+export function object(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+}
+export function text(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+export function list(value) {
+    return Array.isArray(value) ? value : [];
+}
+export function requiredText(value, field) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new CliError('INVALID_ARGUMENT', `${field} 不能为空`);
+    return value;
+}
+export function enabled(value) {
+    return value === true || value === 1 || value === '1' || value === 'true';
+}
+//# sourceMappingURL=value.js.map

package/dist/contracts/value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../src/contracts/value.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3G,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAa;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACxG,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,CAAC;AAC5E,CAAC"}

package/dist/conversation/demo-preview.d.ts

@@ -0,0 +1,7 @@
+import type { Choice, DemoPreview } from '../contracts/cli-output.js';
+import type { SessionView } from '../contracts/node-wire.js';
+import type { AgentQueryApi } from '../api/agent-query-api.js';
+export declare function isInitialDemoRound(view: SessionView): boolean;
+export declare function projectDemoPreview(response: unknown, view: SessionView, choices: Array<Choice>): DemoPreview | undefined;
+/** 修改演示可能由本轮收尾回执生成快照，只匹配本轮所属消息。 */
+export declare function findModifiedDemoPreview(query: AgentQueryApi, view: SessionView): Promise<DemoPreview | undefined>;

package/dist/conversation/demo-preview.js

@@ -0,0 +1,62 @@
+/** 从当前创作轮次对应的快照提取演示地址。@author xiuyu.yi */
+import { z } from 'zod';
+import { parseWire } from '../contracts/node-wire.js';
+import { enabled, list, text } from '../contracts/value.js';
+import { currentRound, roundMessage } from './round-selector.js';
+import { findDevelopmentSnapshot } from './development-snapshot.js';
+const snapshotSchema = z.array(z.object({
+    encryptedId: z.string().min(1),
+    messageId: z.string().min(1),
+    visitUrl: z.string().url().nullish(),
+    createdAt: z.number(),
+}));
+export function isInitialDemoRound(view) {
+    const message = roundMessage(view, currentRound(view));
+    return ['choose_style_v2', 'fake_confirm_generate_more_demo'].includes(String(message?.roundExtra?.business_type));
+}
+export function projectDemoPreview(response, view, choices) {
+    const round = currentRound(view);
+    const selected = choices.find((choice) => choice.selected);
+    const messageIds = [round?.anchorUserMessageId, selected?.lastReplyMessageId, selected?.replyMessageId];
+    const snapshots = parseWire(snapshotSchema, response).sort((a, b) => b.createdAt - a.createdAt);
+    for (const messageId of messageIds) {
+        if (!messageId)
+            continue;
+        const snapshot = snapshots.find((item) => item.messageId === messageId);
+        if (!snapshot)
+            continue;
+        if (!snapshot.visitUrl)
+            return undefined;
+        const url = new URL(snapshot.visitUrl);
+        if (url.protocol !== 'https:' || url.username || url.password)
+            continue;
+        return {
+            snapshotId: snapshot.encryptedId,
+            messageId: snapshot.messageId,
+            url: snapshot.visitUrl,
+            viewed: enabled(view.extra.hasViewedDemo),
+        };
+    }
+    return undefined;
+}
+/** 修改演示可能由本轮收尾回执生成快照，只匹配本轮所属消息。 */
+export async function findModifiedDemoPreview(query, view) {
+    const round = currentRound(view);
+    if (!round)
+        return undefined;
+    const messageIds = [
+        round.anchorUserMessageId,
+        ...list(round.meta?.sourceMessageIds).map(text),
+        ...round.agentItems.map((item) => item.source?.messageId),
+    ].filter((id) => !!id);
+    const snapshot = await findDevelopmentSnapshot(query, view.session.sessionId, messageIds);
+    if (!snapshot)
+        return undefined;
+    return {
+        snapshotId: snapshot.snapshotId,
+        messageId: snapshot.messageId,
+        url: snapshot.url,
+        viewed: enabled(view.extra.hasViewedDemo),
+    };
+}
+//# sourceMappingURL=demo-preview.js.map

package/dist/conversation/demo-preview.js.map

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

package/dist/conversation/development-snapshot.d.ts

@@ -0,0 +1,5 @@
+import type { AgentQueryApi } from '../api/agent-query-api.js';
+import type { DevelopmentSnapshot } from '../contracts/cli-output.js';
+export declare function findDevelopmentSnapshot(query: AgentQueryApi, sessionId: string, messageId: string | Array<string>): Promise<Extract<DevelopmentSnapshot, {
+    status: 'READY';
+}> | undefined>;

package/dist/conversation/development-snapshot.js

@@ -0,0 +1,52 @@
+/** 按研发主线和本轮用户消息匹配快照，不使用历史演示兜底。@author xiuyu.yi */
+import { z } from 'zod';
+import { parseWire } from '../contracts/node-wire.js';
+import { CliError } from '../output/exit-codes.js';
+const snapshotsSchema = z.array(z.object({
+    encryptedId: z.string().min(1),
+    messageId: z.string().min(1),
+    createdAt: z.number(),
+    visitUrl: z.string().nullish(),
+}));
+const pageSchema = z.union([
+    z.object({ data: snapshotsSchema, totalCount: z.number().int().nonnegative() }),
+    // 公共响应信封已解包为列表时，仍按页长判断是否还有下一页。
+    snapshotsSchema,
+]);
+export async function findDevelopmentSnapshot(query, sessionId, messageId) {
+    const messageIds = new Set(Array.isArray(messageId) ? messageId : [messageId]);
+    const seen = new Set();
+    for (let page = 1;; page++) {
+        const response = parseWire(pageSchema, await query.developmentSnapshots(sessionId, page));
+        const items = Array.isArray(response) ? response : response.data;
+        const snapshot = items
+            .filter((item) => messageIds.has(item.messageId))
+            .sort((left, right) => right.createdAt - left.createdAt)[0];
+        if (snapshot) {
+            if (!snapshot.visitUrl)
+                return undefined;
+            let url;
+            try {
+                url = new URL(snapshot.visitUrl);
+            }
+            catch {
+                throw new CliError('PROTOCOL_ERROR', '本轮研发快照地址无效');
+            }
+            if (url.protocol !== 'https:' || url.username || url.password)
+                throw new CliError('PROTOCOL_ERROR', '本轮研发快照未提供安全的 HTTPS 地址');
+            return {
+                status: 'READY',
+                snapshotId: snapshot.encryptedId,
+                messageId: snapshot.messageId,
+                url: snapshot.visitUrl,
+            };
+        }
+        if (!items.length || (Array.isArray(response) ? items.length < 50 : page * 50 >= response.totalCount))
+            return undefined;
+        if (items.every((item) => seen.has(item.encryptedId)))
+            throw new CliError('PROTOCOL_ERROR', '研发快照分页未前进，请稍后重试查询');
+        for (const item of items)
+            seen.add(item.encryptedId);
+    }
+}
+//# sourceMappingURL=development-snapshot.js.map

package/dist/conversation/development-snapshot.js.map

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

package/dist/conversation/next-actions.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeConfig } from '../config/runtime-config.js';
+import type { CreationResult, NextAction } from '../contracts/cli-output.js';
+export type GuidanceResult = Pick<CreationResult, 'state' | 'sessionId'> & Partial<Pick<CreationResult, 'interactions' | 'choices' | 'messageId' | 'cursor' | 'demo' | 'development'>>;
+export declare function buildNextActions(result: GuidanceResult, config: Pick<RuntimeConfig, 'endpoint' | 'locale'>): Array<NextAction>;

package/dist/conversation/next-actions.js

@@ -0,0 +1,199 @@
+/** 根据当前结果提供操作引导，不替用户作答或执行操作。@author xiuyu.yi */
+import { COMMAND_NAME } from '../config/constants.js';
+import { latestStyleChoices } from '../interactions/parsers/style-selection.js';
+const QUESTIONNAIRE_INSTRUCTION = '请一次性向用户完整展示当前交互 questions 中的全部问题和选项：保留原始问题、选项标签及说明，标明题号、选项编号、multiSelect 单选/多选规则和 allowOther 自定义回答能力；展示编号须与 question.id、options.index 对应，不要只概括问题、逐题提问或省略选项。提示用户“请按题号回答，例如1A、2B，也可以补充自己的要求”，示例不代表固定题数或默认答案。收集整份问卷的回答；若用户仅回答部分题目，保留已答内容并一次性展示剩余问题及选项，不要替用户选择推荐项，答案齐全后再统一提交';
+const PLAN_REVIEW_INSTRUCTION = '请按 messages 顺序展示原始规划对话，与产品页面保持一致，不自行摘要、改写或追加 attachments 中的完整研发规划。然后展示：\n- **确认规划**：回复 **“确认规划”** 继续。\n- **调整功能**：直接告诉我需要增加或修改的内容。\n每次调整后都要等待并展示更新方案，再次给出这两个入口；如果服务端再次提问，先回答问题再等待方案。补充要求不等于确认，不能确认旧方案。';
+const FEATURE_SELECTION_INSTRUCTION = '请按 messages 顺序展示原始对话和功能清单，保留展示编号与 details.features 中真实 id 的对应关系；无需额外生成或链接功能清单文档，也不追加勾选状态提示。此时功能尚待选择开发，不展示“继续创作”或“上线运营”入口。最后只提示：“请回复要开发的功能编号或具体需求。”';
+const INTERACTION_INSTRUCTIONS = {
+    PRD_CLARIFICATION: `${QUESTIONNAIRE_INSTRUCTION}；提交后直接生成风格并默认等待风格截图供用户选择，不再额外询问是否生成`,
+    ASK_USER_TOOL: `${QUESTIONNAIRE_INSTRUCTION}；提交后等待实际返回的问题或方案，不自动确认规划`,
+    ASK_USER_MESSAGE: `${QUESTIONNAIRE_INSTRUCTION}；提交后等待实际返回的问题或方案，不自动确认规划`,
+    SECRET_INPUT: '请用户安全提供当前要求的密钥，不要回显密钥内容',
+    PLUGIN_SECRET_INPUT: '请用户安全提供插件所需配置，不要回显密钥内容',
+    PLUGIN_ACTION: '请用户确认是否启用当前插件及相关配置',
+    DDL_CONFIRMATION: '请用户阅读并确认数据库变更',
+    STYLE_SELECTION: '请用户查看风格截图并选择候选',
+    ENTER_IDEATION: '请用户确认进入构想阶段',
+    APPROVE_ARCHITECTURE_PLAN: `${PLAN_REVIEW_INSTRUCTION} 只有用户明确确认当前规划时才执行 APPROVE；包含新增或修改要求时先按调整功能处理，不自动确认`,
+    SELECT_FEATURES: `${FEATURE_SELECTION_INSTRUCTION} 只有用户明确从清单中选择时才将对应真实 id 填入 featureIds。支持明确多选或全选，不默认勾选，不用展示序号代替真实 id；用户直接提出新需求时应继续对话，不强制选择推荐功能`,
+    START_EXECUTION: '请用户确认开始执行当前计划',
+};
+export function buildNextActions(result, config) {
+    return nextActionsForState(result, config).map((action) => action.requiresUserInput
+        ? {
+            ...action,
+            instruction: `${action.instruction} 等待用户明确响应，不设置答题倒计时；未收到响应时保持当前步骤，不自动选择、提交、跳过或继续。`,
+        }
+        : action);
+}
+function nextActionsForState(result, config) {
+    // 显式保留连接地址，避免调用方执行下一步时切回默认环境；凭据不进入命令。
+    const command = [COMMAND_NAME, '--endpoint', config.endpoint, '--locale', config.locale, 'chat'];
+    if (result.development?.snapshot?.status === 'PENDING')
+        return [
+            {
+                action: 'WAIT',
+                instruction: '本轮任务已结束，正在同步对应的研发快照；继续查询，不重复提交研发需求，不使用旧演示链接代替本轮快照。',
+                requiresUserInput: false,
+                command: [...command, 'wait', '--', result.sessionId],
+            },
+        ];
+    if (result.state === 'NEEDS_INPUT' || result.state === 'NEEDS_SELECTION') {
+        const interactions = result.interactions ?? [];
+        if (interactions.length) {
+            const nextActions = interactions.flatMap((interaction) => interaction.actions.map((action) => {
+                if (action === 'SKIP') {
+                    return {
+                        action,
+                        instruction: '仅在用户明确要求跳过当前交互后执行此命令。',
+                        requiresUserInput: true,
+                        interactionId: interaction.interactionId,
+                        command: [...command, 'interaction', 'skip', '--', result.sessionId, interaction.interactionId],
+                    };
+                }
+                const instruction = INTERACTION_INSTRUCTIONS[interaction.kind];
+                return {
+                    action,
+                    instruction: `${instruction}。使用此 interactionId 对应的 questions、details 和 answerSchema，补齐 input 后通过 --input - 提交 JSON；不要替用户填写或选择。`,
+                    requiresUserInput: true,
+                    interactionId: interaction.interactionId,
+                    command: [
+                        ...command,
+                        'interaction',
+                        'reply',
+                        '--input',
+                        '-',
+                        '--',
+                        result.sessionId,
+                        interaction.interactionId,
+                    ],
+                    input: { action },
+                };
+            }));
+            if (result.development?.stage === 'PLAN_REVIEW' &&
+                interactions.every((interaction) => interaction.kind === 'APPROVE_ARCHITECTURE_PLAN'))
+                nextActions.push({
+                    action: 'CONTINUE_CHAT',
+                    instruction: `${PLAN_REVIEW_INSTRUCTION} 用户直接提出调整要求时，将原始要求放入 content，通过 --input - 提交 JSON；不要把修改内容塞进 APPROVE。若只说调整功能，则先询问具体要求；提交后等待更新方案或问题，不自动进入研发。`,
+                    requiresUserInput: true,
+                    command: [...command, 'send', '--input', '-', '--', result.sessionId],
+                });
+            if (result.state === 'NEEDS_INPUT' &&
+                result.development?.planApproved &&
+                result.development.stage === 'FEATURE_SELECTION' &&
+                interactions.every((interaction) => interaction.kind === 'SELECT_FEATURES')) {
+                // 已有本轮研发结果时保留完成后的引导；首次功能清单只引导选择开发内容。
+                const snapshot = result.development.snapshot;
+                if (snapshot?.status === 'READY' || snapshot?.status === 'UNAVAILABLE')
+                    return developmentActions(result, command);
+                nextActions.push({
+                    action: 'CONTINUE_CHAT',
+                    instruction: `${FEATURE_SELECTION_INSTRUCTION} 用户直接给出开发需求时，将用户原文不经改写或扩充地放入 content，通过 --input - 提交 JSON；用户明确选择清单条目时使用 SELECT 和对应的真实 featureIds，不把确认规划当作全选。`,
+                    requiresUserInput: true,
+                    command: [...command, 'send', '--input', '-', '--', result.sessionId],
+                });
+            }
+            return nextActions;
+        }
+    }
+    if (result.state === 'NEEDS_SELECTION') {
+        if (latestStyleChoices(result.choices ?? []).some((choice) => choice.selected))
+            return [];
+        return latestStyleChoices(result.choices ?? []).flatMap((choice) => {
+            if (choice.selected || choice.status !== 'success' || !choice.screenshotUrl || choice.errorType)
+                return [];
+            return [
+                {
+                    action: 'SELECT_STYLE',
+                    instruction: `请向用户展示 choices 中的 screenshotUrl；仅在用户选择风格 ${choice.index + 1} 后执行此命令，继续创作。`,
+                    requiresUserInput: true,
+                    choiceId: choice.choiceId,
+                    command: [...command, 'style', 'select', '--', result.sessionId, choice.choiceId],
+                },
+            ];
+        });
+    }
+    if (result.state === 'COMPLETED' && (result.demo || result.development?.stage === 'READY')) {
+        if (result.demo?.viewed || result.development?.stage === 'READY') {
+            const previewInstruction = result.demo
+                ? '请先以可点击链接展示 demo.url，链接文字为“查看「项目名称」网站演示”（项目名称使用当前项目名称），使用当前返回的地址，不使用旧演示地址。'
+                : '请如实说明本轮演示链接暂未就绪，可稍后查询；不使用旧演示地址代替。';
+            const instruction = `${previewInstruction} 再原样展示以下引导：\n- **修改演示**：直接告诉我修改要求，比如“把主题换成绿色”。\n- **进入研发**：回复 **“开始研发”**，我会先生成研发规划供你确认。\n等待用户响应；查看记录不代表用户已满意，不额外增加确认步骤。`;
+            return [
+                {
+                    action: 'CONTINUE_CHAT',
+                    instruction: `${instruction} 用户直接给出修改要求时，将用户原文不经改写或扩充地放入 content 字段，通过 --input - 提交 JSON，无需先让用户回复“修改演示”；如果用户只选择修改演示而未说明要求，再询问具体修改内容。不自动追加需求或进入研发。`,
+                    requiresUserInput: true,
+                    command: [...command, 'send', '--input', '-', '--', result.sessionId],
+                },
+                {
+                    action: 'ENTER_DEVELOPMENT',
+                    instruction: `${instruction} 仅在用户回复“开始研发”或明确选择进入研发后执行此命令，保留演示并等待研发规划或业务提问；不自动确认规划或选择功能。`,
+                    requiresUserInput: true,
+                    command: [...command, 'develop', '--', result.sessionId],
+                },
+            ];
+        }
+        const selectedStyle = result.choices?.find((choice) => choice.selected);
+        const demoReadyText = selectedStyle
+            ? `已采用方案 ${selectedStyle.index + 1}，简易演示生成完毕。`
+            : '简易演示生成完毕。';
+        return [
+            {
+                action: 'VIEW_DEMO',
+                instruction: `请按以下顺序展示：先告知用户“${demoReadyText}”；在这句话下面完整展示 messages 中“简版使用场景的演示”说明，保留全部条目及括号内说明，未返回说明时不编造；最后询问“现在要查看演示，确认一下效果吗？”此时只引导查看演示，不提前询问修改或进入研发。只有用户明确要求查看后才执行此命令；已取得 demo.url 不代表用户已经查看。`,
+                requiresUserInput: true,
+                command: [...command, 'demo', '--', result.sessionId],
+            },
+        ];
+    }
+    if (result.state === 'COMPLETED' && result.development?.stage === 'COMPLETED') {
+        return developmentActions(result, command);
+    }
+    if (['ACCEPTED', 'RUNNING', 'QUEUED'].includes(result.state)) {
+        const anchor = result.cursor?.branchAnchor;
+        return [
+            {
+                action: anchor ? 'QUERY_STYLES' : 'WAIT',
+                instruction: anchor
+                    ? '风格仍在生成，继续查询本批候选直到截图就绪，再交给用户选择；不要重复生成。'
+                    : '任务尚未结束，继续等待下一步问题或结果；不要重复提交。',
+                requiresUserInput: false,
+                command: anchor
+                    ? [...command, 'style', 'list', '--anchor', anchor, '--', result.sessionId]
+                    : [
+                        ...command,
+                        'wait',
+                        ...(result.messageId ? ['--message-id', result.messageId] : []),
+                        '--',
+                        result.sessionId,
+                    ],
+            },
+        ];
+    }
+    return [];
+}
+function developmentActions(result, command) {
+    const snapshot = result.development?.snapshot;
+    const previewInstruction = snapshot?.status === 'READY'
+        ? '先展示本轮原始结果和 development.snapshot.url 中对应本轮的快照链接，不使用旧演示链接，也不将快照称为已正式发布。'
+        : snapshot?.status === 'UNAVAILABLE'
+            ? `先展示原始结果，并如实说明：${snapshot.reason} 不伪造快照链接，不宣称本轮没有产出。`
+            : '先按 messages 顺序展示原始对话，不把规划确认当作研发完成，也不要求规划轮产生新快照。';
+    const instruction = `${previewInstruction} 然后展示：\n- **继续创作**：直接告诉我想新增或调整的内容。\n- **上线运营**：回复 **“上线运营”**，我会发布最新版本并返回访问链接。`;
+    return [
+        {
+            action: 'CONTINUE_CHAT',
+            instruction: `${instruction} 用户直接提出需求后，将原文放入 content，通过 --input - 继续当前会话；不强制先回复继续研发或选择推荐功能。如果有 details.features，保留真实 id、标题和说明供参考；只有用户明确选择其中条目时，才使用对应 interactionId 的 SELECT 和 featureIds 提交，不默认全选。`,
+            requiresUserInput: true,
+            command: [...command, 'send', '--input', '-', '--', result.sessionId],
+        },
+        {
+            action: 'REVIEW_PUBLISH',
+            instruction: `${instruction} 用户回复“上线运营”即已授权发布：查询 Glow 发布面板的最新待发布版本，按后续动作原样展示该版本 changeLog 并发布，无需再次确认。版本正在发布时只等待，不重复提交；没有可发布版本时如实说明。发布完成且站点公开后再告知已上线并返回正式链接。`,
+            requiresUserInput: true,
+            command: [...command, 'publish', 'status', '--for-launch', '--', result.sessionId],
+        },
+    ];
+}
+//# sourceMappingURL=next-actions.js.map

package/dist/conversation/next-actions.js.map

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

package/dist/conversation/round-selector.d.ts

@@ -0,0 +1,4 @@
+/** 主链当前轮与消息锚点。@author xiuyu.yi */
+import type { NodeRound, NodeMessage, SessionView } from '../contracts/node-wire.js';
+export declare function currentRound(view: SessionView, messageId?: string): NodeRound | undefined;
+export declare function roundMessage(view: SessionView, round?: NodeRound): NodeMessage | undefined;

package/dist/conversation/round-selector.js

@@ -0,0 +1,25 @@
+export function currentRound(view, messageId) {
+    const rounds = view.pipeline.render?.rounds ?? [];
+    if (messageId) {
+        const found = rounds.find((round) => round.anchorUserMessageId === messageId ||
+            [...round.agentItems, ...round.userItems].some((item) => item.source?.messageId === messageId));
+        if (found)
+            return found;
+    }
+    const active = rounds
+        .filter((round) => !round.meta?.consult && !round.meta?.passive)
+        .sort((a, b) => a.time.timestamp - b.time.timestamp);
+    // 最近窗口可能只剩主任务处理子任务回执的轮次；不能把真正的收尾轮全部过滤掉。
+    return active.filter((round) => !round.meta?.subAgentReport).at(-1) ?? active.at(-1);
+}
+export function roundMessage(view, round) {
+    if (!round)
+        return undefined;
+    return view.pipeline.messages
+        .filter((message) => message.role === 2 &&
+        (message.replyMessageId === round.anchorUserMessageId ||
+            round.agentItems.some((item) => item.source?.messageId === message.messageId)))
+        .sort((a, b) => a.createdAt - b.createdAt)
+        .at(-1);
+}
+//# sourceMappingURL=round-selector.js.map

package/dist/conversation/round-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-selector.js","sourceRoot":"","sources":["../../src/conversation/round-selector.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,IAAiB,EAAE,SAAkB;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CACvB,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,mBAAmB,KAAK,SAAS;YACvC,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,KAAK,SAAS,CAAC,CACjG,CAAC;QACF,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM;SAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;SAC/D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,wCAAwC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAiB,EAAE,KAAiB;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ;SAC1B,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,IAAI,KAAK,CAAC;QAClB,CAAC,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,mBAAmB;YACnD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,CACnF;SACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;SACzC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/conversation/session-waiter.d.ts

@@ -0,0 +1,28 @@
+import type { SessionView, NodePipeline } from '../contracts/node-wire.js';
+import type { CreationResult } from '../contracts/cli-output.js';
+import type { ConversationApi } from '../api/conversation-api.js';
+import type { AgentCommandApi } from '../api/agent-command-api.js';
+import type { StyleWaitTarget } from '../interactions/parsers/style-selection.js';
+export type WaitOptions = {
+    timeout?: number;
+    interval?: number;
+    messageId?: string;
+    /** 写请求返回的消息须先进入轮次模型，避免把旧规划当作本次结果。 */
+    requiredMessageId?: string;
+    /** 排队响应没有新消息 ID 时，仍须等到旧轮次发生切换。 */
+    previousMessageId?: string;
+    submittedInteractionId?: string;
+    styleTarget?: StyleWaitTarget;
+};
+export declare function applySnapshot(view: SessionView, pipeline: NodePipeline): SessionView;
+export declare class SessionWaiter {
+    private readonly dependencies;
+    constructor(dependencies: {
+        conversation: ConversationApi;
+        command: AgentCommandApi;
+        load: (sessionId: string) => Promise<SessionView>;
+        inspect: (view: SessionView, styleTarget?: StyleWaitTarget) => Promise<CreationResult>;
+        signal?: AbortSignal;
+    });
+    wait(sessionId: string, options?: WaitOptions): Promise<CreationResult>;
+}