@pageops/sdk 0.1.1 → 0.1.3

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { ContextSession, ConversationMessage, ConversationThread, PageOpsMountOptions } from './types';
+import type { ContextSession, ConversationMessage, ConversationThread, PageOpsMountOptions, SourceSnapshot } from './types';
 export declare class PageOpsClient {
     private options;
     constructor(options: PageOpsMountOptions);
@@ -6,6 +6,8 @@ export declare class PageOpsClient {
     listConversations(): Promise<ConversationThread[]>;
     createConversation(contextSessionId: string, title?: string): Promise<ConversationThread>;
     listMessages(threadId: string): Promise<ConversationMessage[]>;
+    listSources(): Promise<SourceSnapshot[]>;
+    uploadSource(file: File): Promise<SourceSnapshot>;
     streamQuestion(threadId: string, question: string): Promise<Response>;
     private request;
     private base;

package/dist/index.d.ts

@@ -10,6 +10,10 @@ declare class PageOpsSDKController {
     private conversations;
     private messages;
     private steps;
+    private sourceSnapshots;
+    private sourceUploadStatus;
+    private sourceUploadError;
+    private sourceUploading;
     private streaming;
     mount(options: PageOpsMountOptions): void;
     unmount(): void;
@@ -18,12 +22,16 @@ declare class PageOpsSDKController {
     updateContext(options: Partial<PageOpsMountOptions>): void;
     private renderClosed;
     private ensureContext;
+    private loadSources;
     private loadConversations;
     private newConversation;
     private selectThread;
+    private uploadSource;
     private ask;
     private upsertStep;
     private renderPanel;
+    private renderSourceUploader;
+    private renderSourceItem;
     private renderSteps;
     private bindPanelEvents;
 }

package/dist/pageops-sdk.css

@@ -1 +1 @@
-.pageops-sdk{--po-text: #172033;--po-muted: #64748b;--po-border: #dbe5f5;--po-soft-border: #e2e8f0;--po-surface: #ffffff;--po-soft: #f8fafc;--po-panel: #fbfdff;--po-primary: #2563eb;--po-primary-dark: #1d4ed8;--po-shadow: 0 24px 70px rgb(15 23 42 / 18%);color:var(--po-text);font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif}.pageops-sdk *,.pageops-sdk *:before,.pageops-sdk *:after{box-sizing:border-box}.pageops-sdk button,.pageops-sdk input,.pageops-sdk textarea{font:inherit}.pageops-sdk button{cursor:pointer}.po-fab{position:fixed;right:24px;bottom:24px;z-index:2147483000;border:0;border-radius:999px;padding:12px 18px;background:linear-gradient(135deg,#2563eb,#14b8a6);color:#fff;font-weight:800;box-shadow:0 18px 42px #2563eb47}.po-panel{position:fixed;inset:40px;z-index:2147483000;display:grid;grid-template-columns:250px minmax(0,1fr) 340px;min-height:520px;overflow:hidden;border:1px solid var(--po-border);border-radius:24px;background:var(--po-surface);box-shadow:var(--po-shadow)}.po-sidebar{display:flex;min-width:0;min-height:0;flex-direction:column;gap:12px;overflow:hidden;border-right:1px solid #dbeafe;background:#eef5ff;padding:16px}.po-brand{display:flex;align-items:center;gap:10px}.po-brand strong,.po-brand span{display:block}.po-brand span{margin-top:2px;color:var(--po-muted);font-size:12px}.po-logo{width:34px;height:34px;flex:0 0 auto;border-radius:12px;background:linear-gradient(135deg,#5eead4,#2563eb)}.po-new,.po-composer button{border:0;border-radius:10px;background:var(--po-primary);color:#fff;font-weight:750}.po-new{width:100%;padding:10px 12px}.po-search,.po-composer textarea{width:100%;border:1px solid #cbd5e1;border-radius:10px;background:#fff;color:var(--po-text);outline:none}.po-search{padding:9px 10px}.po-thread-list{display:grid;align-content:start;gap:8px;min-height:0;overflow:auto}.po-thread{display:grid;gap:4px;width:100%;border:1px solid transparent;border-radius:10px;background:transparent;color:#334155;padding:9px 10px;text-align:left}.po-thread.active{border-color:#bfdbfe;background:#fff;color:var(--po-text)}.po-thread span{color:#94a3b8;font-size:12px}.po-chat{display:flex;min-width:0;min-height:0;flex-direction:column;background:linear-gradient(180deg,#fff,var(--po-panel));padding:22px 26px}.po-chat header,.po-trace header{display:flex;align-items:center;justify-content:space-between;gap:12px;border-bottom:1px solid var(--po-soft-border);padding-bottom:14px}.po-chat header p,.po-chat header h2,.po-trace header h2{margin:0}.po-chat header p,.po-chat header span{color:var(--po-muted);font-size:12px}.po-chat header h2,.po-trace header h2{font-size:20px;letter-spacing:-.02em}.po-messages{display:grid;align-content:start;gap:14px;min-height:0;flex:1;overflow:auto;padding:18px 4px 18px 0}.po-message{display:grid;max-width:82%;gap:6px;border:1px solid var(--po-soft-border);border-radius:14px;padding:11px 13px;line-height:1.55;white-space:pre-wrap;word-break:break-word}.po-message b{font-size:12px;opacity:.78}.po-message.user{justify-self:end;border-color:var(--po-primary);background:var(--po-primary);color:#fff}.po-message.assistant{justify-self:start;background:var(--po-soft)}.po-message.streaming{border-color:#bfdbfe;background:#eff6ff}.po-message code{border-radius:5px;background:#eaf0ff;color:var(--po-primary-dark);padding:1px 5px}.po-message h2,.po-message h3,.po-message h4,.po-message p{margin:8px 0}.po-message table{width:100%;margin:12px 0;border-collapse:collapse;border-radius:10px;font-size:14px}.po-message th,.po-message td{border:1px solid var(--po-border);padding:8px 10px;text-align:left;vertical-align:top}.po-message th{background:#eef5ff;color:#334155;font-weight:800}.po-composer{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:end;gap:10px;border-top:1px solid var(--po-soft-border);padding-top:12px}.po-composer textarea{min-height:88px;resize:vertical;padding:10px}.po-composer button{min-height:44px;padding:0 16px}.po-trace{display:flex;min-height:0;flex-direction:column;border-left:1px solid var(--po-soft-border);background:#fafbff}.po-trace header{padding:18px}.po-trace header button{width:32px;height:32px;border:1px solid #cbd5e1;border-radius:10px;background:#fff;color:#334155;font-size:20px;line-height:1}.po-trace section{display:grid;align-content:start;gap:12px;min-height:0;overflow:auto;padding:16px}.po-step{border:1px solid var(--po-soft-border);border-radius:14px;background:#fff;padding:12px}.po-step.running{border-color:#bfdbfe;background:#eff6ff}.po-step.completed{border-color:#bbf7d0}.po-step.failed{border-color:#fecaca;background:#fff1f2}.po-step summary{display:flex;justify-content:space-between;gap:8px;cursor:pointer}.po-step summary::marker{color:var(--po-muted)}.po-step pre{overflow:auto;margin:10px 0 0;border-radius:12px;background:#0f172a;color:#e2e8f0;padding:12px;font-size:12px;white-space:pre-wrap}@media(max-width:900px){.po-panel{inset:12px;grid-template-columns:1fr;overflow:auto}.po-sidebar,.po-trace{min-height:220px;border:0}.po-chat{min-height:520px}.po-message{max-width:94%}}
+.pageops-sdk{--po-text: #172033;--po-muted: #64748b;--po-border: #dbe5f5;--po-soft-border: #e2e8f0;--po-surface: #ffffff;--po-soft: #f8fafc;--po-panel: #fbfdff;--po-primary: #2563eb;--po-primary-dark: #1d4ed8;--po-shadow: 0 24px 70px rgb(15 23 42 / 18%);color:var(--po-text);font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif}.pageops-sdk *,.pageops-sdk *:before,.pageops-sdk *:after{box-sizing:border-box}.pageops-sdk button,.pageops-sdk input,.pageops-sdk textarea{font:inherit}.pageops-sdk button{cursor:pointer}.po-fab{position:fixed;right:24px;bottom:24px;z-index:2147483000;border:0;border-radius:999px;padding:12px 18px;background:linear-gradient(135deg,#2563eb,#14b8a6);color:#fff;font-weight:800;box-shadow:0 18px 42px #2563eb47}.po-panel{position:fixed;inset:40px;z-index:2147483000;display:grid;grid-template-columns:250px minmax(0,1fr) 340px;min-height:520px;overflow:hidden;border:1px solid var(--po-border);border-radius:24px;background:var(--po-surface);box-shadow:var(--po-shadow)}.po-sidebar{display:flex;min-width:0;min-height:0;flex-direction:column;gap:12px;overflow:hidden;border-right:1px solid #dbeafe;background:#eef5ff;padding:16px}.po-brand{display:flex;align-items:center;gap:10px}.po-brand strong,.po-brand span{display:block}.po-brand span{margin-top:2px;color:var(--po-muted);font-size:12px}.po-logo{width:34px;height:34px;flex:0 0 auto;border-radius:12px;background:linear-gradient(135deg,#5eead4,#2563eb)}.po-new,.po-composer button{border:0;border-radius:10px;background:var(--po-primary);color:#fff;font-weight:750}.po-new{width:100%;padding:10px 12px}.po-search,.po-composer textarea{width:100%;border:1px solid #cbd5e1;border-radius:10px;background:#fff;color:var(--po-text);outline:none}.po-search{padding:9px 10px}.po-thread-list{display:grid;align-content:start;gap:8px;min-height:0;overflow:auto}.po-thread{display:grid;gap:4px;width:100%;border:1px solid transparent;border-radius:10px;background:transparent;color:#334155;padding:9px 10px;text-align:left}.po-thread.active{border-color:#bfdbfe;background:#fff;color:var(--po-text)}.po-thread span{color:#94a3b8;font-size:12px}.po-chat{display:flex;min-width:0;min-height:0;flex-direction:column;background:linear-gradient(180deg,#fff,var(--po-panel));padding:22px 26px}.po-chat header,.po-trace header{display:flex;align-items:center;justify-content:space-between;gap:12px;border-bottom:1px solid var(--po-soft-border);padding-bottom:14px}.po-chat header p,.po-chat header h2,.po-trace header h2{margin:0}.po-chat header p,.po-chat header span{color:var(--po-muted);font-size:12px}.po-chat header h2,.po-trace header h2{font-size:20px;letter-spacing:-.02em}.po-messages{display:grid;align-content:start;gap:14px;min-height:0;flex:1;overflow:auto;padding:18px 4px 18px 0}.po-message{display:grid;max-width:82%;gap:6px;border:1px solid var(--po-soft-border);border-radius:14px;padding:11px 13px;line-height:1.55;white-space:pre-wrap;word-break:break-word}.po-message b{font-size:12px;opacity:.78}.po-message.user{justify-self:end;border-color:var(--po-primary);background:var(--po-primary);color:#fff}.po-message.assistant{justify-self:start;background:var(--po-soft)}.po-message.streaming{border-color:#bfdbfe;background:#eff6ff}.po-message code{border-radius:5px;background:#eaf0ff;color:var(--po-primary-dark);padding:1px 5px}.po-message h2,.po-message h3,.po-message h4,.po-message p{margin:8px 0}.po-message table{width:100%;margin:12px 0;border-collapse:collapse;border-radius:10px;font-size:14px}.po-message th,.po-message td{border:1px solid var(--po-border);padding:8px 10px;text-align:left;vertical-align:top}.po-message th{background:#eef5ff;color:#334155;font-weight:800}.po-composer{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:end;gap:10px;border-top:1px solid var(--po-soft-border);padding-top:12px}.po-composer textarea{min-height:88px;resize:vertical;padding:10px}.po-composer button{min-height:44px;padding:0 16px}.po-trace{display:flex;min-height:0;flex-direction:column;border-left:1px solid var(--po-soft-border);background:#fafbff}.po-trace header{padding:18px}.po-trace header button{width:32px;height:32px;border:1px solid #cbd5e1;border-radius:10px;background:#fff;color:#334155;font-size:20px;line-height:1}.po-trace section{display:grid;align-content:start;gap:12px;min-height:0;overflow:auto;padding:16px}.po-source-uploader{display:grid;gap:8px;border:1px solid var(--po-soft-border);border-radius:14px;background:#fff;padding:12px}.po-source-uploader p{margin:0;color:var(--po-muted);font-size:12px;line-height:1.5}.po-upload-button{display:inline-flex;justify-content:center;border:1px solid #bfdbfe;border-radius:10px;background:#eff6ff;color:var(--po-primary-dark);padding:8px 10px;font-weight:750;cursor:pointer}.po-upload-button input{display:none}.po-upload-status{color:#166534!important}.po-upload-empty{color:#92400e!important}.po-source-list{display:grid;gap:6px}.po-source-item{display:grid;gap:3px;border:1px solid #dbeafe;border-radius:10px;background:#f8fbff;padding:8px}.po-source-item strong{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.po-source-item span{color:var(--po-muted);font-size:12px}.po-composer textarea:disabled,.po-composer button:disabled{cursor:not-allowed;opacity:.62}.po-upload-error{color:#b91c1c!important}.po-step{border:1px solid var(--po-soft-border);border-radius:14px;background:#fff;padding:12px}.po-step.running{border-color:#bfdbfe;background:#eff6ff}.po-step.completed{border-color:#bbf7d0}.po-step.failed{border-color:#fecaca;background:#fff1f2}.po-step summary{display:flex;justify-content:space-between;gap:8px;cursor:pointer}.po-step summary::marker{color:var(--po-muted)}.po-step pre{overflow:auto;margin:10px 0 0;border-radius:12px;background:#0f172a;color:#e2e8f0;padding:12px;font-size:12px;white-space:pre-wrap}@media(max-width:900px){.po-panel{inset:12px;grid-template-columns:1fr;overflow:auto}.po-sidebar,.po-trace{min-height:220px;border:0}.po-chat{min-height:520px}.po-message{max-width:94%}}

package/dist/pageops-sdk.es.js

@@ -1,13 +1,13 @@
-var y = Object.defineProperty;
-var $ = (i, t, e) => t in i ? y(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
-var l = (i, t, e) => $(i, typeof t != "symbol" ? t + "" : t, e);
-class v {
+var w = Object.defineProperty;
+var x = (r, t, e) => t in r ? w(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var a = (r, t, e) => x(r, typeof t != "symbol" ? t + "" : t, e);
+class S {
   constructor(t) {
     this.options = t;
   }
   async createContext() {
-    var e, s, r, n, a;
-    const t = (r = (s = (e = this.options).getPageContext) == null ? void 0 : s.call(e)) != null ? r : {};
+    var e, s, o, n, c;
+    const t = (o = (s = (e = this.options).getPageContext) == null ? void 0 : s.call(e)) != null ? o : {};
     return this.request("/context/session", {
       method: "POST",
       body: JSON.stringify({
@@ -15,7 +15,7 @@ class v {
         env: this.options.env,
         route: t.route,
         url: (n = t.url) != null ? n : location.href,
-        title: (a = t.title) != null ? a : document.title,
+        title: (c = t.title) != null ? c : document.title,
         tenant_id: t.tenantId,
         user_role: t.userRole,
         build_version: t.buildVersion
@@ -34,6 +34,13 @@ class v {
   async listMessages(t) {
     return (await this.request(`/conversations/${encodeURIComponent(t)}/messages`)).messages;
   }
+  async listSources() {
+    return (await this.request(`/sources?project_id=${encodeURIComponent(this.options.appId)}`)).sources;
+  }
+  uploadSource(t) {
+    const e = new FormData();
+    return e.append("file", t), this.request(`/sources/upload?project_id=${encodeURIComponent(this.options.appId)}`, { method: "POST", body: e, headers: {} });
+  }
   streamQuestion(t, e) {
     return fetch(`${this.base()}/question/stream`, {
       method: "POST",
@@ -42,95 +49,97 @@ class v {
     });
   }
   async request(t, e) {
-    var n, a;
-    const s = await fetch(`${this.base()}${t}`, {
-      ...e,
-      headers: { "content-type": "application/json", ...(n = e == null ? void 0 : e.headers) != null ? n : {} }
-    }), r = await s.json();
-    if (!s.ok) throw new Error((a = r.message) != null ? a : "PageOps 请求失败");
-    return r;
+    var c, h;
+    const s = (e == null ? void 0 : e.body) instanceof FormData ? e.headers : { "content-type": "application/json", ...(c = e == null ? void 0 : e.headers) != null ? c : {} }, o = await fetch(`${this.base()}${t}`, { ...e, headers: s }), n = await o.json();
+    if (!o.ok) throw new Error((h = n.message) != null ? h : "PageOps 请求失败");
+    return n;
   }
   base() {
-    return this.options.apiBase.replace(/\/$/, "");
+    const t = this.options.apiBase.replace(/\/$/, "");
+    return t.endsWith("/api") ? t : `${t}/api`;
   }
 }
-function w(i) {
-  return i.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+function E(r) {
+  return r.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-function g(i) {
-  return w(i).replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+function f(r) {
+  return E(r).replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
 }
-function x(i, t) {
-  const e = i[t], s = i[t + 1];
+function P(r, t) {
+  const e = r[t], s = r[t + 1];
   if (!(e != null && e.includes("|")) || !/^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(s != null ? s : "")) return null;
-  const r = [];
+  const o = [];
   let n = t;
-  for (; n < i.length && i[n].includes("|") && i[n].trim(); )
-    r.push(i[n]), n += 1;
-  const a = (h) => h.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => g(c.trim())), u = a(r[0]).map((h) => `<th>${h}</th>`).join(""), m = r.slice(2).map((h) => `<tr>${a(h).map((c) => `<td>${c}</td>`).join("")}</tr>`).join("");
-  return { html: `<table><thead><tr>${u}</tr></thead><tbody>${m}</tbody></table>`, next: n };
+  for (; n < r.length && r[n].includes("|") && r[n].trim(); )
+    o.push(r[n]), n += 1;
+  const c = (d) => d.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((m) => f(m.trim())), h = c(o[0]).map((d) => `<th>${d}</th>`).join(""), g = o.slice(2).map((d) => `<tr>${c(d).map((m) => `<td>${m}</td>`).join("")}</tr>`).join("");
+  return { html: `<table><thead><tr>${h}</tr></thead><tbody>${g}</tbody></table>`, next: n };
 }
-function b(i) {
-  const t = i.split(`
+function b(r) {
+  const t = r.split(`
 `), e = [];
   for (let s = 0; s < t.length; s += 1) {
-    const r = x(t, s);
-    if (r) {
-      e.push(r.html), s = r.next - 1;
+    const o = P(t, s);
+    if (o) {
+      e.push(o.html), s = o.next - 1;
       continue;
     }
     const n = t[s];
-    n.startsWith("### ") ? e.push(`<h4>${g(n.slice(4))}</h4>`) : n.startsWith("## ") ? e.push(`<h3>${g(n.slice(3))}</h3>`) : n.startsWith("# ") ? e.push(`<h2>${g(n.slice(2))}</h2>`) : n.startsWith("- ") ? e.push(`<li>${g(n.slice(2))}</li>`) : n.trim() ? e.push(`<p>${g(n)}</p>`) : e.push("<br>");
+    n.startsWith("### ") ? e.push(`<h4>${f(n.slice(4))}</h4>`) : n.startsWith("## ") ? e.push(`<h3>${f(n.slice(3))}</h3>`) : n.startsWith("# ") ? e.push(`<h2>${f(n.slice(2))}</h2>`) : n.startsWith("- ") ? e.push(`<li>${f(n.slice(2))}</li>`) : n.trim() ? e.push(`<p>${f(n)}</p>`) : e.push("<br>");
   }
   return e.join("");
 }
-async function S(i, t) {
-  var n, a, u;
-  const e = i.getReader(), s = new TextDecoder();
-  let r = "";
+async function T(r, t) {
+  var n, c, h;
+  const e = r.getReader(), s = new TextDecoder();
+  let o = "";
   for (; ; ) {
-    const { done: m, value: h } = await e.read();
-    if (m) break;
-    r += s.decode(h, { stream: !0 });
-    const c = r.split(`
+    const { done: g, value: d } = await e.read();
+    if (g) break;
+    o += s.decode(d, { stream: !0 });
+    const m = o.split(`
 
 `);
-    r = (n = c.pop()) != null ? n : "";
-    for (const o of c) {
-      const d = (a = o.match(/^event: (.+)$/m)) == null ? void 0 : a[1], p = (u = o.match(/^data: (.+)$/m)) == null ? void 0 : u[1];
-      d && p && t(d, JSON.parse(p));
+    o = (n = m.pop()) != null ? n : "";
+    for (const v of m) {
+      const l = (c = v.match(/^event: (.+)$/m)) == null ? void 0 : c[1], i = (h = v.match(/^data: (.+)$/m)) == null ? void 0 : h[1];
+      l && i && t(l, JSON.parse(i));
     }
   }
 }
-class T {
+class U {
   constructor() {
-    l(this, "client", null);
-    l(this, "options", null);
-    l(this, "root", null);
-    l(this, "panel", null);
-    l(this, "context", null);
-    l(this, "currentThread", null);
-    l(this, "conversations", []);
-    l(this, "messages", []);
-    l(this, "steps", []);
-    l(this, "streaming", "");
+    a(this, "client", null);
+    a(this, "options", null);
+    a(this, "root", null);
+    a(this, "panel", null);
+    a(this, "context", null);
+    a(this, "currentThread", null);
+    a(this, "conversations", []);
+    a(this, "messages", []);
+    a(this, "steps", []);
+    a(this, "sourceSnapshots", []);
+    a(this, "sourceUploadStatus", "");
+    a(this, "sourceUploadError", "");
+    a(this, "sourceUploading", !1);
+    a(this, "streaming", "");
   }
   mount(t) {
     var e;
-    this.unmount(), this.options = t, this.client = new v(t), this.root = document.createElement("div"), this.root.className = "pageops-sdk", ((e = t.container) != null ? e : document.body).appendChild(this.root), this.renderClosed();
+    this.unmount(), this.options = t, this.client = new S(t), this.root = document.createElement("div"), this.root.className = "pageops-sdk", ((e = t.container) != null ? e : document.body).appendChild(this.root), this.renderClosed();
   }
   unmount() {
     var t;
-    (t = this.root) == null || t.remove(), this.root = null, this.panel = null, this.context = null, this.currentThread = null, this.conversations = [], this.messages = [], this.steps = [], this.streaming = "";
+    (t = this.root) == null || t.remove(), this.root = null, this.panel = null, this.context = null, this.currentThread = null, this.conversations = [], this.messages = [], this.steps = [], this.sourceSnapshots = [], this.sourceUploadStatus = "", this.sourceUploadError = "", this.sourceUploading = !1, this.streaming = "";
   }
   open() {
-    this.root && (this.root.innerHTML = "", this.panel = document.createElement("div"), this.panel.className = "po-panel", this.root.appendChild(this.panel), this.loadConversations(), this.renderPanel());
+    this.root && (this.root.innerHTML = "", this.panel = document.createElement("div"), this.panel.className = "po-panel", this.root.appendChild(this.panel), this.loadSources(), this.loadConversations(), this.renderPanel());
   }
   close() {
     this.renderClosed();
   }
   updateContext(t) {
-    this.options && (this.options = { ...this.options, ...t }, this.client = new v(this.options));
+    this.options && (this.options = { ...this.options, ...t }, this.client = new S(this.options));
   }
   renderClosed() {
     var t;
@@ -141,6 +150,16 @@ class T {
     if (!this.client) throw new Error("PageOps SDK 未初始化");
     return this.context = await this.client.createContext(), this.context;
   }
+  async loadSources() {
+    if (this.client) {
+      try {
+        this.sourceSnapshots = await this.client.listSources(), this.sourceUploadError = "";
+      } catch (t) {
+        this.sourceUploadError = t instanceof Error ? t.message : "源码包状态加载失败";
+      }
+      this.renderPanel();
+    }
+  }
   async loadConversations() {
     this.client && (this.conversations = await this.client.listConversations(), this.renderPanel());
   }
@@ -152,14 +171,31 @@ class T {
   async selectThread(t) {
     this.client && (this.currentThread = t, this.messages = await this.client.listMessages(t.id), this.steps = [], this.streaming = "", this.renderPanel());
   }
+  async uploadSource(t) {
+    if (this.client) {
+      this.sourceUploading = !0, this.sourceUploadStatus = "上传中...", this.sourceUploadError = "", this.renderPanel();
+      try {
+        await this.client.uploadSource(t), this.sourceSnapshots = await this.client.listSources(), this.sourceUploadStatus = "上传完成";
+      } catch (e) {
+        this.sourceUploadError = e instanceof Error ? e.message : "源码包上传失败", this.sourceUploadStatus = "";
+      } finally {
+        this.sourceUploading = !1, this.renderPanel();
+      }
+    }
+  }
   async ask(t) {
-    if (!this.client || (this.currentThread || await this.newConversation(), !this.currentThread)) return;
+    if (!this.client) return;
+    if (!this.sourceSnapshots.length) {
+      this.sourceUploadError = "请先上传代码包后再提问。", this.renderPanel();
+      return;
+    }
+    if (this.currentThread || await this.newConversation(), !this.currentThread) return;
     this.messages.push({ id: `local-${Date.now()}`, role: "user", content: t, metadata_json: {} }), this.steps = [], this.streaming = "", this.renderPanel();
     const e = await this.client.streamQuestion(this.currentThread.id, t);
     if (!e.ok || !e.body) throw new Error("PageOps 流式问答失败");
-    await S(e.body, (s, r) => {
+    await T(e.body, (s, o) => {
       var n;
-      s === "step" && this.upsertStep(r), s === "delta" && (this.streaming += String((n = r.content) != null ? n : "")), s === "done" && this.selectThread(this.currentThread), s === "error" && this.upsertStep({ id: "error", title: "执行失败", status: "failed", details: r }), this.renderPanel();
+      s === "step" && this.upsertStep(o), s === "delta" && (this.streaming += String((n = o.content) != null ? n : "")), s === "done" && this.selectThread(this.currentThread), s === "error" && this.upsertStep({ id: "error", title: "执行失败", status: "failed", details: o }), this.renderPanel();
     });
   }
   upsertStep(t) {
@@ -176,53 +212,84 @@ class T {
       var e;
       return `
           <button class="po-thread ${t.id === ((e = this.currentThread) == null ? void 0 : e.id) ? "active" : ""}" data-thread="${t.id}">
-            <strong>${f(t.title)}</strong><span>${C(t.created_at)}</span>
+            <strong>${u(t.title)}</strong><span>${y(t.created_at)}</span>
           </button>`;
     }).join("")}</div>
       </aside>
       <main class="po-chat">
-        <header><div><p>问数回答</p><h2>${this.currentThread ? f(this.currentThread.title) : "未选择问答"}</h2></div><span>Markdown · 流式输出</span></header>
+        <header><div><p>问数回答</p><h2>${this.currentThread ? u(this.currentThread.title) : "未选择问答"}</h2></div><span>Markdown · 流式输出</span></header>
         <section class="po-messages">
-          ${this.messages.map((t) => `<article class="po-message ${t.role}"><b>${t.role === "user" ? "你" : "PageOps 分析"}</b><div>${t.role === "assistant" ? b(t.content) : f(t.content)}</div></article>`).join("")}
+          ${this.messages.map((t) => `<article class="po-message ${t.role}"><b>${t.role === "user" ? "你" : "PageOps 分析"}</b><div>${t.role === "assistant" ? b(t.content) : u(t.content)}</div></article>`).join("")}
           ${this.streaming ? `<article class="po-message assistant streaming"><b>PageOps 分析</b><div>${b(this.streaming)}</div></article>` : ""}
         </section>
-        <form class="po-composer"><textarea placeholder="请输入页面分析问题，Enter 发送，Shift + Enter 换行"></textarea><button type="submit">发送</button></form>
+        <form class="po-composer"><textarea ${this.sourceSnapshots.length ? "" : "disabled"} placeholder="${this.sourceSnapshots.length ? "请输入页面分析问题，Enter 发送，Shift + Enter 换行" : "请先上传代码包后再提问"}"></textarea><button type="submit" ${this.sourceSnapshots.length ? "" : "disabled"}>${this.sourceSnapshots.length ? "发送" : "请先上传代码包"}</button></form>
       </main>
-      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSteps()}</section></aside>
+      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSourceUploader()}${this.renderSteps()}</section></aside>
     `, this.bindPanelEvents());
   }
+  renderSourceUploader() {
+    return `
+      <div class="po-source-uploader">
+        <strong>源码包</strong>
+        <p>上传 zip、tar、tar.gz 或 tgz 后，PageOps 将基于代码证据回答问题。</p>
+        <label class="po-upload-button">
+          <span>${this.sourceUploading ? "上传中..." : "选择代码包"}</span>
+          <input type="file" accept=".zip,.tar,.gz,.tgz" data-action="upload-source" ${this.sourceUploading ? "disabled" : ""} />
+        </label>
+        ${this.sourceUploadStatus ? `<p class="po-upload-status">${u(this.sourceUploadStatus)}</p>` : ""}
+        ${this.sourceSnapshots.length ? `<div class="po-source-list">${this.sourceSnapshots.map((t) => this.renderSourceItem(t)).join("")}</div>` : '<p class="po-upload-empty">当前系统暂无代码包，请先上传后再提问。</p>'}
+        ${this.sourceUploadError ? `<p class="po-upload-error">${u(this.sourceUploadError)}</p>` : ""}
+      </div>
+    `;
+  }
+  renderSourceItem(t) {
+    const e = t.filename || "未命名代码包", s = t.created_at ? y(t.created_at) : "刚刚上传", o = C(t.archive_bytes || t.total_bytes || 0);
+    return `<article class="po-source-item"><strong>${u(e)}</strong><span>${u(s)} · ${u(o)}</span></article>`;
+  }
   renderSteps() {
     return (this.steps.length ? this.steps : [{ id: "idle", title: "等待任务", status: "pending", details: { message: "发送消息后展示执行过程。" } }]).map((e) => {
       var s;
-      return `<details class="po-step ${e.status}" ${e.status === "running" || e.status === "failed" ? "open" : ""}><summary><strong>${f(e.title)}</strong><span>${e.status}</span></summary><pre>${f(JSON.stringify((s = e.details) != null ? s : {}, null, 2))}</pre></details>`;
+      return `<details class="po-step ${e.status}" ${e.status === "running" || e.status === "failed" ? "open" : ""}><summary><strong>${u(e.title)}</strong><span>${e.status}</span></summary><pre>${u(JSON.stringify((s = e.details) != null ? s : {}, null, 2))}</pre></details>`;
     }).join("");
   }
   bindPanelEvents() {
-    var t, e, s, r, n, a, u, m, h;
-    (e = (t = this.panel) == null ? void 0 : t.querySelector('[data-action="new"]')) == null || e.addEventListener("click", () => void this.newConversation()), (r = (s = this.panel) == null ? void 0 : s.querySelector('[data-action="close"]')) == null || r.addEventListener("click", () => this.close()), (n = this.panel) == null || n.querySelectorAll("[data-thread]").forEach((c) => {
-      c.addEventListener("click", () => {
-        const o = this.conversations.find((d) => d.id === c.dataset.thread);
-        o && this.selectThread(o);
-      });
-    }), (u = (a = this.panel) == null ? void 0 : a.querySelector("form")) == null || u.addEventListener("submit", (c) => {
+    var t, e, s, o, n, c, h, g, d, m, v;
+    (e = (t = this.panel) == null ? void 0 : t.querySelector('[data-action="new"]')) == null || e.addEventListener("click", () => void this.newConversation()), (o = (s = this.panel) == null ? void 0 : s.querySelector('[data-action="close"]')) == null || o.addEventListener("click", () => this.close()), (c = (n = this.panel) == null ? void 0 : n.querySelector('[data-action="upload-source"]')) == null || c.addEventListener("change", (l) => {
       var p;
-      c.preventDefault();
-      const o = (p = this.panel) == null ? void 0 : p.querySelector("textarea"), d = o == null ? void 0 : o.value.trim();
-      d && (o.value = "", this.ask(d));
-    }), (h = (m = this.panel) == null ? void 0 : m.querySelector("textarea")) == null || h.addEventListener("keydown", (c) => {
-      var d, p;
-      const o = c;
-      o.key === "Enter" && !o.shiftKey && (o.preventDefault(), (p = (d = this.panel) == null ? void 0 : d.querySelector("form")) == null || p.requestSubmit());
+      const i = (p = l.target.files) == null ? void 0 : p[0];
+      i && this.uploadSource(i);
+    }), (h = this.panel) == null || h.querySelectorAll("[data-thread]").forEach((l) => {
+      l.addEventListener("click", () => {
+        const i = this.conversations.find((p) => p.id === l.dataset.thread);
+        i && this.selectThread(i);
+      });
+    }), (d = (g = this.panel) == null ? void 0 : g.querySelector("form")) == null || d.addEventListener("submit", (l) => {
+      var $;
+      l.preventDefault();
+      const i = ($ = this.panel) == null ? void 0 : $.querySelector("textarea"), p = i == null ? void 0 : i.value.trim();
+      p && (i.value = "", this.ask(p));
+    }), (v = (m = this.panel) == null ? void 0 : m.querySelector("textarea")) == null || v.addEventListener("keydown", (l) => {
+      var p, $;
+      const i = l;
+      i.key === "Enter" && !i.shiftKey && (i.preventDefault(), ($ = (p = this.panel) == null ? void 0 : p.querySelector("form")) == null || $.requestSubmit());
     });
   }
 }
-function f(i) {
-  return i.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+function u(r) {
+  return r.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function y(r) {
+  return new Intl.DateTimeFormat("zh-CN", { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" }).format(new Date(r));
 }
-function C(i) {
-  return new Intl.DateTimeFormat("zh-CN", { month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" }).format(new Date(i));
+function C(r) {
+  if (!r) return "0 B";
+  const t = ["B", "KB", "MB", "GB"];
+  let e = r, s = 0;
+  for (; e >= 1024 && s < t.length - 1; )
+    e /= 1024, s += 1;
+  return `${e >= 10 || s === 0 ? e.toFixed(0) : e.toFixed(1)} ${t[s]}`;
 }
-const E = new T();
+const q = new U();
 export {
-  E as PageOpsSDK
+  q as PageOpsSDK
 };

package/dist/pageops-sdk.umd.cjs

@@ -1,23 +1,35 @@
-(function(h,o){typeof exports=="object"&&typeof module!="undefined"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(h=typeof globalThis!="undefined"?globalThis:h||self,o(h.PageOpsSDK={}))})(this,(function(h){"use strict";var C=Object.defineProperty;var O=(h,o,g)=>o in h?C(h,o,{enumerable:!0,configurable:!0,writable:!0,value:g}):h[o]=g;var d=(h,o,g)=>O(h,typeof o!="symbol"?o+"":o,g);class o{constructor(t){this.options=t}async createContext(){var e,s,i,n,a;const t=(i=(s=(e=this.options).getPageContext)==null?void 0:s.call(e))!=null?i:{};return this.request("/context/session",{method:"POST",body:JSON.stringify({app_id:this.options.appId,env:this.options.env,route:t.route,url:(n=t.url)!=null?n:location.href,title:(a=t.title)!=null?a:document.title,tenant_id:t.tenantId,user_role:t.userRole,build_version:t.buildVersion})})}async listConversations(){return(await this.request("/conversations")).conversations}async createConversation(t,e){return this.request("/conversations",{method:"POST",body:JSON.stringify({context_session_id:t,title:e})})}async listMessages(t){return(await this.request(`/conversations/${encodeURIComponent(t)}/messages`)).messages}streamQuestion(t,e){return fetch(`${this.base()}/question/stream`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({thread_id:t,question:e})})}async request(t,e){var n,a;const s=await fetch(`${this.base()}${t}`,{...e,headers:{"content-type":"application/json",...(n=e==null?void 0:e.headers)!=null?n:{}}}),i=await s.json();if(!s.ok)throw new Error((a=i.message)!=null?a:"PageOps 请求失败");return i}base(){return this.options.apiBase.replace(/\/$/,"")}}function g(r){return r.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function v(r){return g(r).replace(/`([^`]+)`/g,"<code>$1</code>").replace(/\*\*([^*]+)\*\*/g,"<strong>$1</strong>")}function w(r,t){const e=r[t],s=r[t+1];if(!(e!=null&&e.includes("|"))||!/^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(s!=null?s:""))return null;const i=[];let n=t;for(;n<r.length&&r[n].includes("|")&&r[n].trim();)i.push(r[n]),n+=1;const a=p=>p.trim().replace(/^\|/,"").replace(/\|$/,"").split("|").map(l=>v(l.trim())),f=a(i[0]).map(p=>`<th>${p}</th>`).join(""),b=i.slice(2).map(p=>`<tr>${a(p).map(l=>`<td>${l}</td>`).join("")}</tr>`).join("");return{html:`<table><thead><tr>${f}</tr></thead><tbody>${b}</tbody></table>`,next:n}}function $(r){const t=r.split(`
-`),e=[];for(let s=0;s<t.length;s+=1){const i=w(t,s);if(i){e.push(i.html),s=i.next-1;continue}const n=t[s];n.startsWith("### ")?e.push(`<h4>${v(n.slice(4))}</h4>`):n.startsWith("## ")?e.push(`<h3>${v(n.slice(3))}</h3>`):n.startsWith("# ")?e.push(`<h2>${v(n.slice(2))}</h2>`):n.startsWith("- ")?e.push(`<li>${v(n.slice(2))}</li>`):n.trim()?e.push(`<p>${v(n)}</p>`):e.push("<br>")}return e.join("")}async function S(r,t){var n,a,f;const e=r.getReader(),s=new TextDecoder;let i="";for(;;){const{done:b,value:p}=await e.read();if(b)break;i+=s.decode(p,{stream:!0});const l=i.split(`
+(function(h,c){typeof exports=="object"&&typeof module!="undefined"?c(exports):typeof define=="function"&&define.amd?define(["exports"],c):(h=typeof globalThis!="undefined"?globalThis:h||self,c(h.PageOpsSDK={}))})(this,(function(h){"use strict";var O=Object.defineProperty;var q=(h,c,v)=>c in h?O(h,c,{enumerable:!0,configurable:!0,writable:!0,value:v}):h[c]=v;var a=(h,c,v)=>q(h,typeof c!="symbol"?c+"":c,v);class c{constructor(t){this.options=t}async createContext(){var e,s,r,n,l;const t=(r=(s=(e=this.options).getPageContext)==null?void 0:s.call(e))!=null?r:{};return this.request("/context/session",{method:"POST",body:JSON.stringify({app_id:this.options.appId,env:this.options.env,route:t.route,url:(n=t.url)!=null?n:location.href,title:(l=t.title)!=null?l:document.title,tenant_id:t.tenantId,user_role:t.userRole,build_version:t.buildVersion})})}async listConversations(){return(await this.request("/conversations")).conversations}async createConversation(t,e){return this.request("/conversations",{method:"POST",body:JSON.stringify({context_session_id:t,title:e})})}async listMessages(t){return(await this.request(`/conversations/${encodeURIComponent(t)}/messages`)).messages}async listSources(){return(await this.request(`/sources?project_id=${encodeURIComponent(this.options.appId)}`)).sources}uploadSource(t){const e=new FormData;return e.append("file",t),this.request(`/sources/upload?project_id=${encodeURIComponent(this.options.appId)}`,{method:"POST",body:e,headers:{}})}streamQuestion(t,e){return fetch(`${this.base()}/question/stream`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({thread_id:t,question:e})})}async request(t,e){var l,u;const s=(e==null?void 0:e.body)instanceof FormData?e.headers:{"content-type":"application/json",...(l=e==null?void 0:e.headers)!=null?l:{}},r=await fetch(`${this.base()}${t}`,{...e,headers:s}),n=await r.json();if(!r.ok)throw new Error((u=n.message)!=null?u:"PageOps 请求失败");return n}base(){const t=this.options.apiBase.replace(/\/$/,"");return t.endsWith("/api")?t:`${t}/api`}}function v(o){return o.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function S(o){return v(o).replace(/`([^`]+)`/g,"<code>$1</code>").replace(/\*\*([^*]+)\*\*/g,"<strong>$1</strong>")}function E(o,t){const e=o[t],s=o[t+1];if(!(e!=null&&e.includes("|"))||!/^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(s!=null?s:""))return null;const r=[];let n=t;for(;n<o.length&&o[n].includes("|")&&o[n].trim();)r.push(o[n]),n+=1;const l=m=>m.trim().replace(/^\|/,"").replace(/\|$/,"").split("|").map(g=>S(g.trim())),u=l(r[0]).map(m=>`<th>${m}</th>`).join(""),$=r.slice(2).map(m=>`<tr>${l(m).map(g=>`<td>${g}</td>`).join("")}</tr>`).join("");return{html:`<table><thead><tr>${u}</tr></thead><tbody>${$}</tbody></table>`,next:n}}function w(o){const t=o.split(`
+`),e=[];for(let s=0;s<t.length;s+=1){const r=E(t,s);if(r){e.push(r.html),s=r.next-1;continue}const n=t[s];n.startsWith("### ")?e.push(`<h4>${S(n.slice(4))}</h4>`):n.startsWith("## ")?e.push(`<h3>${S(n.slice(3))}</h3>`):n.startsWith("# ")?e.push(`<h2>${S(n.slice(2))}</h2>`):n.startsWith("- ")?e.push(`<li>${S(n.slice(2))}</li>`):n.trim()?e.push(`<p>${S(n)}</p>`):e.push("<br>")}return e.join("")}async function P(o,t){var n,l,u;const e=o.getReader(),s=new TextDecoder;let r="";for(;;){const{done:$,value:m}=await e.read();if($)break;r+=s.decode(m,{stream:!0});const g=r.split(`
 
-`);i=(n=l.pop())!=null?n:"";for(const c of l){const u=(a=c.match(/^event: (.+)$/m))==null?void 0:a[1],m=(f=c.match(/^data: (.+)$/m))==null?void 0:f[1];u&&m&&t(u,JSON.parse(m))}}}class x{constructor(){d(this,"client",null);d(this,"options",null);d(this,"root",null);d(this,"panel",null);d(this,"context",null);d(this,"currentThread",null);d(this,"conversations",[]);d(this,"messages",[]);d(this,"steps",[]);d(this,"streaming","")}mount(t){var e;this.unmount(),this.options=t,this.client=new o(t),this.root=document.createElement("div"),this.root.className="pageops-sdk",((e=t.container)!=null?e:document.body).appendChild(this.root),this.renderClosed()}unmount(){var t;(t=this.root)==null||t.remove(),this.root=null,this.panel=null,this.context=null,this.currentThread=null,this.conversations=[],this.messages=[],this.steps=[],this.streaming=""}open(){this.root&&(this.root.innerHTML="",this.panel=document.createElement("div"),this.panel.className="po-panel",this.root.appendChild(this.panel),this.loadConversations(),this.renderPanel())}close(){this.renderClosed()}updateContext(t){this.options&&(this.options={...this.options,...t},this.client=new o(this.options))}renderClosed(){var t;this.root&&(this.root.innerHTML='<button class="po-fab" type="button">多轮问答</button>',(t=this.root.querySelector("button"))==null||t.addEventListener("click",()=>this.open()))}async ensureContext(){if(this.context)return this.context;if(!this.client)throw new Error("PageOps SDK 未初始化");return this.context=await this.client.createContext(),this.context}async loadConversations(){this.client&&(this.conversations=await this.client.listConversations(),this.renderPanel())}async newConversation(){if(!this.client)return;const t=await this.ensureContext();this.currentThread=await this.client.createConversation(t.id,t.route||document.title||"新的问答"),this.conversations=[this.currentThread,...this.conversations],this.messages=[],this.steps=[],this.streaming="",this.renderPanel()}async selectThread(t){this.client&&(this.currentThread=t,this.messages=await this.client.listMessages(t.id),this.steps=[],this.streaming="",this.renderPanel())}async ask(t){if(!this.client||(this.currentThread||await this.newConversation(),!this.currentThread))return;this.messages.push({id:`local-${Date.now()}`,role:"user",content:t,metadata_json:{}}),this.steps=[],this.streaming="",this.renderPanel();const e=await this.client.streamQuestion(this.currentThread.id,t);if(!e.ok||!e.body)throw new Error("PageOps 流式问答失败");await S(e.body,(s,i)=>{var n;s==="step"&&this.upsertStep(i),s==="delta"&&(this.streaming+=String((n=i.content)!=null?n:"")),s==="done"&&this.selectThread(this.currentThread),s==="error"&&this.upsertStep({id:"error",title:"执行失败",status:"failed",details:i}),this.renderPanel()})}upsertStep(t){const e=this.steps.findIndex(s=>s.id===t.id);this.steps=e===-1?[...this.steps,t]:this.steps.map(s=>s.id===t.id?{...s,...t}:s)}renderPanel(){this.panel&&(this.panel.innerHTML=`
+`);r=(n=g.pop())!=null?n:"";for(const y of g){const d=(l=y.match(/^event: (.+)$/m))==null?void 0:l[1],i=(u=y.match(/^data: (.+)$/m))==null?void 0:u[1];d&&i&&t(d,JSON.parse(i))}}}class T{constructor(){a(this,"client",null);a(this,"options",null);a(this,"root",null);a(this,"panel",null);a(this,"context",null);a(this,"currentThread",null);a(this,"conversations",[]);a(this,"messages",[]);a(this,"steps",[]);a(this,"sourceSnapshots",[]);a(this,"sourceUploadStatus","");a(this,"sourceUploadError","");a(this,"sourceUploading",!1);a(this,"streaming","")}mount(t){var e;this.unmount(),this.options=t,this.client=new c(t),this.root=document.createElement("div"),this.root.className="pageops-sdk",((e=t.container)!=null?e:document.body).appendChild(this.root),this.renderClosed()}unmount(){var t;(t=this.root)==null||t.remove(),this.root=null,this.panel=null,this.context=null,this.currentThread=null,this.conversations=[],this.messages=[],this.steps=[],this.sourceSnapshots=[],this.sourceUploadStatus="",this.sourceUploadError="",this.sourceUploading=!1,this.streaming=""}open(){this.root&&(this.root.innerHTML="",this.panel=document.createElement("div"),this.panel.className="po-panel",this.root.appendChild(this.panel),this.loadSources(),this.loadConversations(),this.renderPanel())}close(){this.renderClosed()}updateContext(t){this.options&&(this.options={...this.options,...t},this.client=new c(this.options))}renderClosed(){var t;this.root&&(this.root.innerHTML='<button class="po-fab" type="button">多轮问答</button>',(t=this.root.querySelector("button"))==null||t.addEventListener("click",()=>this.open()))}async ensureContext(){if(this.context)return this.context;if(!this.client)throw new Error("PageOps SDK 未初始化");return this.context=await this.client.createContext(),this.context}async loadSources(){if(this.client){try{this.sourceSnapshots=await this.client.listSources(),this.sourceUploadError=""}catch(t){this.sourceUploadError=t instanceof Error?t.message:"源码包状态加载失败"}this.renderPanel()}}async loadConversations(){this.client&&(this.conversations=await this.client.listConversations(),this.renderPanel())}async newConversation(){if(!this.client)return;const t=await this.ensureContext();this.currentThread=await this.client.createConversation(t.id,t.route||document.title||"新的问答"),this.conversations=[this.currentThread,...this.conversations],this.messages=[],this.steps=[],this.streaming="",this.renderPanel()}async selectThread(t){this.client&&(this.currentThread=t,this.messages=await this.client.listMessages(t.id),this.steps=[],this.streaming="",this.renderPanel())}async uploadSource(t){if(this.client){this.sourceUploading=!0,this.sourceUploadStatus="上传中...",this.sourceUploadError="",this.renderPanel();try{await this.client.uploadSource(t),this.sourceSnapshots=await this.client.listSources(),this.sourceUploadStatus="上传完成"}catch(e){this.sourceUploadError=e instanceof Error?e.message:"源码包上传失败",this.sourceUploadStatus=""}finally{this.sourceUploading=!1,this.renderPanel()}}}async ask(t){if(!this.client)return;if(!this.sourceSnapshots.length){this.sourceUploadError="请先上传代码包后再提问。",this.renderPanel();return}if(this.currentThread||await this.newConversation(),!this.currentThread)return;this.messages.push({id:`local-${Date.now()}`,role:"user",content:t,metadata_json:{}}),this.steps=[],this.streaming="",this.renderPanel();const e=await this.client.streamQuestion(this.currentThread.id,t);if(!e.ok||!e.body)throw new Error("PageOps 流式问答失败");await P(e.body,(s,r)=>{var n;s==="step"&&this.upsertStep(r),s==="delta"&&(this.streaming+=String((n=r.content)!=null?n:"")),s==="done"&&this.selectThread(this.currentThread),s==="error"&&this.upsertStep({id:"error",title:"执行失败",status:"failed",details:r}),this.renderPanel()})}upsertStep(t){const e=this.steps.findIndex(s=>s.id===t.id);this.steps=e===-1?[...this.steps,t]:this.steps.map(s=>s.id===t.id?{...s,...t}:s)}renderPanel(){this.panel&&(this.panel.innerHTML=`
       <aside class="po-sidebar">
         <div class="po-brand"><div class="po-logo"></div><div><strong>PageOps 问答</strong><span>页面工程专家</span></div></div>
         <button class="po-new" data-action="new">+ 新建问答</button>
         <input class="po-search" placeholder="搜索问答" />
         <div class="po-thread-list">${this.conversations.map(t=>{var e;return`
           <button class="po-thread ${t.id===((e=this.currentThread)==null?void 0:e.id)?"active":""}" data-thread="${t.id}">
-            <strong>${y(t.title)}</strong><span>${T(t.created_at)}</span>
+            <strong>${p(t.title)}</strong><span>${x(t.created_at)}</span>
           </button>`}).join("")}</div>
       </aside>
       <main class="po-chat">
-        <header><div><p>问数回答</p><h2>${this.currentThread?y(this.currentThread.title):"未选择问答"}</h2></div><span>Markdown · 流式输出</span></header>
+        <header><div><p>问数回答</p><h2>${this.currentThread?p(this.currentThread.title):"未选择问答"}</h2></div><span>Markdown · 流式输出</span></header>
         <section class="po-messages">
-          ${this.messages.map(t=>`<article class="po-message ${t.role}"><b>${t.role==="user"?"你":"PageOps 分析"}</b><div>${t.role==="assistant"?$(t.content):y(t.content)}</div></article>`).join("")}
-          ${this.streaming?`<article class="po-message assistant streaming"><b>PageOps 分析</b><div>${$(this.streaming)}</div></article>`:""}
+          ${this.messages.map(t=>`<article class="po-message ${t.role}"><b>${t.role==="user"?"你":"PageOps 分析"}</b><div>${t.role==="assistant"?w(t.content):p(t.content)}</div></article>`).join("")}
+          ${this.streaming?`<article class="po-message assistant streaming"><b>PageOps 分析</b><div>${w(this.streaming)}</div></article>`:""}
         </section>
-        <form class="po-composer"><textarea placeholder="请输入页面分析问题，Enter 发送，Shift + Enter 换行"></textarea><button type="submit">发送</button></form>
+        <form class="po-composer"><textarea ${this.sourceSnapshots.length?"":"disabled"} placeholder="${this.sourceSnapshots.length?"请输入页面分析问题，Enter 发送，Shift + Enter 换行":"请先上传代码包后再提问"}"></textarea><button type="submit" ${this.sourceSnapshots.length?"":"disabled"}>${this.sourceSnapshots.length?"发送":"请先上传代码包"}</button></form>
       </main>
-      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSteps()}</section></aside>
-    `,this.bindPanelEvents())}renderSteps(){return(this.steps.length?this.steps:[{id:"idle",title:"等待任务",status:"pending",details:{message:"发送消息后展示执行过程。"}}]).map(e=>{var s;return`<details class="po-step ${e.status}" ${e.status==="running"||e.status==="failed"?"open":""}><summary><strong>${y(e.title)}</strong><span>${e.status}</span></summary><pre>${y(JSON.stringify((s=e.details)!=null?s:{},null,2))}</pre></details>`}).join("")}bindPanelEvents(){var t,e,s,i,n,a,f,b,p;(e=(t=this.panel)==null?void 0:t.querySelector('[data-action="new"]'))==null||e.addEventListener("click",()=>void this.newConversation()),(i=(s=this.panel)==null?void 0:s.querySelector('[data-action="close"]'))==null||i.addEventListener("click",()=>this.close()),(n=this.panel)==null||n.querySelectorAll("[data-thread]").forEach(l=>{l.addEventListener("click",()=>{const c=this.conversations.find(u=>u.id===l.dataset.thread);c&&this.selectThread(c)})}),(f=(a=this.panel)==null?void 0:a.querySelector("form"))==null||f.addEventListener("submit",l=>{var m;l.preventDefault();const c=(m=this.panel)==null?void 0:m.querySelector("textarea"),u=c==null?void 0:c.value.trim();u&&(c.value="",this.ask(u))}),(p=(b=this.panel)==null?void 0:b.querySelector("textarea"))==null||p.addEventListener("keydown",l=>{var u,m;const c=l;c.key==="Enter"&&!c.shiftKey&&(c.preventDefault(),(m=(u=this.panel)==null?void 0:u.querySelector("form"))==null||m.requestSubmit())})}}function y(r){return r.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}function T(r){return new Intl.DateTimeFormat("zh-CN",{month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit"}).format(new Date(r))}const P=new x;h.PageOpsSDK=P,Object.defineProperty(h,Symbol.toStringTag,{value:"Module"})}));
+      <aside class="po-trace"><header><h2>执行过程</h2><button data-action="close">×</button></header><section>${this.renderSourceUploader()}${this.renderSteps()}</section></aside>
+    `,this.bindPanelEvents())}renderSourceUploader(){return`
+      <div class="po-source-uploader">
+        <strong>源码包</strong>
+        <p>上传 zip、tar、tar.gz 或 tgz 后，PageOps 将基于代码证据回答问题。</p>
+        <label class="po-upload-button">
+          <span>${this.sourceUploading?"上传中...":"选择代码包"}</span>
+          <input type="file" accept=".zip,.tar,.gz,.tgz" data-action="upload-source" ${this.sourceUploading?"disabled":""} />
+        </label>
+        ${this.sourceUploadStatus?`<p class="po-upload-status">${p(this.sourceUploadStatus)}</p>`:""}
+        ${this.sourceSnapshots.length?`<div class="po-source-list">${this.sourceSnapshots.map(t=>this.renderSourceItem(t)).join("")}</div>`:'<p class="po-upload-empty">当前系统暂无代码包，请先上传后再提问。</p>'}
+        ${this.sourceUploadError?`<p class="po-upload-error">${p(this.sourceUploadError)}</p>`:""}
+      </div>
+    `}renderSourceItem(t){const e=t.filename||"未命名代码包",s=t.created_at?x(t.created_at):"刚刚上传",r=U(t.archive_bytes||t.total_bytes||0);return`<article class="po-source-item"><strong>${p(e)}</strong><span>${p(s)} · ${p(r)}</span></article>`}renderSteps(){return(this.steps.length?this.steps:[{id:"idle",title:"等待任务",status:"pending",details:{message:"发送消息后展示执行过程。"}}]).map(e=>{var s;return`<details class="po-step ${e.status}" ${e.status==="running"||e.status==="failed"?"open":""}><summary><strong>${p(e.title)}</strong><span>${e.status}</span></summary><pre>${p(JSON.stringify((s=e.details)!=null?s:{},null,2))}</pre></details>`}).join("")}bindPanelEvents(){var t,e,s,r,n,l,u,$,m,g,y;(e=(t=this.panel)==null?void 0:t.querySelector('[data-action="new"]'))==null||e.addEventListener("click",()=>void this.newConversation()),(r=(s=this.panel)==null?void 0:s.querySelector('[data-action="close"]'))==null||r.addEventListener("click",()=>this.close()),(l=(n=this.panel)==null?void 0:n.querySelector('[data-action="upload-source"]'))==null||l.addEventListener("change",d=>{var f;const i=(f=d.target.files)==null?void 0:f[0];i&&this.uploadSource(i)}),(u=this.panel)==null||u.querySelectorAll("[data-thread]").forEach(d=>{d.addEventListener("click",()=>{const i=this.conversations.find(f=>f.id===d.dataset.thread);i&&this.selectThread(i)})}),(m=($=this.panel)==null?void 0:$.querySelector("form"))==null||m.addEventListener("submit",d=>{var b;d.preventDefault();const i=(b=this.panel)==null?void 0:b.querySelector("textarea"),f=i==null?void 0:i.value.trim();f&&(i.value="",this.ask(f))}),(y=(g=this.panel)==null?void 0:g.querySelector("textarea"))==null||y.addEventListener("keydown",d=>{var f,b;const i=d;i.key==="Enter"&&!i.shiftKey&&(i.preventDefault(),(b=(f=this.panel)==null?void 0:f.querySelector("form"))==null||b.requestSubmit())})}}function p(o){return o.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}function x(o){return new Intl.DateTimeFormat("zh-CN",{month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit"}).format(new Date(o))}function U(o){if(!o)return"0 B";const t=["B","KB","MB","GB"];let e=o,s=0;for(;e>=1024&&s<t.length-1;)e/=1024,s+=1;return`${e>=10||s===0?e.toFixed(0):e.toFixed(1)} ${t[s]}`}const C=new T;h.PageOpsSDK=C,Object.defineProperty(h,Symbol.toStringTag,{value:"Module"})}));

package/dist/types.d.ts

@@ -43,6 +43,21 @@ export interface ExecutionStep {
     status: 'pending' | 'running' | 'completed' | 'failed';
     details?: Record<string, unknown>;
 }
+export interface SourceSnapshot {
+    id?: string;
+    source_snapshot_id?: string | null;
+    project_id?: string;
+    filename?: string | null;
+    archive_bytes?: number;
+    status: string;
+    message?: string | null;
+    file_count: number;
+    total_bytes?: number;
+    created_at?: string | null;
+}
+export interface SourceSnapshotListResponse {
+    sources: SourceSnapshot[];
+}
 export interface StreamDonePayload {
     message_id: string;
     answer: Record<string, unknown>;

package/package.json

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