@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/admin/ModelPreview.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 模型预览组件
+ */
+import React from 'react';
+import type { TrainingModel } from '@shared/types/index.js';
+interface ModelPreviewProps {
+    model: TrainingModel;
+}
+/**
+ * 模型预览
+ */
+declare const ModelPreview: React.FC<ModelPreviewProps>;
+export default ModelPreview;

package/dist-types/client/src/admin/OptionSelector.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 选项选择器组件
+ * 展示 AI 生成的选项卡片，支持单选/多选
+ */
+import React from 'react';
+export interface OptionItem {
+    value: string;
+    label: string;
+    description?: string;
+    difficulty?: 'easy' | 'medium' | 'hard';
+    icon?: React.ReactNode;
+}
+export interface OptionSelectorProps {
+    title: string;
+    description?: string;
+    options: OptionItem[];
+    selectedValue?: string;
+    selectedValues?: string[];
+    onSelect: (option: OptionItem) => void;
+    onMultipleSelect?: (options: OptionItem[]) => void;
+    loading?: boolean;
+    onRefresh?: () => void;
+    showCustomOption?: boolean;
+    onCustomSelect?: () => void;
+    emptyText?: string;
+    gridColumns?: number;
+    multiple?: boolean;
+    showOtherOption?: boolean;
+    onOtherSelect?: () => void;
+}
+declare const OptionSelector: React.FC<OptionSelectorProps>;
+export default OptionSelector;

package/dist-types/client/src/admin/StageStepEditor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 阶段与步骤编辑器
+ */
+import React from "react";
+import type { Stage, Step, TrainingModel } from "@shared/types/index.js";
+import type { TokenProvider } from "../lib/types";
+interface StageStepEditorProps {
+    stages: Stage[];
+    onChange: (stages: Stage[]) => void;
+    abilityMap?: any;
+    model?: TrainingModel;
+    getToken?: TokenProvider;
+}
+export declare const toggleStepEvaluationRules: (step: Step, enabled: boolean) => Step;
+export declare const updateStepEvaluationRulesField: (step: Step, field: "dimensions" | "businessRules", value: any) => Step;
+/**
+ * 阶段与步骤编辑器主组件
+ */
+declare const StageStepEditor: React.FC<StageStepEditorProps>;
+export default StageStepEditor;

package/dist-types/client/src/admin/StepAnswerKeyEditor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 逐案例答案键可视化编辑器（stepAnswers[stepId] → StepAnswerKey）
+ *
+ * 按判分插件类型渲染贴合题面的可视化表单，默认可视化、可一键切换 JSON。
+ * 题面结构来自 AnswerKeyStepQuestion（案例无关的"考卷"），答案键为该案例特定的"正确答案"。
+ *  - decision-making → decisionReferences（逐题组：correctOptions / referenceConclusion）
+ *  - form-filling    → fieldReferences（逐字段：correctValue + explanation）
+ *  - case-analysis   → referenceAnswer + requiredPoints
+ *  - document-review → documentReferenceAnswers（逐不符点：fieldName + typeId + displayValue + correctValue ...）
+ */
+import React from 'react';
+import type { StepAnswerKey } from '@shared/types/index.js';
+import type { AnswerKeyStepQuestion } from './services';
+declare const StepAnswerKeyEditor: React.FC<{
+    step: AnswerKeyStepQuestion;
+    value: StepAnswerKey;
+    onChange: (val: StepAnswerKey) => void;
+}>;
+export default StepAnswerKeyEditor;

package/dist-types/client/src/admin/StepByStepCreator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 分步创建器主组件（重构版）
+ * Step 1: 意图收集
+ * Step 2: 流程大纲生成
+ * Step 3: 步骤细节编辑
+ * Step 4: 案例生成
+ */
+import React from "react";
+import type { TrainingModel } from "@shared/types/index.js";
+import type { CreatorContext, StepByStepCreatorProps } from "../lib/types";
+import type { TrainingBlueprint } from "./types/creatorArtifacts";
+import type { StageContract, StepTaskPackage } from "./types/creatorArtifacts";
+export declare const buildStep3ContractOverviewStats: (stageContracts: StageContract[], stepTaskPackages: StepTaskPackage[]) => {
+    stageId: string;
+    stageName: string;
+    stepCount: number;
+}[];
+export declare const buildCreatorPersistencePayload: (context: CreatorContext, trainingBlueprint: TrainingBlueprint) => CreatorContext;
+/**
+ * 启发式检测：策略实验室的「设计→推演→迭代」闭环被错误拆成了两个步骤。
+ * strategy-lab 插件本身就是单步内的完整循环，若相邻两步呈现「先设计/制定方案、
+ * 后推演/模拟验证」且任一步挂 strategy-lab，多半是拆分错误，应合并为一个步骤。
+ * 规则较宽松，只产出软告警提示用户复核，不硬阻断流程。
+ */
+export declare const detectSplitStrategyLabLoops: (model: TrainingModel | null | undefined) => string[];
+declare const StepByStepCreator: React.FC<StepByStepCreatorProps>;
+export default StepByStepCreator;

package/dist-types/client/src/admin/components/AbilityMapEditor.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { AbilityMap } from '@shared/types/index.js';
+interface AbilityMapEditorProps {
+    value?: AbilityMap;
+    onChange?: (value: AbilityMap) => void;
+    intentData?: any;
+}
+/**
+ * 能力图谱编辑器
+ */
+export declare const AbilityMapEditor: React.FC<AbilityMapEditorProps>;
+export {};

package/dist-types/client/src/admin/components/CasePreview.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { Case, CaseSchema } from '@shared/types/index.js';
+interface CasePreviewProps {
+    case: Case;
+    schema?: CaseSchema;
+}
+declare const CasePreview: React.FC<CasePreviewProps>;
+export default CasePreview;

package/dist-types/client/src/admin/components/StepAbilitySelector.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { AbilityMap, StepTargetAbility } from '@shared/types/index.js';
+interface StepAbilitySelectorProps {
+    value?: StepTargetAbility[];
+    onChange?: (value: StepTargetAbility[]) => void;
+    abilityMap?: AbilityMap;
+}
+export declare const StepAbilitySelector: React.FC<StepAbilitySelectorProps>;
+export {};

package/dist-types/client/src/admin/constants/creatorConstants.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 创建器常量定义
+ */
+import type { CaseVariantPackageOption } from "../services";
+import type { TrainingBlueprint } from "../types/creatorArtifacts";
+export declare const PLUGIN_TYPE_OPTIONS: {
+    value: string;
+    label: string;
+}[];
+export declare const TRAINING_TYPE_OPTIONS: {
+    value: string;
+    label: string;
+    description: string;
+}[];
+/**
+ * 步骤索引
+ */
+export declare enum StepIndex {
+    INTENT = 0,
+    OUTLINE = 1,
+    DETAILS = 2,
+    CASES = 3,
+    ASSEMBLY = 4
+}
+export type CreatorTrainingBlueprint = TrainingBlueprint;
+/**
+ * 案例场景数据
+ */
+export interface CaseScenarioData {
+    caseVariantPackages: CaseVariantPackageOption[];
+    selectedVariantIds: string[];
+}
+/**
+ * 加载状态
+ */
+export interface LoadingState {
+    visible: boolean;
+    message: string;
+}

package/dist-types/client/src/admin/editors/CaseAnalysisEditor.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+/** UI 配置（方案设计：仅保留运行时仍生效的字段） */
+export declare const CaseAnalysisUIConfigEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+}>;
+export declare const CaseAnalysisInitDataEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    model?: any;
+}>;

package/dist-types/client/src/admin/editors/DecisionMakingEditor.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import type { DecisionMakingInitData } from "../../plugins/decision-making/types";
+export declare const DecisionMakingInitDataEditor: React.FC<{
+    value: Partial<DecisionMakingInitData>;
+    onChange: (val: Partial<DecisionMakingInitData>) => void;
+    model?: any;
+}>;

package/dist-types/client/src/admin/editors/DialogueEditor.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export declare const DialogueInitDataEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    hideUIConfig?: boolean;
+    model?: any;
+}>;
+export declare const DialogueUIConfigEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    hideBaseFields?: boolean;
+}>;

package/dist-types/client/src/admin/editors/DocumentReviewEditor.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import type { DocumentReviewInitData } from "../../plugins/shared/types";
+export declare const DocumentReviewInitDataEditor: React.FC<{
+    value: Partial<DocumentReviewInitData>;
+    onChange: (val: Partial<DocumentReviewInitData>) => void;
+    model?: any;
+}>;

package/dist-types/client/src/admin/editors/DocumentReviewRuntimeRulesEditor.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+import type { DocumentReviewInitData, DocumentReviewRuntimeRules } from "../../plugins/shared/types";
+/**
+ * 单据审核 · RuntimeRules 编辑器（参考答案 + 判分配置）
+ *
+ * - referenceAnswers：每条挂靠到 documents 的字段（fieldName）+ 错误类型（typeId）
+ *   - fieldName / typeId 在能拿到 initData 时为下拉，选项分别来自 documents 的字段与 errorTypes
+ *   - 下拉关联即对齐：从 UI 层杜绝 typeId/fieldName 写错
+ * - scoring：baseRatio（命中基础分占比，默认 0.6）、falseMarkPenalty（误标扣分，'half' 或数字）
+ */
+export declare const DocumentReviewRuntimeRulesEditor: React.FC<{
+    value: Partial<DocumentReviewRuntimeRules>;
+    onChange: (val: Partial<DocumentReviewRuntimeRules>) => void;
+    initData?: Partial<DocumentReviewInitData>;
+}>;

package/dist-types/client/src/admin/editors/FormFillingEditor.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import type { TokenProvider } from "../../lib/types";
+/**
+ * 表单填写 initData 编辑器（多表单 / 单证）
+ *  - 支持一个步骤内多张单证（Tab 切换增删）
+ *  - 每证：formName/中英双语抬头/编号/字段表/预填/分组
+ *  - 已移除高代码自定义布局（customLayoutCode）
+ *  - 编辑统一持久化为 initData.forms（resolveForms 全链路消费）
+ */
+export declare const FormFillingInitDataEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    hideUIConfig?: boolean;
+    model?: any;
+    stageIndex?: number;
+    stepIndex?: number;
+    getToken?: TokenProvider;
+}>;
+/**
+ * 表单填写过程参数编辑器（runtimeRules）。校验规则与实时指导是过程约束/完成门禁，归 runtimeRules；
+ * 在后台「过程参数」编辑区使用（RouterEditors 的 RuntimeRulesEditor）。
+ */
+export declare const FormFillingRuntimeRulesEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+}>;
+/** uiConfig 子编辑器（表单填写）—— 模型级 UI 配置复用（ModelUIConfigEditor） */
+export declare const UIConfigEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    hideBaseFields?: boolean;
+    disabled?: boolean;
+}>;

package/dist-types/client/src/admin/editors/ModelUIConfigEditor.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export declare const ModelUIConfigEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+}>;

package/dist-types/client/src/admin/editors/QAEditor.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+export declare const QAInitDataEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    model?: any;
+}>;

package/dist-types/client/src/admin/editors/RouterEditors.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+import { PluginType } from "@shared/types/index.js";
+import type { TokenProvider } from "../../lib/types";
+export declare const InitDataEditor: React.FC<{
+    pluginType: PluginType;
+    value: any;
+    onChange: (val: any) => void;
+    model?: any;
+    stageIndex?: number;
+    stepIndex?: number;
+    getToken?: TokenProvider;
+}>;
+export declare const RuntimeRulesEditor: React.FC<{
+    pluginType: PluginType;
+    value: any;
+    onChange: (val: any) => void;
+    initData?: any;
+}>;

package/dist-types/client/src/admin/editors/StepBriefingEditor.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { StepBriefing } from '@shared/types/index.js';
+/**
+ * 步骤资料区（stepBriefing）编辑器。
+ * 编辑 Step 顶层的 scenario / caseFacts / referenceDocs / aiQA / display。
+ * AI 生成（Step3 落地）后可在此手工查看与微调。见 docs/2026年6月4日/公共资料区StepBriefing契约草案.md
+ */
+interface StepBriefingEditorProps {
+    value?: StepBriefing;
+    onChange: (v: StepBriefing) => void;
+    model?: any;
+}
+declare const StepBriefingEditor: React.FC<StepBriefingEditorProps>;
+export default StepBriefingEditor;

package/dist-types/client/src/admin/editors/StrategyLabEditor.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+export declare const StrategyLabUIConfigEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    hideBaseFields?: boolean;
+}>;
+/**
+ * 策略实验室 InitData 编辑器。
+ * 数据模型：所有「场景配置」（场景/背景/镜头/收敛方式/推演配置/评估维度/输入方式/角色）只活在
+ * initData.nodes[]。编辑器用「节点标签页」切换当前编辑的节点，下方所有场景字段读写当前节点；
+ * uiConfig / sceneThemeType 等步骤级字段读写顶层。单场景 = 1 个节点。
+ */
+export declare const StrategyLabInitDataEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    hideUIConfig?: boolean;
+    model?: any;
+    stageIndex?: number;
+    stepIndex?: number;
+}>;
+export declare const StrategyLabCheckRulesEditor: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+}>;

package/dist-types/client/src/admin/editors/decisionEditorParts.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+import type { DecisionField, DecisionOption, MaterialBlock } from "../../plugins/decision-making/types";
+export declare const genId: (p: string) => string;
+export declare const FieldEditor: React.FC<{
+    field: DecisionField;
+    onChange: (f: DecisionField) => void;
+    onRemove: () => void;
+}>;
+export declare const emptyField: () => DecisionField;
+export declare const OptionListEditor: React.FC<{
+    options: DecisionOption[];
+    onChange: (o: DecisionOption[]) => void;
+}>;
+export declare const BlockEditor: React.FC<{
+    block: MaterialBlock;
+    onChange: (b: MaterialBlock) => void;
+    onRemove: () => void;
+}>;

package/dist-types/client/src/admin/editors/index.d.ts

@@ -0,0 +1,8 @@
+export * from './shared';
+export * from './DialogueEditor';
+export * from './FormFillingEditor';
+export * from './CaseAnalysisEditor';
+export * from './QAEditor';
+export * from './StrategyLabEditor';
+export * from './ModelUIConfigEditor';
+export * from './RouterEditors';

package/dist-types/client/src/admin/editors/shared.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+/**
+ * JSON 编辑文本框
+ */
+export declare const JsonTextArea: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    rows?: number;
+}>;
+/**
+ * JSON / 可视化 切换包裹器
+ */
+export declare const JsonFallbackToggle: React.FC<{
+    value: any;
+    onChange: (val: any) => void;
+    children: React.ReactNode;
+}>;

package/dist-types/client/src/admin/hooks/useStep1Intent.d.ts

@@ -0,0 +1,16 @@
+import type { IntentData } from "../../configs/intentDiscoveryConfig";
+import type { TrainingBlueprint } from "../types/creatorArtifacts";
+import { StepIndex } from "../constants/creatorConstants";
+interface UseStep1IntentProps {
+    onComplete: (intentData: IntentData, blueprint: TrainingBlueprint) => void;
+    onStepChange: (step: StepIndex) => void;
+}
+export declare function mapIntentToBlueprint(data: Record<string, any>): {
+    intent: IntentData;
+    blueprint: TrainingBlueprint;
+};
+export declare function useStep1Intent({ onComplete, onStepChange }: UseStep1IntentProps): {
+    intentData: IntentData | null;
+    handleIntentComplete: (data: Record<string, any>) => void;
+};
+export {};

package/dist-types/client/src/admin/hooks/useStep2Outline.d.ts

@@ -0,0 +1,41 @@
+import type { ProcessOutline } from "../services";
+import type { AbilityMap } from "@shared/types/index.js";
+import type { CreatorNotifyAdapter, TokenProvider } from "../../lib/types";
+import type { TrainingBlueprint } from "../types/creatorArtifacts";
+import { StepIndex } from "../constants/creatorConstants";
+interface UseStep2OutlineProps {
+    trainingBlueprint: TrainingBlueprint;
+    getToken: TokenProvider;
+    notify: CreatorNotifyAdapter;
+    onOutlineConfirmed: (outline: ProcessOutline) => void;
+    onStepChange: (step: StepIndex) => void;
+    onLoadingChange: (loading: {
+        visible: boolean;
+        message: string;
+    }) => void;
+    onStreamContentChange: (content: string | ((prev: string) => string)) => void;
+    saveContext: (step: StepIndex, outline: ProcessOutline, messages: any[]) => void;
+}
+export declare function useStep2Outline({ trainingBlueprint, getToken, notify, onOutlineConfirmed, onStepChange, onLoadingChange, onStreamContentChange, saveContext, }: UseStep2OutlineProps): {
+    processOutline: ProcessOutline | null;
+    setProcessOutline: import("react").Dispatch<import("react").SetStateAction<ProcessOutline | null>>;
+    abilityMap: AbilityMap | null;
+    setAbilityMap: import("react").Dispatch<import("react").SetStateAction<AbilityMap | null>>;
+    outlineMessages: {
+        role: "user" | "ai";
+        content: string;
+    }[];
+    setOutlineMessages: import("react").Dispatch<import("react").SetStateAction<{
+        role: "user" | "ai";
+        content: string;
+    }[]>>;
+    outlineInput: string;
+    setOutlineInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+    outlineConversationId: string | null;
+    setOutlineConversationId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    messagesEndRef: import("react").RefObject<HTMLDivElement>;
+    handleGenerateOutline: (blueprint: TrainingBlueprint) => Promise<void>;
+    handleRefineOutline: () => Promise<void>;
+    handleConfirmOutline: () => void;
+};
+export {};

package/dist-types/client/src/admin/hooks/useStep3Details.d.ts

@@ -0,0 +1,123 @@
+import type { ProcessOutline } from "../services";
+import type { CreatorNotifyAdapter, TokenProvider } from "../../lib/types";
+import type { TrainingModel, CaseSchema, CaseSchemaField, CaseSchemaConstraint, Stage } from "@shared/types/index.js";
+import type { TrainingBlueprint, StageContract, StepTaskPackage, StageAcceptanceRecord, AssemblyDryRunResult, GenerationPhase, Phase1Artifacts } from "../types/creatorArtifacts";
+import { StepIndex } from "../constants/creatorConstants";
+import type { IntentData } from "../../configs/intentDiscoveryConfig";
+import type { AbilityMap } from "@shared/types/index.js";
+export declare const mergeDeclaredFields: (oldFields: CaseSchemaField[], newFields: CaseSchemaField[]) => CaseSchemaField[];
+/** 约束增量追加 */
+export declare const mergeDeclaredConstraints: (oldConstraints: CaseSchemaConstraint[], newConstraints: CaseSchemaConstraint[]) => CaseSchemaConstraint[];
+/** 替换模型中指定阶段（浅拷贝父级保持引用安全） */
+export declare const replaceStageAt: (model: TrainingModel, stageIndex: number, newStage: Stage) => TrainingModel;
+/** 替换模型中指定步骤（浅拷贝父级保持引用安全） */
+export declare const replaceStepAt: (model: TrainingModel, stageIndex: number, stepIndex: number, newStep: Stage["steps"][number]) => TrainingModel;
+export type FallbackValidationDecision = {
+    action: 'skip';
+} | {
+    action: 'throw';
+} | {
+    action: 'ask-continue';
+    validateMsg: string;
+};
+export declare function evaluateFallbackValidationDecision(params: {
+    fallbackValidationMessage: string | null;
+    hasUserContinued: boolean;
+    buildValidateMsg: (scope: 'single-pass' | 'stage', message: string, stageName?: string) => string;
+}): FallbackValidationDecision;
+export declare const getStep3ValidationErrorMessage: (stageContract: StageContract | null | undefined, stepTaskPackages: StepTaskPackage[]) => string | null;
+export type AiRevisionTarget = {
+    mode: 'stage';
+    stageIndex: number;
+} | {
+    mode: 'step';
+    stageIndex: number;
+    stepIndex: number;
+} | null;
+export type SaveContextSnapshot = {
+    generatedModel?: TrainingModel;
+    caseSchema?: CaseSchema;
+    stageContracts?: StageContract[];
+    stepTaskPackages?: StepTaskPackage[];
+    stageAcceptanceRecords?: StageAcceptanceRecord[];
+    assemblyDryRunResult?: AssemblyDryRunResult;
+    assemblyDraft?: TrainingModel;
+    outlineConversationId?: string;
+    detailConversationId?: string;
+    generationPhase?: GenerationPhase;
+    phase1Artifacts?: Phase1Artifacts | null;
+};
+interface UseStep3DetailsProps {
+    processOutline: ProcessOutline | null;
+    outlineConversationId: string | null;
+    initialDetailConversationId?: string | null;
+    trainingBlueprint: TrainingBlueprint;
+    intentData: IntentData | null;
+    abilityMap?: AbilityMap | null;
+    getToken: TokenProvider;
+    notify: CreatorNotifyAdapter;
+    onDetailsConfirmed: (model: TrainingModel, schema: CaseSchema) => void;
+    onStepChange: (step: StepIndex) => void;
+    onLoadingChange: (loading: {
+        visible: boolean;
+        message: string;
+    }) => void;
+    onStreamContentChange: (content: string | ((prev: string) => string)) => void;
+    onDetailConversationIdUpdate: (id: string) => void;
+    saveContext?: (snapshot: SaveContextSnapshot) => void;
+    /** 二次失败后弹出继续/放弃对话框，返回 true=继续，false=放弃 */
+    onContinueOrAbort?: (message: string) => Promise<boolean>;
+}
+export declare function useStep3Details({ processOutline, outlineConversationId, initialDetailConversationId, trainingBlueprint, intentData, abilityMap: externalAbilityMap, getToken, notify, onDetailsConfirmed, onStepChange, onLoadingChange, onStreamContentChange, onDetailConversationIdUpdate, saveContext, onContinueOrAbort, }: UseStep3DetailsProps): {
+    caseSchema: CaseSchema | null;
+    setCaseSchema: import("react").Dispatch<import("react").SetStateAction<CaseSchema | null>>;
+    generatedModel: TrainingModel | null;
+    setGeneratedModel: import("react").Dispatch<import("react").SetStateAction<TrainingModel | null>>;
+    editingStep: {
+        stageIndex: number;
+        stepIndex: number;
+    } | null;
+    setEditingStep: import("react").Dispatch<import("react").SetStateAction<{
+        stageIndex: number;
+        stepIndex: number;
+    } | null>>;
+    stageAcceptanceRecords: StageAcceptanceRecord[];
+    setStageAcceptanceRecords: import("react").Dispatch<import("react").SetStateAction<StageAcceptanceRecord[]>>;
+    stageContracts: StageContract[];
+    setStageContracts: import("react").Dispatch<import("react").SetStateAction<StageContract[]>>;
+    stepTaskPackages: StepTaskPackage[];
+    setStepTaskPackages: import("react").Dispatch<import("react").SetStateAction<StepTaskPackage[]>>;
+    assemblyDryRunResult: AssemblyDryRunResult;
+    setAssemblyDryRunResult: import("react").Dispatch<import("react").SetStateAction<AssemblyDryRunResult>>;
+    assemblyDraft: TrainingModel | null;
+    setAssemblyDraft: import("react").Dispatch<import("react").SetStateAction<TrainingModel | null>>;
+    aiRevisionTarget: AiRevisionTarget;
+    setAiRevisionTarget: import("react").Dispatch<import("react").SetStateAction<AiRevisionTarget>>;
+    aiRevisionInstruction: string;
+    setAiRevisionInstruction: import("react").Dispatch<import("react").SetStateAction<string>>;
+    aiRevisionLoading: boolean;
+    detailConversationId: string | null;
+    setDetailConversationId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    handleAiReviseDetails: (target: NonNullable<AiRevisionTarget>, instruction: string) => Promise<void>;
+    handleConfirmOutlineAndGenerate: () => Promise<void>;
+    handleConfirmPhase1AndLand: (options?: {
+        forceRelandAll?: boolean;
+    }) => Promise<void>;
+    /** 强制重跑所有步骤的落地（忽略缓存）——供 UI「全部重新落地」入口使用，默认按钮走只补跑失败步骤 */
+    handleRelandAllSteps: () => Promise<void>;
+    handleUpdateStep: (stageIndex: number, stepIndex: number, field: string, value: any) => void;
+    handleUpdateStepTaskPackageConfig: (stageIndex: number, stepIndex: number, field: "initData" | "runtimeRules" | "uiConfig", value: any) => void;
+    handleConfirmDetails: () => void;
+    generationPhase: GenerationPhase;
+    setGenerationPhase: import("react").Dispatch<import("react").SetStateAction<GenerationPhase>>;
+    phase1Artifacts: Phase1Artifacts | null;
+    setPhase1Artifacts: import("react").Dispatch<import("react").SetStateAction<Phase1Artifacts | null>>;
+    landingProgress: {
+        stepId: string;
+        stepName: string;
+        status: "error" | "done" | "pending" | "streaming";
+        attempts?: number;
+        reused?: boolean;
+    }[];
+};
+export {};

package/dist-types/client/src/admin/hooks/useStep4Cases.d.ts

@@ -0,0 +1,48 @@
+import type { TrainingModel, CaseSchema, Case } from "@shared/types/index.js";
+import type { CreatorNotifyAdapter, TokenProvider } from "../../lib/types";
+import type { TrainingBlueprint, CaseVariantPackage } from "../types/creatorArtifacts";
+import type { CaseVariantPackageOption } from "../services";
+import type { CaseScenarioData } from "../constants/creatorConstants";
+interface UseStep4CasesProps {
+    generatedModel: TrainingModel | null;
+    caseSchema: CaseSchema | null;
+    trainingBlueprint: TrainingBlueprint;
+    getToken: TokenProvider;
+    notify: CreatorNotifyAdapter;
+    onCasesGenerated: (cases: Case[]) => void;
+    onLoadingChange: (loading: {
+        visible: boolean;
+        message: string;
+    }) => void;
+    onStreamContentChange: (content: string | ((prev: string) => string)) => void;
+    saveContext?: () => void;
+}
+interface OptionsModalState {
+    visible: boolean;
+    type: string | null;
+    options: CaseVariantPackageOption[];
+    title: string;
+    isMultiple: boolean;
+}
+export declare function useStep4Cases({ generatedModel, caseSchema, trainingBlueprint, getToken, notify, onCasesGenerated, onLoadingChange, onStreamContentChange, saveContext, }: UseStep4CasesProps): {
+    caseScenario: CaseScenarioData;
+    setCaseScenario: import("react").Dispatch<import("react").SetStateAction<CaseScenarioData>>;
+    caseVariantPackages: CaseVariantPackage[];
+    setCaseVariantPackages: import("react").Dispatch<import("react").SetStateAction<CaseVariantPackage[]>>;
+    generatedCases: Case[];
+    setGeneratedCases: import("react").Dispatch<import("react").SetStateAction<Case[]>>;
+    casesConversationId: string | null;
+    setCasesConversationId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    optionsModal: OptionsModalState;
+    tempSelectedValues: string[];
+    handleGenerateCaseOptions: () => Promise<void>;
+    handleMultipleSelect: (options: any[]) => void;
+    handleMultipleConfirm: () => void;
+    handleCloseOptionsModal: () => void;
+    handleUpdateVariantField: (variantId: string, field: keyof CaseVariantPackageOption, value: any) => void;
+    handleUpdateVariantListItem: (variantId: string, field: keyof CaseVariantPackageOption, index: number, newValue: string) => void;
+    handleRemoveVariantListItem: (variantId: string, field: keyof CaseVariantPackageOption, index: number) => void;
+    handleAddVariantListItem: (variantId: string, field: keyof CaseVariantPackageOption) => void;
+    handleGenerateCasesInStep5: () => Promise<void>;
+};
+export {};