@fses/workbench-app 0.2.0 → 0.2.2

package/dist/fses-workbench-app.js

@@ -1,6 +1,6 @@
-import { D as s, o, q as r, t, u as n, v as c, x as i, k as l, y as p, z as C, A, B as m, C as g, E as d, F as E, l as _, p as u, j as T, a as R, c as S, e as h, g as L, s as M, d as P, G as v, w as y } from "./index-DbH6tMQy.js";
+import { D as s, q as o, t as r, k as t, u as n, v as c, x as i, l, y as p, z as C, A, B as m, C as g, E as d, F as E, m as _, p as u, j as T, a as R, c as S, e as h, g as L, s as M, d as P, G as v, w as y } from "./index-CbIJlts1.js";
 import { c as W } from "./canvasFacade-B0oy__da.js";
-import { D as b, b as D, c as N, d as O, e as B, f as I, g as x, h as w, i as H, j as F, k as G, l as K, m as U, n as V, o as j, p as z, q as Y, r as q, s as X, t as Z, v as J, w as Q, x as $, y as ee, z as ae, A as se, B as oe, C as re, E as te, F as ne, G as ce, u as ie, a as le, H as pe, I as Ce } from "./useWorkbenchRuntime-XpOzwm56.js";
+import { D as b, b as D, c as N, d as O, e as B, f as I, g as x, h as w, i as H, j as F, k as G, l as K, m as U, n as V, o as j, p as z, q as Y, r as q, s as X, t as Z, v as J, w as Q, x as $, y as ee, z as ae, A as se, B as oe, C as re, E as te, F as ne, G as ce, u as ie, a as le, H as pe, I as Ce } from "./useWorkbenchRuntime-Ch8lqkjO.js";
 import { D as me, L as ge, S as de, d as Ee, e as _e, b as ue, f as Te, g as Re, h as Se, i as he, j as Le, k as Me, l as Pe, m as ve, p as ye, n as ke, o as We, q as fe, r as be, s as De } from "./cardFactory-CoDF-zsR.js";
 import { W as Oe, a as Be, b as Ie, c as xe, d as we } from "./workbenchCustomComponentRegistry-6GHzavdM.js";
 export {

package/dist/{index-DbH6tMQy.js → index-CbIJlts1.js}

@@ -1,6 +1,6 @@
 import { toRefs as ne, shallowReadonly as W, inject as oe, defineComponent as E, provide as ae, openBlock as b, createElementBlock as I, renderSlot as g, createElementVNode as A, normalizeClass as q, normalizeStyle as R, withModifiers as se, createCommentVNode as P, createVNode as z, Transition as ie, withCtx as w, computed as de, createBlock as K, defineAsyncComponent as ce, unref as le } from "vue";
 import "./canvasFacade-B0oy__da.js";
-import "./useWorkbenchRuntime-XpOzwm56.js";
+import "./useWorkbenchRuntime-Ch8lqkjO.js";
 import "./cardFactory-CoDF-zsR.js";
 import "./workbenchCustomComponentRegistry-6GHzavdM.js";
 const G = Symbol("workbench-app-context");
@@ -197,7 +197,7 @@ const sr = /* @__PURE__ */ E({
   setup(e) {
     const r = e;
     Ie(r.adapters, r.config, r.extensions);
-    const t = ce(() => import("./Workspace-DMye5DU8.js"));
+    const t = ce(() => import("./Workspace-fYH2XNdb.js"));
     return (n, o) => (b(), K(le(t), {
       "embed-in-portal": r.embedInPortal
     }, {
@@ -818,16 +818,16 @@ export {
   tr as h,
   nr as i,
   yr as j,
-  Ir as k,
-  wr as l,
-  kr as m,
+  rr as k,
+  Ir as l,
+  wr as m,
   T as n,
-  G as o,
+  kr as o,
   lr as p,
-  Sr as q,
+  G as q,
   or as r,
   mr as s,
-  rr as t,
+  Sr as t,
   sr as u,
   we as v,
   ve as w,

package/dist/internal/personal-workbench/components/workbench/WorkbenchStudio.vue.d.ts

@@ -126,7 +126,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
     insertSystemCard: (selection: SystemCardPromptSelection) => any;
     inputChange: (value: string) => any;
     send: (payload?: WorkbenchChatSendPayload) => any;
-    stop: () => any;
+    stop: (turnId?: string) => any;
     composerIntentSelect: (intent: WorkbenchIntentChannel) => any;
     toggleTurnCollapse: (turnId: string) => any;
     confirmLayoutDraft: (turnId: string) => any;
@@ -195,7 +195,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
     onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
     onInputChange?: (value: string) => any;
     onSend?: (payload?: WorkbenchChatSendPayload) => any;
-    onStop?: () => any;
+    onStop?: (turnId?: string) => any;
     onComposerIntentSelect?: (intent: WorkbenchIntentChannel) => any;
     onToggleTurnCollapse?: (turnId: string) => any;
     onConfirmLayoutDraft?: (turnId: string) => any;

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

@@ -22,7 +22,33 @@ export interface DeepAgentRunView {
     eventsUrl?: string;
     currentInterrupt?: unknown;
     error?: unknown;
+    queuePosition?: number;
+    startedAt?: string;
+    lastProgressAt?: string;
+    cancellingAt?: string;
+    terminationReason?: string;
 }
+export interface DeepAgentQueueRunInputSummary {
+    content: string;
+    clientTurnId?: string;
+    attachments?: Array<{
+        fileId: string;
+        fileName?: string;
+        mimeType?: string;
+    }>;
+}
+export interface DeepAgentThreadQueueRunView extends DeepAgentRunView {
+    input?: DeepAgentQueueRunInputSummary;
+}
+export interface DeepAgentThreadQueueView {
+    version?: string;
+    active: DeepAgentThreadQueueRunView | null;
+    pending: Array<DeepAgentThreadQueueRunView & {
+        input?: DeepAgentQueueRunInputSummary;
+        queuePosition: number;
+    }>;
+}
+export type DeepAgentCreateErrorKind = 'queue_full' | 'migration' | 'legacy_active' | 'network' | 'unknown';
 export interface ListDeepAgentMessagesQuery {
     cursor?: string;
     limit?: number;
@@ -47,13 +73,19 @@ export interface DeepAgentRunEventMeta {
  * @returns true 表示前端应展示等待当前任务完成的业务提示
  */
 export declare function isDeepAgentActiveRunConflict(error: unknown): boolean;
+/**
+ * 将创建请求错误归类为前端可稳定恢复的队列状态。
+ * @param error - 请求层抛出的任意错误。
+ * @returns 队列已满、迁移、旧 active 冲突、网络或未知错误。
+ */
+export declare function classifyDeepAgentCreateError(error: unknown): DeepAgentCreateErrorKind;
 /**
  * 首次创建 DeepAgent run。
  * @param context - 运行态身份上下文
  * @param payload - 用户输入和 UI 上下文
  * @returns run 视图
  */
-export declare function createDeepAgentRun(context: DeepAgentClientContext, payload: CreateDeepAgentRunPayload): Promise<DeepAgentRunView>;
+export declare function createDeepAgentRun(context: DeepAgentClientContext, payload: CreateDeepAgentRunPayload, idempotencyKey: string): Promise<DeepAgentRunView>;
 /**
  * 在已有 thread 下创建后续 run。
  * @param context - 运行态身份上下文
@@ -61,7 +93,14 @@ export declare function createDeepAgentRun(context: DeepAgentClientContext, payl
  * @param payload - 用户输入和 UI 上下文
  * @returns run 视图
  */
-export declare function createDeepAgentThreadRun(context: DeepAgentClientContext, threadId: string, payload: CreateDeepAgentRunPayload): Promise<DeepAgentRunView>;
+export declare function createDeepAgentThreadRun(context: DeepAgentClientContext, threadId: string, payload: CreateDeepAgentRunPayload, idempotencyKey: string): Promise<DeepAgentRunView>;
+/**
+ * 查询 thread 当前 active owner 与 FIFO pending 快照。
+ * @param context - 运行态身份上下文。
+ * @param threadId - DeepAgent thread id。
+ * @returns 带单调版本号的队列快照。
+ */
+export declare function getDeepAgentThreadQueue(context: DeepAgentClientContext, threadId: string): Promise<DeepAgentThreadQueueView>;
 /**
  * 查询 run 视图。
  * @param context - 运行态身份上下文

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

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview DeepAgent 前端队列状态 - 管理稳定幂等键、轻量恢复快照和单调快照合并。
+ * @author seadon
+ * @created 2026-08-13
+ */
+export type DeepAgentSubmissionStatus = 'submitting' | 'pending' | 'active' | 'retry_waiting' | 'accepted';
+export interface DeepAgentSubmissionState {
+    idempotencyKey: string;
+    runId?: string;
+    threadId?: string;
+    queuePosition?: number;
+    status: DeepAgentSubmissionStatus;
+    retryCount?: number;
+    retryKind?: 'queue_full' | 'migration' | 'legacy_active' | 'network' | 'unknown';
+}
+export interface DeepAgentAttachmentReference {
+    id?: string;
+    name?: string;
+    type?: string;
+    url?: string;
+}
+export interface RecoverableDeepAgentTurnSnapshot {
+    id: string;
+    conversationId?: string;
+    userPrompt: string;
+    createdAt: string;
+    attachments?: DeepAgentAttachmentReference[];
+    deepAgentSubmission: DeepAgentSubmissionState;
+}
+interface RecoverableTurnInput {
+    id: string;
+    conversationId?: string;
+    userPrompt: string;
+    createdAt: string;
+    attachments?: Array<DeepAgentAttachmentReference & Record<string, unknown>>;
+    submission: DeepAgentSubmissionState;
+    clientContext?: unknown;
+}
+export interface VersionedDeepAgentQueueSnapshot {
+    version?: string;
+}
+export interface DeepAgentQueueSnapshotRun {
+    runId: string;
+    threadId: string;
+    status: string;
+    queuePosition?: number;
+    input?: {
+        content: string;
+        clientTurnId?: string;
+        attachments?: Array<{
+            fileId: string;
+            fileName?: string;
+            mimeType?: string;
+        }>;
+    };
+}
+export interface DeepAgentQueueSnapshot extends VersionedDeepAgentQueueSnapshot {
+    active: DeepAgentQueueSnapshotRun | null;
+    pending: DeepAgentQueueSnapshotRun[];
+}
+export interface DeepAgentQueueProjectedTurn {
+    id: string;
+    conversationId: string;
+    userPrompt: string;
+    status: 'streaming';
+    worklogStageDetail: string;
+    attachmentReferences?: DeepAgentAttachmentReference[];
+    deepAgentSubmission: DeepAgentSubmissionState;
+}
+/**
+ * 生成浏览器会话内稳定且足够唯一的 DeepAgent 提交键。
+ * @returns UUID 或兼容环境下的随机键。
+ */
+export declare function createDeepAgentIdempotencyKey(): string;
+/**
+ * 创建首次提交状态。
+ * @param createKey - 幂等键生成器，单测可注入确定性实现。
+ * @returns submitting 状态。
+ */
+export declare function createDeepAgentSubmission(createKey?: () => string): DeepAgentSubmissionState;
+/**
+ * 根据用户输入变化决定复用原幂等键还是开启新提交。
+ * @param prompt - 当前待提交文本。
+ * @param originalPrompt - 原提交文本。
+ * @param submission - 原提交状态。
+ * @param createKey - 幂等键生成器。
+ * @returns 可用于本次提交的状态。
+ */
+export declare function submissionForPrompt(prompt: string, originalPrompt: string, submission: DeepAgentSubmissionState, createKey?: () => string): DeepAgentSubmissionState;
+/**
+ * 生成仅含恢复提交所需内容的本地快照。
+ * @param turn - 原始 turn、附件和提交状态。
+ * @returns 已剥离附件正文与 clientContext 的轻量快照。
+ */
+export declare function recoverableDeepAgentTurnSnapshot(turn: RecoverableTurnInput): RecoverableDeepAgentTurnSnapshot;
+/**
+ * 单调合并轮询快照，避免慢响应覆盖更新的 owner 或队列位置。
+ * @param current - 当前已应用快照。
+ * @param incoming - 新到达快照。
+ * @returns 版本不倒退的快照。
+ */
+export declare function mergeDeepAgentQueueSnapshot<T extends VersionedDeepAgentQueueSnapshot & Record<string, unknown>>(current: T | null, incoming: T): T & {
+    version: string;
+};
+/**
+ * 把服务端队列快照投影为可与 transcript 合并的轻量 turn，最多恢复五个 pending。
+ * @param snapshot - 同一次原子读取返回的 active/pending 快照。
+ * @returns active 在前、pending 按队列位置排列的 turn 列表。
+ */
+export declare function queueTurnsFromSnapshot(snapshot: DeepAgentQueueSnapshot): DeepAgentQueueProjectedTurn[];
+export {};

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

@@ -111,6 +111,15 @@ export declare function applyStreamMessageEvent(turn: ConversationTurn, event: S
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 /**
  * 应用智能体规划事件。
@@ -177,6 +186,15 @@ export declare function applyPatchPlanReadyEvent(turn: ConversationTurn, event:
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 /**
  * 将确认请求事件写入 turn 状态和返回项，保证左右两侧都有统一的渲染数据。
@@ -221,6 +239,15 @@ export declare function applyNeedsConfirmationEvent(turn: ConversationTurn, even
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 export declare function applyStatusPulseEvent(turn: ConversationTurn, event: StatusPulseEvent): {
     worklogStageText: WorklogStageText;
@@ -259,6 +286,15 @@ export declare function applyStatusPulseEvent(turn: ConversationTurn, event: Sta
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 export declare function applyActionStreamEvent(turn: ConversationTurn, event: ActionStreamEvent): {
     streamActions: StreamActionItem[];
@@ -297,6 +333,15 @@ export declare function applyActionStreamEvent(turn: ConversationTurn, event: Ac
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 export declare function applyFinalDeltaEvent(turn: ConversationTurn, event: FinalDeltaEvent): ConversationTurn;
 export declare function applyUsageStreamEvent(turn: ConversationTurn, event: UsageStreamEvent): {
@@ -336,6 +381,15 @@ export declare function applyUsageStreamEvent(turn: ConversationTurn, event: Usa
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 export declare function applyTraceEvent(turn: ConversationTurn, event: TraceEvent): {
     returnItems: ConversationReturnItem[];
@@ -374,6 +428,15 @@ export declare function applyTraceEvent(turn: ConversationTurn, event: TraceEven
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 export declare function finishStreamedTurn(turn: ConversationTurn, fillFinalText?: boolean): {
     assistantFinalText: string;
@@ -412,6 +475,15 @@ export declare function finishStreamedTurn(turn: ConversationTurn, fillFinalText
     error?: string;
     suppressErrorDisplay?: boolean;
     collapsed?: boolean;
+    deepAgentSubmission?: {
+        idempotencyKey: string;
+        runId?: string;
+        threadId?: string;
+        queuePosition?: number;
+        status: "submitting" | "pending" | "active" | "retry_waiting" | "accepted";
+        retryCount?: number;
+        retryKind?: "queue_full" | "migration" | "legacy_active" | "network" | "unknown";
+    };
 };
 export declare function updateTurn(turns: ConversationTurn[], turnId: string, updater: (turn: ConversationTurn) => ConversationTurn): ConversationTurn[];
 export declare function sortBlocks(blocks: MaterializedBlock[]): MaterializedBlock[];

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

@@ -20,7 +20,7 @@ export declare function createWorkbenchSocketClient(input: {
     baseUrl?: string;
     workspaceId: string;
     userId: string;
-    onEvent: (event: WorkbenchSocketEvent) => void;
+    onEvent: (event: WorkbenchSocketEvent) => Promise<void> | void;
     socketPath?: string;
     transports?: WorkbenchSocketTransport[];
     socketFactory?: WorkbenchSocketFactory;

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

@@ -1,6 +1,7 @@
 import type { AssistantPersonaKey, LayoutConfig, RoleId } from '@fses/workbench-app/types';
 import type { WorkbenchCanvasGapPreset, WorkbenchCardPresetSizeConfig } from './cardSizeConfig';
 import type { WorkbenchCardStyleConfig } from './cardStyleConfig';
+import type { RecoverableDeepAgentTurnSnapshot } from './deepAgentQueueState';
 export interface WorkbenchCanvasSettingsMemory {
     layoutConfig?: LayoutConfig;
     cardStyleConfig?: WorkbenchCardStyleConfig;
@@ -37,6 +38,7 @@ export interface WorkbenchUiMemory {
     cardPresetSizeConfig?: WorkbenchCardPresetSizeConfig;
     canvasGapPreset?: WorkbenchCanvasGapPreset;
     canvasSettingsByWorkspaceId?: Record<string, WorkbenchCanvasSettingsMemory>;
+    recoverableDeepAgentTurnsByScope?: Record<string, RecoverableDeepAgentTurnSnapshot[]>;
 }
 /**
  * 构建会话恢复作用域 key。

package/dist/runtime/index.js

@@ -1,4 +1,4 @@
-import { u as r, a as u } from "../useWorkbenchRuntime-XpOzwm56.js";
+import { u as r, a as u } from "../useWorkbenchRuntime-Ch8lqkjO.js";
 export {
   r as useWorkbenchRuntime,
   u as useWorkbenchRuntimeStore