@pageops/sdk 0.1.36 → 0.1.38

package/README.md

@@ -7,6 +7,16 @@ controls and conversation presentation behavior directly to the SDK. Version
 activity, collapses it when answer text starts, and allows casual chat without
 injecting page/source business context.
 
+Version `0.1.37` separates the answer-local `thoughts` stream/history contract
+from the right-side `steps` contract. The middle timeline no longer re-renders
+the execution cards; it receives only selected model decisions and evidence
+activities shaped by the backend thought presenter.
+
+Version `0.1.38` hides node progress in the right sidebar and keeps it only
+inside chat answers, including live updates and historical Run selection. The
+sidebar source-package controls remain available; backend step data is retained
+for cancellation and history.
+
 `src/index.js` is the readable ESM runtime baseline, `src/styles.css` preserves
 the 0.1.34 styles, and `src/extensions.css` contains the new non-minified style
 rules. `npm run build` synchronizes ESM, UMD, and CSS under `dist/` without

package/dist/index.d.ts

@@ -12,6 +12,7 @@ declare class PageOpsSDKController {
     private conversations;
     private messages;
     private steps;
+    private thoughts;
     private selectedAgentRunId;
     private runLoading;
     private runLoadError;
@@ -73,6 +74,7 @@ declare class PageOpsSDKController {
     private updateStreamingMessage;
     private resetAnswerState;
     private upsertStep;
+    private upsertThought;
     private loadAgentRun;
     private copyAgentRunId;
     private updateCopyFeedback;
@@ -87,9 +89,9 @@ declare class PageOpsSDKController {
     private renderMessage;
     private renderSourceUploader;
     private renderSourceItem;
-    private renderSteps;
     private renderThinkingProcess;
-    private renderExecutionSteps;
+    private renderThinkingSteps;
+    private renderThinkingTimeline;
     private bindPanelEvents;
 }
 export declare const PageOpsSDK: PageOpsSDKController;

package/dist/pageops-sdk.es.js

@@ -192,6 +192,7 @@ class V {
     i(this, "conversations", []);
     i(this, "messages", []);
     i(this, "steps", []);
+    i(this, "thoughts", []);
     i(this, "selectedAgentRunId", "");
     i(this, "runLoading", !1);
     i(this, "runLoadError", "");
@@ -232,7 +233,7 @@ class V {
   }
   unmount() {
     var e;
-    this.cleanupFloatingLauncher(), this.stopSourceRefresh(), this.cancelActiveAnswer(!1), this.resetAnswerState(), (e = this.root) == null || e.remove(), this.root = null, this.panel = null, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.conversations = [], this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoading = !1, this.runLoadError = "", this.clearCopyFeedback(), this.sourceSnapshots = [], this.selectedSourceSnapshotId = null, this.sourceUploadStatus = "", this.sourceUploadProgress = null, this.sourceUploadError = "", this.sourceLoadError = "", this.sourceUploading = !1, this.developerAccess = !1, this.activeQuestionStartedAt = "", this.answerAudience = "developer";
+    this.cleanupFloatingLauncher(), this.stopSourceRefresh(), this.cancelActiveAnswer(!1), this.resetAnswerState(), (e = this.root) == null || e.remove(), this.root = null, this.panel = null, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.conversations = [], this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoading = !1, this.runLoadError = "", this.clearCopyFeedback(), this.sourceSnapshots = [], this.selectedSourceSnapshotId = null, this.sourceUploadStatus = "", this.sourceUploadProgress = null, this.sourceUploadError = "", this.sourceLoadError = "", this.sourceUploading = !1, this.developerAccess = !1, this.activeQuestionStartedAt = "", this.answerAudience = "developer";
   }
   open() {
     this.root && (this.cleanupFloatingLauncher(), this.root.innerHTML = "", this.panel = document.createElement("div"), this.panel.className = "po-panel", this.root.appendChild(this.panel), this.loadDeveloperAccess(), this.loadSources(), this.loadConversations(), this.renderPanel());
@@ -245,7 +246,7 @@ class V {
     const t = this.options.appId, s = String(this.options.ownerId || "").trim();
     this.options = { ...this.options, ...e }, this.client = new K(this.options);
     const r = String(this.options.ownerId || "").trim(), n = this.options.appId !== t;
-    (n || r !== s) && (n && (this.answerAudience = this.loadAnswerAudience(this.options.appId), this.selectedSourceSnapshotId = null), this.currentThread = null, this.selectedPageKey = "", this.conversations = [], this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = ""), this.context = null, this.contextKey = "", r !== s && this.loadDeveloperAccess(), this.panel && this.loadConversations(), this.renderPanel();
+    (n || r !== s) && (n && (this.answerAudience = this.loadAnswerAudience(this.options.appId), this.selectedSourceSnapshotId = null), this.currentThread = null, this.selectedPageKey = "", this.conversations = [], this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = ""), this.context = null, this.contextKey = "", r !== s && this.loadDeveloperAccess(), this.panel && this.loadConversations(), this.renderPanel();
   }
   renderClosed() {
     var e;
@@ -367,7 +368,7 @@ class V {
     if (this.asking) return;
     const s = e === "" ? null : e;
     if ((this.selectedSourceSnapshotId == null ? "" : String(this.selectedSourceSnapshotId)) === (s == null ? "" : String(s))) return;
-    this.selectedSourceSnapshotId = s, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
+    this.selectedSourceSnapshotId = s, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
   }
   sourceSnapshotValue(e) {
     var t, s;
@@ -382,7 +383,7 @@ class V {
     if (this.client) {
       try {
         const e = await this.client.listSources(), t = e[0], s = t ? this.sourceSnapshotValue(t) : null, r = this.context && this.context.source_snapshot_id != null ? String(this.context.source_snapshot_id) : null, n = this.selectedSourceSnapshotId == null && s != null && r !== s && (this.context != null || this.currentThread != null);
-        this.sourceSnapshots = e, this.sourceLoadError = "", n && (this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1);
+        this.sourceSnapshots = e, this.sourceLoadError = "", n && (this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1);
       } catch (e) {
         this.sourceLoadError = "源码包状态加载失败，连接恢复后将自动重试。";
       }
@@ -396,11 +397,11 @@ class V {
     var s;
     if (!this.client) return;
     const t = await this.ensureContext(), r = e ? conversationTitle(t, e) : (s = t.menu_path) != null && s.length ? t.menu_path.join(" / ") : t.route || document.title || "新的问答";
-    this.currentThread = await this.client.createConversation(t.id, r), this.selectedPageKey = this.contextKey, this.conversations = [this.currentThread, ...this.conversations], this.messages = [], this.steps = [], this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
+    this.currentThread = await this.client.createConversation(t.id, r), this.selectedPageKey = this.contextKey, this.conversations = [this.currentThread, ...this.conversations], this.messages = [], this.steps = [], this.thoughts = [], this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
   }
   async selectThread(e) {
     if (!this.client) return;
-    this.currentThread = e, this.selectedPageKey = this.getPageContextKey(this.getPageContext()), this.messages = await this.client.listMessages(e.id), this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
+    this.currentThread = e, this.selectedPageKey = this.getPageContextKey(this.getPageContext()), this.messages = await this.client.listMessages(e.id), this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
     const t = [...this.messages].reverse().map(M).find(Boolean);
     t && await this.loadAgentRun(t);
   }
@@ -410,7 +411,7 @@ class V {
       this.deletingThreadId = e.id, this.conversationError = "", this.renderPanel();
       try {
         if (await this.client.deleteConversation(e.id), this.conversations = this.conversations.filter((s) => s.id !== e.id), ((t = this.currentThread) == null ? void 0 : t.id) === e.id) {
-          this.currentThread = null, this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1;
+          this.currentThread = null, this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1;
           const s = this.conversations[0];
           s && await this.selectThread(s);
         }
@@ -449,7 +450,7 @@ class V {
     try {
       const n = this.getPageContextKey(this.getPageContext());
       if (this.currentThread && this.selectedPageKey && this.selectedPageKey !== n && (this.currentThread = null), this.currentThread || await this.newConversation(e), !this.currentThread) throw new Error("无法创建问答会话，请稍后重试。");
-      this.messages.push({ id: `local-${Date.now()}`, role: "user", content: e, metadata_json: {}, created_at: this.activeQuestionStartedAt }), this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.renderPanel();
+      this.messages.push({ id: `local-${Date.now()}`, role: "user", content: e, metadata_json: {}, created_at: this.activeQuestionStartedAt }), this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.renderPanel();
       const c = await this.client.streamQuestion(this.currentThread.id, e, this.answerAudience, r.signal);
       if (!c.ok) throw new Error(await z(c, "服务暂时无法回答，请稍后重试。"));
       if (!c.body) throw new Error("服务未返回有效的流式响应，请稍后重试。");
@@ -478,10 +479,22 @@ class V {
       this.typewriter.clear(), this.waitingForFirstContent = !1, (t = this.abortController) == null || t.abort(), this.abortController = null, e && this.renderPanel();
     }
   }
+  /**
+   * Consume an SSE event without duplicating node progress in the sidebar.
+   * Full steps remain available for cancellation; public thoughts update only
+   * the answer-local timeline. This method does not make remote requests.
+   * @param {string} e Backend event name.
+   * @param {object} t Event payload for steps, thoughts, content or completion.
+   * @returns {void}
+   */
   handleStreamEvent(e, t) {
     var s, r;
     if (e === "step") {
-      this.upsertStep(t), this.renderExecutionSteps(!0);
+      this.upsertStep(t);
+      return;
+    }
+    if (e === "thought") {
+      this.upsertThought(t), this.renderThinkingTimeline();
       return;
     }
     if (e === "delta") {
@@ -516,16 +529,20 @@ class V {
     const t = this.steps.findIndex((s) => s.id === e.id);
     this.steps = t === -1 ? [...this.steps, e] : this.steps.map((s) => s.id === e.id ? { ...s, ...e } : s);
   }
+  upsertThought(e) {
+    const t = this.thoughts.findIndex((s) => s.id === e.id);
+    this.thoughts = t === -1 ? [...this.thoughts, e] : this.thoughts.map((s) => s.id === e.id ? { ...s, ...e } : s);
+  }
   async loadAgentRun(e) {
     if (!(!this.client || !e)) {
       this.selectedAgentRunId = e, this.runLoading = !0, this.runLoadError = "", this.renderPanel();
       try {
         const t = await this.client.getAgentRun(e);
         if (this.selectedAgentRunId !== e) return;
-        this.steps = t.steps;
+        this.steps = t.steps, this.thoughts = t.thoughts || [];
       } catch (t) {
         if (this.selectedAgentRunId !== e) return;
-        this.steps = [], this.runLoadError = t instanceof Error ? t.message : "执行过程加载失败";
+        this.steps = [], this.thoughts = [], this.runLoadError = t instanceof Error ? t.message : "执行过程加载失败";
       } finally {
         this.selectedAgentRunId === e && (this.runLoading = !1, this.renderPanel());
       }
@@ -578,7 +595,14 @@ class V {
   stopSourceRefresh() {
     this.sourceRefreshTimer && clearTimeout(this.sourceRefreshTimer), this.sourceRefreshTimer = null;
   }
-  renderPanel(e = this.asking, t = !1) {
+  /**
+   * Recreate the chat shell and source controls while keeping progress in answers.
+   * Preserve chat scroll unless following the active answer; bind DOM listeners
+   * after replacement. The sidebar contains no node progress or auto-scroll.
+   * @param {boolean} e Whether to scroll the chat to its latest message.
+   * @returns {void} No-op when the SDK panel is closed; no remote requests.
+   */
+  renderPanel(e = this.asking) {
     var g;
     if (!this.panel) return;
     const s = (g = this.panel.querySelector(".po-messages")) == null ? void 0 : g.scrollTop, r = this.questionUnavailableReason(), n = r || (this.asking ? "回答生成中，请稍候" : this.sourceSnapshots.length ? "请输入页面分析问题，Enter 发送，Shift + Enter 换行" : "可直接闲聊；业务问题需先上传代码包"), c = !!(r || this.asking), p = r ? '<button type="submit" disabled>暂不可提问</button>' : this.asking ? '<button class="po-stop" type="button" data-action="stop-answer" aria-label="停止输出" title="停止输出"><span aria-hidden="true"></span></button>' : '<button type="submit">发送</button>', m = C.map((o) => `
@@ -609,7 +633,7 @@ class V {
         </section>
         <form class="po-composer"><textarea ${c ? "disabled" : ""} placeholder="${l(n)}"></textarea>${p}</form>
       </main>
-      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSourceUploader()}<div class="po-steps">${this.renderSteps()}</div></section></aside>
+      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSourceUploader()}</section></aside>
     `, this.bindPanelEvents(), e) {
       const o = this.panel.querySelector(".po-messages");
       o && (o.scrollTop = o.scrollHeight);
@@ -617,10 +641,6 @@ class V {
       const o = this.panel.querySelector(".po-messages");
       o && (o.scrollTop = s);
     }
-    if (t) {
-      const o = this.panel.querySelector(".po-trace > section");
-      o && (o.scrollTop = o.scrollHeight);
-    }
   }
   renderAnswerState() {
     const n = messageTime(this.activeQuestionStartedAt), c = this.renderThinkingProcess(), e = this.asking && this.waitingForFirstContent ? `<article class="po-message assistant waiting" role="status" aria-live="polite">${n}<b>PageOps 分析</b><div class="po-ai-waiting"><span class="po-ai-spinner" aria-hidden="true"></span><span>正在理解问题并检索证据</span></div>${c}</article>` : "", t = this.streaming ? `<article class="po-message assistant streaming">${n}<b>PageOps 分析</b><div><span data-streaming-content>${R(this.streaming)}</span>${this.asking ? '<span class="po-typing-cursor" aria-hidden="true"></span>' : ""}</div>${c}</article>` : "", s = this.answerError ? `<article class="po-message assistant answer-error" role="alert">${n}<b>PageOps 分析</b><strong>本次回答失败</strong><div>${l(this.answerError)}</div></article>` : "", r = this.answerStopped ? '<div class="po-stream-stopped" role="status">已停止输出</div>' : "";
@@ -674,42 +694,24 @@ class V {
     const t = e.filename || "未命名代码包", s = e.created_at ? O(e.created_at) : "刚刚上传", r = G(e.archive_bytes || e.total_bytes || 0), n = String((b = (w = e.metadata) == null ? void 0 : w.analysis_status) != null ? b : "unknown"), c = typeof ((S = e.metadata) == null ? void 0 : S.tag) == "string" ? e.metadata.tag : "", p = typeof (($ = e.metadata) == null ? void 0 : $.branch) == "string" ? e.metadata.branch : "", m = c ? `Tag: ${c}` : p ? `Branch: ${p}` : "未记录代码引用", g = typeof ((E = e.metadata) == null ? void 0 : E.remark) == "string" && e.metadata.remark ? e.metadata.remark : "无备注", o = typeof ((A = e.metadata) == null ? void 0 : A.uploader) == "string" ? e.metadata.uploader : "未知用户", y = (T = { pending: "项目记忆等待更新", running: "项目记忆更新中", ready: "项目记忆已就绪", failed: "项目记忆更新失败" }[n]) != null ? T : "项目记忆状态未知";
     return `<article class="po-source-item ${this.selectedSourceSnapshotId != null && this.sourceSnapshotValue(e) === String(this.selectedSourceSnapshotId) || this.selectedSourceSnapshotId == null && e === this.sourceSnapshots[0] ? "selected" : ""}"><strong>${l(t)}</strong><span>${l(m)}</span><span>备注：${l(g)}</span><span>上传人：${l(o)} · ${l(s)} · ${l(r)}</span><span>${l(y)} · 当前问答${this.selectedSourceSnapshotId == null && e === this.sourceSnapshots[0] ? "默认" : ""}引用</span></article>`;
   }
-  renderSteps() {
-    return this.runLoading ? '<div class="po-trace-state"><span class="po-ai-spinner" aria-hidden="true"></span><span>正在恢复本次执行过程</span></div>' : this.runLoadError ? `<div class="po-trace-state failed" role="alert">${l(this.runLoadError)}</div>` : (this.steps.length ? this.steps : [{ id: "idle", title: "等待任务", status: "pending", summary: "发送问题后，这里会展示完整分析过程。" }]).map((t) => {
-      var c, p, m;
-      const s = (c = t.metrics) != null && c.length ? `<div class="po-step-metrics">${t.metrics.map((g) => `<span>${l(g)}</span>`).join("")}</div>` : "", r = (p = t.details) != null && p.length ? `<div class="po-step-details">${t.details.map((g) => `<div><span>${l(g.label)}</span><p>${l(g.value)}</p></div>`).join("")}</div>` : "", n = !!(s || r);
-      return `<details class="po-step ${t.status}" ${t.status === "running" || t.status === "failed" ? "open" : ""} ${n ? "" : "data-static"}>
-        <summary>
-          <span class="po-step-dot" aria-hidden="true"></span>
-          <span class="po-step-copy"><strong>${l(t.title)}</strong><small>${l((m = t.summary) != null ? m : "")}</small>${s}</span>
-          <span class="po-step-status">${Z(t.status)}</span>
-        </summary>
-        ${r}
-      </details>`;
-    }).join("");
-  }
   renderThinkingProcess() {
-    if (!this.asking && !this.steps.length && !this.runLoading && !this.runLoadError) return "";
-    const e = this.asking && !this.streaming, t = this.asking && !this.streaming ? "思考中" : this.runLoading ? "加载中" : this.runLoadError ? "加载失败" : "已思考完成", s = thinkingDuration(this.steps, this.activeQuestionStartedAt);
+    if (!this.asking && !this.thoughts.length && !this.runLoading && !this.runLoadError) return "";
+    const e = this.asking && !this.streaming, t = this.asking && !this.streaming ? "思考中" : this.runLoading ? "加载中" : this.runLoadError ? "加载失败" : "已思考完成", s = thinkingDuration(this.thoughts, this.activeQuestionStartedAt);
     return `<details class="po-thinking-process" ${e ? "open" : ""}><summary><strong>${s ? `用时 ${l(s)}` : "思考过程"}</strong><span>${t}</span></summary><div class="po-thinking-content">${this.renderThinkingSteps()}</div></details>`;
   }
   renderThinkingSteps() {
     if (this.runLoading) return '<div class="po-thinking-state"><span class="po-ai-spinner" aria-hidden="true"></span><span>正在恢复思考过程</span></div>';
     if (this.runLoadError) return `<div class="po-thinking-state failed">${l(this.runLoadError)}</div>`;
-    const e = this.steps.length ? this.steps : [{ id: "idle", kind: "thinking", title: "理解问题", status: "running", summary: "正在判断问题并规划需要核对的信息。" }];
+    const e = this.thoughts.length ? this.thoughts : [{ id: "idle", kind: "thinking", label: "理解问题", status: "running", text: "正在判断问题并规划需要核对的信息。" }];
     return e.map((t) => {
-      const s = String(t.kind || (String(t.id || "").startsWith("model-turn-") ? "thinking" : "status")), r = thinkingIcon(s), n = (t.metrics || []).length ? `<span class="po-thinking-metrics">${t.metrics.map((c) => l(c)).join(" · ")}</span>` : "", p = (t.details || []).map((c) => `<div class="po-thinking-detail"><span>${l(c.label)}</span>${String(c.value || "").split("\n").filter(Boolean).map((m) => `<code>${l(m)}</code>`).join("")}</div>`).join("");
-      if (s === "thinking") return `<div class="po-thinking-note ${t.status}">${r}<div><strong>${l(t.title)}</strong><p>${l(t.summary || "")}</p>${n}</div></div>`;
-      return `<div class="po-thinking-activity ${t.status}">${r}<div class="po-thinking-activity-copy"><strong>${l(t.title)}</strong><span>${l(t.summary || "")}</span>${n}${p}</div></div>`;
+      const s = String(t.kind || "thinking"), r = thinkingIcon(s), n = (t.metrics || []).length ? `<span class="po-thinking-metrics">${t.metrics.map((c) => l(c)).join(" · ")}</span>` : "", p = (t.details || []).map((c) => `<div class="po-thinking-detail"><span>${l(c.label)}</span>${String(c.value || "").split("\n").filter(Boolean).map((m) => `<code>${l(m)}</code>`).join("")}</div>`).join("");
+      if (s === "thinking") return `<div class="po-thinking-note ${t.status}">${r}<div><strong>${l(t.label)}</strong><p>${l(t.text || "")}</p>${n}</div></div>`;
+      return `<div class="po-thinking-activity ${t.status}">${r}<div class="po-thinking-activity-copy"><strong>${l(t.label)}</strong><span>${l(t.text || "")}</span>${n}${p}</div></div>`;
     }).join("");
   }
-  renderExecutionSteps(e = !1) {
-    var s, r;
-    const t = (s = this.panel) == null ? void 0 : s.querySelector(".po-steps");
-    if (t && (t.innerHTML = this.renderSteps(), this.panel == null || this.panel.querySelectorAll(".po-thinking-content").forEach((n) => n.innerHTML = this.renderThinkingSteps()), e)) {
-      const n = (r = this.panel) == null ? void 0 : r.querySelector(".po-trace > section");
-      n && (n.scrollTop = n.scrollHeight);
-    }
+  renderThinkingTimeline() {
+    var e;
+    (e = this.panel) == null || e.querySelectorAll(".po-thinking-content").forEach((t) => t.innerHTML = this.renderThinkingSteps());
   }
   bindPanelEvents() {
     var e, t, s, r, n, c, p, m, g, o, y, w, b, S, $, E, A, T, h, d;
@@ -829,9 +831,6 @@ function G(a) {
     t /= 1024, s += 1;
   return `${t >= 10 || s === 0 ? t.toFixed(0) : t.toFixed(1)} ${e[s]}`;
 }
-function Z(a) {
-  return { pending: "等待中", running: "执行中", completed: "已完成", failed: "失败", cancelled: "已停止" }[a];
-}
 const Y = new V();
 export {
   Y as PageOpsSDK

package/dist/pageops-sdk.umd.cjs

@@ -192,6 +192,7 @@ class V {
     i(this, "conversations", []);
     i(this, "messages", []);
     i(this, "steps", []);
+    i(this, "thoughts", []);
     i(this, "selectedAgentRunId", "");
     i(this, "runLoading", !1);
     i(this, "runLoadError", "");
@@ -232,7 +233,7 @@ class V {
   }
   unmount() {
     var e;
-    this.cleanupFloatingLauncher(), this.stopSourceRefresh(), this.cancelActiveAnswer(!1), this.resetAnswerState(), (e = this.root) == null || e.remove(), this.root = null, this.panel = null, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.conversations = [], this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoading = !1, this.runLoadError = "", this.clearCopyFeedback(), this.sourceSnapshots = [], this.selectedSourceSnapshotId = null, this.sourceUploadStatus = "", this.sourceUploadProgress = null, this.sourceUploadError = "", this.sourceLoadError = "", this.sourceUploading = !1, this.developerAccess = !1, this.activeQuestionStartedAt = "", this.answerAudience = "developer";
+    this.cleanupFloatingLauncher(), this.stopSourceRefresh(), this.cancelActiveAnswer(!1), this.resetAnswerState(), (e = this.root) == null || e.remove(), this.root = null, this.panel = null, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.conversations = [], this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoading = !1, this.runLoadError = "", this.clearCopyFeedback(), this.sourceSnapshots = [], this.selectedSourceSnapshotId = null, this.sourceUploadStatus = "", this.sourceUploadProgress = null, this.sourceUploadError = "", this.sourceLoadError = "", this.sourceUploading = !1, this.developerAccess = !1, this.activeQuestionStartedAt = "", this.answerAudience = "developer";
   }
   open() {
     this.root && (this.cleanupFloatingLauncher(), this.root.innerHTML = "", this.panel = document.createElement("div"), this.panel.className = "po-panel", this.root.appendChild(this.panel), this.loadDeveloperAccess(), this.loadSources(), this.loadConversations(), this.renderPanel());
@@ -245,7 +246,7 @@ class V {
     const t = this.options.appId, s = String(this.options.ownerId || "").trim();
     this.options = { ...this.options, ...e }, this.client = new K(this.options);
     const r = String(this.options.ownerId || "").trim(), n = this.options.appId !== t;
-    (n || r !== s) && (n && (this.answerAudience = this.loadAnswerAudience(this.options.appId), this.selectedSourceSnapshotId = null), this.currentThread = null, this.selectedPageKey = "", this.conversations = [], this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = ""), this.context = null, this.contextKey = "", r !== s && this.loadDeveloperAccess(), this.panel && this.loadConversations(), this.renderPanel();
+    (n || r !== s) && (n && (this.answerAudience = this.loadAnswerAudience(this.options.appId), this.selectedSourceSnapshotId = null), this.currentThread = null, this.selectedPageKey = "", this.conversations = [], this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = ""), this.context = null, this.contextKey = "", r !== s && this.loadDeveloperAccess(), this.panel && this.loadConversations(), this.renderPanel();
   }
   renderClosed() {
     var e;
@@ -367,7 +368,7 @@ class V {
     if (this.asking) return;
     const s = e === "" ? null : e;
     if ((this.selectedSourceSnapshotId == null ? "" : String(this.selectedSourceSnapshotId)) === (s == null ? "" : String(s))) return;
-    this.selectedSourceSnapshotId = s, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
+    this.selectedSourceSnapshotId = s, this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
   }
   sourceSnapshotValue(e) {
     var t, s;
@@ -382,7 +383,7 @@ class V {
     if (this.client) {
       try {
         const e = await this.client.listSources(), t = e[0], s = t ? this.sourceSnapshotValue(t) : null, r = this.context && this.context.source_snapshot_id != null ? String(this.context.source_snapshot_id) : null, n = this.selectedSourceSnapshotId == null && s != null && r !== s && (this.context != null || this.currentThread != null);
-        this.sourceSnapshots = e, this.sourceLoadError = "", n && (this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1);
+        this.sourceSnapshots = e, this.sourceLoadError = "", n && (this.context = null, this.contextKey = "", this.selectedPageKey = "", this.currentThread = null, this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1);
       } catch (e) {
         this.sourceLoadError = "源码包状态加载失败，连接恢复后将自动重试。";
       }
@@ -396,11 +397,11 @@ class V {
     var s;
     if (!this.client) return;
     const t = await this.ensureContext(), r = e ? conversationTitle(t, e) : (s = t.menu_path) != null && s.length ? t.menu_path.join(" / ") : t.route || document.title || "新的问答";
-    this.currentThread = await this.client.createConversation(t.id, r), this.selectedPageKey = this.contextKey, this.conversations = [this.currentThread, ...this.conversations], this.messages = [], this.steps = [], this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
+    this.currentThread = await this.client.createConversation(t.id, r), this.selectedPageKey = this.contextKey, this.conversations = [this.currentThread, ...this.conversations], this.messages = [], this.steps = [], this.thoughts = [], this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
   }
   async selectThread(e) {
     if (!this.client) return;
-    this.currentThread = e, this.selectedPageKey = this.getPageContextKey(this.getPageContext()), this.messages = await this.client.listMessages(e.id), this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
+    this.currentThread = e, this.selectedPageKey = this.getPageContextKey(this.getPageContext()), this.messages = await this.client.listMessages(e.id), this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1, this.renderPanel();
     const t = [...this.messages].reverse().map(M).find(Boolean);
     t && await this.loadAgentRun(t);
   }
@@ -410,7 +411,7 @@ class V {
       this.deletingThreadId = e.id, this.conversationError = "", this.renderPanel();
       try {
         if (await this.client.deleteConversation(e.id), this.conversations = this.conversations.filter((s) => s.id !== e.id), ((t = this.currentThread) == null ? void 0 : t.id) === e.id) {
-          this.currentThread = null, this.messages = [], this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1;
+          this.currentThread = null, this.messages = [], this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.streaming = "", this.answerError = "", this.answerStopped = !1;
           const s = this.conversations[0];
           s && await this.selectThread(s);
         }
@@ -449,7 +450,7 @@ class V {
     try {
       const n = this.getPageContextKey(this.getPageContext());
       if (this.currentThread && this.selectedPageKey && this.selectedPageKey !== n && (this.currentThread = null), this.currentThread || await this.newConversation(e), !this.currentThread) throw new Error("无法创建问答会话，请稍后重试。");
-      this.messages.push({ id: `local-${Date.now()}`, role: "user", content: e, metadata_json: {}, created_at: this.activeQuestionStartedAt }), this.steps = [], this.selectedAgentRunId = "", this.runLoadError = "", this.renderPanel();
+      this.messages.push({ id: `local-${Date.now()}`, role: "user", content: e, metadata_json: {}, created_at: this.activeQuestionStartedAt }), this.steps = [], this.thoughts = [], this.selectedAgentRunId = "", this.runLoadError = "", this.renderPanel();
       const c = await this.client.streamQuestion(this.currentThread.id, e, this.answerAudience, r.signal);
       if (!c.ok) throw new Error(await z(c, "服务暂时无法回答，请稍后重试。"));
       if (!c.body) throw new Error("服务未返回有效的流式响应，请稍后重试。");
@@ -478,10 +479,22 @@ class V {
       this.typewriter.clear(), this.waitingForFirstContent = !1, (t = this.abortController) == null || t.abort(), this.abortController = null, e && this.renderPanel();
     }
   }
+  /**
+   * Consume an SSE event without duplicating node progress in the sidebar.
+   * Full steps remain available for cancellation; public thoughts update only
+   * the answer-local timeline. This method does not make remote requests.
+   * @param {string} e Backend event name.
+   * @param {object} t Event payload for steps, thoughts, content or completion.
+   * @returns {void}
+   */
   handleStreamEvent(e, t) {
     var s, r;
     if (e === "step") {
-      this.upsertStep(t), this.renderExecutionSteps(!0);
+      this.upsertStep(t);
+      return;
+    }
+    if (e === "thought") {
+      this.upsertThought(t), this.renderThinkingTimeline();
       return;
     }
     if (e === "delta") {
@@ -516,16 +529,20 @@ class V {
     const t = this.steps.findIndex((s) => s.id === e.id);
     this.steps = t === -1 ? [...this.steps, e] : this.steps.map((s) => s.id === e.id ? { ...s, ...e } : s);
   }
+  upsertThought(e) {
+    const t = this.thoughts.findIndex((s) => s.id === e.id);
+    this.thoughts = t === -1 ? [...this.thoughts, e] : this.thoughts.map((s) => s.id === e.id ? { ...s, ...e } : s);
+  }
   async loadAgentRun(e) {
     if (!(!this.client || !e)) {
       this.selectedAgentRunId = e, this.runLoading = !0, this.runLoadError = "", this.renderPanel();
       try {
         const t = await this.client.getAgentRun(e);
         if (this.selectedAgentRunId !== e) return;
-        this.steps = t.steps;
+        this.steps = t.steps, this.thoughts = t.thoughts || [];
       } catch (t) {
         if (this.selectedAgentRunId !== e) return;
-        this.steps = [], this.runLoadError = t instanceof Error ? t.message : "执行过程加载失败";
+        this.steps = [], this.thoughts = [], this.runLoadError = t instanceof Error ? t.message : "执行过程加载失败";
       } finally {
         this.selectedAgentRunId === e && (this.runLoading = !1, this.renderPanel());
       }
@@ -578,7 +595,14 @@ class V {
   stopSourceRefresh() {
     this.sourceRefreshTimer && clearTimeout(this.sourceRefreshTimer), this.sourceRefreshTimer = null;
   }
-  renderPanel(e = this.asking, t = !1) {
+  /**
+   * Recreate the chat shell and source controls while keeping progress in answers.
+   * Preserve chat scroll unless following the active answer; bind DOM listeners
+   * after replacement. The sidebar contains no node progress or auto-scroll.
+   * @param {boolean} e Whether to scroll the chat to its latest message.
+   * @returns {void} No-op when the SDK panel is closed; no remote requests.
+   */
+  renderPanel(e = this.asking) {
     var g;
     if (!this.panel) return;
     const s = (g = this.panel.querySelector(".po-messages")) == null ? void 0 : g.scrollTop, r = this.questionUnavailableReason(), n = r || (this.asking ? "回答生成中，请稍候" : this.sourceSnapshots.length ? "请输入页面分析问题，Enter 发送，Shift + Enter 换行" : "可直接闲聊；业务问题需先上传代码包"), c = !!(r || this.asking), p = r ? '<button type="submit" disabled>暂不可提问</button>' : this.asking ? '<button class="po-stop" type="button" data-action="stop-answer" aria-label="停止输出" title="停止输出"><span aria-hidden="true"></span></button>' : '<button type="submit">发送</button>', m = C.map((o) => `
@@ -609,7 +633,7 @@ class V {
         </section>
         <form class="po-composer"><textarea ${c ? "disabled" : ""} placeholder="${l(n)}"></textarea>${p}</form>
       </main>
-      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSourceUploader()}<div class="po-steps">${this.renderSteps()}</div></section></aside>
+      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSourceUploader()}</section></aside>
     `, this.bindPanelEvents(), e) {
       const o = this.panel.querySelector(".po-messages");
       o && (o.scrollTop = o.scrollHeight);
@@ -617,10 +641,6 @@ class V {
       const o = this.panel.querySelector(".po-messages");
       o && (o.scrollTop = s);
     }
-    if (t) {
-      const o = this.panel.querySelector(".po-trace > section");
-      o && (o.scrollTop = o.scrollHeight);
-    }
   }
   renderAnswerState() {
     const n = messageTime(this.activeQuestionStartedAt), c = this.renderThinkingProcess(), e = this.asking && this.waitingForFirstContent ? `<article class="po-message assistant waiting" role="status" aria-live="polite">${n}<b>PageOps 分析</b><div class="po-ai-waiting"><span class="po-ai-spinner" aria-hidden="true"></span><span>正在理解问题并检索证据</span></div>${c}</article>` : "", t = this.streaming ? `<article class="po-message assistant streaming">${n}<b>PageOps 分析</b><div><span data-streaming-content>${R(this.streaming)}</span>${this.asking ? '<span class="po-typing-cursor" aria-hidden="true"></span>' : ""}</div>${c}</article>` : "", s = this.answerError ? `<article class="po-message assistant answer-error" role="alert">${n}<b>PageOps 分析</b><strong>本次回答失败</strong><div>${l(this.answerError)}</div></article>` : "", r = this.answerStopped ? '<div class="po-stream-stopped" role="status">已停止输出</div>' : "";
@@ -674,42 +694,24 @@ class V {
     const t = e.filename || "未命名代码包", s = e.created_at ? O(e.created_at) : "刚刚上传", r = G(e.archive_bytes || e.total_bytes || 0), n = String((b = (w = e.metadata) == null ? void 0 : w.analysis_status) != null ? b : "unknown"), c = typeof ((S = e.metadata) == null ? void 0 : S.tag) == "string" ? e.metadata.tag : "", p = typeof (($ = e.metadata) == null ? void 0 : $.branch) == "string" ? e.metadata.branch : "", m = c ? `Tag: ${c}` : p ? `Branch: ${p}` : "未记录代码引用", g = typeof ((E = e.metadata) == null ? void 0 : E.remark) == "string" && e.metadata.remark ? e.metadata.remark : "无备注", o = typeof ((A = e.metadata) == null ? void 0 : A.uploader) == "string" ? e.metadata.uploader : "未知用户", y = (T = { pending: "项目记忆等待更新", running: "项目记忆更新中", ready: "项目记忆已就绪", failed: "项目记忆更新失败" }[n]) != null ? T : "项目记忆状态未知";
     return `<article class="po-source-item ${this.selectedSourceSnapshotId != null && this.sourceSnapshotValue(e) === String(this.selectedSourceSnapshotId) || this.selectedSourceSnapshotId == null && e === this.sourceSnapshots[0] ? "selected" : ""}"><strong>${l(t)}</strong><span>${l(m)}</span><span>备注：${l(g)}</span><span>上传人：${l(o)} · ${l(s)} · ${l(r)}</span><span>${l(y)} · 当前问答${this.selectedSourceSnapshotId == null && e === this.sourceSnapshots[0] ? "默认" : ""}引用</span></article>`;
   }
-  renderSteps() {
-    return this.runLoading ? '<div class="po-trace-state"><span class="po-ai-spinner" aria-hidden="true"></span><span>正在恢复本次执行过程</span></div>' : this.runLoadError ? `<div class="po-trace-state failed" role="alert">${l(this.runLoadError)}</div>` : (this.steps.length ? this.steps : [{ id: "idle", title: "等待任务", status: "pending", summary: "发送问题后，这里会展示完整分析过程。" }]).map((t) => {
-      var c, p, m;
-      const s = (c = t.metrics) != null && c.length ? `<div class="po-step-metrics">${t.metrics.map((g) => `<span>${l(g)}</span>`).join("")}</div>` : "", r = (p = t.details) != null && p.length ? `<div class="po-step-details">${t.details.map((g) => `<div><span>${l(g.label)}</span><p>${l(g.value)}</p></div>`).join("")}</div>` : "", n = !!(s || r);
-      return `<details class="po-step ${t.status}" ${t.status === "running" || t.status === "failed" ? "open" : ""} ${n ? "" : "data-static"}>
-        <summary>
-          <span class="po-step-dot" aria-hidden="true"></span>
-          <span class="po-step-copy"><strong>${l(t.title)}</strong><small>${l((m = t.summary) != null ? m : "")}</small>${s}</span>
-          <span class="po-step-status">${Z(t.status)}</span>
-        </summary>
-        ${r}
-      </details>`;
-    }).join("");
-  }
   renderThinkingProcess() {
-    if (!this.asking && !this.steps.length && !this.runLoading && !this.runLoadError) return "";
-    const e = this.asking && !this.streaming, t = this.asking && !this.streaming ? "思考中" : this.runLoading ? "加载中" : this.runLoadError ? "加载失败" : "已思考完成", s = thinkingDuration(this.steps, this.activeQuestionStartedAt);
+    if (!this.asking && !this.thoughts.length && !this.runLoading && !this.runLoadError) return "";
+    const e = this.asking && !this.streaming, t = this.asking && !this.streaming ? "思考中" : this.runLoading ? "加载中" : this.runLoadError ? "加载失败" : "已思考完成", s = thinkingDuration(this.thoughts, this.activeQuestionStartedAt);
     return `<details class="po-thinking-process" ${e ? "open" : ""}><summary><strong>${s ? `用时 ${l(s)}` : "思考过程"}</strong><span>${t}</span></summary><div class="po-thinking-content">${this.renderThinkingSteps()}</div></details>`;
   }
   renderThinkingSteps() {
     if (this.runLoading) return '<div class="po-thinking-state"><span class="po-ai-spinner" aria-hidden="true"></span><span>正在恢复思考过程</span></div>';
     if (this.runLoadError) return `<div class="po-thinking-state failed">${l(this.runLoadError)}</div>`;
-    const e = this.steps.length ? this.steps : [{ id: "idle", kind: "thinking", title: "理解问题", status: "running", summary: "正在判断问题并规划需要核对的信息。" }];
+    const e = this.thoughts.length ? this.thoughts : [{ id: "idle", kind: "thinking", label: "理解问题", status: "running", text: "正在判断问题并规划需要核对的信息。" }];
     return e.map((t) => {
-      const s = String(t.kind || (String(t.id || "").startsWith("model-turn-") ? "thinking" : "status")), r = thinkingIcon(s), n = (t.metrics || []).length ? `<span class="po-thinking-metrics">${t.metrics.map((c) => l(c)).join(" · ")}</span>` : "", p = (t.details || []).map((c) => `<div class="po-thinking-detail"><span>${l(c.label)}</span>${String(c.value || "").split("\n").filter(Boolean).map((m) => `<code>${l(m)}</code>`).join("")}</div>`).join("");
-      if (s === "thinking") return `<div class="po-thinking-note ${t.status}">${r}<div><strong>${l(t.title)}</strong><p>${l(t.summary || "")}</p>${n}</div></div>`;
-      return `<div class="po-thinking-activity ${t.status}">${r}<div class="po-thinking-activity-copy"><strong>${l(t.title)}</strong><span>${l(t.summary || "")}</span>${n}${p}</div></div>`;
+      const s = String(t.kind || "thinking"), r = thinkingIcon(s), n = (t.metrics || []).length ? `<span class="po-thinking-metrics">${t.metrics.map((c) => l(c)).join(" · ")}</span>` : "", p = (t.details || []).map((c) => `<div class="po-thinking-detail"><span>${l(c.label)}</span>${String(c.value || "").split("\n").filter(Boolean).map((m) => `<code>${l(m)}</code>`).join("")}</div>`).join("");
+      if (s === "thinking") return `<div class="po-thinking-note ${t.status}">${r}<div><strong>${l(t.label)}</strong><p>${l(t.text || "")}</p>${n}</div></div>`;
+      return `<div class="po-thinking-activity ${t.status}">${r}<div class="po-thinking-activity-copy"><strong>${l(t.label)}</strong><span>${l(t.text || "")}</span>${n}${p}</div></div>`;
     }).join("");
   }
-  renderExecutionSteps(e = !1) {
-    var s, r;
-    const t = (s = this.panel) == null ? void 0 : s.querySelector(".po-steps");
-    if (t && (t.innerHTML = this.renderSteps(), this.panel == null || this.panel.querySelectorAll(".po-thinking-content").forEach((n) => n.innerHTML = this.renderThinkingSteps()), e)) {
-      const n = (r = this.panel) == null ? void 0 : r.querySelector(".po-trace > section");
-      n && (n.scrollTop = n.scrollHeight);
-    }
+  renderThinkingTimeline() {
+    var e;
+    (e = this.panel) == null || e.querySelectorAll(".po-thinking-content").forEach((t) => t.innerHTML = this.renderThinkingSteps());
   }
   bindPanelEvents() {
     var e, t, s, r, n, c, p, m, g, o, y, w, b, S, $, E, A, T, h, d;
@@ -829,8 +831,5 @@ function G(a) {
     t /= 1024, s += 1;
   return `${t >= 10 || s === 0 ? t.toFixed(0) : t.toFixed(1)} ${e[s]}`;
 }
-function Z(a) {
-  return { pending: "等待中", running: "执行中", completed: "已完成", failed: "失败", cancelled: "已停止" }[a];
-}
 const Y = new V();
 exports.PageOpsSDK=Y;}));

package/dist/types.d.ts

@@ -68,6 +68,20 @@ export interface AgentRunHistory {
     tool_call_count: number;
     active_skill?: string | null;
     steps: ExecutionStep[];
+    thoughts: AgentRunThought[];
+}
+
+export interface AgentRunThought {
+    id: string;
+    kind: 'thinking' | 'read' | 'search' | 'data' | 'tool' | 'status';
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    label: string;
+    text: string;
+    metrics?: string[];
+    details?: Array<{
+        label: string;
+        value: string;
+    }>;
 }
 export interface SourceSnapshot {
     id?: number | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pageops/sdk",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "PageOps embeddable frontend SDK",
   "type": "module",
   "main": "dist/pageops-sdk.umd.cjs",