@blade-hq/agent-client 2612.0.0-beta.13 → 2612.0.0-beta.15

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { BladeApiError } from "./rest";
 export type { LoginOptions, LoginResult, TokenStorageMode } from "./auth-login";
 export { SDK_NAME, SDK_VERSION } from "./version";
 export { AgentSession } from "./session/agent-session";
-export type { AttachAppOptions, SendOptions } from "./session/agent-session";
+export type { AttachAppOptions, SendOptions, PreparedSend, PreparedSendOptions, DeliveryReceipt } from "./session/agent-session";
 export { AgentSessionError } from "./session/errors";
 export type { AgentSessionEvents, AgentSessionEventName } from "./session/events";
 export type { WorkflowRunEntry, WorkflowRunState } from "./session/workflow";
@@ -33,3 +33,5 @@ export type { ChatGroup, ChatGroupRole, ChatGroupMember, ChatGroupTask, CreateCh
 export { normalizePluginRefs } from "./schemas/plugin-refs";
 export type { PluginRef } from "./schemas/plugin-refs";
 export type { ToolEvidence } from "./schemas/projection";
+export { ToolProvider } from "./tool-provider";
+export type { ToolProviderOptions, ProviderTool, ProviderToolResult } from "./tool-provider";

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   SessionInfo,
   SessionSetupError,
   SessionStatus,
+  ToolProvider,
   chatErrorForDisplay,
   contentPreview,
   getFileParts,
@@ -19,7 +20,7 @@ import {
   normalizeTopicAssetRefs,
   transformSlashCommand,
   userFacingErrorText
-} from "./chunk-KPS6X6QX.js";
+} from "./chunk-7LEZA2WA.js";
 export {
   AgentSession,
   AgentSessionError,
@@ -31,6 +32,7 @@ export {
   SessionInfo,
   SessionSetupError,
   SessionStatus,
+  ToolProvider,
   chatErrorForDisplay,
   contentPreview,
   getFileParts,

package/dist/internal.js

@@ -18,6 +18,7 @@ import {
   SessionInfo,
   SessionSetupError,
   SessionStatus,
+  ToolProvider,
   acceptedPostChatFollowupCompletesLatestRun,
   acknowledgeTurnEvents,
   applyTurnPatch,
@@ -82,7 +83,7 @@ import {
   withTurns,
   workflowEntriesFromOutput,
   workflowNameFromArguments
-} from "./chunk-KPS6X6QX.js";
+} from "./chunk-7LEZA2WA.js";
 
 // src/polling-backoff.ts
 var MAX_BACKOFF_MS = 6e4;
@@ -272,6 +273,7 @@ export {
   SessionStatus,
   Task,
   TaskStatus,
+  ToolProvider,
   acceptedPostChatFollowupCompletesLatestRun,
   acknowledgeTurnEvents,
   applyTurnPatch,

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

@@ -87,6 +87,8 @@ export interface SessionPluginConfigUpdate {
     remove?: string[];
 }
 export interface CreateSessionRequest {
+    /** 认证创建独立匿名沙盒；链接持有者可继续聊天，不继承个人资源。 */
+    anonymous?: boolean;
     intent?: string;
     /** 正式 Solution 来源。Hub 使用 { source: "hub", org, name }。 */
     solution_ref?: PublishedSolutionRef;
@@ -557,6 +559,15 @@ export declare class SessionsResource {
         id: string;
         leaf_id: string;
     }>;
+    listAnonymousSessions(): Promise<Array<{
+        id: string;
+        intent: string;
+        created_at: string;
+        status: string;
+    }>>;
+    deleteAnonymousSession(sessionId: string): Promise<{
+        deleted: boolean;
+    }>;
     deleteSession(sessionId: string, options?: {
         deleteWorkspace?: boolean;
     }): Promise<{

package/dist/schemas/message.d.ts

@@ -87,6 +87,7 @@ export interface ChatMessage {
     duration_ms?: number;
     timestamp?: string;
     entry_id?: string;
+    client_request_id?: string;
     /** Stable React key retained when an optimistic user message is confirmed. */
     render_id?: string;
     parent_id?: string | null;

package/dist/schemas/session.d.ts

@@ -58,6 +58,7 @@ export declare const SessionInfo: import("arktype/internal/variants/object.ts").
     created_at: string;
     updated_at: string;
     shared?: boolean | undefined;
+    anonymous?: boolean | undefined;
     memory_enabled?: boolean | undefined;
     is_persistent?: boolean | undefined;
     initiator?: "sdk" | "ui" | "unknown" | null | undefined;

package/dist/session/agent-session.d.ts

@@ -84,6 +84,27 @@ export interface SendOptions {
      */
     queueWhenRunning?: boolean;
 }
+/** Durable plain-text input. Persist this JSON value before calling sendPrepared. */
+export interface PreparedSend {
+    sessionId: string;
+    requestId: string;
+    content: string;
+    options: PreparedSendOptions;
+}
+export interface PreparedSendOptions {
+    mode?: "planning" | "executing";
+    model?: string;
+    thinkingOverride?: boolean;
+    reasoningLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+}
+export interface DeliveryReceipt {
+    requestId: string;
+    status: "accepted" | "not_found" | "rejected" | "unknown";
+    itemId?: string;
+    queueStatus?: string;
+    executionId?: string | null;
+    message?: string;
+}
 export declare function sessionStatusFromChatEnd(status: string | undefined): SessionStatus;
 /**
  * 一个会话的实时状态机：封装 Socket.IO 订阅、历史 + 流式合流、断线补数，
@@ -265,6 +286,12 @@ export declare class AgentSession {
      * CLI 安装成功后才保存 getContext；之后每次 send 前恰好读取一次。
      */
     attachApp(options: AttachAppOptions): Promise<AppCliAttachment | null>;
+    /** Prepare a durable text input without sending any network request. */
+    prepareSend(content: string, options?: PreparedSendOptions): PreparedSend;
+    /** Durably enqueue an ordinary text input. Retries must reuse the saved request. */
+    sendPrepared(request: PreparedSend): Promise<DeliveryReceipt>;
+    /** Owner-authorized lookup; receipts remain until the session is deleted. */
+    getDelivery(requestId: string): Promise<DeliveryReceipt>;
     /** 发送一条消息。字符串或多模态内容均可。 */
     send(content: MessageContent, options?: SendOptions): Promise<boolean>;
     /**

package/dist/tool-provider.d.ts

@@ -0,0 +1,51 @@
+import type { BladeClient } from "./blade-client";
+export interface ProviderTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    handler: (arguments_: Record<string, unknown>, context: {
+        sessionId: string;
+        signal: AbortSignal;
+    }) => Promise<ProviderToolResult>;
+}
+export interface ProviderToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+export interface ToolProviderOptions {
+    /** Stable application-owned ID, preserved across reconnects. */
+    providerId: string;
+    /** Secret bound to the session's mcp_sources bearer_token. */
+    capability: string;
+    tools: ProviderTool[];
+    onError?: (error: Error) => void;
+}
+/** Backend-only outbound connection. Reconnects registrations, never tool calls. */
+export declare class ToolProvider {
+    private client;
+    private options;
+    private onDispose;
+    readonly url: string;
+    private socket?;
+    private timer?;
+    private registrationTimer?;
+    private disposed;
+    private registered;
+    private attempts;
+    private calls;
+    private waiters;
+    constructor(client: BladeClient, options: ToolProviderOptions, onDispose: () => void);
+    /** Resolves only after BA has authenticated and registered this connection. */
+    ready(): Promise<void>;
+    reconnect(): void;
+    private reset;
+    private fail;
+    private open;
+    private schedule;
+    private receive;
+    dispose(): void;
+}

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

@@ -109,14 +109,35 @@ export declare namespace ChatAppendPayloadSchema {
     type SessionId = string;
     type Message = string;
     type ClientRequestId = (string | null);
+    type Mode = (("planning" | "executing") | null);
+    type Model = (string | null);
+    type ThinkingOverride = (boolean | null);
+    type ReasoningLevel = (("off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max") | null);
     interface ChatAppendPayload {
         session_id: SessionId;
         message: Message;
         client_request_id?: ClientRequestId;
+        prepared_options?: (PreparedSendOptions | null);
         [k: string]: unknown;
     }
+    interface PreparedSendOptions {
+        mode?: Mode;
+        model?: Model;
+        thinking_override?: ThinkingOverride;
+        reasoning_level?: ReasoningLevel;
+    }
 }
 export type ChatAppendPayload = ChatAppendPayloadSchema.ChatAppendPayload;
+export declare namespace ChatQueueRequestPayloadSchema {
+    type SessionId = string;
+    type ClientRequestId = string;
+    interface ChatQueueRequestPayload {
+        session_id: SessionId;
+        client_request_id: ClientRequestId;
+        [k: string]: unknown;
+    }
+}
+export type ChatQueueRequestPayload = ChatQueueRequestPayloadSchema.ChatQueueRequestPayload;
 export declare namespace ChatCompactPayloadSchema {
     type SessionId = string;
     interface ChatCompactPayload {
@@ -598,6 +619,12 @@ export declare namespace ChatQueueAckSchema {
     type Items = ChatQueueItem[];
     type Status1 = string;
     type Message = (string | null);
+    type Status2 = ("accepted" | "not_found" | "error");
+    type RequestId = (string | null);
+    type ItemId = (string | null);
+    type QueueStatus = (string | null);
+    type ExecutionId = (string | null);
+    type Message1 = (string | null);
     interface ChatQueueAck {
         session_id: SessionId;
         revision: Revision;
@@ -606,6 +633,7 @@ export declare namespace ChatQueueAckSchema {
         items?: Items;
         status?: Status1;
         message?: Message;
+        delivery?: (ChatDeliveryAck | null);
         [k: string]: unknown;
     }
     interface ChatQueueItem {
@@ -620,12 +648,40 @@ export declare namespace ChatQueueAckSchema {
         error?: Error;
         [k: string]: unknown;
     }
+    interface ChatDeliveryAck {
+        status: Status2;
+        request_id?: RequestId;
+        item_id?: ItemId;
+        queue_status?: QueueStatus;
+        execution_id?: ExecutionId;
+        message?: Message1;
+        [k: string]: unknown;
+    }
 }
 export type ChatQueueAck = ChatQueueAckSchema.ChatQueueAck;
+export declare namespace ChatDeliveryAckSchema {
+    type Status = ("accepted" | "not_found" | "error");
+    type RequestId = (string | null);
+    type ItemId = (string | null);
+    type QueueStatus = (string | null);
+    type ExecutionId = (string | null);
+    type Message = (string | null);
+    interface ChatDeliveryAck {
+        status: Status;
+        request_id?: RequestId;
+        item_id?: ItemId;
+        queue_status?: QueueStatus;
+        execution_id?: ExecutionId;
+        message?: Message;
+        [k: string]: unknown;
+    }
+}
+export type ChatDeliveryAck = ChatDeliveryAckSchema.ChatDeliveryAck;
 export interface ClientToServerEvents {
     "chat:send": (payload: ChatSendPayload, ack: (response: ChatSendAck) => void) => void;
     "chat:stop": (payload: ChatStopPayload, ack: (response: ChatStopAck) => void) => void;
     "chat:append": (payload: ChatAppendPayload, ack: (response: ChatQueueAck) => void) => void;
+    "chat:queue:request": (payload: ChatQueueRequestPayload, ack: (response: ChatDeliveryAck) => void) => void;
     "chat:compact": (payload: ChatCompactPayload, ack: (response: ChatCompactAck) => void) => void;
     "chat:queue:list": (payload: ChatQueueListPayload, ack: (response: ChatQueueAck) => void) => void;
     "chat:queue:update": (payload: ChatQueueUpdatePayload, ack: (response: ChatQueueAck) => void) => void;

package/package.json

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

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 106 个公开声明。
+共 113 个公开声明。
 
 ## `AccountComputer` (interface)
 
@@ -62,6 +62,7 @@ deliverQueuedMessage: (itemId: string, expectedVersion: number) => Promise<Queue
 dispose: () => void
 downloadFile: (filePath: string, downloadName?: string) => Promise<void>
 exitReplay: () => Promise<void>
+getDelivery: (requestId: string) => Promise<DeliveryReceipt>
 getState: () => SessionState
 hasOlderHistory: boolean
 insertText: (text: string) => void
@@ -74,6 +75,7 @@ locateEntry: (entryId: string) => Promise<boolean>
 off: <K extends keyof AgentSessionEvents>(name: K, handler: (event: AgentSessionEvents[K]) => void) => void
 on: <K extends keyof AgentSessionEvents>(name: K, handler: (event: AgentSessionEvents[K]) => void) => () => void
 onCommand: (action: string, handler: CommandHandler) => () => void
+prepareSend: (content: string, options?: PreparedSendOptions) => PreparedSend
 queueMessage: (content: string) => Promise<QueueOperationResult>
 refreshQueue: () => Promise<QueueOperationResult>
 refreshRunningState: () => Promise<void>
@@ -81,6 +83,7 @@ reloadHistory: () => Promise<boolean>
 reorderQueuedMessages: (expectedRevision: number, orderedIds: string[]) => Promise<QueueOperationResult>
 resumeQueue: () => Promise<QueueOperationResult>
 send: (content: MessageContent, options?: SendOptions) => Promise<boolean>
+sendPrepared: (request: PreparedSend) => Promise<DeliveryReceipt>
 sessionId: string
 setReplaySpeed: (speed: ReplaySpeed) => Promise<void>
 stop: () => Promise<Record<string, unknown>>
@@ -200,7 +203,9 @@ blob: (method: HttpMethod, path: string) => Promise<Blob>
 buildAuthedUrl: (path: string) => string
 chatGroups: ChatGroupsResource
 computers: ComputersResource
+connectToolProvider: (options: ToolProviderOptions) => ToolProvider
 fetch: (method: HttpMethod, path: string, init?: BladeFetchInit, isRetry?: boolean) => Promise<Response>
+forAnonymousSession: (sessionId: string) => BladeClient
 formData: (method: HttpMethod, path: string, form: FormData, options?: { expectOk?: boolean; onUploadProgress?: (progress: UploadProgress) => void; }) => Promise<Response>
 hasToken: () => boolean
 headless: HeadlessResource
@@ -228,8 +233,9 @@ token: string | null
 ## `BladeClientOptions` (interface)
 
 ```ts
+anonymousSessionId: string | undefined
 baseUrl: string
-commandTransport: ((event: string, payload: Record<string, unknown>, send: () => Promise<Record<string, unknown>>) => Promise<Record<string, unknown>>) | undefined
+commandTransport: ((event: string, payload: Record<string, unknown>, send: () => Promise<Record<string, unknown>>, scope?: { anonymousSessionId: string; }) => Promise<Record<string, unknown>>) | undefined
 fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
 onRefreshSuccess: (() => void | Promise<void>) | undefined
 socketToken: string | (() => string | null | undefined) | undefined
@@ -321,6 +327,7 @@ updated_at: string
 
 ```ts
 blocks: ContentBlock[] | undefined
+client_request_id: string | undefined
 compaction: CompactionInfo | undefined
 content: MessageContent
 context: ContextProjectionData | undefined
@@ -380,6 +387,7 @@ title: string
 
 ```ts
 agent_runtime_id: string | null | undefined
+anonymous: boolean | undefined
 biz_role_id: string | null | undefined
 chat_group_id: string | null | undefined
 compaction_ratio: number | null | undefined
@@ -405,6 +413,17 @@ solution_snapshot_session_id: string | undefined
 DEFAULT_REPLAY_SPEED: ReplaySpeed
 ```
 
+## `DeliveryReceipt` (interface)
+
+```ts
+executionId: string | null | undefined
+itemId: string | undefined
+message: string | undefined
+queueStatus: string | undefined
+requestId: string
+status: "unknown" | "accepted" | "not_found" | "rejected"
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -607,6 +626,24 @@ provider: "plugin"
 server: string
 ```
 
+## `PreparedSend` (interface)
+
+```ts
+content: string
+options: PreparedSendOptions
+requestId: string
+sessionId: string
+```
+
+## `PreparedSendOptions` (interface)
+
+```ts
+mode: "planning" | "executing" | undefined
+model: string | undefined
+reasoningLevel: "max" | "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined
+thinkingOverride: boolean | undefined
+```
+
 ## `ProvidersResponse` (interface)
 
 ```ts
@@ -614,6 +651,23 @@ password_enabled: boolean
 providers: { name: string; authorize_url: string; }[]
 ```
 
+## `ProviderTool` (interface)
+
+```ts
+description: string | undefined
+handler: (arguments_: Record<string, unknown>, context: { sessionId: string; signal: AbortSignal; }) => Promise<ProviderToolResult>
+inputSchema: Record<string, unknown>
+name: string
+```
+
+## `ProviderToolResult` (interface)
+
+```ts
+content: { type: "text"; text: string; }[]
+isError: boolean | undefined
+structuredContent: Record<string, unknown> | undefined
+```
+
 ## `QueuedMessage` (interface)
 
 ```ts
@@ -780,6 +834,7 @@ solution: SolutionDefinition | undefined
 
 ```ts
 agent_runtime_id: string | null | undefined
+anonymous: boolean | undefined
 ba_version: string | null | undefined
 biz_role_id: string | null | undefined
 chat_group_id: string | null | undefined
@@ -825,6 +880,7 @@ SessionInfo = type({
   created_at: "string",
   updated_at: "string",
   "shared?": "boolean",
+  "anonymous?": "boolean",
   "memory_enabled?": "boolean",
   "is_persistent?": "boolean",
   "initiator?": "'ui' | 'sdk' | 'unknown' | null",
@@ -895,6 +951,7 @@ createSession: (intent?: string) => Promise<{ session_id: string; }>
 createSessionWithRequest: (request: CreateSessionRequest) => Promise<{ session_id: string; }>
 createShare: (sessionId: string) => Promise<ShareLinkResult>
 createWithProfile: (params: { intent: string; profile: SessionProfile; }) => Promise<{ session_id: string; }>
+deleteAnonymousSession: (sessionId: string) => Promise<{ deleted: boolean; }>
 deleteFile: (sessionId: string, filePath: string) => Promise<void>
 deleteSession: (sessionId: string, options?: { deleteWorkspace?: boolean; }) => Promise<{ deleted: boolean; workspace_deleted?: boolean; }>
 downloadFile: (sessionId: string, filePath: string, downloadName?: string) => Promise<void>
@@ -920,6 +977,7 @@ getSessionTurns: (sessionId: string) => Promise<TurnProjection[]>
 getSessionTurnsPage: (sessionId: string, options?: SessionTurnsQuery, init?: RequestInit) => Promise<SessionTurnsPage>
 getSharedSession: (token: string) => Promise<TurnProjection[]>
 importSession: (file: File, name?: string, solutionOverride?: string | null | ImportSessionOptions) => Promise<{ session_id: string; }>
+listAnonymousSessions: () => Promise<Array<{ id: string; intent: string; created_at: string; status: string; }>>
 listBackgroundTasks: (sessionId: string, init?: RequestInit) => Promise<BackgroundTask[]>
 listDir: (sessionId: string, dirPath: string, showHidden?: boolean) => Promise<FileEntry[]>
 listResultFeedback: (sessionId: string) => Promise<ResultFeedback[]>
@@ -1095,6 +1153,24 @@ tool_call_id: string
 url: string | undefined
 ```
 
+## `ToolProvider` (class)
+
+```ts
+dispose: () => void
+ready: () => Promise<void>
+reconnect: () => void
+url: string
+```
+
+## `ToolProviderOptions` (interface)
+
+```ts
+capability: string
+onError: ((error: Error) => void) | undefined
+providerId: string
+tools: ProviderTool[]
+```
+
 ## `TopicAssetRef` (interface)
 
 ```ts