@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/lib/workbenchApi.d.ts

@@ -0,0 +1,686 @@
+/**
+ * @fileoverview 个人工作台 run-agent 代理 API 客户端。
+ * @author seadon
+ * @created 2026-05-06
+ */
+import type { AssistantPersonaPayload, AssistantPersonaKey, BlockLayout, BlockPlan, ConversationScreenContext, ConversationConfirmation, LayoutConfig, MaterializedBlock, MaterializeResponse, MutationTransaction, PatchPlan, PlanResponse, RoleId, SubmitDraft, UserWorkbenchPreference, WorkbenchPlanStreamEvent, WorkbenchSnapshot, WorkbenchTemplate } from '@fses/workbench-app/types';
+import type { ComposeStreamEvent, WorkbenchV2Document } from '@workbench-internal/types/workbenchV2';
+import type { FdeWorkbenchAssetPackage } from './fdeWorkbenchAssetPackage';
+import type { MetricFilterBinding } from './workbenchMetricFilterBinding';
+import type { SystemCardWorkbenchPromptParams } from './workbenchSystemCardPrompt';
+import type { WorkbenchChatHistoryMessage } from './workbenchChatHistory';
+export { runtimeIdentityHeaders } from './runtimeIdentity';
+export interface WorkbenchUpdateInfoPayload {
+    workspaceId: string;
+    name?: string;
+    description?: string;
+}
+export interface WorkbenchDisplaySpec {
+    unitCode?: string;
+    unitLabel?: string;
+    valueFormat?: string;
+    decimalPlaces?: number;
+    displayValue?: string;
+}
+export interface WorkbenchConversationSubject {
+    subjectId: string;
+    type: 'runtime_metric';
+    sourceTurnId?: string;
+    confidence: number;
+    payload: {
+        metricName?: string;
+        metricCode: string;
+        metricId?: string;
+        appId?: string;
+    };
+    displaySpec?: WorkbenchDisplaySpec;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkbenchActionPayload {
+    capabilityId: 'runtime_metric.query' | 'semantic_sql.query' | 'query_result.followup' | 'general_answer.open_domain' | 'workbench_card.patch' | 'workbench_card.compose' | 'data_action.execute' | 'cross_source.compute' | string;
+    action?: string;
+    cardIntent?: Record<string, unknown>;
+    dataActionIntent?: Record<string, unknown>;
+    queryIntent?: string;
+    quickEntryId?: string;
+    source?: string;
+    subject?: WorkbenchConversationSubject;
+    sourceTurnId?: string;
+    [key: string]: unknown;
+}
+export interface WorkbenchAssetImportResult {
+    workspaceId: string;
+    userId: string;
+    roleId: RoleId | string;
+    importedCardCount: number;
+    importedQueryPlanCount: number;
+    existed?: boolean;
+    skipped?: boolean;
+    skipReason?: string;
+}
+export interface WorkbenchChatActionRef {
+    capabilityId?: string;
+    action?: string;
+    sourceTurnId?: string;
+    subjectId?: string;
+}
+export interface WorkbenchChatRequestRefs {
+    workspaceId?: string;
+    selectedBlockId?: string;
+    selectedSystemCardId?: string;
+    businessGroupId?: string;
+    attachmentIds?: string[];
+    action?: WorkbenchChatActionRef;
+}
+export interface WorkbenchPrologueResult {
+    prologueContent: string;
+}
+export interface WorkbenchApplicationOption {
+    value: string;
+    label: string;
+}
+export interface WorkbenchChartModelServiceOption {
+    value: string;
+    label: string;
+    appId: string;
+    dataCode: string;
+    svcCode: string;
+    dataSvcMode: string;
+}
+export interface WorkbenchChartListOption {
+    value: string;
+    label: string;
+    appId: string;
+    dataCode: string;
+    formKey: string;
+}
+export interface WorkbenchChartMetricOption {
+    value: string;
+    label: string;
+    appId: string;
+    metricCode: string;
+}
+export interface WorkbenchAccessCheckResult {
+    allowed: boolean;
+    code: string;
+    message: string;
+    state: string;
+}
+export interface WorkbenchContext {
+    workspaceId: string;
+    roleId: RoleId | '';
+    userId: string;
+    tenantId?: string;
+    appId?: string;
+}
+export type WorkbenchIdentityContext = Pick<WorkbenchContext, 'userId' | 'tenantId' | 'appId'>;
+export interface WorkbenchRuntimeIdentity {
+    userId: string;
+    tenantId: string;
+    source: string;
+}
+/**
+ * 构建仅含用户身份的工作台请求上下文。
+ * @param context - 当前用户上下文。
+ * @returns 不含 roleId 的用户请求上下文。
+ */
+export interface WorkbenchPromptAttachment {
+    id?: string;
+    name?: string;
+    type?: string;
+    url?: string;
+}
+export declare function fetchWorkbenchSnapshot(context: WorkbenchContext): Promise<WorkbenchSnapshot>;
+/**
+ * 读取后端可信运行态身份，供直接打开工作台 URL 时补齐用户作用域。
+ * @returns 当前请求可信用户、租户和身份来源。
+ */
+export declare function fetchWorkbenchIdentity(): Promise<WorkbenchRuntimeIdentity>;
+/**
+ * Checks whether the current user can access a personal workbench resource.
+ * @param resourceId - Workbench resource_id from the route entry.
+ * @returns Normalized access check result.
+ */
+export declare function fetchWorkbenchAccessCheck(resourceId: string): Promise<WorkbenchAccessCheckResult>;
+/**
+ * Fetches current tenant manageable applications for chart config dropdowns.
+ * @param options - Optional fuzzy app name search.
+ * @returns Normalized dropdown options.
+ */
+export declare function fetchWorkbenchApplications(options?: {
+    name?: string;
+}): Promise<WorkbenchApplicationOption[]>;
+/**
+ * Fetches model selectMore services for the selected platform application.
+ * @param appId - Selected platform application id.
+ * @returns Flattened model-service dropdown options.
+ */
+export declare function fetchWorkbenchChartModelServices(appId: string): Promise<WorkbenchChartModelServiceOption[]>;
+/**
+ * Fetches metric dictionary options for the selected platform application.
+ * @param appId - Selected platform application id.
+ * @returns Metric dropdown options.
+ */
+export declare function fetchWorkbenchChartMetrics(appId: string): Promise<WorkbenchChartMetricOption[]>;
+/**
+ * Fetches list pages for the selected platform application.
+ * @param appId - Selected platform application id.
+ * @returns Flattened list dropdown options.
+ */
+export declare function fetchWorkbenchChartLists(appId: string): Promise<WorkbenchChartListOption[]>;
+/**
+ * Imports a FDE draft asset package into the ES-backed runtime workbench store.
+ * @param context - Runtime target scope that will own the published workbench.
+ * @param assetPackage - FDE asset package generated by the editor or host draft.
+ * @returns Import counts returned by run-agent.
+ */
+export declare function importWorkbenchAssetPackage(context: WorkbenchContext, assetPackage: FdeWorkbenchAssetPackage): Promise<WorkbenchAssetImportResult>;
+/**
+ * Ensures a published FDE system asset package has been imported before opening its runtime workspace.
+ * @param context - Runtime target scope that will own the published workbench.
+ * @param payload - System resource id to import into the target workspace id.
+ * @returns Import result or existed marker returned by run-agent.
+ */
+export declare function ensurePublishedWorkbenchAssetPackage(context: WorkbenchContext, payload: {
+    resource_id: string;
+}): Promise<WorkbenchAssetImportResult & {
+    existed?: boolean;
+}>;
+export declare function fetchWorkbenchWorkspaces(context: WorkbenchIdentityContext): Promise<{
+    workbenches: WorkbenchTemplate[];
+    preference: UserWorkbenchPreference;
+}>;
+/**
+ * 获取个人工作台开场白。
+ * @param resourceId - 当前工作台 resource_id。
+ * @returns 归一化后的开场白文案。
+ */
+export declare function fetchWorkbenchPrologue(resourceId: string): Promise<WorkbenchPrologueResult>;
+export declare function selectWorkbench(context: WorkbenchIdentityContext, payload: {
+    workspaceId: string;
+    assistantPersona?: AssistantPersonaKey;
+}): Promise<UserWorkbenchPreference>;
+export declare function saveAssistantPersonaPreference(context: WorkbenchIdentityContext, payload: {
+    workspaceId: string;
+    assistantPersona: AssistantPersonaKey;
+}): Promise<UserWorkbenchPreference>;
+export declare function updateWorkbenchInfo(context: WorkbenchIdentityContext, payload: WorkbenchUpdateInfoPayload): Promise<WorkbenchTemplate>;
+export declare function deleteWorkbench(context: WorkbenchIdentityContext, payload: {
+    workspaceId: string;
+}): Promise<{
+    message: string;
+}>;
+export declare function saveWorkbenchSnapshot(context: WorkbenchContext, snapshot: WorkbenchSnapshot, options?: {
+    baseVersion?: number;
+    persistenceFallbackReason?: string;
+    persistenceFallbackSummary?: Record<string, unknown>;
+}): Promise<WorkbenchSnapshot>;
+export declare function confirmCardMutation(context: WorkbenchContext, payload: {
+    turnId: string;
+    conversationId?: string;
+    confirmed: boolean;
+}): Promise<{
+    snapshot: WorkbenchSnapshot;
+    mutationTransaction?: MutationTransaction;
+    confirmation: ConversationConfirmation;
+    message: string;
+}>;
+/**
+ * Applies a conversational card style or ECharts option patch through run-agent.
+ * @param context - Current workbench identity and role context.
+ * @param payload - User instruction plus optional turn, version, and screen context.
+ * @returns Patch response with plan, confirmation state, transaction, and optional snapshot.
+ */
+export declare function applyWorkbenchCardPatch(context: WorkbenchContext, payload: {
+    input: string;
+    conversationId?: string;
+    turnId?: string;
+    baseVersion?: number;
+    selectedBlockId?: string;
+    screenContext?: ConversationScreenContext;
+}): Promise<{
+    status: "applied" | "needs_confirmation" | "failed" | "blocked" | "version_conflict";
+    patchPlan?: PatchPlan;
+    snapshot?: WorkbenchSnapshot;
+    changedBlockIds?: string[];
+    confirmation?: ConversationConfirmation & {
+        pendingPatchId?: string;
+    };
+    mutationTransaction?: MutationTransaction;
+    error?: {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+        retryable?: boolean;
+    };
+    message: string;
+}>;
+export declare function planWorkbench(context: WorkbenchContext, payload: {
+    conversationId?: string;
+    input: string;
+    selectedBlockId?: string;
+    workspaceSummary: {
+        workspaceId: string;
+        roleId: RoleId | '';
+        blockCount: number;
+        blockTitles: string[];
+        layoutConfig?: LayoutConfig;
+        assistantPersona?: AssistantPersonaPayload;
+        selectedBlock?: {
+            id: string;
+            title: string;
+            blockType: string;
+            subType: string;
+        } | null;
+    };
+    messages: WorkbenchChatHistoryMessage[];
+    screenContext?: ConversationScreenContext;
+}): Promise<PlanResponse>;
+export declare function confirmLayoutDraftStream(context: WorkbenchContext, payload: {
+    turnId: string;
+    sourceTurnId?: string;
+    conversationId?: string;
+    layoutDraftId: string;
+}, onEvent: (event: WorkbenchPlanStreamEvent) => void, onError?: (error: Error) => void, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function materializeBlocks(context: WorkbenchContext, payload: {
+    blockPlans: BlockPlan[];
+    mode: 'preview' | 'final';
+}): Promise<MaterializeResponse>;
+export declare function saveWorkbenchLayout(context: WorkbenchContext, payload: {
+    baseVersion?: number;
+    layoutVersion?: number;
+    layout: BlockLayout[];
+    layoutConfig?: LayoutConfig;
+    visualConfig?: WorkbenchSnapshot['visualConfig'] | null;
+}): Promise<WorkbenchSnapshot>;
+export declare function insertWorkbenchCard(context: WorkbenchContext, payload: {
+    baseVersion: number;
+    title: string;
+    subtitle?: string;
+    capabilityId: string;
+    rendererKey: string;
+    bodyJson: Record<string, unknown>;
+    layout?: Partial<BlockLayout>;
+    style?: Record<string, unknown>;
+    commonMeta?: Record<string, unknown>;
+    dataBinding?: Record<string, unknown>;
+}): Promise<WorkbenchSnapshot>;
+export type SmartInsertStatus = 'applied' | 'needs_confirmation' | 'blocked' | 'requires_query' | 'version_conflict' | 'layout_conflict' | 'legacy_host_resolved' | 'failed';
+export type LayoutResolutionSource = 'frontend_runtime' | 'host_port' | 'host_existing_insert' | 'fallback_layout';
+export interface CanonicalLayoutContextSummary {
+    baseVersion: number;
+    layoutVersion: number;
+    layoutSource: 'gridstack_layout_tree' | 'block_layout';
+    layoutFingerprint: string;
+}
+export interface TargetResolutionPayload {
+    rawReference?: string;
+    resolvedBy: 'frontend_canvas' | 'backend_canonical';
+    targetBlockIds: string[];
+    baseVersion: number;
+    layoutSource: 'gridstack_layout_tree' | 'block_layout';
+    layoutFingerprint: string;
+    confidence?: number;
+    warnings?: string[];
+}
+export interface RegisteredWorkbenchCardInsertResult {
+    status: SmartInsertStatus;
+    message: string;
+    snapshot?: WorkbenchSnapshot;
+    changedBlockIds?: string[];
+    insertedBlockIds?: string[];
+    layoutChangedBlockIds?: string[];
+    affectedBlockIds?: string[];
+    queryRequirement?: Record<string, unknown>;
+    targetResolution?: TargetResolutionPayload;
+    canonicalLayoutContext?: CanonicalLayoutContextSummary;
+    metadata?: {
+        layoutResolutionSource?: LayoutResolutionSource;
+        layoutFallbackReason?: string;
+        targetResolution?: TargetResolutionPayload;
+        canonicalLayoutContext?: CanonicalLayoutContextSummary;
+        [key: string]: unknown;
+    };
+    error?: {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+        retryable?: boolean;
+    };
+    warnings?: string[];
+}
+export interface WorkbenchCardRecommendationResult {
+    success: boolean;
+    message: string;
+    sourceTurnId?: string;
+    queryResult?: Record<string, unknown>;
+    exhausted?: boolean;
+    totalRecommendationCount?: number;
+    eligibleCandidateCount?: number;
+    returnedCandidateCount?: number;
+    readyCandidateCount?: number;
+    diagnosticCandidateCount?: number;
+    chartFamilyCoverage?: string[];
+    projectionFamilyCoverage?: Record<string, string[]>;
+    echartsCoverage?: Record<string, unknown>;
+    registryCoverage?: Record<string, unknown>;
+    recommendations: Array<Record<string, unknown>>;
+}
+/**
+ * Recommends registered cards from the latest successful query result in the conversation.
+ * @param context - Current workbench identity and role context.
+ * @param payload - Conversation and optional recommendation instruction.
+ * @returns Non-mutating card recommendation candidates.
+ */
+export declare function recommendWorkbenchCards(context: WorkbenchContext, payload: {
+    conversationId: string;
+    input?: string;
+    preferredCategories?: string[];
+}): Promise<WorkbenchCardRecommendationResult>;
+/**
+ * Inserts a selected registered/system card through CardModule instead of the workbench chat stream.
+ * @param context - Current workbench identity context.
+ * @param payload - Selected card metadata and optional user instruction.
+ * @returns Structured card insertion result; data-backed cards may require a real query first.
+ */
+export declare function insertRegisteredWorkbenchCard(context: Pick<WorkbenchContext, 'workspaceId' | 'userId' | 'tenantId' | 'appId'>, payload: {
+    baseVersion?: number;
+    input?: string;
+    conversationId?: string;
+    turnId?: string;
+    selectedSystemCard: SystemCardWorkbenchPromptParams;
+    queryEvidence?: Record<string, unknown>;
+    plannedBlock?: Record<string, unknown>;
+    plannedLayoutTreePatch?: Record<string, unknown>;
+    canonicalLayoutContext?: Record<string, unknown>;
+    targetResolution?: Record<string, unknown>;
+    screenContext?: Omit<ConversationScreenContext, 'roleId'>;
+}): Promise<RegisteredWorkbenchCardInsertResult>;
+export interface WorkbenchDataBindingQueryResult {
+    bindingId: string;
+    success: boolean;
+    capabilityId?: string;
+    rendererKey?: string;
+    dataShape?: string;
+    registryTitle?: string;
+    rows?: Array<Record<string, unknown>>;
+    columns?: Array<{
+        name: string;
+        type: string;
+    }>;
+    rowCount?: number;
+    latencyMs?: number;
+    errorCode?: string;
+    errorMessage?: string;
+    traceId?: string;
+    detailEnabled?: boolean;
+    detailSupported?: boolean;
+    dataPayload?: Record<string, unknown>;
+    card?: MaterializedBlock;
+    snapshot?: WorkbenchSnapshot;
+    document?: WorkbenchV2Document;
+}
+export interface WorkbenchManualSqlDrilldownPageResult {
+    bindingId: string;
+    success: boolean;
+    rows: Array<Record<string, unknown>>;
+    columns: Array<{
+        name: string;
+        type: string;
+    }>;
+    rowCount: number;
+    hasMore: boolean;
+    pageIndex: number;
+    pageSize: number;
+    total: number;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface WorkbenchDataBindingRepairResult {
+    workspaceId: string;
+    userId: string;
+    scanned: number;
+    keptBindingIds: string[];
+    deletedBindingIds: string[];
+    orphanDeletedBindingIds?: string[];
+    staleDeletedBindingIds?: string[];
+    failedBindingIds: string[];
+    orphanFailedBindingIds?: string[];
+    staleFailedBindingIds?: string[];
+}
+/**
+ * Repairs stale or orphaned backend query plans for the current workspace scope.
+ * @param context - Current workbench identity context.
+ * @returns Scoped repair report returned by run-agent.
+ */
+export declare function repairWorkbenchDataBindings(context: Pick<WorkbenchContext, 'workspaceId' | 'userId' | 'tenantId' | 'appId'>): Promise<WorkbenchDataBindingRepairResult>;
+/**
+ * Runs scoped data-binding repair after a stale refresh failure.
+ * @param context - User scope for the current workbench.
+ * @param refreshApi - Refresh API that failed.
+ * @param error - Refresh error to inspect.
+ * @returns Repair report when repair was triggered, otherwise null.
+ */
+export declare function repairWorkbenchDataBindingsForRefreshApi(context: Pick<WorkbenchContext, 'userId' | 'tenantId' | 'appId'>, refreshApi: string, error: unknown): Promise<WorkbenchDataBindingRepairResult | null>;
+export declare function queryWorkbenchDataBinding(context: Pick<WorkbenchContext, 'userId'> & Partial<Pick<WorkbenchContext, 'tenantId' | 'appId' | 'roleId'>> & {
+    conversationId?: string;
+}, refreshApi: string, options?: {
+    businessWording?: string;
+    semanticAppId?: string;
+    filterValues?: Record<string, unknown>;
+    metricFilterBindings?: MetricFilterBinding[];
+}): Promise<WorkbenchDataBindingQueryResult>;
+/**
+ * 更新已有运行态指标卡的 FDE 筛选绑定。
+ * @param context - 当前可信运行时身份
+ * @param workspaceId - 目标工作区 ID
+ * @param bindingId - 目标数据绑定 ID
+ * @param bindings - 已确认指标筛选绑定
+ * @returns 更新后的前端安全绑定摘要
+ */
+export declare function updateWorkbenchMetricFilterBindings(context: Pick<WorkbenchContext, 'userId'> & Partial<Pick<WorkbenchContext, 'tenantId' | 'appId' | 'roleId'>>, workspaceId: string, bindingId: string, bindings: MetricFilterBinding[]): Promise<{
+    bindingId: string;
+    refreshApi: string;
+    fieldMapping: Record<string, unknown>;
+    paramsSchema: Record<string, unknown>;
+}>;
+/**
+ * Activates a card-level data-binding candidate kept after manual placeholder replacement.
+ * @param context - Current workbench identity and optional conversation scope.
+ * @param cardId - Card id carrying candidate query metadata.
+ * @returns Query result and the latest snapshot from run-agent.
+ */
+export declare function queryWorkbenchDataBindingCandidate(context: WorkbenchContext & {
+    conversationId?: string;
+}, cardId: string): Promise<WorkbenchDataBindingQueryResult>;
+/**
+ * Rebinds any card to a user-supplied business wording and executes a real query.
+ * @param context - Current workbench identity and optional conversation scope.
+ * @param cardId - Card id that should receive a data-binding contract.
+ * @param payload - User-supplied business wording used as the query intent.
+ * @returns Query result and the latest snapshot from run-agent.
+ */
+export declare function rebindWorkbenchCardDataBinding(context: WorkbenchContext & {
+    conversationId?: string;
+}, cardId: string, payload: {
+    businessWording: string;
+    fieldMapping?: Record<string, unknown>;
+    fieldLabels?: Record<string, unknown>;
+    cardConfig?: Record<string, unknown>;
+    selectedConfig?: Record<string, unknown>;
+}): Promise<WorkbenchDataBindingQueryResult>;
+/**
+ * Queries paged detail rows for a clicked chart category.
+ * @param context - Current workbench identity.
+ * @param cardId - Card id whose chart category was clicked.
+ * @param bindingId - Existing binding id on the selected card.
+ * @param payload - Clicked category value and pagination.
+ * @returns Paged drilldown table data.
+ */
+export declare function queryWorkbenchManualSqlDrilldownPage(context: WorkbenchContext, cardId: string, bindingId: string, payload: {
+    categoryValue: unknown;
+    pageIndex: number;
+    pageSize: number;
+}): Promise<WorkbenchManualSqlDrilldownPageResult>;
+export declare function updateWorkbenchCard(context: WorkbenchContext, cardId: string, payload: {
+    baseVersion: number;
+    cardVersion: number;
+    patchMode?: 'merge' | 'replace';
+    patch: {
+        title?: string;
+        subtitle?: string;
+        layout?: BlockLayout;
+        state?: MaterializeResponse['materializedBlocks'][number]['state'];
+        renderer?: Record<string, unknown>;
+        style?: Record<string, unknown>;
+        commonMeta?: Record<string, unknown>;
+        bodyJson?: Record<string, unknown>;
+    };
+}): Promise<WorkbenchSnapshot>;
+/**
+ * 删除指定工作台卡片，并返回后端增量处理后的最新快照。
+ * @param context - 当前工作台上下文。
+ * @param cardId - 要删除的卡片 ID。
+ * @param payload - 乐观锁版本信息。
+ * @returns 删除后的工作台快照。
+ */
+export declare function deleteWorkbenchCard(context: WorkbenchContext, cardId: string, payload: {
+    baseVersion: number;
+    cardVersion: number;
+}): Promise<WorkbenchSnapshot>;
+export declare function refreshWorkbench(context: WorkbenchContext, payload?: {
+    blockId?: string;
+}): Promise<WorkbenchSnapshot>;
+export interface RuntimeBusinessQueryResult {
+    objectType: string;
+    objectLabel: string;
+    query: string;
+    timeRange: string;
+    page: number;
+    pageSize: number;
+    total: number;
+    columns: Array<{
+        key: string;
+        label: string;
+    }>;
+    rows: Array<Record<string, unknown>>;
+    sourceLabel: string;
+    dataStatus: string;
+}
+export declare function queryRuntimeBusinessObjects(context: WorkbenchContext, payload: {
+    params: Record<string, unknown>;
+}): Promise<RuntimeBusinessQueryResult>;
+export declare function executeRuntimeAction(context: WorkbenchContext, payload: {
+    actionType: string;
+    blockId?: string;
+    capabilityId?: string;
+    params?: Record<string, unknown>;
+}): Promise<{
+    snapshot: WorkbenchSnapshot;
+    actionLog: Array<Record<string, unknown>>;
+    event: Record<string, unknown>;
+    message: string;
+}>;
+export declare function submitWorkbenchForm(context: WorkbenchContext, payload: {
+    blockId: string;
+    values: Record<string, unknown>;
+    confirmed?: boolean;
+}): Promise<{
+    snapshot: WorkbenchSnapshot;
+    message: string;
+}>;
+export declare function submitWorkbenchSurvey(context: WorkbenchContext, payload: {
+    blockId: string;
+    answers: Record<string, unknown>;
+    confirmed?: boolean;
+}): Promise<{
+    snapshot: WorkbenchSnapshot;
+    message: string;
+}>;
+export declare function executeWorkbenchAction(context: WorkbenchContext, payload: {
+    blockId: string;
+    actionId: string;
+    actionLabel: string;
+    confirmed?: boolean;
+}): Promise<{
+    snapshot: WorkbenchSnapshot;
+    actionLog: Array<Record<string, unknown>>;
+    message: string;
+}>;
+export declare function generateWorkbenchReport(context: WorkbenchContext, payload: {
+    blockId: string;
+    confirmed?: boolean;
+}): Promise<{
+    snapshot: WorkbenchSnapshot;
+    artifact: Record<string, unknown>;
+    message: string;
+}>;
+export declare function confirmSubmitDraft(context: WorkbenchContext, payload: {
+    draftId: string;
+    confirmed: true;
+    turnId?: string;
+    conversationId?: string;
+    filledFields?: Record<string, unknown>;
+}): Promise<{
+    snapshot?: WorkbenchSnapshot;
+    submitDraft: SubmitDraft;
+    confirmation: ConversationConfirmation;
+    message: string;
+    draftPreserved?: boolean;
+    actionLog?: Array<Record<string, unknown>>;
+    artifact?: Record<string, unknown>;
+    submission?: Record<string, unknown>;
+}>;
+/**
+ * 发起编排流请求（SSE）
+ * @param params - 编排请求参数
+ * @param onEvent - SSE 事件回调
+ * @returns Promise，在流完成后 resolve
+ */
+export declare function composeStream(params: {
+    workspaceId: string;
+    userId: string;
+    roleId: string;
+    source: 'text';
+    content: string;
+    conversationId?: string;
+}, onEvent: (event: {
+    type: string;
+    data?: unknown;
+}) => void): Promise<void>;
+/**
+ * 发起 Workbench V2 图片编排流请求。
+ * @param params - V2 图片编排请求参数。
+ * @param onEvent - SSE 事件回调。
+ * @param options - 可选取消信号和流空闲超时配置。
+ * @returns 流读取完成后 resolve。
+ */
+export interface ComposeImageV2StreamOptions {
+    signal?: AbortSignal;
+    /**
+     * @deprecated 图片识别不再使用前端空闲超时，仅为兼容旧调用保留。
+     */
+    idleTimeoutMs?: number;
+}
+export declare const WORKBENCH_IMAGE_COMPOSE_IDLE_TIMEOUT_CODE = "WORKBENCH_IMAGE_COMPOSE_IDLE_TIMEOUT";
+export declare function composeImageV2Stream(params: {
+    workspaceId: string;
+    userId: string;
+    roleId: string;
+    content: string;
+    image: {
+        base64: string;
+        mimeType: string;
+    };
+    imageContext?: {
+        fileName?: string;
+        originalWidth?: number;
+        originalHeight?: number;
+        optimizedWidth?: number;
+        optimizedHeight?: number;
+    };
+    conversationId?: string;
+}, onEvent: (event: ComposeStreamEvent) => void, options?: ComposeImageV2StreamOptions): Promise<void>;