@blade-hq/agent-client 2612.0.0-beta.20 → 2612.0.0-beta.21

package/dist/index.js

@@ -21,7 +21,7 @@ import {
   normalizeTopicAssetRefs,
   transformSlashCommand,
   userFacingErrorText
-} from "./chunk-2VIJBVAC.js";
+} from "./chunk-J3XXTHHK.js";
 export {
   AgentSession,
   AgentSessionError,

package/dist/internal.d.ts

@@ -58,3 +58,4 @@ export type { TopicAssetRef } from "./schemas/topic-assets";
 export { normalizePluginRefs } from "./schemas/plugin-refs";
 export type { PluginRef } from "./schemas/plugin-refs";
 export type { ToolEvidence } from "./schemas/projection";
+export { getServerTime, syncServerTime } from "./server-clock";

package/dist/internal.js

@@ -45,6 +45,7 @@ import {
   getContextGroupDisplayState,
   getFileParts,
   getImageParts,
+  getServerTime,
   getTextContent,
   groupAdjacentContextRuns,
   groupMessagesByLoop,
@@ -77,6 +78,7 @@ import {
   sessionStatusFromChatEnd,
   shouldApplySnapshot,
   sortComputers,
+  syncServerTime,
   toReplaySnapshot,
   transformSlashCommand,
   upsertTurn,
@@ -84,7 +86,7 @@ import {
   withTurns,
   workflowEntriesFromOutput,
   workflowNameFromArguments
-} from "./chunk-2VIJBVAC.js";
+} from "./chunk-J3XXTHHK.js";
 
 // src/polling-backoff.ts
 var MAX_BACKOFF_MS = 6e4;
@@ -301,6 +303,7 @@ export {
   getContextGroupDisplayState,
   getFileParts,
   getImageParts,
+  getServerTime,
   getTextContent,
   groupAdjacentContextRuns,
   groupMessagesByLoop,
@@ -337,6 +340,7 @@ export {
   sessionStatusFromChatEnd,
   shouldApplySnapshot,
   sortComputers,
+  syncServerTime,
   toReplaySnapshot,
   transformSlashCommand,
   upsertTurn,

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/polling-backoff.ts","../src/platform-endpoints.ts","../src/commands/protocol.ts","../src/schemas/projection-utils.ts","../src/schemas/solution.ts","../src/schemas/task.ts"],"sourcesContent":["import { BladeApiError } from \"./rest\"\n\nconst MAX_BACKOFF_MS = 60_000\nconst MAX_TIMER_MS = 2_147_483_647\n\n/** Scheduling policy for read-only polling; never sends or replays a request. */\nexport class PollingBackoff {\n  private failures = 0\n  private nextAt: number | false = 0\n\n  constructor(private readonly intervalMs: number) {\n    if (!Number.isFinite(intervalMs) || intervalMs <= 0 || intervalMs > MAX_BACKOFF_MS) {\n      throw new RangeError(\"Polling interval must be between 0 and 60000 ms\")\n    }\n  }\n\n  reset(): void {\n    this.failures = 0\n    this.nextAt = 0\n  }\n\n  failed(error: unknown): void {\n    if (\n      (error instanceof Error && error.name === \"AbortError\") ||\n      (error instanceof BladeApiError && error.status < 500 &&\n        error.status !== 408 && error.status !== 429)\n    ) {\n      this.nextAt = false\n      return\n    }\n    this.failures = Math.min(this.failures + 1, 10)\n    const ceiling = Math.min(MAX_BACKOFF_MS, this.intervalMs * 2 ** this.failures)\n    const backoff = Math.max(this.intervalMs, ceiling * (0.5 + Math.random() * 0.5))\n    const header = error instanceof BladeApiError\n      ? error.response.headers.get(\"Retry-After\")?.trim()\n      : undefined\n    const retryAfter = header\n      ? /^\\d+$/.test(header) ? Number(header) * 1000 : Date.parse(header) - Date.now()\n      : 0\n    const delay = Math.max(backoff, Number.isNaN(retryAfter) ? 0 : retryAfter)\n    // Oversized server delays must not overflow browser timers into a hot loop.\n    this.nextAt = delay > MAX_TIMER_MS ? false : Date.now() + delay\n  }\n\n  /** Zero means ready, false means stop, otherwise wait at least this many ms. */\n  waitMs(): number | false {\n    return this.nextAt === false ? false : Math.max(0, this.nextAt - Date.now())\n  }\n}\n","import { isRecord } from \"./shared/type-guards\"\n\nexport const PLATFORM_SERVICE_NAMES = [\n  \"os\",\n  \"hub\",\n  \"agent\",\n  \"oauth\",\n  \"llmGateway\",\n  \"gitea\",\n  \"tile\",\n] as const\n\nexport type PlatformServiceName = (typeof PLATFORM_SERVICE_NAMES)[number]\n\nexport interface PlatformEndpoints {\n  services: Partial<Record<PlatformServiceName, string>>\n}\n\nexport const EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints = Object.freeze({\n  services: Object.freeze({}),\n})\n\nexport interface LoadPlatformEndpointsOptions {\n  baseUrl?: string\n  fetchImpl?: typeof fetch\n  timeoutMs?: number\n}\n\nfunction defaultDocumentBaseUrl(): string | undefined {\n  if (typeof document === \"undefined\") return undefined\n  if (document.querySelector(\"base[href]\")) return document.baseURI\n  if (typeof location !== \"undefined\" && location.origin) return `${location.origin}/`\n  return document.baseURI\n}\n\nfunction normalizeServiceUrl(value: unknown): string | null {\n  if (typeof value !== \"string\" || !value.trim()) return null\n  if (value.includes(\"?\") || value.includes(\"#\")) return null\n  try {\n    const url = new URL(value.trim())\n    if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return null\n    if (url.username || url.password || url.search || url.hash) return null\n    return url.toString().replace(/\\/$/, \"\")\n  } catch {\n    return null\n  }\n}\n\nexport function parsePlatformEndpoints(value: unknown): PlatformEndpoints | null {\n  if (!isRecord(value) || !isRecord(value.services)) return null\n\n  const services: Partial<Record<PlatformServiceName, string>> = {}\n  for (const name of PLATFORM_SERVICE_NAMES) {\n    if (!(name in value.services)) continue\n    const url = normalizeServiceUrl(value.services[name])\n    if (!url) return null\n    if (name === \"agent\" && new URL(url).pathname !== \"/\") return null\n    services[name] = url\n  }\n\n  return { services }\n}\n\nexport async function loadPlatformEndpoints(\n  options: LoadPlatformEndpointsOptions = {},\n): Promise<PlatformEndpoints> {\n  const fetchImpl = options.fetchImpl ?? globalThis.fetch\n  const baseUrl = options.baseUrl ?? defaultDocumentBaseUrl()\n  if (!fetchImpl || !baseUrl) return EMPTY_PLATFORM_ENDPOINTS\n\n  const controller = new AbortController()\n  const timeout = globalThis.setTimeout(() => controller.abort(), options.timeoutMs ?? 3_000)\n  try {\n    const response = await fetchImpl(new URL(\"config.json\", baseUrl), {\n      cache: \"no-store\",\n      credentials: \"same-origin\",\n      headers: { Accept: \"application/json\" },\n      signal: controller.signal,\n    })\n    if (!response.ok) return EMPTY_PLATFORM_ENDPOINTS\n    return parsePlatformEndpoints(await response.json()) ?? EMPTY_PLATFORM_ENDPOINTS\n  } catch {\n    return EMPTY_PLATFORM_ENDPOINTS\n  } finally {\n    globalThis.clearTimeout(timeout)\n  }\n}\n\nexport function resolveServiceUrl(\n  endpoints: PlatformEndpoints,\n  name: PlatformServiceName,\n  path = \"\",\n): string | null {\n  const baseUrl = endpoints.services[name]\n  if (!baseUrl) return null\n  if (!path) return baseUrl\n  const pathReference = path.trimStart()\n  if (\n    path.includes(\"\\\\\") ||\n    pathReference.startsWith(\"//\") ||\n    /^[a-z][a-z0-9+.-]*:/i.test(pathReference)\n  ) {\n    return null\n  }\n  const base = new URL(`${baseUrl}/`)\n  const target = new URL(path.replace(/^\\/+/, \"\"), base)\n  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) {\n    return null\n  }\n  return target.toString()\n}\n","/**\n * 页面协作协议（对应后端 `_meta.bridge` 通道，见 docs/specs/260417-embed-bridge）。\n *\n * ## action 从哪里来\n *\n * 智能体 → 宿主方向的每一条指令，都源自**技能作者写的工具代码**：工具返回值\n * JSON 里带 `_meta.bridge: { action, payload }`，后端在持久化前把它剥离成独立\n * 事件送达前端（LLM 的对话历史里读不到它）。因此：\n *\n * - action 字符串（如 \"map.highlight\"）是**技能作者与宿主页面开发者之间的业务\n *   契约**，LLM 不参与协议、SDK 不做枚举校验；\n * - 宿主页面用 `session.onCommand(\"map.highlight\", fn)` 消费；\n * - 未注册 handler 的 action 会进入有限缓冲等待注册，超限后丢弃并 console 告警。\n *\n * 宿主 → 智能体方向只有三个白名单动作：attach（附件入输入框）/ insertText\n * （追加输入文本）/ send（直接发消息），对应协议层的 addContext / appendInput /\n * sendMessage。\n */\n\nexport interface CommandEnvelope {\n  __bladeBridge: true\n  direction: \"agent-to-host\"\n  action: string\n  payload: unknown\n  meta: {\n    sessionId: string\n    toolCallId?: string\n    timestamp: number\n  }\n}\n\nexport type InboundAction = \"addContext\" | \"appendInput\" | \"sendMessage\"\n\nexport interface InboundEnvelope {\n  __bladeBridge: true\n  direction: \"host-to-agent\"\n  action: InboundAction\n  payload: unknown\n}\n\nexport function isCommandEnvelope(value: unknown): value is CommandEnvelope {\n  if (typeof value !== \"object\" || value === null) return false\n  const record = value as Record<string, unknown>\n  return (\n    record.__bladeBridge === true &&\n    record.direction === \"agent-to-host\" &&\n    typeof record.action === \"string\"\n  )\n}\n\nexport function isInboundEnvelope(value: unknown): value is InboundEnvelope {\n  if (typeof value !== \"object\" || value === null) return false\n  const record = value as Record<string, unknown>\n  return (\n    record.__bladeBridge === true &&\n    record.direction === \"host-to-agent\" &&\n    (record.action === \"addContext\" || record.action === \"appendInput\" || record.action === \"sendMessage\")\n  )\n}\n","import type { PostChatFollowup, TurnProjection } from \"./projection\"\n\n/** 返回最新根会话轮次的小结；新用户消息到达后旧小结立即失效。 */\nexport function latestPostChatFollowup(turns: TurnProjection[]): PostChatFollowup | null {\n  for (let index = turns.length - 1; index >= 0; index -= 1) {\n    const turn = turns[index]\n    if (\n      turn.loop_id === \"root\" &&\n      (turn.role === \"user\" || turn.role === \"assistant\") &&\n      (turn.kind ?? \"message\") === \"message\" &&\n      !turn.blocks.some((block) =>\n        [\"mode_change\", \"plan_status\", \"ask_user_answer\"].includes(block.type),\n      )\n    ) {\n      return turn.role === \"assistant\" ? (turn.post_chat_followup ?? null) : null\n    }\n  }\n  return null\n}\n","export enum LayoutType {\n  Default = \"default\",\n  SkillEditor = \"skill-editor\",\n  SolutionEditor = \"solution-editor\",\n  SolutionApp = \"solution-app\",\n  Custom = \"custom\",\n}\n\nexport interface Solution {\n  id: string\n  name: string\n  version: string\n  description?: string | null\n  source?: \"builtin\" | \"personal\" | string | null\n  layout_type: LayoutType | string\n  initial_mode?: \"planning\" | \"executing\" | string | null\n  initial_message?: string | null\n  preview?: { url: string; title?: string | null } | null\n  layout?: {\n    available?: boolean\n    source_dir?: string\n    entry?: string\n    export?: string\n  } | null\n  roles?: BizRole[] | null\n  data?: Record<string, unknown> | null\n  ui_config?: SolutionAppUiConfig | null\n}\n\nexport interface SolutionAppUiConfig {\n  branding: {\n    name: string\n    subtitle?: string\n    icon_text: string\n    icon_gradient?: string\n  }\n  list: {\n    title: string\n    create_button: string\n    card?: {\n      subtitle?: string\n      stats?: Array<{\n        label: string\n        value: string\n        color?: string\n      }>\n    }\n  }\n  create: {\n    title: string\n    description?: string\n    submit_button: string\n    sections: Array<{\n      id: string\n      title: string\n      description?: string\n      fields: Array<SolutionAppField>\n    }>\n  }\n}\n\nexport type SolutionAppField =\n  | {\n      id: string\n      kind: \"textarea\"\n      label: string\n      placeholder?: string\n    }\n  | {\n      id: string\n      kind: \"file-upload\"\n      accept?: string[]\n      categories?: Array<{\n        label: string\n        description: string\n        color: string\n      }>\n    }\n\nexport interface SolutionAppState {\n  pipeline: Array<{\n    id: string\n    label: string\n    status: \"done\" | \"active\" | \"pending\" | \"error\"\n  }>\n  meta: Record<\n    string,\n    {\n      label: string\n      value: string\n      color?: string\n    }\n  >\n}\n\nexport interface BizRole {\n  id: string\n  name: string\n  description?: string | null\n  preview?: { url: string; title?: string | null } | null\n}\n","import { type } from \"arktype\"\n\nexport const TaskStatus = type(\"'pending' | 'in_progress' | 'done' | 'failed' | 'skipped'\")\nexport type TaskStatus = typeof TaskStatus.infer\n\nexport const Task = type({\n  id: \"string\",\n  goal: \"string\",\n  skills: \"string[]\",\n  depends_on: \"string[]\",\n  status: TaskStatus,\n  result_summary: \"string\",\n  number: \"string\",\n})\nexport type Task = typeof Task.infer\n"],"mappings":"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","names":["LayoutType"]}
+{"version":3,"sources":["../src/polling-backoff.ts","../src/platform-endpoints.ts","../src/commands/protocol.ts","../src/schemas/projection-utils.ts","../src/schemas/solution.ts","../src/schemas/task.ts"],"sourcesContent":["import { BladeApiError } from \"./rest\"\n\nconst MAX_BACKOFF_MS = 60_000\nconst MAX_TIMER_MS = 2_147_483_647\n\n/** Scheduling policy for read-only polling; never sends or replays a request. */\nexport class PollingBackoff {\n  private failures = 0\n  private nextAt: number | false = 0\n\n  constructor(private readonly intervalMs: number) {\n    if (!Number.isFinite(intervalMs) || intervalMs <= 0 || intervalMs > MAX_BACKOFF_MS) {\n      throw new RangeError(\"Polling interval must be between 0 and 60000 ms\")\n    }\n  }\n\n  reset(): void {\n    this.failures = 0\n    this.nextAt = 0\n  }\n\n  failed(error: unknown): void {\n    if (\n      (error instanceof Error && error.name === \"AbortError\") ||\n      (error instanceof BladeApiError && error.status < 500 &&\n        error.status !== 408 && error.status !== 429)\n    ) {\n      this.nextAt = false\n      return\n    }\n    this.failures = Math.min(this.failures + 1, 10)\n    const ceiling = Math.min(MAX_BACKOFF_MS, this.intervalMs * 2 ** this.failures)\n    const backoff = Math.max(this.intervalMs, ceiling * (0.5 + Math.random() * 0.5))\n    const header = error instanceof BladeApiError\n      ? error.response.headers.get(\"Retry-After\")?.trim()\n      : undefined\n    const retryAfter = header\n      ? /^\\d+$/.test(header) ? Number(header) * 1000 : Date.parse(header) - Date.now()\n      : 0\n    const delay = Math.max(backoff, Number.isNaN(retryAfter) ? 0 : retryAfter)\n    // Oversized server delays must not overflow browser timers into a hot loop.\n    this.nextAt = delay > MAX_TIMER_MS ? false : Date.now() + delay\n  }\n\n  /** Zero means ready, false means stop, otherwise wait at least this many ms. */\n  waitMs(): number | false {\n    return this.nextAt === false ? false : Math.max(0, this.nextAt - Date.now())\n  }\n}\n","import { isRecord } from \"./shared/type-guards\"\n\nexport const PLATFORM_SERVICE_NAMES = [\n  \"os\",\n  \"hub\",\n  \"agent\",\n  \"oauth\",\n  \"llmGateway\",\n  \"gitea\",\n  \"tile\",\n] as const\n\nexport type PlatformServiceName = (typeof PLATFORM_SERVICE_NAMES)[number]\n\nexport interface PlatformEndpoints {\n  services: Partial<Record<PlatformServiceName, string>>\n}\n\nexport const EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints = Object.freeze({\n  services: Object.freeze({}),\n})\n\nexport interface LoadPlatformEndpointsOptions {\n  baseUrl?: string\n  fetchImpl?: typeof fetch\n  timeoutMs?: number\n}\n\nfunction defaultDocumentBaseUrl(): string | undefined {\n  if (typeof document === \"undefined\") return undefined\n  if (document.querySelector(\"base[href]\")) return document.baseURI\n  if (typeof location !== \"undefined\" && location.origin) return `${location.origin}/`\n  return document.baseURI\n}\n\nfunction normalizeServiceUrl(value: unknown): string | null {\n  if (typeof value !== \"string\" || !value.trim()) return null\n  if (value.includes(\"?\") || value.includes(\"#\")) return null\n  try {\n    const url = new URL(value.trim())\n    if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return null\n    if (url.username || url.password || url.search || url.hash) return null\n    return url.toString().replace(/\\/$/, \"\")\n  } catch {\n    return null\n  }\n}\n\nexport function parsePlatformEndpoints(value: unknown): PlatformEndpoints | null {\n  if (!isRecord(value) || !isRecord(value.services)) return null\n\n  const services: Partial<Record<PlatformServiceName, string>> = {}\n  for (const name of PLATFORM_SERVICE_NAMES) {\n    if (!(name in value.services)) continue\n    const url = normalizeServiceUrl(value.services[name])\n    if (!url) return null\n    if (name === \"agent\" && new URL(url).pathname !== \"/\") return null\n    services[name] = url\n  }\n\n  return { services }\n}\n\nexport async function loadPlatformEndpoints(\n  options: LoadPlatformEndpointsOptions = {},\n): Promise<PlatformEndpoints> {\n  const fetchImpl = options.fetchImpl ?? globalThis.fetch\n  const baseUrl = options.baseUrl ?? defaultDocumentBaseUrl()\n  if (!fetchImpl || !baseUrl) return EMPTY_PLATFORM_ENDPOINTS\n\n  const controller = new AbortController()\n  const timeout = globalThis.setTimeout(() => controller.abort(), options.timeoutMs ?? 3_000)\n  try {\n    const response = await fetchImpl(new URL(\"config.json\", baseUrl), {\n      cache: \"no-store\",\n      credentials: \"same-origin\",\n      headers: { Accept: \"application/json\" },\n      signal: controller.signal,\n    })\n    if (!response.ok) return EMPTY_PLATFORM_ENDPOINTS\n    return parsePlatformEndpoints(await response.json()) ?? EMPTY_PLATFORM_ENDPOINTS\n  } catch {\n    return EMPTY_PLATFORM_ENDPOINTS\n  } finally {\n    globalThis.clearTimeout(timeout)\n  }\n}\n\nexport function resolveServiceUrl(\n  endpoints: PlatformEndpoints,\n  name: PlatformServiceName,\n  path = \"\",\n): string | null {\n  const baseUrl = endpoints.services[name]\n  if (!baseUrl) return null\n  if (!path) return baseUrl\n  const pathReference = path.trimStart()\n  if (\n    path.includes(\"\\\\\") ||\n    pathReference.startsWith(\"//\") ||\n    /^[a-z][a-z0-9+.-]*:/i.test(pathReference)\n  ) {\n    return null\n  }\n  const base = new URL(`${baseUrl}/`)\n  const target = new URL(path.replace(/^\\/+/, \"\"), base)\n  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) {\n    return null\n  }\n  return target.toString()\n}\n","/**\n * 页面协作协议（对应后端 `_meta.bridge` 通道，见 docs/specs/260417-embed-bridge）。\n *\n * ## action 从哪里来\n *\n * 智能体 → 宿主方向的每一条指令，都源自**技能作者写的工具代码**：工具返回值\n * JSON 里带 `_meta.bridge: { action, payload }`，后端在持久化前把它剥离成独立\n * 事件送达前端（LLM 的对话历史里读不到它）。因此：\n *\n * - action 字符串（如 \"map.highlight\"）是**技能作者与宿主页面开发者之间的业务\n *   契约**，LLM 不参与协议、SDK 不做枚举校验；\n * - 宿主页面用 `session.onCommand(\"map.highlight\", fn)` 消费；\n * - 未注册 handler 的 action 会进入有限缓冲等待注册，超限后丢弃并 console 告警。\n *\n * 宿主 → 智能体方向只有三个白名单动作：attach（附件入输入框）/ insertText\n * （追加输入文本）/ send（直接发消息），对应协议层的 addContext / appendInput /\n * sendMessage。\n */\n\nexport interface CommandEnvelope {\n  __bladeBridge: true\n  direction: \"agent-to-host\"\n  action: string\n  payload: unknown\n  meta: {\n    sessionId: string\n    toolCallId?: string\n    timestamp: number\n  }\n}\n\nexport type InboundAction = \"addContext\" | \"appendInput\" | \"sendMessage\"\n\nexport interface InboundEnvelope {\n  __bladeBridge: true\n  direction: \"host-to-agent\"\n  action: InboundAction\n  payload: unknown\n}\n\nexport function isCommandEnvelope(value: unknown): value is CommandEnvelope {\n  if (typeof value !== \"object\" || value === null) return false\n  const record = value as Record<string, unknown>\n  return (\n    record.__bladeBridge === true &&\n    record.direction === \"agent-to-host\" &&\n    typeof record.action === \"string\"\n  )\n}\n\nexport function isInboundEnvelope(value: unknown): value is InboundEnvelope {\n  if (typeof value !== \"object\" || value === null) return false\n  const record = value as Record<string, unknown>\n  return (\n    record.__bladeBridge === true &&\n    record.direction === \"host-to-agent\" &&\n    (record.action === \"addContext\" || record.action === \"appendInput\" || record.action === \"sendMessage\")\n  )\n}\n","import type { PostChatFollowup, TurnProjection } from \"./projection\"\n\n/** 返回最新根会话轮次的小结；新用户消息到达后旧小结立即失效。 */\nexport function latestPostChatFollowup(turns: TurnProjection[]): PostChatFollowup | null {\n  for (let index = turns.length - 1; index >= 0; index -= 1) {\n    const turn = turns[index]\n    if (\n      turn.loop_id === \"root\" &&\n      (turn.role === \"user\" || turn.role === \"assistant\") &&\n      (turn.kind ?? \"message\") === \"message\" &&\n      !turn.blocks.some((block) =>\n        [\"mode_change\", \"plan_status\", \"ask_user_answer\"].includes(block.type),\n      )\n    ) {\n      return turn.role === \"assistant\" ? (turn.post_chat_followup ?? null) : null\n    }\n  }\n  return null\n}\n","export enum LayoutType {\n  Default = \"default\",\n  SkillEditor = \"skill-editor\",\n  SolutionEditor = \"solution-editor\",\n  SolutionApp = \"solution-app\",\n  Custom = \"custom\",\n}\n\nexport interface Solution {\n  id: string\n  name: string\n  version: string\n  description?: string | null\n  source?: \"builtin\" | \"personal\" | string | null\n  layout_type: LayoutType | string\n  initial_mode?: \"planning\" | \"executing\" | string | null\n  initial_message?: string | null\n  preview?: { url: string; title?: string | null } | null\n  layout?: {\n    available?: boolean\n    source_dir?: string\n    entry?: string\n    export?: string\n  } | null\n  roles?: BizRole[] | null\n  data?: Record<string, unknown> | null\n  ui_config?: SolutionAppUiConfig | null\n}\n\nexport interface SolutionAppUiConfig {\n  branding: {\n    name: string\n    subtitle?: string\n    icon_text: string\n    icon_gradient?: string\n  }\n  list: {\n    title: string\n    create_button: string\n    card?: {\n      subtitle?: string\n      stats?: Array<{\n        label: string\n        value: string\n        color?: string\n      }>\n    }\n  }\n  create: {\n    title: string\n    description?: string\n    submit_button: string\n    sections: Array<{\n      id: string\n      title: string\n      description?: string\n      fields: Array<SolutionAppField>\n    }>\n  }\n}\n\nexport type SolutionAppField =\n  | {\n      id: string\n      kind: \"textarea\"\n      label: string\n      placeholder?: string\n    }\n  | {\n      id: string\n      kind: \"file-upload\"\n      accept?: string[]\n      categories?: Array<{\n        label: string\n        description: string\n        color: string\n      }>\n    }\n\nexport interface SolutionAppState {\n  pipeline: Array<{\n    id: string\n    label: string\n    status: \"done\" | \"active\" | \"pending\" | \"error\"\n  }>\n  meta: Record<\n    string,\n    {\n      label: string\n      value: string\n      color?: string\n    }\n  >\n}\n\nexport interface BizRole {\n  id: string\n  name: string\n  description?: string | null\n  preview?: { url: string; title?: string | null } | null\n}\n","import { type } from \"arktype\"\n\nexport const TaskStatus = type(\"'pending' | 'in_progress' | 'done' | 'failed' | 'skipped'\")\nexport type TaskStatus = typeof TaskStatus.infer\n\nexport const Task = type({\n  id: \"string\",\n  goal: \"string\",\n  skills: \"string[]\",\n  depends_on: \"string[]\",\n  status: TaskStatus,\n  result_summary: \"string\",\n  number: \"string\",\n})\nexport type Task = typeof Task.infer\n"],"mappings":"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","names":["LayoutType"]}

package/dist/resources/auth.d.ts

@@ -53,7 +53,9 @@ export declare class AuthResource {
     /** 清除 login() 存储的令牌。 */
     logoutToken(): void;
     getProviders(): Promise<ProvidersResponse>;
-    getMe(): Promise<UserInfo>;
+    getMe(options?: {
+        signal?: AbortSignal;
+    }): Promise<UserInfo>;
     logout(): Promise<{
         logout_url: string;
     }>;

package/dist/resources/models.d.ts

@@ -2,6 +2,9 @@ import type { BladeClient } from "../blade-client";
 export interface ModelOption {
     id: string;
     label: string;
+    thinkingAvailable?: boolean;
+    reasoningLevels?: string[];
+    defaultReasoningLevel?: string;
     /**
      * 把这个模型发给 `baseUrl` 时该用的名字。`id` 是平台内部标识，接了多个模型服务时
      * 形如 `provider-xxx::name`，直接发过去会被拒。不在 `baseUrl` 那个服务上的模型
@@ -35,5 +38,7 @@ export interface ModelCatalog {
 export declare class ModelsResource {
     private client;
     constructor(client: BladeClient);
-    list(): Promise<ModelCatalog>;
+    list(options?: {
+        signal?: AbortSignal;
+    }): Promise<ModelCatalog>;
 }

package/dist/resources/sessions.d.ts

@@ -116,6 +116,8 @@ export interface CreateSessionRequest {
     chat_group_id?: string | null;
 }
 export interface McpSourceConfig {
+    /** Source summary shown before lazy tool discovery. */
+    description?: string;
     id: string;
     url: string;
     bearer_token?: string | null;

package/dist/server-clock.d.ts

@@ -0,0 +1,2 @@
+export declare function syncServerTime(client: object, timestamp: unknown, receivedAt?: number): void;
+export declare function getServerTime(client: object | null, now?: number): number | null;

package/dist/types/socket-events.d.ts

@@ -511,6 +511,7 @@ export declare namespace SystemNotificationPayloadSchema {
 }
 export type SystemNotificationPayload = SystemNotificationPayloadSchema.SystemNotificationPayload;
 export declare namespace TurnEventsPayloadSchema {
+    type ServerTime = (string | null);
     type SessionId = string;
     type Type = string;
     type StreamSequence = (number | null);
@@ -519,6 +520,7 @@ export declare namespace TurnEventsPayloadSchema {
     type DeltaSeq = (number | null);
     type Events = RawWireEvent[];
     interface TurnEventsPayload {
+        server_time?: ServerTime;
         session_id: SessionId;
         events: Events;
         [k: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blade-hq/agent-client",
-  "version": "2612.0.0-beta.20",
+  "version": "2612.0.0-beta.21",
   "description": "Blade Agent 框架无关客户端：会话实时状态机、REST 通道、弹窗登录、页面协作。浏览器与 Node.js 通用。",
   "repository": {
     "type": "git",

package/public-api.md

@@ -168,7 +168,7 @@ getContext: () => Record<string, unknown> | Promise<Record<string, unknown>>
 
 ```ts
 exchangeCode: (params: ExchangeCodeParams) => Promise<ExchangeCodeResult>
-getMe: () => Promise<UserInfo>
+getMe: (options?: { signal?: AbortSignal; }) => Promise<UserInfo>
 getProviders: () => Promise<ProvidersResponse>
 login: (options?: LoginOptions) => Promise<LoginResult>
 logout: () => Promise<{ logout_url: string; }>
@@ -528,6 +528,7 @@ user: { id?: string; username?: string; display_name?: string; } | undefined
 
 ```ts
 bearer_token: string | null | undefined
+description: string | undefined
 eager_tools: string[] | undefined
 exposure: "lazy" | "eager" | undefined
 id: string
@@ -575,15 +576,18 @@ unavailableProviderIds: string[] | undefined
 ## `ModelOption` (interface)
 
 ```ts
+defaultReasoningLevel: string | undefined
 id: string
 label: string
+reasoningLevels: string[] | undefined
 serviceModelId: string | undefined
+thinkingAvailable: boolean | undefined
 ```
 
 ## `ModelsResource` (class)
 
 ```ts
-list: () => Promise<ModelCatalog>
+list: (options?: { signal?: AbortSignal; }) => Promise<ModelCatalog>
 ```
 
 ## `MountHandle` (interface)