@yiyi_zhang/reactflow-ui 1.2.0 → 1.3.0

package/dist/AiWorkflowIDE.d.ts

@@ -11,6 +11,7 @@ import type { AiConfig } from './services/ai/protocolAdapter';
 import type { AiMetrics } from './store/aiStore';
 import type { WorkflowLibraryItem } from './types/workflowLibrary';
 import type { LibraryProvider } from './library/types';
+import type { IdeProviders } from './providers/types';
 import type { ExecutionActions, ThemeMode, ThemeColor, LayoutDirection, ViewMode, WorkflowExecutionInput } from './types/workflow';
 import type { CustomTool } from './services/ai/toolRegistry';
 import type { CustomValidationRule } from './services/ai/ruleEngine';
@@ -57,6 +58,12 @@ export interface AiWorkflowIDEProps {
      * ```
      */
     libraryProvider?: LibraryProvider;
+    /**
+     * 统一扩展点集合（`library` / `onboarding` / `telemetry`）。
+     * 解析顺序：专用 prop（如 `libraryProvider`）> 本 prop > 外层 `WorkflowIdeProvider` > 无。
+     * 按字段比较引用，宿主每次渲染新建对象但 provider 实例不变时不会触发目录重载。
+     */
+    providers?: IdeProviders;
     /**
      * 流程库目录注入系统提示词的条数上限，默认 50（按层级 L3 -> L1 截断）。
      * 超出部分会提示 AI 改用 `search_workflow_library` 检索。

package/dist/WorkflowIDE.d.ts

@@ -4,6 +4,7 @@ import { AIServiceConfig } from './services/aiService';
 import { ActionDefinition } from './actions/types';
 import type { WorkflowLevel } from './types/workflowLibrary';
 import type { LibraryProvider } from './library/types';
+import type { IdeProviders } from './providers/types';
 import './styles/tokens.css';
 import './styles/executionStyles.css';
 /**
@@ -18,6 +19,8 @@ export interface WorkflowIDERef {
     save: () => void;
     /** 创建空白工作流 */
     createBlankWorkflow: (name?: string) => void;
+    /** 打开「导入接口」对话框（OpenAPI / Swagger / Postman / curl），供宿主或自助接入向导调用 */
+    openApiImport: () => void;
 }
 /**
  * WorkflowIDE 组件的属性接口
@@ -121,6 +124,12 @@ export interface WorkflowIDEProps {
      * ```
      */
     libraryProvider?: LibraryProvider;
+    /**
+     * 统一扩展点集合（`library` / `onboarding` / `telemetry`）。
+     * 解析顺序：专用 prop（如 `libraryProvider`）> 本 prop > 外层 `WorkflowIdeProvider` > 无。
+     * 按字段比较引用，宿主每次渲染新建对象但 provider 实例不变时不会触发目录重载。
+     */
+    providers?: IdeProviders;
     /**
      * 当前正在编辑的工作流层级（L1 / L2 / L3）。
      * 提供时，动作选择器隐藏违反分层调用规则的流程库动作（L1 不显示 L2/L3，L2 不显示 L3）；未提供则不过滤。

package/dist/ai.d.ts

@@ -41,3 +41,19 @@ export { getCompletionItems, buildDataFlowGraph, refactorTaskReferenceName, getU
 export type { WlspCompletionItem, DataFlowGraph, DataFlowEdge, InferredField, UpstreamTaskInfo, } from './services/wlsp/workflowLsp';
 export { executeLocalSandboxDryRun, buildDefaultWorkflowMockInput, generateDefaultTaskOutputPreview, } from './utils/localSandboxEngine';
 export type { SandboxDryRunOptions, TaskMockOverride, } from './utils/localSandboxEngine';
+export { WorkflowIdeProvider, useIdeProviders } from './providers/WorkflowIdeProvider';
+export type { WorkflowIdeProviderProps } from './providers/WorkflowIdeProvider';
+export { resolveProviders, stabilizeProviders } from './providers/resolve';
+export type { ProviderSources } from './providers/resolve';
+export type { IdeProviders, OnboardingProvider, OnboardingContext, ProductInfo, StartTrialResult, PromotionStatus, } from './providers/types';
+export { WorkflowNameBuilder, OnboardingWizard, PromotionPanel, OnboardingGuideCard } from './components/onboarding';
+export type { WorkflowNameBuilderProps, OnboardingWizardProps, OnboardingCreateResult, PromotionPanelProps, OnboardingGuideCardProps, } from './components/onboarding';
+export { buildWorkflowName, validateNameParts, suggestFuncSlug, promotionTargetName, isPromotableName, buildSkeletonWorkflow, nextPollDelay, isTerminalPromotionState, buildPromotionTimeline, promotionStateLabel, pollPromotion, } from './onboarding';
+export type { WorkflowNameParts, PromotionTargetType, SkeletonInput, TimelineItem, PromotionState, StartSource } from './onboarding';
+export { createTelemetryBuffer } from './telemetry/buffer';
+export type { TelemetryBuffer, TelemetryBufferOptions } from './telemetry/buffer';
+export type { TelemetrySink, IdeEvent, IdeEventName } from './telemetry/types';
+export { detectFormat, parseApiText, parseOpenApi3, parseSwagger2, parsePostman21, parseCurl, buildHttpAction, appendImportedActions, sanitizeHeaders, } from './import';
+export type { ImportFormat, DetectedFormat, ImportedOperation, ImportedParam, ImportedBody, ParseResult, BuildHttpActionOptions, } from './import';
+export { ApiImportDialog } from './components/import/ApiImportDialog';
+export type { ApiImportDialogProps, ApiImportInsertInfo } from './components/import/ApiImportDialog';

package/dist/components/business/StepFlowEditor.d.ts

@@ -16,5 +16,11 @@ export interface StepFlowEditorProps {
     currentWorkflowLevel?: WorkflowLevel;
     /** 提供时，步骤头部显示「🤖」按钮，点击请 AI 介绍该步骤（AI IDE 中使用） */
     onAskAi?: (step: BusinessStep) => void;
+    /** 通过动作选择器新增步骤后回调（埋点用）：source = library（流程库能力）/ builtin（内置或宿主动作） */
+    onStepAdded?: (info: {
+        source: 'library' | 'builtin';
+    }) => void;
+    /** 本地沙箱试跑结束后回调（埋点用）：result 为执行状态，或 'error'（试跑抛错） */
+    onSandboxRun?: (result: string) => void;
 }
 export declare const StepFlowEditor: React.FC<StepFlowEditorProps>;

package/dist/components/import/ApiImportDialog.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { ActionDefinition } from '../../actions/types';
+import type { ImportFormat } from '../../import/types';
+export interface ApiImportInsertInfo {
+    format: ImportFormat;
+    /** 本次插入的步骤数 */
+    count: number;
+    /** 解析时产生的提示（敏感头替换、不支持的部分等） */
+    warnings: string[];
+}
+export interface ApiImportDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /**
+     * 确认插入：actions 为所选接口生成的 HTTP 业务动作（按文档顺序）。
+     * 调用方负责把动作注册到动作库并把步骤追加到流程（可用 `appendImportedActions`）；
+     * 对话框在回调返回后自动关闭。B2 向导的「从接口导入」可直接复用本组件。
+     */
+    onInsert: (actions: ActionDefinition[], info: ApiImportInsertInfo) => void;
+    /** 已存在的动作 id，用于避免重复导入时 id 冲突 */
+    existingActionIds?: Iterable<string>;
+}
+/**
+ * 接口导入对话框：粘贴或上传 -> 识别格式 -> 勾选接口 -> 插入为步骤。
+ * 外层仅在打开时挂载内容，因此每次打开都是干净状态。
+ */
+export declare const ApiImportDialog: React.FC<ApiImportDialogProps>;

package/dist/components/onboarding/ModalShell.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+export interface ModalShellProps {
+    /** 用于 aria-labelledby 的标题元素 id */
+    titleId: string;
+    title: string;
+    onClose: () => void;
+    children: ReactNode;
+    footer?: ReactNode;
+    width?: number;
+}
+/**
+ * 自助接入弹窗外壳：Portal 渲染到 body，并带上 data-mode / data-brand 使主题变量生效。
+ * 无障碍：role="dialog" + aria-modal + 标题关联；Esc 关闭；Tab 在弹窗内循环；关闭后焦点回到打开前的元素。
+ */
+export declare function ModalShell({ titleId, title, onClose, children, footer, width }: ModalShellProps): import("react").ReactPortal | null;

package/dist/components/onboarding/OnboardingController.d.ts

@@ -0,0 +1,67 @@
+import type { OnboardingProvider, ProductInfo } from '../../providers/types';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+import type { IdeEventName } from '../../telemetry/types';
+import type { OnboardingCreateResult } from './OnboardingWizard';
+import type { OnboardingData } from './useOnboardingData';
+/** 向导创建骨架后、选择了模板 / 导入时暂存的流程身份，供宿主在后续步骤里保留名称 */
+export interface PendingIdentity {
+    name: string;
+    description: string;
+    ownerEmail?: string;
+}
+export interface OnboardingControllerOptions {
+    /** 解析后的 providers.onboarding；不存在时一切入口都不出现 */
+    provider: OnboardingProvider | undefined;
+    /** useTelemetry 返回的 track */
+    track: (name: IdeEventName, props?: Record<string, unknown>) => void;
+    /** 只读 / 运行态时隐藏入口 */
+    disabled?: boolean;
+    /** 向导「模板中心」起点的回调；不提供则隐藏该选项 */
+    onPickTemplate?: () => void;
+    /** 向导「从接口导入」起点的回调；不提供则隐藏该选项 */
+    onImportApi?: () => void;
+    ownerEmail?: string;
+}
+export interface OnboardingController {
+    enabled: boolean;
+    data: OnboardingData;
+    /** 向导选择的层级；宿主没有传 currentWorkflowLevel 时作为默认值 */
+    level: WorkflowLevel | undefined;
+    wizardOpen: boolean;
+    promoOpen: boolean;
+    openWizard: () => void;
+    openPromotion: () => void;
+    /** 当前流程是否可申请上线（名称可解析且类型为 tmp） */
+    canPromote: boolean;
+    /** 是否显示空画布的「开始试用」引导 */
+    showGuide: boolean;
+    dismissGuide: () => void;
+    /** 取走并清空暂存的流程身份（选了模板 / 导入后使用） */
+    takePendingIdentity: () => PendingIdentity | null;
+    provider: OnboardingProvider | undefined;
+    /** 以下供 OnboardingOverlays 使用 */
+    close: () => void;
+    handleCreate: (r: OnboardingCreateResult) => void;
+    handleTrialStarted: (p: ProductInfo) => void;
+    onPickTemplate?: () => void;
+    onImportApi?: () => void;
+    ownerEmail?: string;
+    track: OnboardingControllerOptions['track'];
+}
+/**
+ * IDE 内部使用：把自助接入的状态与动作集中在一处，IDE 只需渲染
+ * `<OnboardingToolbarButtons>`、`<OnboardingOverlays>` 与（可选）引导卡片。
+ */
+export declare function useOnboardingController(opts: OnboardingControllerOptions): OnboardingController;
+/** 工具栏入口：「新建流程」与「申请上线」。没有 onboarding provider 时不渲染任何内容 */
+export declare function OnboardingToolbarButtons({ c }: {
+    c: OnboardingController;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** 弹窗：向导与申请上线面板（Portal 渲染，自带主题属性） */
+export declare function OnboardingOverlays({ c }: {
+    c: OnboardingController;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** 空画布引导：覆盖整个 IDE 的半透明层（不拦截点击），卡片居中；仅 `c.showGuide` 时渲染 */
+export declare function OnboardingGuideOverlay({ c }: {
+    c: OnboardingController;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/onboarding/OnboardingGuideCard.d.ts

@@ -0,0 +1,10 @@
+export interface OnboardingGuideCardProps {
+    onStart: () => void;
+    /** 提供时显示「暂不使用」，用于露出画布原有的空状态 */
+    onDismiss?: () => void;
+}
+/**
+ * 空画布上的「开始试用」引导卡片。
+ * 仅在测试环境开放自助试用且用户还没有所属产品时由宿主显示。
+ */
+export declare function OnboardingGuideCard({ onStart, onDismiss }: OnboardingGuideCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/onboarding/OnboardingWizard.d.ts

@@ -0,0 +1,42 @@
+import type { OnboardingProvider, ProductInfo } from '../../providers/types';
+import type { WorkflowDef } from '../../types/conductor';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+import type { StartSource } from '../../onboarding/wizardState';
+export interface OnboardingCreateResult {
+    /** 向导生成的骨架定义（名称已按规范拼好） */
+    def: WorkflowDef;
+    /** 所选层级，宿主可据此设置 `currentWorkflowLevel` */
+    level: WorkflowLevel;
+    /** 起点：空白 / 模板中心 / 从接口导入 */
+    source: StartSource;
+}
+export interface OnboardingWizardProps {
+    /** 只用到 startTrial；传完整的 OnboardingProvider 即可 */
+    provider: Pick<OnboardingProvider, 'startTrial'>;
+    /** 当前环境是否开放自助试用（决定能否登记新产品、类型是否固定 tmp） */
+    trialEnabled: boolean;
+    /** 我的产品 */
+    products: ProductInfo[];
+    /** 业务域列表 */
+    domains: string[];
+    /** 默认层级，默认 L2 */
+    defaultLevel?: WorkflowLevel;
+    /** 写入骨架定义的负责人邮箱 */
+    ownerEmail?: string;
+    onClose: () => void;
+    /** 完成：交给宿主把骨架设为当前流程 */
+    onCreate: (result: OnboardingCreateResult) => void;
+    /** 新产品登记成功（宿主可刷新「我的产品」、上报 trial_started） */
+    onTrialStarted?: (product: ProductInfo) => void;
+    /** 选择「从模板中心开始」：创建骨架后调用，宿主打开模板中心；不提供则隐藏该选项 */
+    onPickTemplate?: () => void;
+    /** 选择「从接口导入」：创建骨架后调用，宿主打开导入面板；不提供则隐藏该选项 */
+    onImportApi?: () => void;
+}
+/**
+ * 自助接入向导（3 步弹窗）：产品 → 命名 → 起点。
+ * - 试用环境可登记新产品（startTrial）；产品被他人占用时提示联系负责人；
+ * - 接口失败停在当前步，显示「重试」，已填内容保留；
+ * - 完成后用 `onCreate({ def, level, source })` 交给宿主设置当前流程。
+ */
+export declare function OnboardingWizard({ provider, trialEnabled, products, domains, defaultLevel, ownerEmail, onClose, onCreate, onTrialStarted, onPickTemplate, onImportApi, }: OnboardingWizardProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/onboarding/PromotionPanel.d.ts

@@ -0,0 +1,20 @@
+import type { OnboardingProvider, PromotionStatus } from '../../providers/types';
+import type { PromotionTargetType } from '../../onboarding/naming';
+export interface PromotionPanelProps {
+    /** 用到 requestPromotion / getPromotion */
+    provider: Pick<OnboardingProvider, 'requestPromotion' | 'getPromotion'>;
+    /** 当前（tmp 类型的）流程名称 */
+    workflowName: string;
+    /** 当前流程版本 */
+    version: number;
+    onClose: () => void;
+    /** 提交成功（埋点：promotion_requested） */
+    onRequested?: (targetType: PromotionTargetType) => void;
+    /** 状态变化（埋点：promotion_state），同一状态只回调一次 */
+    onStateChange?: (state: PromotionStatus['state']) => void;
+}
+/**
+ * 申请上线面板：选择目标类型 → 预览正式名称 → 提交 → 轮询进度（指数退避，30 秒封顶）。
+ * 轮询在关闭面板 / 卸载时中止。
+ */
+export declare function PromotionPanel({ provider, workflowName, version, onClose, onRequested, onStateChange }: PromotionPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/onboarding/WorkflowNameBuilder.d.ts

@@ -0,0 +1,19 @@
+import type { ProductInfo } from '../../providers/types';
+import type { WorkflowNameParts } from '../../onboarding/naming';
+export interface WorkflowNameBuilderProps {
+    /** 可选的所属产品（我的产品）；业务域取自所选产品 */
+    products: ProductInfo[];
+    /** 允许的业务域列表；提供时参与校验 */
+    domains?: string[];
+    /** 试用环境：类型固定为 tmp；否则可选 custom / std */
+    trial: boolean;
+    value: WorkflowNameParts;
+    onChange: (next: WorkflowNameParts) => void;
+    disabled?: boolean;
+}
+/**
+ * 五段式命名生成器：`类型-层级-业务域-产品-功能`。
+ * 受控组件：类型（试用固定 tmp）、层级、产品（下拉我的产品，业务域随产品带出）、功能（自由输入，推荐 snake_case），
+ * 实时预览完整名称并用 `validateWorkflowName` 校验。
+ */
+export declare function WorkflowNameBuilder({ products, domains, trial, value, onChange, disabled }: WorkflowNameBuilderProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/onboarding/index.d.ts

@@ -0,0 +1,8 @@
+export { WorkflowNameBuilder } from './WorkflowNameBuilder';
+export type { WorkflowNameBuilderProps } from './WorkflowNameBuilder';
+export { OnboardingWizard } from './OnboardingWizard';
+export type { OnboardingWizardProps, OnboardingCreateResult } from './OnboardingWizard';
+export { PromotionPanel } from './PromotionPanel';
+export type { PromotionPanelProps } from './PromotionPanel';
+export { OnboardingGuideCard } from './OnboardingGuideCard';
+export type { OnboardingGuideCardProps } from './OnboardingGuideCard';

package/dist/components/onboarding/styles.d.ts

@@ -0,0 +1,11 @@
+import type { CSSProperties } from 'react';
+/** 自助接入组件共用的内联样式：只使用主题 CSS 变量，弹窗根节点另行设置 data-mode / data-brand */
+export declare const labelStyle: CSSProperties;
+export declare const inputStyle: CSSProperties;
+export declare const hintStyle: CSSProperties;
+export declare const errorStyle: CSSProperties;
+export declare const buttonBase: CSSProperties;
+export declare const primaryButton: CSSProperties;
+export declare const ghostButton: CSSProperties;
+export declare function disabledStyle(base: CSSProperties, disabled: boolean): CSSProperties;
+export declare const noticeStyle: (kind: "error" | "warning" | "success") => CSSProperties;

package/dist/components/onboarding/useOnboardingData.d.ts

@@ -0,0 +1,17 @@
+import type { OnboardingContext, OnboardingProvider, ProductInfo } from '../../providers/types';
+export interface OnboardingData {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    context: OnboardingContext | null;
+    domains: string[];
+    products: ProductInfo[];
+    error: string | null;
+    /** 重新加载（失败后重试） */
+    reload: () => void;
+    /** 新登记产品后本地追加，避免再请求一次 */
+    addProduct: (p: ProductInfo) => void;
+}
+/**
+ * 按 provider 实例加载一次：上下文、业务域、我的产品。
+ * provider 引用变化时重新加载；卸载或切换时中止进行中的请求。没有 provider 时保持 idle。
+ */
+export declare function useOnboardingData(provider: OnboardingProvider | undefined): OnboardingData;

package/dist/components/template/TemplateGallery.d.ts

@@ -6,5 +6,7 @@ export interface TemplateGalleryProps {
     onClose: () => void;
     onSelectTemplate: (configuredDef: WorkflowDef) => void;
     templateStore?: TemplateStore;
+    /** 试跑结束（快捷试跑或向导内试跑）：参数为最终状态或 'error'，用于接入埋点，不含数据 */
+    onSandboxRun?: (result: string) => void;
 }
 export declare const TemplateGallery: React.FC<TemplateGalleryProps>;

package/dist/components/template/TemplateSetupWizard.d.ts

@@ -5,5 +5,7 @@ export interface TemplateSetupWizardProps {
     template: WorkflowTemplate;
     onApply: (configuredDef: WorkflowDef) => void;
     onClose: () => void;
+    /** 向导内试跑结束：最终状态或 'error'（埋点用，不含数据） */
+    onSandboxRun?: (result: string) => void;
 }
 export declare const TemplateSetupWizard: React.FC<TemplateSetupWizardProps>;

package/dist/import/buildAction.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ImportedOperation → 业务动作（ActionDefinition）。
+ *
+ * - 字段：路径参数 / 查询参数 / 请求头参数 / 请求体属性，沿用 `buildFields` 规则（title → 标签、enum → 下拉、
+ *   类型 → 控件），全部支持插入数据胶囊；
+ * - 出参：2xx 响应 schema，沿用 `buildOutputs`，键为 Conductor HTTP 任务的真实输出路径
+ *   `response.body.<字段>`，因此数据胶囊引用 `${ref.output.response.body.xxx}` 运行时可直接取到；
+ * - 编译：Conductor `HTTP` 任务，`inputParameters` 里保留 `_actionId` 与各字段值，
+ *   使步骤重新打开时能被 `decompile` 还原为同一动作（动作未注册时退回「专业步骤」卡片，定义无损）。
+ */
+import type { ActionDefinition } from '../actions/types';
+import type { ImportedOperation } from './types';
+export interface BuildHttpActionOptions {
+    /** 已存在的动作 id（完整 id，如 `import.get_tickets`）：冲突时自动追加 `_2` 等后缀 */
+    existingIds?: Iterable<string>;
+    /** 动作 id 前缀，默认 `import` */
+    idPrefix?: string;
+}
+/**
+ * 由导入的接口生成 HTTP 业务动作。
+ * 固定请求头会再做一次敏感值检查（解析器已处理时这里是空操作），保证动作定义里不会出现凭据。
+ */
+export declare function buildHttpAction(op: ImportedOperation, opts?: BuildHttpActionOptions): ActionDefinition;

package/dist/import/common.d.ts

@@ -0,0 +1,17 @@
+/** 各格式解析器共用的收尾逻辑（纯函数）。 */
+import type { ImportedOperation } from './types';
+import type { ImportedParam } from './types';
+/** 收尾：替换固定请求头里的敏感值，并把提示并入接口的 warnings */
+export declare function finishOperation(op: ImportedOperation): ImportedOperation;
+/** 接口的展示标识：`GET /tickets/{id}` */
+export declare function operationLabel(op: Pick<ImportedOperation, 'method' | 'path'>): string;
+/** 汇总所有接口的提示（带接口前缀，去重） */
+export declare function collectWarnings(ops: ImportedOperation[], extra?: string[]): string[];
+/** 把 JSON 示例的顶层属性作为默认值写入 schema；敏感字段名的默认值换成占位 */
+export declare function schemaWithDefaults(example: unknown, warnings: string[]): Record<string, any>;
+/** 把查询串解析为 query 参数（字面量作为默认值；敏感参数名的值替换为占位） */
+export declare function queryParamsFromString(query: string, warnings: string[]): ImportedParam[];
+/** Content-Type / Accept 由 body.contentType 与 accept 统一输出，不再作为固定头 */
+export declare function dropContentHeaders(headers: Record<string, string>): Record<string, string>;
+/** 不区分大小写取请求头的值 */
+export declare function findHeader(headers: Record<string, string>, name: string): string | undefined;

package/dist/import/curl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * curl 命令 → ImportedOperation[]（恒为 0 或 1 个接口）。
+ * 支持：-X、-H（多个）、-d / --data / --data-raw / --data-binary、-u、--url、-G、行尾 `\` 续行、
+ * 单引号 / 双引号 / `$'…'`（浏览器「复制为 cURL」）。不执行任何命令。
+ */
+import type { ParseResult } from './types';
+/** 把命令行切成 token（兼容续行与常见引号写法） */
+export declare function tokenizeCurl(input: string): string[];
+/** 提示用的 curl 示例（对话框 placeholder 使用） */
+export declare const CURL_SAMPLE = "curl -X POST 'https://api.example.com/v1/tickets' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Authorization: Bearer <token>' \\\n  -d '{\"title\":\"\u78C1\u76D8\u544A\u8B66\",\"priority\":\"high\"}'";
+/** 解析一条 curl 命令 */
+export declare function parseCurl(command: string): ParseResult;

package/dist/import/detect.d.ts

@@ -0,0 +1,9 @@
+/** 输入格式识别与统一入口（纯函数，不抛异常）。 */
+import type { DetectedFormat, ParseResult } from './types';
+/** 识别输入文本的格式 */
+export declare function detectFormat(text: string): DetectedFormat;
+/**
+ * 识别并解析：返回 ParseResult，永不抛异常。
+ * YAML 不受支持，返回固定提示 {@link YAML_HINT}。
+ */
+export declare function parseApiText(text: string): ParseResult;

package/dist/import/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types';
+export { detectFormat, parseApiText } from './detect';
+export { parseOpenApi3, parseSwagger2 } from './openapi';
+export { parsePostman21 } from './postman';
+export { parseCurl, tokenizeCurl, CURL_SAMPLE } from './curl';
+export { buildHttpAction } from './buildAction';
+export type { BuildHttpActionOptions } from './buildAction';
+export { appendImportedActions, blankImportWorkflow, collectWorkflowInputRefs } from './insert';
+export { resolveSchema } from './schema';
+export { isSensitiveHeader, sanitizeHeaders, inputPlaceholder } from './sensitive';

package/dist/import/insert.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 把导入生成的动作作为步骤追加到流程末尾（纯函数，业务模式与专业模式共用）。
+ * B2 向导的「从接口导入」也可直接复用。
+ */
+import type { ActionDefinition } from '../actions/types';
+import type { TaskDef, WorkflowDef } from '../types/conductor';
+/** 没有当前流程时使用的空白骨架 */
+export declare function blankImportWorkflow(name?: string): WorkflowDef;
+/** 取出任务里引用的 `${workflow.input.xxx}` 的顶层入参名 */
+export declare function collectWorkflowInputRefs(tasks: TaskDef[]): string[];
+/**
+ * 为每个动作按默认值生成一个步骤并追加到 `def.tasks` 末尾；
+ * 步骤引用的 `${workflow.input.xxx}`（敏感头占位、路径参数默认值等）会补进流程的入参声明。
+ * 不修改入参，返回新的定义。
+ */
+export declare function appendImportedActions(def: WorkflowDef | null | undefined, actions: ActionDefinition[]): WorkflowDef;

package/dist/import/openapi.d.ts

@@ -0,0 +1,9 @@
+/**
+ * OpenAPI 3.x / Swagger 2.0（JSON 文档对象）→ ImportedOperation[]。
+ * 只做解析，不发请求；解析失败返回 { ok: false }，不抛异常。
+ */
+import type { ParseResult } from './types';
+/** 解析 OpenAPI 3.x 文档对象 */
+export declare function parseOpenApi3(doc: unknown): ParseResult;
+/** 解析 Swagger 2.0 文档对象 */
+export declare function parseSwagger2(doc: unknown): ParseResult;

package/dist/import/postman.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Postman Collection v2.1（JSON 文档对象）→ ImportedOperation[]。
+ * Postman 变量 `{{var}}` 转为 `${workflow.input.var}`；认证配置只生成占位，不读取凭据值。
+ */
+import type { ParseResult } from './types';
+/** `{{var}}` → `${workflow.input.var}`；记录用到的变量名 */
+export declare function convertPostmanVars(text: string, used?: Set<string>): string;
+/** 解析 Postman Collection v2.1 文档对象 */
+export declare function parsePostman21(doc: unknown): ParseResult;

package/dist/import/schema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * JSON Schema 本地 `$ref` 解析（OpenAPI 3 `#/components/schemas/...`、Swagger 2 `#/definitions/...`）。
+ * 防循环引用，最大展开深度 6；不处理远程引用。
+ */
+import type { JsonSchema } from './types';
+export declare const MAX_SCHEMA_DEPTH = 6;
+/** 按 JSON Pointer（`#/a/b`）取值，找不到返回 undefined */
+export declare function resolvePointer(root: unknown, ref: string): unknown;
+/** 解开非 schema 对象（parameter / requestBody / response）上的 `$ref`，最多跳 10 次 */
+export declare function derefObject<T = any>(node: unknown, root: unknown): T | undefined;
+/**
+ * 解析 schema：展开本地 `$ref` 与 allOf，oneOf / anyOf 取第一个分支。
+ * 超过深度上限的节点只保留类型；循环引用处截断为 `{ type: 'object' }` 并在 warnings 中提示一次。
+ */
+export declare function resolveSchema(schema: unknown, root: unknown, warnings?: string[], maxDepth?: number): JsonSchema;

package/dist/import/sensitive.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 敏感信息处理：请求头 / 查询参数 / 请求体字段里的凭据不落入流程定义，
+ * 一律替换为 `${workflow.input.xxx}` 占位，并给出提示。
+ */
+export declare function isSensitiveHeader(name: string): boolean;
+/** 查询参数 / 请求体字段名是否敏感 */
+export declare function isSensitiveName(name: string): boolean;
+/** 占位表达式：`${workflow.input.<camelName>}` */
+export declare function inputPlaceholder(name: string): string;
+export declare function sensitiveHeaderWarning(name: string): string;
+/**
+ * 替换请求头中的敏感值。已是 `${...}` 表达式的值视为已处理，原样保留。
+ * 返回新对象，不修改入参。
+ */
+export declare function sanitizeHeaders(headers: Record<string, string>): {
+    headers: Record<string, string>;
+    warnings: string[];
+};

package/dist/import/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 接口导入：解析结果的公共类型（纯数据，无 React 依赖）。
+ * 设计见 docs/design/v1.3.0-自助接入设计.md 第 4 节。
+ */
+/** 可导入的来源格式 */
+export type ImportFormat = 'openapi3' | 'swagger2' | 'postman21' | 'curl';
+/** detectFormat 的结果：除可导入格式外，还可能是 YAML（不支持）或无法识别 */
+export type DetectedFormat = ImportFormat | 'yaml' | 'unknown';
+/** JSON Schema 片段（已解析本地 $ref，保持宽松类型） */
+export type JsonSchema = Record<string, any>;
+export type ParamLocation = 'path' | 'query' | 'header';
+export interface ImportedParam {
+    name: string;
+    in: ParamLocation;
+    required: boolean;
+    schema: JsonSchema;
+    description?: string;
+    /** 导入时带入的默认值（curl / Postman 中的字面量；敏感名称已替换为占位） */
+    defaultValue?: string;
+}
+export interface ImportedBody {
+    /** 例如 application/json */
+    contentType: string;
+    /** object 且含 properties 时拆成多个字段；否则整体作为单个 `body` 字段 */
+    schema: JsonSchema;
+}
+export interface ImportedOperation {
+    /** 同一次解析内唯一，形如 `get_tickets_id`，用于动作 id（`import.<id>`） */
+    id: string;
+    /** 大写 HTTP 方法 */
+    method: string;
+    /** 服务地址（不含路径），可能为空或含 `${workflow.input.xxx}` */
+    baseUrl: string;
+    /** 路径模板，路径参数写作 `{id}` */
+    path: string;
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags: string[];
+    params: ImportedParam[];
+    /** 固定请求头（敏感头的值已替换为 `${workflow.input.xxx}` 占位） */
+    headers: Record<string, string>;
+    body?: ImportedBody;
+    /** 2xx 响应的 JSON Schema */
+    responseSchema?: JsonSchema;
+    /** 与该接口相关的提示（敏感头替换、不支持的部分等） */
+    warnings: string[];
+}
+export type ParseResult = {
+    ok: true;
+    format: ImportFormat;
+    operations: ImportedOperation[];
+    /** 汇总提示（含各接口的提示，已带接口前缀） */
+    warnings: string[];
+} | {
+    ok: false;
+    format?: DetectedFormat;
+    /** 面向用户的中文错误信息 */
+    error: string;
+};
+/** 提示用户把 YAML 转成 JSON 的固定文案 */
+export declare const YAML_HINT = "YAML \u8BF7\u5148\u8F6C\u4E3A JSON \u540E\u518D\u5BFC\u5165";

package/dist/import/util.d.ts

@@ -0,0 +1,23 @@
+/** 接口导入内部的小工具（纯函数）。 */
+import type { JsonSchema } from './types';
+export declare const HTTP_METHODS: readonly ["get", "post", "put", "delete", "patch", "head", "options"];
+export declare function isPlainObject(v: unknown): v is Record<string, any>;
+/** 去 BOM、首尾空白 */
+export declare function normalizeText(text: string): string;
+/** 把任意名称转为 snake_case 片段（只保留字母数字） */
+export declare function slugify(raw: string, maxLen?: number): string;
+/** 把名称转为 camelCase（用于 `${workflow.input.xxx}`） */
+export declare function camelName(raw: string): string;
+/** 在已有 id 集合内取唯一 id（冲突时追加 _2、_3…），并登记到集合 */
+export declare function uniqueId(base: string, used: Set<string>): string;
+/** 由一个 JSON 示例值推断简单 schema（不含 default） */
+export declare function inferSchema(value: unknown, depth?: number): JsonSchema;
+/** 取 schema 的主类型（忽略 null） */
+export declare function schemaType(schema: JsonSchema | undefined): string;
+/** 简单的 URL 拆分：baseUrl（协议+主机 或 `${...}` 变量）、路径、查询串 */
+export declare function splitUrl(raw: string): {
+    baseUrl: string;
+    path: string;
+    query: string;
+};
+export declare function safeDecode(s: string): string;

package/dist/index.d.ts

@@ -43,3 +43,19 @@ export type { RunStoryTimelineProps } from './components/business/RunStoryTimeli
 export * from './library';
 export type { WorkflowLevel, WorkflowLibraryItem } from './types/workflowLibrary';
 export type { TaskSchema } from './services/ai/schemaRegistry';
+export { WorkflowIdeProvider, useIdeProviders } from './providers/WorkflowIdeProvider';
+export type { WorkflowIdeProviderProps } from './providers/WorkflowIdeProvider';
+export { resolveProviders, stabilizeProviders } from './providers/resolve';
+export type { ProviderSources } from './providers/resolve';
+export type { IdeProviders, OnboardingProvider, OnboardingContext, ProductInfo, StartTrialResult, PromotionStatus, } from './providers/types';
+export { WorkflowNameBuilder, OnboardingWizard, PromotionPanel, OnboardingGuideCard } from './components/onboarding';
+export type { WorkflowNameBuilderProps, OnboardingWizardProps, OnboardingCreateResult, PromotionPanelProps, OnboardingGuideCardProps, } from './components/onboarding';
+export { buildWorkflowName, validateNameParts, suggestFuncSlug, promotionTargetName, isPromotableName, buildSkeletonWorkflow, nextPollDelay, isTerminalPromotionState, buildPromotionTimeline, promotionStateLabel, pollPromotion, } from './onboarding';
+export type { WorkflowNameParts, PromotionTargetType, SkeletonInput, TimelineItem, PromotionState, StartSource } from './onboarding';
+export { createTelemetryBuffer } from './telemetry/buffer';
+export type { TelemetryBuffer, TelemetryBufferOptions } from './telemetry/buffer';
+export type { TelemetrySink, IdeEvent, IdeEventName } from './telemetry/types';
+export { detectFormat, parseApiText, parseOpenApi3, parseSwagger2, parsePostman21, parseCurl, buildHttpAction, appendImportedActions, sanitizeHeaders, } from './import';
+export type { ImportFormat, DetectedFormat, ImportedOperation, ImportedParam, ImportedBody, ParseResult, BuildHttpActionOptions, } from './import';
+export { ApiImportDialog } from './components/import/ApiImportDialog';
+export type { ApiImportDialogProps, ApiImportInsertInfo } from './components/import/ApiImportDialog';

package/dist/onboarding/index.d.ts

@@ -0,0 +1,6 @@
+export { buildWorkflowName, validateNameParts, suggestFuncSlug, promotionTargetName, isPromotableName, buildSkeletonWorkflow, } from './naming';
+export type { WorkflowNameParts, PromotionTargetType, SkeletonInput } from './naming';
+export { nextPollDelay, isTerminalPromotionState, buildPromotionTimeline, promotionStateLabel, pollPromotion, } from './poll';
+export type { TimelineItem, PollOptions, PromotionState } from './poll';
+export { WIZARD_STEPS, WIZARD_STEP_LABEL, createInitialDraft, validateProductName, productStepError, namingStepErrors, draftToNameParts, canAdvance, nextStep, prevStep, availableSources, } from './wizardState';
+export type { WizardStep, WizardDraft, StartSource } from './wizardState';