@blade-hq/agent-client 2608.0.8 → 2608.0.9

package/dist/index.js

@@ -2,6 +2,9 @@
 function isAuthCallbackMessage(value) {
   return typeof value === "object" && value !== null && value.type === "blade-agent:sdk-auth";
 }
+var AUTH_ERROR_HINTS = {
+  pat_unavailable: "\u6CA1\u80FD\u4E3A\u4F60\u51C6\u5907\u8BBF\u95EE\u51ED\u636E\u3002\u8BF7\u9000\u51FA\u540E\u91CD\u65B0\u767B\u5F55 Blade \u518D\u8BD5\u4E00\u6B21\uFF1B\u82E5\u4ECD\u7136\u5931\u8D25\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002"
+};
 function randomState() {
   const bytes = new Uint8Array(24);
   crypto.getRandomValues(bytes);
@@ -79,18 +82,22 @@ async function loginWithPopup(client, options = {}) {
       if (event.data.state !== state) return;
       const message = event.data;
       stopCloseWatch();
-      try {
-        popup.close();
-      } catch {
-      }
+      const closePopup = () => {
+        try {
+          popup.close();
+        } catch {
+        }
+      };
       if (message.status === "denied") {
+        closePopup();
         settle(() => reject(new Error("\u4F60\u53D6\u6D88\u4E86\u6388\u6743\uFF0C\u672A\u5B8C\u6210\u767B\u5F55\u3002")));
         return;
       }
       if (message.status !== "success" || !message.code) {
-        settle(() => reject(new Error(message.error || "\u767B\u5F55\u5931\u8D25\uFF0C\u672A\u53D6\u5F97\u6388\u6743\u7801\u3002")));
+        settle(() => reject(new Error(AUTH_ERROR_HINTS[message.error ?? ""] ?? message.error ?? "\u767B\u5F55\u5931\u8D25\uFF0C\u672A\u53D6\u5F97\u6388\u6743\u7801\u3002")));
         return;
       }
+      closePopup();
       client.json("POST", "/api/auth/sdk/token", {
         code: message.code,
         state,
@@ -174,6 +181,24 @@ var AuthResource = class {
   login(options) {
     return this.client.login(options);
   }
+  /**
+   * 用一次性 code 换 PAT。给**服务端**用：浏览器把 code 交给你自己的后端，
+   * 后端换到的 PAT 不进浏览器。浏览器里直接用 `login()` 就够了。
+   *
+   * 服务端调用时会自己补上 `Origin` 头（浏览器会自动带，服务端不会，缺了
+   * 后端报 `missing_request_origin`）。
+   */
+  exchangeCode(params) {
+    return this.client.jsonFromInit("/api/auth/sdk/token", {
+      method: "POST",
+      headers: { Origin: params.clientOrigin },
+      body: JSON.stringify({
+        code: params.code,
+        state: params.state,
+        client_origin: params.clientOrigin
+      })
+    });
+  }
   /** 清除 login() 存储的令牌。 */
   logoutToken() {
     this.client.logoutToken();
@@ -407,6 +432,47 @@ var ModelsResource = class {
   }
 };
 
+// src/schemas/session.ts
+import { type } from "arktype";
+var SessionStatus = type(
+  "'created' | 'running' | 'completed' | 'failed' | 'interrupted' | 'waiting_for_input'"
+);
+var DEFAULT_REPLAY_SPEED = 5;
+var SessionInfo = type({
+  id: "string",
+  intent: "string",
+  status: SessionStatus,
+  created_at: "string",
+  updated_at: "string",
+  "shared?": "boolean",
+  "memory_enabled?": "boolean",
+  "is_persistent?": "boolean",
+  "is_headless?": "boolean",
+  "viewer_role?": "'owner' | 'viewer'",
+  "template_id?": "string | null",
+  "model?": "string | null",
+  "enable_thinking?": "boolean | null",
+  "solution_id?": "string | null",
+  "solution_ref?": "unknown",
+  "biz_role_id?": "string | null",
+  "solution?": "unknown",
+  "plan_summary?": "string | null",
+  "primary_skill_id?": "string | null",
+  // ship-attack v2：后端 engine.set_bound_skill 写入的"绑定 skill id"。
+  // 未绑定 / 非 ship-attack session 为 null。
+  "bound_skill_id?": "string | null",
+  "replay_state?": "unknown",
+  "is_pinned?": "boolean",
+  "pinned_at?": "string | null",
+  "is_example?": "boolean",
+  "ports?": "unknown",
+  "disable_tools?": "string[]",
+  "runtime_type?": "string | null",
+  "daemon_id?": "string | null",
+  "workspace_path?": "string | null",
+  "match?": "unknown"
+});
+
 // src/session/definition.ts
 var SessionSetupError = class extends Error {
   constructor(message, stage, sessionId, options) {
@@ -827,6 +893,28 @@ function sourceLoopFor(loopId, loopDescriptions) {
   if (!description) return null;
   return { loop_name: loopId, description };
 }
+var MAX_FINAL_ARTIFACTS = 3;
+function normalizeFinalArtifacts(raw) {
+  if (!Array.isArray(raw)) return [];
+  const artifacts = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of raw) {
+    if (typeof item !== "object" || item === null) continue;
+    const record = item;
+    const target = String(record.target ?? "").trim();
+    if (!target || seen.has(target)) continue;
+    const isLink = /^https?:\/\//i.test(target);
+    if (!isLink && target.split("/").includes("..")) continue;
+    seen.add(target);
+    artifacts.push({
+      kind: isLink ? "link" : "file",
+      target,
+      label: String(record.label ?? "").trim()
+    });
+    if (artifacts.length === MAX_FINAL_ARTIFACTS) break;
+  }
+  return artifacts;
+}
 function normalizePostChatFollowup(data, assistantEntryId) {
   const raw = data.suggestions;
   const suggestions = [];
@@ -838,11 +926,13 @@ function normalizePostChatFollowup(data, assistantEntryId) {
     }
   }
   const recaption = String(data.recaption ?? "");
-  if (suggestions.length === 0 && !recaption) return null;
+  const finalArtifacts = normalizeFinalArtifacts(data.final_artifacts);
+  if (suggestions.length === 0 && !recaption && finalArtifacts.length === 0) return null;
   return {
     assistant_entry_id: assistantEntryId,
     recaption,
-    suggestions: suggestions.slice(0, 3)
+    suggestions: suggestions.slice(0, 3),
+    final_artifacts: finalArtifacts
   };
 }
 function normalizeChildPause(pausePayload) {
@@ -2130,12 +2220,16 @@ var SessionsResource = class {
   pinSession(sessionId, pinned) {
     return this.client.json("PATCH", `/api/sessions/${sessionId}/pin`, { pinned });
   }
-  startReplaySession(sourceSessionId, speed = 5) {
+  startReplaySession(sourceSessionId, speed = DEFAULT_REPLAY_SPEED) {
     return this.client.json("POST", `/api/sessions/${sourceSessionId}/replay`, { speed });
   }
   updateReplaySession(sessionId, payload) {
     return this.client.json("PATCH", `/api/sessions/${sessionId}/replay`, payload);
   }
+  /** 查询会话能否作为回放来源；不支持时 reason 可直接展示，用来提前禁用入口。 */
+  getReplayPreview(sessionId) {
+    return this.client.json("GET", `/api/sessions/${sessionId}/replay/preview`);
+  }
   updateSharing(sessionId, shared) {
     return this.client.json("PATCH", `/api/sessions/${sessionId}/sharing`, { shared });
   }
@@ -2589,10 +2683,15 @@ function contentPreview(content, maxLen = 80) {
   const text = getTextContent(content).trim();
   return text.length > maxLen ? `${text.slice(0, maxLen)}\u2026` : text;
 }
-function transformSlashCommand(skillName, rawInput) {
+function transformSlashCommand(skillName, rawInput, { local = true, installed = true } = {}) {
   const prompt = rawInput.replace(`<skill>${skillName}</skill>`, "").trim();
-  return prompt ? `\u8BF7\u4F7F\u7528 ${skillName} skill \u5B8C\u6210\u4EFB\u52A1
+  if (local) {
+    return prompt ? `\u8BF7\u4F7F\u7528 ${skillName} skill \u5B8C\u6210\u4EFB\u52A1
 ${prompt}` : `\u8BF7\u4F7F\u7528 ${skillName} skill \u5B8C\u6210\u4EFB\u52A1`;
+  }
+  const steps = installed ? `\u8BF7\u5148\u8FD0\u884C blade hub skill use ${skillName} \u52A0\u8F7D\u6280\u80FD` : `\u8BE5\u6280\u80FD\u5C1A\u672A\u5B89\u88C5\u3002\u8BF7\u5148\u8FD0\u884C blade hub skill install ${skillName} \u5B89\u88C5\uFF0C\u518D\u8FD0\u884C blade hub skill use ${skillName} \u52A0\u8F7D`;
+  return prompt ? `${steps}\uFF0C\u7136\u540E\u5B8C\u6210\u4EFB\u52A1\uFF1A
+${prompt}` : `${steps}\uFF0C\u7136\u540E\u4F7F\u7528\u5B83\u5B8C\u6210\u4EFB\u52A1`;
 }
 var ATTACHMENT_TAG_RE = /\[附件:\s*([^\]]+)\](?:[ \t]*已上传到工作区路径:[ \t]*([^\r\n]+))?/g;
 var CONTEXT_PART_RE = /^\[上下文:\s*([^\]]+)\]\n([\s\S]*)$/;
@@ -2678,6 +2777,14 @@ function groupMessagesByLoop(messages) {
 }
 
 // src/session/state.ts
+function toReplaySnapshot(raw) {
+  if (!raw || !raw.status) return null;
+  return {
+    isReplay: raw.status === "replay",
+    speed: raw.speed ?? 1,
+    sourceSessionId: raw.source_session_id ?? null
+  };
+}
 function createInitialSessionState(sessionId) {
   return {
     sessionId,
@@ -2690,7 +2797,9 @@ function createInitialSessionState(sessionId) {
     errorMessage: null,
     askAnswers: {},
     agentLoops: {},
-    activeCompaction: null
+    activeCompaction: null,
+    replay: null,
+    viewerRole: null
   };
 }
 function parseAgentDescription(argumentsJson) {
@@ -3141,6 +3250,11 @@ var AgentSession = class _AgentSession {
   patchFlushCancel = null;
   joined = false;
   joinPending = null;
+  // 回放控制请求排成一条队列。连着点"5x"再点"退出回放"时，并发发出去的两个
+  // 请求响应可能乱序回来，晚到的旧值会把已经退出的会话又显示成回放中；用
+  // 序号丢弃过期响应又会在失败时留下中间态。串行执行就没有这些情况：每个
+  // 响应都是当时最新的，失败也只影响自己。
+  replayQueue = Promise.resolve();
   pendingReplayMessage = null;
   pendingReplayMode;
   recentChatEndAt = 0;
@@ -3171,6 +3285,10 @@ var AgentSession = class _AgentSession {
         emitWithAck: async () => readonlyError(),
         ensureConnected: readonlyError,
         fetchTurns: async () => turns,
+        // 静态历史没有回放身份可言，给个空详情即可，不要抛错——_bootstrap
+        // 不会跑到这里，但保持只读语义一致。
+        fetchSessionInfo: async () => ({ replay_state: null }),
+        updateReplay: async () => readonlyError(),
         listDir: async () => readonlyError(),
         countFiles: async () => readonlyError(),
         downloadFile: async () => readonlyError(),
@@ -3462,10 +3580,13 @@ var AgentSession = class _AgentSession {
     this.joinPending = null;
     try {
       await this.ensureJoined();
-      await this.syncTurnsFromHistory({
-        clearOnEmpty: true,
-        preserveChangesSince: turnsBeforeRejoin
-      });
+      await Promise.all([
+        this.syncTurnsFromHistory({
+          clearOnEmpty: true,
+          preserveChangesSince: turnsBeforeRejoin
+        }),
+        this.syncReplayFromSession()
+      ]);
     } catch {
     }
   }
@@ -3473,6 +3594,40 @@ var AgentSession = class _AgentSession {
   async _bootstrap() {
     await this.syncTurnsFromHistory({ suppressErrors: false });
     await this.ensureJoined();
+    await this.syncReplayFromSession();
+  }
+  /** 改回放是 owner 专属（服务端 PATCH 走 _get_owned_session）。 */
+  get canControlReplay() {
+    return this.state.viewerRole !== "viewer";
+  }
+  /** 拉一次会话详情，填回放状态和只读身份；失败按非回放会话处理，不挡启动。 */
+  async syncReplayFromSession() {
+    try {
+      const info = await this.runtime.fetchSessionInfo(this.sessionId);
+      const replay = toReplaySnapshot(info.replay_state);
+      const viewerRole = info.viewer_role ?? null;
+      this.update((s) => ({ ...s, replay, viewerRole }));
+    } catch {
+    }
+  }
+  /** 调整回放倍速；不是回放会话、或只读身份时什么都不做。 */
+  async setReplaySpeed(speed) {
+    if (!this.state.replay?.isReplay || !this.canControlReplay) return;
+    await this.applyReplayControl({ speed });
+  }
+  /** 退出回放，之后的对话交给真实模型运行；不是回放会话、或只读身份时什么都不做。 */
+  async exitReplay() {
+    if (!this.state.replay?.isReplay || !this.canControlReplay) return;
+    await this.applyReplayControl({ status: "autonomous" });
+  }
+  /** 把一次回放控制请求排进队列；前一个完成后才发出，响应直接安装。 */
+  applyReplayControl(payload) {
+    const run = this.replayQueue.then(async () => {
+      const result = await this.runtime.updateReplay(this.sessionId, payload);
+      this.update((s) => ({ ...s, replay: toReplaySnapshot(result) }));
+    });
+    this.replayQueue = run.catch(() => void 0);
+    return run;
   }
   /** @internal */
   _handleTurnStart(turn) {
@@ -3552,6 +3707,10 @@ var AgentSession = class _AgentSession {
     if (data.status) {
       this.update((s) => ({ ...s, status: data.status ?? s.status }));
     }
+    if (data.replay_state !== void 0) {
+      const replay = toReplaySnapshot(data.replay_state);
+      this.update((s) => ({ ...s, replay }));
+    }
     this.emitter.emit("sessionUpdated", {
       intent: data.intent,
       status: data.status,
@@ -4001,6 +4160,8 @@ var SessionHub = class {
       }),
       ensureConnected: () => this.ensureConnected(),
       fetchTurns: (sessionId) => this.client.sessions.getSessionTurns(sessionId),
+      fetchSessionInfo: (sessionId) => this.client.sessions.getSession(sessionId),
+      updateReplay: (sessionId, payload) => this.client.sessions.updateReplaySession(sessionId, payload).then((result) => result.replay_state ?? null),
       listDir: (sessionId, dirPath) => this.client.sessions.listDir(sessionId, dirPath),
       countFiles: (sessionId, dirPath) => this.client.sessions.countFiles(sessionId, dirPath),
       downloadFile: (sessionId, filePath, downloadName) => this.client.sessions.downloadFile(sessionId, filePath, downloadName),
@@ -4222,7 +4383,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2608.0.8" : "1.1.1";
+var SDK_VERSION = true ? "2608.0.9" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -4416,7 +4577,7 @@ var BladeClient = class {
     const response = await (this.options.fetchImpl ?? fetch)(url.toString(), {
       method,
       body: init.body,
-      credentials: init.credentials ?? "include",
+      credentials: init.credentials ?? "same-origin",
       headers: this.buildHeaders(url, init.headers),
       signal: init.signal
     });
@@ -4615,87 +4776,6 @@ function parseXhrHeaders(rawHeaders) {
   return headers;
 }
 
-// src/platform-endpoints.ts
-var PLATFORM_SERVICE_NAMES = [
-  "os",
-  "hub",
-  "agent",
-  "oauth",
-  "llmGateway",
-  "gitea"
-];
-var EMPTY_PLATFORM_ENDPOINTS = Object.freeze({
-  services: Object.freeze({})
-});
-function defaultDocumentBaseUrl() {
-  if (typeof document === "undefined") return void 0;
-  if (document.querySelector("base[href]")) return document.baseURI;
-  if (typeof location !== "undefined" && location.origin) return `${location.origin}/`;
-  return document.baseURI;
-}
-function isRecord6(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function normalizeServiceUrl(value) {
-  if (typeof value !== "string" || !value.trim()) return null;
-  if (value.includes("?") || value.includes("#")) return null;
-  try {
-    const url = new URL(value.trim());
-    if (url.protocol !== "http:" && url.protocol !== "https:") return null;
-    if (url.username || url.password || url.search || url.hash) return null;
-    return url.toString().replace(/\/$/, "");
-  } catch {
-    return null;
-  }
-}
-function parsePlatformEndpoints(value) {
-  if (!isRecord6(value) || !isRecord6(value.services)) return null;
-  const services = {};
-  for (const name of PLATFORM_SERVICE_NAMES) {
-    if (!(name in value.services)) continue;
-    const url = normalizeServiceUrl(value.services[name]);
-    if (!url) return null;
-    services[name] = url;
-  }
-  return { services };
-}
-async function loadPlatformEndpoints(options = {}) {
-  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
-  const baseUrl = options.baseUrl ?? defaultDocumentBaseUrl();
-  if (!fetchImpl || !baseUrl) return EMPTY_PLATFORM_ENDPOINTS;
-  const controller = new AbortController();
-  const timeout = globalThis.setTimeout(() => controller.abort(), options.timeoutMs ?? 3e3);
-  try {
-    const response = await fetchImpl(new URL("config.json", baseUrl), {
-      cache: "no-store",
-      credentials: "same-origin",
-      headers: { Accept: "application/json" },
-      signal: controller.signal
-    });
-    if (!response.ok) return EMPTY_PLATFORM_ENDPOINTS;
-    return parsePlatformEndpoints(await response.json()) ?? EMPTY_PLATFORM_ENDPOINTS;
-  } catch {
-    return EMPTY_PLATFORM_ENDPOINTS;
-  } finally {
-    globalThis.clearTimeout(timeout);
-  }
-}
-function resolveServiceUrl(endpoints, name, path = "") {
-  const baseUrl = endpoints.services[name];
-  if (!baseUrl) return null;
-  if (!path) return baseUrl;
-  const pathReference = path.trimStart();
-  if (path.includes("\\") || pathReference.startsWith("//") || /^[a-z][a-z0-9+.-]*:/i.test(pathReference)) {
-    return null;
-  }
-  const base = new URL(`${baseUrl}/`);
-  const target = new URL(path.replace(/^\/+/, ""), base);
-  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) {
-    return null;
-  }
-  return target.toString();
-}
-
 // src/commands/protocol.ts
 function isCommandEnvelope(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -4755,46 +4835,6 @@ function connectEmbedded(options) {
   };
 }
 
-// src/schemas/session.ts
-import { type } from "arktype";
-var SessionStatus = type(
-  "'created' | 'running' | 'completed' | 'failed' | 'interrupted' | 'waiting_for_input'"
-);
-var SessionInfo = type({
-  id: "string",
-  intent: "string",
-  status: SessionStatus,
-  created_at: "string",
-  updated_at: "string",
-  "shared?": "boolean",
-  "memory_enabled?": "boolean",
-  "is_persistent?": "boolean",
-  "is_headless?": "boolean",
-  "viewer_role?": "'owner' | 'viewer'",
-  "template_id?": "string | null",
-  "model?": "string | null",
-  "enable_thinking?": "boolean | null",
-  "solution_id?": "string | null",
-  "solution_ref?": "unknown",
-  "biz_role_id?": "string | null",
-  "solution?": "unknown",
-  "plan_summary?": "string | null",
-  "primary_skill_id?": "string | null",
-  // ship-attack v2：后端 engine.set_bound_skill 写入的"绑定 skill id"。
-  // 未绑定 / 非 ship-attack session 为 null。
-  "bound_skill_id?": "string | null",
-  "replay_state?": "unknown",
-  "is_pinned?": "boolean",
-  "pinned_at?": "string | null",
-  "is_example?": "boolean",
-  "ports?": "unknown",
-  "disable_tools?": "string[]",
-  "runtime_type?": "string | null",
-  "daemon_id?": "string | null",
-  "workspace_path?": "string | null",
-  "match?": "unknown"
-});
-
 // src/schemas/solution.ts
 var LayoutType = /* @__PURE__ */ ((LayoutType2) => {
   LayoutType2["Default"] = "default";
@@ -4826,7 +4866,7 @@ export {
   BladeApiError,
   BladeClient,
   ClientProjectionBuilder,
-  EMPTY_PLATFORM_ENDPOINTS,
+  DEFAULT_REPLAY_SPEED,
   LayoutType,
   ModelsResource,
   SDK_NAME,
@@ -4850,9 +4890,8 @@ export {
   isCommandEnvelope,
   isHiddenInternalMessage,
   isInboundEnvelope,
-  loadPlatformEndpoints,
   normalizeMessageContent,
-  resolveServiceUrl,
+  toReplaySnapshot,
   transformSlashCommand
 };
 //# sourceMappingURL=index.js.map