@blade-hq/agent-client 2612.0.0-beta.48 → 2612.0.0-beta.49

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export { AgentSessionError } from "./session/errors";
 export type { AgentSessionEvents, AgentSessionEventName } from "./session/events";
 export type { WorkflowRunEntry, WorkflowRunState } from "./session/workflow";
 export type { ActiveCompactionState, AgentLoopInfo, AskUserAnswerData, ConnectionStatus, ReplaySnapshot, SessionState, } from "./session/state";
+export { parseAskUserQuestion, formatAskUserAnswer } from "./schemas/ask-user-question";
+export type { AskUserQuestionOption, AskUserQuestionItem, AskUserQuestionData } from "./schemas/ask-user-question";
 export { SessionSetupError } from "./session/definition";
 export type { SessionConfig, SessionDefinition, SessionSetupStage, SkillDefinition, SkillFile, SolutionDefinition, TextFile, } from "./session/definition";
 export type { QueuedMessage, QueuedMessageStatus, QueueOperationResult, SessionQueueSnapshot, } from "./session/queue";

package/dist/index.js

@@ -15,6 +15,7 @@ import {
   ToolProvider,
   chatErrorForDisplay,
   contentPreview,
+  formatAskUserAnswer,
   getFileParts,
   getImageParts,
   getTextContent,
@@ -22,9 +23,10 @@ import {
   normalizeMessageRefs,
   normalizePluginRefs,
   normalizeTopicAssetRefs,
+  parseAskUserQuestion,
   transformSlashCommand,
   userFacingErrorText
-} from "./chunk-2AGTCYFG.js";
+} from "./chunk-NNYV4ZVA.js";
 export {
   AgentSession,
   AgentSessionError,
@@ -42,6 +44,7 @@ export {
   ToolProvider,
   chatErrorForDisplay,
   contentPreview,
+  formatAskUserAnswer,
   getFileParts,
   getImageParts,
   getTextContent,
@@ -49,6 +52,7 @@ export {
   normalizeMessageRefs,
   normalizePluginRefs,
   normalizeTopicAssetRefs,
+  parseAskUserQuestion,
   transformSlashCommand,
   userFacingErrorText
 };

package/dist/internal.js

@@ -43,6 +43,7 @@ import {
   createInitialSessionState,
   createSocket,
   extractTextAttachments,
+  formatAskUserAnswer,
   getContextDisplayState,
   getContextGroupDisplayState,
   getFileParts,
@@ -70,6 +71,7 @@ import {
   normalizePluginRefs,
   normalizeTopicAssetRefs,
   parentForkToolCallIdFromTurn,
+  parseAskUserQuestion,
   parseQueueAck,
   phoneSerialLabel,
   phoneState,
@@ -92,7 +94,7 @@ import {
   withTurns,
   workflowEntriesFromOutput,
   workflowNameFromArguments
-} from "./chunk-2AGTCYFG.js";
+} from "./chunk-NNYV4ZVA.js";
 
 // src/polling-backoff.ts
 var MAX_BACKOFF_MS = 6e4;
@@ -307,6 +309,7 @@ export {
   createInitialSessionState,
   createSocket,
   extractTextAttachments,
+  formatAskUserAnswer,
   getContextDisplayState,
   getContextGroupDisplayState,
   getFileParts,
@@ -337,6 +340,7 @@ export {
   normalizePluginRefs,
   normalizeTopicAssetRefs,
   parentForkToolCallIdFromTurn,
+  parseAskUserQuestion,
   parseQueueAck,
   phoneSerialLabel,
   phoneState,

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/computers.d.ts

@@ -18,7 +18,7 @@ export interface SessionComputer {
     last_seen_at?: string | null;
     /** 这台电脑此刻连着后端。由服务端读心跳时间判定，不做实时探测。 */
     online: boolean;
-    /** 这次会话已经启动了它。和 `online` 互相独立。 */
+    /** 本次会话可用，默认启用，明确停用后为 false。和 `online` 互相独立。 */
     enabled: boolean;
 }
 export interface SessionComputerList {

package/dist/schemas/ask-user-question.d.ts

@@ -0,0 +1,21 @@
+import type { AskUserAnswerData } from "../session/state";
+export interface AskUserQuestionOption {
+    label: string;
+    description: string;
+}
+export interface AskUserQuestionItem {
+    question: string;
+    options: AskUserQuestionOption[];
+    multiSelect?: boolean;
+}
+export interface AskUserQuestionData {
+    questions: AskUserQuestionItem[];
+    source_loop?: {
+        loop_name: string;
+        description: string;
+    } | null;
+}
+/** Normalize the question payload returned by AskUserQuestion or stored in its arguments. */
+export declare function parseAskUserQuestion(toolResult: string | null | undefined): AskUserQuestionData | null;
+/** Build the user message accompanying a structured AskUserQuestion answer. */
+export declare function formatAskUserAnswer(data: AskUserQuestionData, answer: AskUserAnswerData): string;

package/package.json

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

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 133 个公开声明。
+共 138 个公开声明。
 
 ## `AccountComputer` (interface)
 
@@ -172,6 +172,28 @@ note: string | undefined
 selections: Record<number, number[]>
 ```
 
+## `AskUserQuestionData` (interface)
+
+```ts
+questions: AskUserQuestionItem[]
+source_loop: { loop_name: string; description: string; } | null | undefined
+```
+
+## `AskUserQuestionItem` (interface)
+
+```ts
+multiSelect: boolean | undefined
+options: AskUserQuestionOption[]
+question: string
+```
+
+## `AskUserQuestionOption` (interface)
+
+```ts
+description: string
+label: string
+```
+
 ## `AttachAppOptions` (interface)
 
 ```ts
@@ -547,6 +569,12 @@ path: string
 tags: string[] | undefined
 ```
 
+## `formatAskUserAnswer` (function)
+
+```ts
+formatAskUserAnswer: (data: AskUserQuestionData, answer: AskUserAnswerData) => string
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -721,6 +749,12 @@ offset: number
 total: number
 ```
 
+## `parseAskUserQuestion` (function)
+
+```ts
+parseAskUserQuestion: (toolResult: string | null | undefined) => AskUserQuestionData | null
+```
+
 ## `PhoneAccessKey` (interface)
 
 ```ts