@vtj/designer 0.18.27 → 0.19.0

package/types/components/widgets/agent/utils/filePrompt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 文件识别描述块工具
+ * useFileRecognition.buildFilePrompt 生成的描述块带剥离标记，
+ * 回显/重试时可用此工具还原用户纯文本
+ */
+/** 文件识别描述块（useFileRecognition.buildFilePrompt 生成的带标记格式） */
+export declare const FILE_DESC_BLOCK_RE: RegExp;
+/** 从 prompt 中剥离文件识别描述块，还原用户纯文本（旧数据无标记时原样返回） */
+export declare function stripFileDescBlocks(prompt: string): string;

package/types/components/widgets/agent/utils/genId.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 通用 ID 生成（时间戳 + 随机后缀）
+ */
+export declare function genId(prefix: string): string;

package/types/components/widgets/agent/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './outputParser';
+export * from './toolExecutor';
+export * from './request';
+export * from './filePrompt';
+export * from './response';
+export * from './breakpoint';

package/types/components/widgets/agent/utils/json.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON 提取工具
+ * 从 LLM 混合输出中稳健地提取 JSON 对象，替代脆弱的贪婪正则 `\{[\s\S]*\}`
+ */
+/**
+ * 从文本中提取第一个完整的顶层 JSON 对象
+ *
+ * 策略：
+ * 1. 优先取 ```json 代码块内容
+ * 2. 回退：从第一个 `{` 开始做括号配对扫描（忽略字符串内的花括号与转义），
+ *    保证在对象之后还存在其他花括号文本时也能正确截取
+ */
+export declare function extractJsonObject(text: string): string | null;
+/**
+ * 从文本中提取 JSON 并解析
+ * @returns 解析成功返回对象，失败返回 null
+ */
+export declare function parseJsonObject<T = Record<string, any>>(text: string): T | null;

package/types/components/widgets/agent/utils/markdown.d.ts

@@ -0,0 +1 @@
+export declare function formatMarkdownContent(value: unknown): string;

package/types/components/widgets/agent/utils/messages.d.ts

@@ -0,0 +1,185 @@
+import { Ref } from 'vue';
+export type AgentStatusType = 'info' | 'warning' | 'success' | 'danger';
+export interface AgentStatusMessage {
+    text: string;
+    type: AgentStatusType;
+}
+/** 写入状态文本与类型 */
+export declare function setAgentStatus(statusText: Ref<string>, statusType: Ref<AgentStatusType>, message: AgentStatusMessage): void;
+/** 状态写入回调（各 composable deps 统一使用，避免传递双 ref） */
+export type StatusSetter = (message: AgentStatusMessage) => void;
+/** 常用状态消息 */
+export declare const Messages: {
+    tokenMissing: {
+        readonly text: "请先获取 Token";
+        readonly type: "danger";
+    };
+    promptEmpty: {
+        readonly text: "请输入消息或上传文件";
+        readonly type: "danger";
+    };
+    topicIdMissing: {
+        readonly text: "请输入 Topic ID";
+        readonly type: "danger";
+    };
+    retryTopicIdMissing: {
+        readonly text: "缺少 Topic ID，无法重试";
+        readonly type: "danger";
+    };
+    resumeTopicIdMissing: {
+        readonly text: "缺少 Topic ID，无法恢复";
+        readonly type: "danger";
+    };
+    noRetryRound: {
+        readonly text: "没有可重试的轮次";
+        readonly type: "danger";
+    };
+    noResumeRound: {
+        readonly text: "没有可恢复的轮次";
+        readonly type: "danger";
+    };
+    architectChatIdMissing: {
+        readonly text: "该轮次缺少 Architect chat ID，无法重试";
+        readonly type: "danger";
+    };
+    stepNotFailed: {
+        readonly text: "该步骤不是失败状态";
+        readonly type: "danger";
+    };
+    lockedProject: {
+        readonly text: "项目已被锁定，无法应用变更";
+        readonly type: "danger";
+    };
+    userRejectedTool: {
+        readonly text: "用户拒绝执行此操作";
+        readonly type: "danger";
+    };
+    userRejectedVue: {
+        readonly text: "用户拒绝应用 Vue 变更";
+        readonly type: "danger";
+    };
+    userRejectedDiff: {
+        readonly text: "用户拒绝应用 Diff";
+        readonly type: "danger";
+    };
+    projectNotReady: {
+        readonly text: "项目未就绪";
+        readonly type: "danger";
+    };
+    fileNotReady: {
+        readonly text: "当前文件未就绪";
+        readonly type: "danger";
+    };
+    sourceUnavailable: {
+        readonly text: "无法获取当前文件源码";
+        readonly type: "danger";
+    };
+    stepNotRetryable: {
+        readonly text: "没有可重试的失败步骤";
+        readonly type: "danger";
+    };
+    summaryNotRetryable: {
+        readonly text: "没有可重试的总结";
+        readonly type: "danger";
+    };
+    planNotResumable: {
+        readonly text: "没有可恢复的计划";
+        readonly type: "danger";
+    };
+    replayStepFailed: {
+        readonly text: "执行失败";
+        readonly type: "danger";
+    };
+    replaySummaryFailed: {
+        readonly text: "总结生成失败";
+        readonly type: "danger";
+    };
+    creatingTopic: {
+        readonly text: "创建话题 (architect)...";
+        readonly type: "info";
+    };
+    creatingArchitectChat: {
+        readonly text: "创建 Architect 聊天...";
+        readonly type: "info";
+    };
+    architectPlanning: {
+        readonly text: "Architect 规划中...";
+        readonly type: "warning";
+    };
+    retryingSummary: {
+        readonly text: "重新生成任务总结...";
+        readonly type: "warning";
+    };
+    planInvalid: {
+        readonly text: "Architect 输出异常，未生成有效计划";
+        readonly type: "danger";
+    };
+    architectAnswered: {
+        readonly text: "Architect 直接回答";
+        readonly type: "success";
+    };
+    generatingSummary: {
+        readonly text: "生成任务总结...";
+        readonly type: "warning";
+    };
+    resumedSummary: {
+        readonly text: "恢复生成任务总结...";
+        readonly type: "warning";
+    };
+    summaryRegenerated: {
+        readonly text: "任务总结已重新生成";
+        readonly type: "success";
+    };
+    summaryGenerated: {
+        readonly text: "任务总结已生成";
+        readonly type: "success";
+    };
+    retryingLastRequest: {
+        readonly text: "重试上次请求...";
+        readonly type: "warning";
+    };
+    resumingFromPrompt: {
+        readonly text: "检测到续跑意图，从断点恢复执行...";
+        readonly type: "warning";
+    };
+    cancelled: {
+        readonly text: "已取消";
+        readonly type: "info";
+    };
+    loadingHistory: {
+        readonly text: "加载历史记录...";
+        readonly type: "info";
+    };
+    historyEmpty: {
+        readonly text: "未找到交互记录";
+        readonly type: "warning";
+    };
+    replayTopicIdMissing: {
+        readonly text: "缺少 Topic ID";
+        readonly type: "danger";
+    };
+    topicCreated: (topicId: string) => AgentStatusMessage;
+    planGenerated: (intent: string) => AgentStatusMessage;
+    allStepsDone: (count: number) => AgentStatusMessage;
+    stepFailed: (index: number) => AgentStatusMessage;
+    summaryFailed: (message: string) => AgentStatusMessage;
+    cancelledWithProgress: (done: number, total: number) => AgentStatusMessage;
+    resumingStep: (step: number, total: number) => AgentStatusMessage;
+    retryingStep: (index: number) => AgentStatusMessage;
+    retryArchitect: (label: string) => AgentStatusMessage;
+    architectRetrying: (attempt: number, max: number) => AgentStatusMessage;
+    architectFailed: (message: string) => AgentStatusMessage;
+    error: (message: string) => AgentStatusMessage;
+    retryFailed: (message: string) => AgentStatusMessage;
+    historyLoaded: (count: number) => AgentStatusMessage;
+    historyLoadFailed: (message: string) => AgentStatusMessage;
+    historyFormatInvalid: (type: string) => AgentStatusMessage;
+    editorExecuting: (description: string, index: number, total: number) => AgentStatusMessage;
+    awaitingApproval: (action: string, risk: string) => AgentStatusMessage;
+    executingAction: (action: string) => AgentStatusMessage;
+    actionRejected: (action: string) => AgentStatusMessage;
+    chatCreateFailed: (message: string) => AgentStatusMessage;
+    maxTurnsReached: (count: number) => AgentStatusMessage;
+    vueToDslFailed: (message: string) => AgentStatusMessage;
+    diffApplyFailed: (message: string) => AgentStatusMessage;
+};

package/types/components/widgets/agent/utils/outputParser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Editor 输出解析器
+ * 识别 LLM 输出中的代码块类型：json(tool_call)、vue、diff
+ */
+export interface ToolCall {
+    action: string;
+    parameters: any[];
+}
+export interface DiffPatch {
+    search: string;
+    replace: string;
+}
+export interface ParsedOutput {
+    type: 'tool_call' | 'vue_code' | 'diff' | 'unknown';
+    tool?: ToolCall;
+    code?: string;
+    patches?: DiffPatch[];
+    raw?: string;
+    error?: string;
+}
+/**
+ * 解析 LLM 输出，识别输出类型
+ */
+export declare function parseOutput(text: string): ParsedOutput;

package/types/components/widgets/agent/utils/plan.d.ts

@@ -0,0 +1,7 @@
+import { PlanResult } from '../types/agent';
+export interface PlanOutputParseResult {
+    plan: PlanResult | null;
+    /** 大模型明确输出的错误说明（如缺少关键信息），最终失败时反馈给用户 */
+    error?: string;
+}
+export declare function parsePlanOutput(text: string): PlanOutputParseResult;

package/types/components/widgets/agent/utils/request.d.ts

@@ -0,0 +1 @@
+export declare function withRequestRetry<T>(request: () => Promise<T>): Promise<T>;

package/types/components/widgets/agent/utils/response.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 远程接口响应处理（纯函数）
+ * - unwrapOpenApi：响应码校验与 data 解包
+ * - pickChat / pickTopic：后端响应存在两套形态（裸对象 / { topic|chat } 包裹，
+ *   主键存在 id / chatId 双命名），统一提取，避免调用侧散落 `xxx.xxx || xxx` 兼容逻辑
+ */
+/** 响应码校验解包：非零 code / success=false 抛错，优先返回 data 字段 */
+export declare function unwrapOpenApi<T>(response: any): T;
+/** chat 实体提取结果 */
+export interface PickedChat {
+    /** chat 实体（优先取包裹字段，回退整包） */
+    chat: any;
+    /** chat 主键（兼容 id / chatId 双命名） */
+    chatId: string;
+}
+/** topic 实体提取结果（topic 响应同时携带起始 chat） */
+export interface PickedTopic extends PickedChat {
+    topic: any;
+    topicId: string;
+    userId: string;
+}
+/** 提取 chat 实体与主键 */
+export declare function pickChat(response: any): PickedChat;
+/** 提取 topic 实体、主键与起始 chat */
+export declare function pickTopic(response: any): PickedTopic;

package/types/components/widgets/agent/utils/resume.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 续跑意图识别（纯函数）
+ * 判定用户输入是否为"继续执行上一轮没完成的计划"类表述。
+ * 命中后前端将其映射为断点恢复/失败重试（resumeLastRound / retryLastRound），
+ * 而非新建 Architect 规划轮——修复"继续执行"时模型因无断点上下文而从头重复执行的问题。
+ */
+export declare function isResumeIntent(text: string): boolean;

package/types/components/widgets/agent/utils/summary.d.ts

@@ -0,0 +1,2 @@
+import { PlanResult, StepRecord } from '../types/agent';
+export declare function buildSummaryPrompt(userRequest: string, plan: PlanResult | null, stepRecords: StepRecord[]): string;

package/types/components/widgets/agent/utils/toolExecutor.d.ts

@@ -0,0 +1,23 @@
+import { Engine } from '../../../../framework';
+export interface ToolExecResult {
+    success: boolean;
+    action: string;
+    result?: any;
+    error?: string;
+    /** 执行耗时(ms) */
+    duration: number;
+}
+/**
+ * 执行单个工具调用
+ *
+ * @param engine   设计器引擎实例
+ * @param action   工具名称
+ * @param parameters 工具参数数组
+ * @param timeoutMs 超时时间(ms)，默认 30000
+ * @param signal   取消信号（用户中止工作流时立即中断等待中的工具调用）
+ */
+export declare function executeTool(engine: Engine, action: string, parameters: any[], timeoutMs?: number, signal?: AbortSignal): Promise<ToolExecResult>;
+/**
+ * 将工具执行结果格式化为 LLM 反馈消息（O: 格式）
+ */
+export declare function formatToolFeedback(result: ToolExecResult): string;

package/types/components/widgets/apis/form.d.ts

@@ -49,10 +49,10 @@ declare const _default: DefineComponent<Props, {}, {}, {}, {}, ComponentOptionsM
             readonly title?: string | undefined;
             readonly cancel?: string | boolean | undefined;
             readonly beforeClose?: (() => boolean | Promise<boolean>) | undefined;
+            readonly src?: string | undefined;
             readonly content?: Record<string, any> | VNode<RendererNode, RendererElement, {
                 [key: string]: any;
             }> | DefineComponent<any, any, any, any> | undefined;
-            readonly src?: string | undefined;
             readonly subtitle?: string | undefined;
             readonly submit?: string | boolean | undefined;
             readonly resizable?: boolean | ResizableOptions | undefined;
@@ -1456,7 +1456,7 @@ declare const _default: DefineComponent<Props, {}, {}, {}, {}, ComponentOptionsM
         onChange?: ((model: Record<string, any>) => any) | undefined;
         onReset?: (() => any) | undefined;
         onSubmit?: ((model: Record<string, any>) => any) | undefined;
-    }>, "model" | "validate" | "footer" | "submit" | "formRef" | "tooltipMessage" | "inline" | "reset" | "submitText" | "resetText" | "enterSubmit" | "sticky" | "footerAlign" | "clearValidate"> & {
+    }>, "model" | "footer" | "submit" | "formRef" | "tooltipMessage" | "inline" | "reset" | "submitText" | "resetText" | "enterSubmit" | "sticky" | "footerAlign" | "validate" | "clearValidate"> & {
         formRef: any;
         model: FormModel;
         submit: () => Promise<void>;

package/types/components/widgets/apis/swagger.d.ts

@@ -785,7 +785,7 @@ declare const _default: DefineComponent<Props, {}, {}, {}, {}, ComponentOptionsM
         onCellSelected?: ((params: any) => any) | undefined;
         onEditChange?: ((data: any[]) => any) | undefined;
         onLoaded?: ((rows: any[]) => any) | undefined;
-    }>, "search" | "validate" | "page" | "auto" | "resizable" | "load" | "state" | "remove" | "$vtjDynamicSlots" | "editable" | "columns" | "rowSortable" | "columnSortable" | "customable" | "pager" | "pageSize" | "pageSizes" | "virtual" | "vxeRef" | "insertActived" | "getSelected" | "getRows" | "setActived" | "doLayout" | "getRecords" | "setSelectCell"> & {
+    }>, "search" | "page" | "auto" | "resizable" | "load" | "state" | "remove" | "$vtjDynamicSlots" | "editable" | "validate" | "columns" | "rowSortable" | "columnSortable" | "customable" | "pager" | "pageSize" | "pageSizes" | "virtual" | "vxeRef" | "insertActived" | "getSelected" | "getRows" | "setActived" | "doLayout" | "getRecords" | "setSelectCell"> & {
         state: {
             [x: string]: any;
             page?: number | undefined;

package/types/components/widgets/devtools/index.d.ts

@@ -43,10 +43,10 @@ declare const _default: DefineComponent<{}, {
             readonly title?: string | undefined;
             readonly cancel?: string | boolean | undefined;
             readonly beforeClose?: (() => boolean | Promise<boolean>) | undefined;
+            readonly src?: string | undefined;
             readonly content?: Record<string, any> | VNode<RendererNode, RendererElement, {
                 [key: string]: any;
             }> | DefineComponent<any, any, any, any> | undefined;
-            readonly src?: string | undefined;
             readonly subtitle?: string | undefined;
             readonly submit?: string | boolean | undefined;
             readonly resizable?: boolean | ResizableOptions | undefined;

package/types/components/widgets/env/index.d.ts

@@ -779,7 +779,7 @@ declare const _default: DefineComponent<{}, {}, {}, {}, {}, ComponentOptionsMixi
         onCellSelected?: ((params: any) => any) | undefined;
         onEditChange?: ((data: any[]) => any) | undefined;
         onLoaded?: ((rows: any[]) => any) | undefined;
-    }>, "search" | "validate" | "page" | "auto" | "resizable" | "load" | "state" | "remove" | "$vtjDynamicSlots" | "editable" | "columns" | "rowSortable" | "columnSortable" | "customable" | "pager" | "pageSize" | "pageSizes" | "virtual" | "vxeRef" | "insertActived" | "getSelected" | "getRows" | "setActived" | "doLayout" | "getRecords" | "setSelectCell"> & {
+    }>, "search" | "page" | "auto" | "resizable" | "load" | "state" | "remove" | "$vtjDynamicSlots" | "editable" | "validate" | "columns" | "rowSortable" | "columnSortable" | "customable" | "pager" | "pageSize" | "pageSizes" | "virtual" | "vxeRef" | "insertActived" | "getSelected" | "getRows" | "setActived" | "doLayout" | "getRecords" | "setSelectCell"> & {
         state: {
             [x: string]: any;
             page?: number | undefined;

package/types/components/widgets/i18n/index.d.ts

@@ -779,7 +779,7 @@ declare const _default: DefineComponent<{}, {}, {}, {}, {}, ComponentOptionsMixi
         onCellSelected?: ((params: any) => any) | undefined;
         onEditChange?: ((data: any[]) => any) | undefined;
         onLoaded?: ((rows: any[]) => any) | undefined;
-    }>, "search" | "validate" | "page" | "auto" | "resizable" | "load" | "state" | "remove" | "$vtjDynamicSlots" | "editable" | "columns" | "rowSortable" | "columnSortable" | "customable" | "pager" | "pageSize" | "pageSizes" | "virtual" | "vxeRef" | "insertActived" | "getSelected" | "getRows" | "setActived" | "doLayout" | "getRecords" | "setSelectCell"> & {
+    }>, "search" | "page" | "auto" | "resizable" | "load" | "state" | "remove" | "$vtjDynamicSlots" | "editable" | "validate" | "columns" | "rowSortable" | "columnSortable" | "customable" | "pager" | "pageSize" | "pageSizes" | "virtual" | "vxeRef" | "insertActived" | "getSelected" | "getRows" | "setActived" | "doLayout" | "getRecords" | "setSelectCell"> & {
         state: {
             [x: string]: any;
             page?: number | undefined;