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

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";
@@ -20,10 +20,19 @@ export type { RunOptions, RunResult, RunTrace } from "./types/sdk-profile";
 export type { ModelsResource, ModelCatalog, ModelOption } from "./resources/models";
 export type { ComputersResource } from "./resources/computers";
 export type { AccountComputer, SessionComputer } from "./resources/computers";
-export type { AppCliAttachment, AppCliDefinition, CreateSessionRequest, FileEntry, PaginatedSessionsResult, SessionsResource, SessionTurnsPage, SessionTurnsQuery, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
+export type { AppCliAttachment, AppCliDefinition, CreateSessionRequest, UpdateSessionConfigurationRequest, SessionConfiguration, McpSourceConfig, FileEntry, PaginatedSessionsResult, SessionsResource, SessionTurnsPage, SessionTurnsQuery, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
 export { DEFAULT_REPLAY_SPEED, SessionInfo, SessionStatus } from "./schemas/session";
 export type { ReplaySpeed, ReplayState, SessionDetail } from "./schemas/session";
-export type { ChatMessage, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolCallInfo, } from "./schemas/message";
+export type { ChatMessage, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolCallInfo, WorkflowStepInfo, } from "./schemas/message";
 export { chatErrorForDisplay, contentPreview, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, transformSlashCommand, } from "./schemas/message-utils";
 export type { SkillMentionAvailability } from "./schemas/message-utils";
 export { userFacingErrorText } from "./shared/oom";
+export { normalizeTopicAssetRefs } from "./schemas/topic-assets";
+export type { TopicAssetRef } from "./schemas/topic-assets";
+export type { ChatGroup, ChatGroupRole, ChatGroupMember, ChatGroupTask, CreateChatGroupTask, UpdateChatGroupTask, ChatGroupAsset, ChatGroupAssetList } from "./resources/chat-groups";
+export { normalizePluginRefs, normalizeMessageRefs } from "./schemas/plugin-refs";
+export type { PluginRef, SkillRef, MessageRef } from "./schemas/plugin-refs";
+export type { ToolEvidence } from "./schemas/projection";
+export { ToolProvider } from "./tool-provider";
+export type { ToolProviderOptions, ProviderTool, ProviderToolResult } from "./tool-provider";
+export type { ContextAttachment } from "./schemas/context-attachments";

package/dist/index.js

@@ -9,15 +9,19 @@ import {
   SessionInfo,
   SessionSetupError,
   SessionStatus,
+  ToolProvider,
   chatErrorForDisplay,
   contentPreview,
   getFileParts,
   getImageParts,
   getTextContent,
   groupMessagesByLoop,
+  normalizeMessageRefs,
+  normalizePluginRefs,
+  normalizeTopicAssetRefs,
   transformSlashCommand,
   userFacingErrorText
-} from "./chunk-PWJJJATA.js";
+} from "./chunk-2VIJBVAC.js";
 export {
   AgentSession,
   AgentSessionError,
@@ -29,12 +33,16 @@ export {
   SessionInfo,
   SessionSetupError,
   SessionStatus,
+  ToolProvider,
   chatErrorForDisplay,
   contentPreview,
   getFileParts,
   getImageParts,
   getTextContent,
   groupMessagesByLoop,
+  normalizeMessageRefs,
+  normalizePluginRefs,
+  normalizeTopicAssetRefs,
   transformSlashCommand,
   userFacingErrorText
 };

package/dist/internal.d.ts

@@ -24,7 +24,7 @@ export { ComputersResource } from "./resources/computers";
 export type { SessionPlugin, SessionPluginActivation } from "./resources/sessions";
 export type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState, SessionPluginConfigStateName, SessionPluginConfigSummary, SessionPluginConfigUpdate, } from "./resources/sessions";
 export { ChatGroupsResource } from "./resources/chat-groups";
-export type { ChatGroup } from "./resources/chat-groups";
+export type { ChatGroup, ChatGroupRole, ChatGroupMember, ChatGroupTask, CreateChatGroupTask, UpdateChatGroupTask, ChatGroupAsset, ChatGroupAssetList } from "./resources/chat-groups";
 export { PluginsResource } from "./resources/plugins";
 export type { PluginCatalogEntry } from "./resources/plugins";
 export type { SiteVisitsResource, SiteVisitsSummary } from "./resources/site-visits";
@@ -36,11 +36,11 @@ export { buildMessageContent, extractTextAttachments, isBackgroundWakeMessage, i
 export type { ParsedTextAttachment, ParsedTextContext } from "./schemas/message-utils";
 export { contextProjectionData, getContextDisplayState, getContextGroupDisplayState, groupAdjacentContextRuns, } from "./schemas/context";
 export type { ContextAction, ContextDisplayState, ContextGroupDisplayState, ContextProjectionData, ContextProjectionFields, ContextSourceInfo, } from "./schemas/context";
-export type { ContentBlock, FinalArtifact, MemoryRef, PatchEnvelope, PendingQuestionRef, PostChatFollowup, RunTiming, ToolCallProjection, TurnProjection, } from "./schemas/projection";
+export type { ContentBlock, FinalArtifact, MemoryRef, PatchEnvelope, PendingQuestionRef, PostChatFollowup, RunTiming, ToolCallProjection, WorkflowStepProjection, TurnProjection, } from "./schemas/projection";
 export { latestPostChatFollowup } from "./schemas/projection-utils";
 export { buildToolUiCardKey, collectInlineToolUiCards, collectPreviewToolUiCards, isAppDevToolUiCard, isInternalStatusToolUiCard, isToolUiCard, resolveToolUiCardContent, } from "./shared/tool-ui-card";
 export type { InlineToolUiCardEntry, PreviewToolUiCardEntry, ToolUiCard, ToolUiCardContentType, } from "./shared/tool-ui-card";
-export type { ModeId, PrimarySkillParallelMode, PrimarySkillSnapshot, PrimarySkillStageSpec, PrimarySkillStepSpec, PublishedSolutionRef, ReplayPreview, SessionPortMapping, SessionSearchMatch, SkillEditorTemplateId, TemplateId, } from "./schemas/session";
+export type { ModeId, PublishedSolutionRef, ReplayPreview, SessionPortMapping, SessionSearchMatch, } from "./schemas/session";
 export { LayoutType } from "./schemas/solution";
 export type { BizRole, Solution, SolutionAppField, SolutionAppState, SolutionAppUiConfig, } from "./schemas/solution";
 export { Task, TaskStatus } from "./schemas/task";
@@ -53,3 +53,8 @@ export { isOomText, OOM_MESSAGE } from "./shared/oom";
 export { createSocket } from "./socket";
 export type { CreateSocketOptions, TypedSocket } from "./socket";
 export type { AsrAudioPayload } from "./types/socket-events";
+export { normalizeTopicAssetRefs } from "./schemas/topic-assets";
+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";

package/dist/internal.js

@@ -18,6 +18,7 @@ import {
   SessionInfo,
   SessionSetupError,
   SessionStatus,
+  ToolProvider,
   acceptedPostChatFollowupCompletesLatestRun,
   acknowledgeTurnEvents,
   applyTurnPatch,
@@ -61,6 +62,9 @@ import {
   isToolUiCard,
   isWorkflowRunToolName,
   normalizeMessageContent,
+  normalizeMessageRefs,
+  normalizePluginRefs,
+  normalizeTopicAssetRefs,
   parentForkToolCallIdFromTurn,
   parseQueueAck,
   prependOlder,
@@ -80,7 +84,7 @@ import {
   withTurns,
   workflowEntriesFromOutput,
   workflowNameFromArguments
-} from "./chunk-PWJJJATA.js";
+} from "./chunk-2VIJBVAC.js";
 
 // src/polling-backoff.ts
 var MAX_BACKOFF_MS = 6e4;
@@ -270,6 +274,7 @@ export {
   SessionStatus,
   Task,
   TaskStatus,
+  ToolProvider,
   acceptedPostChatFollowupCompletesLatestRun,
   acknowledgeTurnEvents,
   applyTurnPatch,
@@ -316,6 +321,9 @@ export {
   latestPostChatFollowup,
   loadPlatformEndpoints,
   normalizeMessageContent,
+  normalizeMessageRefs,
+  normalizePluginRefs,
+  normalizeTopicAssetRefs,
   parentForkToolCallIdFromTurn,
   parseQueueAck,
   prependOlder,

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

@@ -1,4 +1,5 @@
 import type { BladeClient } from "../blade-client";
+export type ChatGroupRole = "owner" | "editor" | "viewer";
 export interface ChatGroup {
     id: string;
     name: string;
@@ -6,12 +7,67 @@ export interface ChatGroup {
     created_at: string;
     updated_at: string;
     session_count: number;
+    member_count: number;
+    role: ChatGroupRole;
     initiator: "ui" | "sdk" | null;
     workspace_path: string;
 }
+export interface ChatGroupMember {
+    user_id: string;
+    display_name: string | null;
+    username: string;
+    role: ChatGroupRole;
+    added_by: string;
+    added_at: string;
+}
+export interface ChatGroupTask {
+    id: string;
+    group_id: string;
+    number: number;
+    title: string;
+    description: string;
+    owner_user_id: string;
+    owner_display_name: string;
+    owner_left: boolean;
+    due_date: string | null;
+    status: "todo" | "doing" | "done";
+    /** Only returned to the owner of this private session. */
+    session_id: string | null;
+    can_open_session: boolean;
+    agent_started: boolean;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateChatGroupTask {
+    title: string;
+    description?: string;
+    owner_user_id: string;
+    due_date?: string | null;
+    start_agent?: boolean;
+}
+export interface UpdateChatGroupTask extends Partial<Omit<CreateChatGroupTask, "start_agent">> {
+    status?: ChatGroupTask["status"];
+}
+export interface ChatGroupAsset {
+    path: string;
+    is_dir: boolean;
+    size: number;
+    sha256: string;
+    submitted_by: string;
+    submitted_by_name: string;
+    session_id: string | null;
+    message: string;
+    updated_at: string;
+}
+export interface ChatGroupAssetList {
+    group_id: string;
+    items: ChatGroupAsset[];
+}
 export declare class ChatGroupsResource {
     private readonly client;
     constructor(client: BladeClient);
+    private path;
     list(): Promise<ChatGroup[]>;
     create(payload: {
         name: string;
@@ -28,4 +84,40 @@ export declare class ChatGroupsResource {
         deleted: boolean;
         deleted_sessions: number;
     }>;
+    listMembers(groupId: string): Promise<ChatGroupMember[]>;
+    addMembers(groupId: string, userIds: string[], role: "editor" | "viewer"): Promise<ChatGroupMember[]>;
+    updateMember(groupId: string, userId: string, role: "editor" | "viewer"): Promise<ChatGroupMember>;
+    removeMember(groupId: string, userId: string): Promise<{
+        deleted: boolean;
+    }>;
+    listTasks(groupId: string): Promise<ChatGroupTask[]>;
+    createTask(groupId: string, payload: CreateChatGroupTask): Promise<ChatGroupTask>;
+    updateTask(groupId: string, taskId: string, payload: UpdateChatGroupTask): Promise<ChatGroupTask>;
+    deleteTask(groupId: string, taskId: string): Promise<{
+        deleted: boolean;
+    }>;
+    listAssets(groupId: string): Promise<ChatGroupAssetList>;
+    readAsset(groupId: string, path: string, signal?: AbortSignal): Promise<Blob>;
+    /** Read at most the first 1 MiB. Full downloads continue to use readAsset. */
+    readAssetPreview(groupId: string, path: string, signal?: AbortSignal): Promise<{
+        blob: Blob;
+        truncated: boolean;
+    }>;
+    uploadAsset(groupId: string, file: File, path: string, message?: string): Promise<{
+        file: ChatGroupAsset;
+    }>;
+    createAssetFolder(groupId: string, path: string): Promise<{
+        file: ChatGroupAsset;
+    }>;
+    deleteAsset(groupId: string, path: string): Promise<{
+        deleted: boolean;
+    }>;
+    submitSessionAsset(payload: {
+        session_id: string;
+        path: string;
+        target_path: string;
+        message?: string;
+    }): Promise<{
+        file: ChatGroupAsset;
+    }>;
 }

package/dist/resources/headless.d.ts

@@ -1,9 +1,13 @@
+import type { TopicAssetRef } from "../schemas/topic-assets";
 import type { BladeClient } from "../blade-client";
 export type JsonSchemaObject = Record<string, unknown>;
 export interface HeadlessRunOptions {
     schema?: JsonSchemaObject | null;
     model?: string | null;
     timeoutMs?: number;
+    /** Assets explicitly selected for this message in a topic-linked session. */
+    refs?: import("../schemas/plugin-refs").MessageRef[];
+    topicAssetRefs?: TopicAssetRef[];
 }
 export interface HeadlessRunInSessionResult<T = unknown> {
     session_id: string;
@@ -16,6 +20,7 @@ export declare class HeadlessError extends Error {
 }
 export declare class HeadlessResource {
     private client;
+    private readonly subscriptions;
     constructor(client: BladeClient);
     run<T = unknown>(prompt: string, options: HeadlessRunOptions & {
         schema: JsonSchemaObject;

package/dist/resources/plugins.d.ts

@@ -16,6 +16,7 @@ export interface PluginCatalogEntry {
      */
     icon: string | null;
     /** 当前用户是否安装了它。 */
+    auth_status?: "login_required" | "ready" | "expired" | "unavailable";
     installed: boolean;
 }
 /**

package/dist/resources/sessions.d.ts

@@ -1,7 +1,7 @@
 import type { BackgroundTask, BackgroundTaskStopResult } from "../schemas/background";
 import type { TurnProjection } from "../schemas/projection";
 import type { McpAppArchive } from "../schemas/mcp-app";
-import type { PublishedSolutionRef, ReplayPreview, ReplaySpeed, SessionDetail, SessionInfo, TemplateId } from "../schemas/session";
+import type { PublishedSolutionRef, ReplayPreview, ReplaySpeed, SessionDetail, SessionInfo } from "../schemas/session";
 import type { McpAppContextState, McpAppContextUpdate } from "../schemas/mcp-app";
 import type { Task } from "../schemas/task";
 import type { BladeClient, UploadProgress } from "../blade-client";
@@ -52,6 +52,14 @@ export interface SessionPluginConfigError {
     /** Value-free message; the platform never echoes submitted secrets. */
     message: string;
 }
+export interface SessionPluginHostState {
+    digest: string;
+    revision: string;
+    state: string;
+    reason: string;
+    restarts: number;
+    recent?: string[];
+}
 export interface SessionPluginConfigState {
     state: SessionPluginConfigStateName;
     reason: string | null;
@@ -64,6 +72,8 @@ export interface SessionPluginConfigState {
     /** Opaque revision for optimistic concurrency; null when nothing is stored. */
     revision: string | null;
     errors: SessionPluginConfigError[];
+    auth_status?: "login_required" | "ready" | "expired";
+    global_ready?: boolean;
 }
 export interface SessionPluginConfigSet {
     /** JSON Pointer; arrays are replaced as a whole. */
@@ -77,8 +87,11 @@ export interface SessionPluginConfigUpdate {
     remove?: string[];
 }
 export interface CreateSessionRequest {
+    /** Notification owner. Built-in Web declares ui; external applications default to sdk. */
+    initiator?: "ui" | "sdk";
+    /** 认证创建独立匿名沙盒；链接持有者可继续聊天，不继承个人资源。 */
+    anonymous?: boolean;
     intent?: string;
-    template_id?: TemplateId;
     /** 正式 Solution 来源。Hub 使用 { source: "hub", org, name }。 */
     solution_ref?: PublishedSolutionRef;
     /** @deprecated 请使用结构化的 solution_ref；继续支持以保证现有 SDK 调用无感升级。 */
@@ -86,12 +99,14 @@ export interface CreateSessionRequest {
     /** 从已有会话复制其不可变 Solution 与 Skill 运行快照。 */
     solution_snapshot_session_id?: string;
     biz_role_id?: string | null;
-    primary_skill_id?: string | null;
     model?: string | null;
     enable_thinking?: boolean | null;
     memory_enabled?: boolean | null;
     env?: Record<string, string>;
     disable_tools?: string[] | null;
+    mcp_sources?: McpSourceConfig[];
+    /** 此会话的所有普通轮次直接执行工具，不弹审批。 */
+    skip_confirmations?: boolean;
     session_solution_asset_id?: string | null;
     compaction_ratio?: number | null;
     runtime_type?: "sandbox" | "daemon" | "native" | null;
@@ -100,6 +115,50 @@ export interface CreateSessionRequest {
     agent_runtime_id?: string | null;
     chat_group_id?: string | null;
 }
+export interface McpSourceConfig {
+    id: string;
+    url: string;
+    bearer_token?: string | null;
+    exposure?: "lazy" | "eager";
+    include_tools?: string[] | null;
+    eager_tools?: string[];
+}
+/** Sandbox only. Omitted fields are retained; lists/maps replace their previous value. */
+export interface UpdateSessionConfigurationRequest {
+    version: string;
+    expected_revision?: number;
+    solution_ref?: PublishedSolutionRef;
+    solution_id?: string;
+    session_solution_asset_id?: string;
+    biz_role_id?: string;
+    model?: string;
+    enable_thinking?: boolean | null;
+    memory_enabled?: boolean;
+    env?: Record<string, string>;
+    disable_tools?: string[];
+    mcp_sources?: McpSourceConfig[];
+    skip_confirmations?: boolean;
+    compaction_ratio?: number | null;
+}
+export interface SessionConfiguration {
+    session_id: string;
+    version: string | null;
+    revision: number;
+    configuration: {
+        solution_identity: Record<string, unknown> | null;
+        solution_version: string | null;
+        biz_role_id: string | null;
+        biz_role_version: string | null;
+        model: string | null;
+        enable_thinking: boolean | null;
+        memory_enabled: boolean;
+        env: Record<string, string>;
+        disable_tools: string[];
+        mcp_sources: Omit<McpSourceConfig, "bearer_token">[];
+        skip_confirmations: boolean;
+        compaction_ratio: number | null;
+    };
+}
 export interface CheckpointNode {
     id: string;
     parent_id: string | null;
@@ -281,6 +340,7 @@ export interface ImportPreviewSkill {
     description: string;
     path: string;
 }
+/** Legacy archive decode shape only; custom scenario scripts are never executed. */
 export interface ImportPreviewScenario {
     scenario?: {
         name?: string;
@@ -294,6 +354,7 @@ export interface ImportPreview {
     user_messages: string[];
     turn_count: number;
     skills: ImportPreviewSkill[];
+    /** Retained for older responses. Current servers always return null. */
     scenario: ImportPreviewScenario | null;
 }
 export interface ImportSessionOptions {
@@ -360,32 +421,36 @@ export declare class SessionsResource {
      *
      * Secrets are never returned: `write_only` lists the pointers that hold one.
      */
-    getSessionPluginConfig(sessionId: string, name: string, init?: RequestInit): Promise<{
+    getSessionPluginConfig(sessionId: string, name: string, init?: RequestInit, scope?: "personal" | "global"): Promise<{
         plugin: string;
         config: SessionPluginConfigState;
+        can_configure_global?: boolean;
+        host?: SessionPluginHostState | null;
     }>;
     /**
-     * Publish explicit set/remove operations to the user's keychain file.
+     * Save explicit set/remove operations to encrypted server storage.
      *
      * Fields absent from both lists keep their stored value, so a form never has
-     * to round-trip a secret. Rejections leave the previous file untouched; the
-     * call never restarts MCP servers.
+     * to round-trip a secret. Rejections preserve the previous values; the
+     * shared settings restart only the affected hosted plugin.
      */
-    updateSessionPluginConfig(sessionId: string, name: string, update: SessionPluginConfigUpdate, init?: RequestInit): Promise<{
+    updateSessionPluginConfig(sessionId: string, name: string, update: SessionPluginConfigUpdate, init?: RequestInit, scope?: "personal" | "global"): Promise<{
         plugin: string;
         config: SessionPluginConfigState;
     }>;
+    restartSessionPluginHost(sessionId: string, name: string): Promise<{
+        host: SessionPluginHostState | null;
+    }>;
     /** 创建新会话并直接连接，返回可收发消息的 AgentSession。 */
     create(request?: CreateSessionRequest | SessionDefinition): Promise<AgentSession>;
     private createDeclared;
     private prepareSolution;
     private cleanupSolutionAsset;
     private fetchSessionsPage;
-    listSessions(template_id_prefix?: string, solution_id?: string): Promise<SessionInfo[]>;
+    listSessions(solution_id?: string): Promise<SessionInfo[]>;
     listSessionsPaginated(params: {
         limit: number;
         offset: number;
-        template_id_prefix?: string;
         solution_id?: string;
         solution_registry_id?: string;
         q?: string;
@@ -396,7 +461,7 @@ export declare class SessionsResource {
         q: string;
         limit?: number;
     }): Promise<GlobalSearchResult>;
-    createSession(intent?: string, template_id?: TemplateId, primary_skill_id?: string | null): Promise<{
+    createSession(intent?: string): Promise<{
         session_id: string;
     }>;
     createSessionWithRequest(request: CreateSessionRequest): Promise<{
@@ -413,6 +478,9 @@ export declare class SessionsResource {
         intent?: string;
         chat_group_id?: string | null;
     }): Promise<SessionDetail>;
+    getSessionConfiguration(sessionId: string, init?: RequestInit): Promise<SessionConfiguration>;
+    /** Updates atomically between turns. A running/handoff session returns HTTP 409. */
+    updateSessionConfiguration(sessionId: string, request: UpdateSessionConfigurationRequest): Promise<SessionConfiguration>;
     setSessionEnv(sessionId: string, env: Record<string, string>): Promise<SessionDetail>;
     pinSession(sessionId: string, pinned: boolean): Promise<SessionInfo>;
     startReplaySession(sourceSessionId: string, speed?: ReplaySpeed): Promise<{
@@ -478,15 +546,30 @@ export declare class SessionsResource {
         mode?: string;
         files_restored?: boolean;
         linear?: boolean;
+        history_committed?: boolean;
+        file_checkpoint_cleanup_failed?: boolean;
+        warning?: string;
     }>;
     rewindSession(sessionId: string, checkpointId: string): Promise<{
         id: string;
         content: string;
+        history_committed?: boolean;
+        file_checkpoint_cleanup_failed?: boolean;
+        warning?: string;
     }>;
     switchBranch(sessionId: string, checkpointId: string): Promise<{
         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/context-attachments.d.ts

@@ -0,0 +1,16 @@
+/** Frozen application data belonging to one message. The server does not interpret business types. */
+export interface ContextAttachment {
+    id: string;
+    label: string;
+    content: string;
+    data?: Record<string, unknown> | null;
+    files?: Array<{
+        name: string;
+        session_id?: string;
+        path?: string;
+    }>;
+}
+/** Validate before persisting a reliable request. JSON cloning also rejects cycles. */
+export declare function snapshotContextAttachments(value: ContextAttachment[]): ContextAttachment[];
+/** Server-owned snapshots travel unchanged through stream and history projections. */
+export declare function normalizeContextAttachments(value: unknown): ContextAttachment[];

package/dist/schemas/event.d.ts

@@ -1,3 +1,4 @@
+import type { ToolEvidence } from "./projection";
 export interface ContentDelta {
     content: string;
     loop_name?: string;
@@ -21,6 +22,7 @@ export interface ToolCallArgumentsDelta {
     arguments_delta: string;
 }
 export interface ToolResultDone {
+    evidence?: ToolEvidence[];
     tool_call_id: string;
     loop_name?: string;
     function: {

package/dist/schemas/message-utils.d.ts

@@ -24,21 +24,15 @@ export declare function buildMessageContent(text: string, attachments: Array<{
     mimeType?: string;
 }>): MessageContent;
 export declare function contentPreview(content: MessageContent, maxLen?: number): string;
-/** `/` 选中的技能当前处于什么状态，决定智能体要不要先装、先加载。 */
+/** @deprecated 技能可用状态由运行时解析，发送身份请使用 SkillRef。 */
 export interface SkillMentionAvailability {
     /** 本地已有（内置 / 技能目录 / 会话已加载），直接可用。 */
     local?: boolean;
     /** Blade Hub 上该账号是否已安装。本地技能恒为 true。 */
     installed?: boolean;
 }
-/**
- * Transform a skill mention into a natural language skill invocation.
- * Strips the `<skill>name</skill>` tag from the raw input and prepends the instruction.
- *
- * Hub 技能装没装、加载没加载，用户不需要知道，但智能体需要——所以把状态翻译
- * 成它能直接照做的 CLI 步骤。不传 availability 时按本地技能处理，与旧行为一致。
- */
-export declare function transformSlashCommand(skillName: string, rawInput: string, { local, installed }?: SkillMentionAvailability): string;
+/** Serialize a skill marker as user text. Send its identity separately in refs. */
+export declare function transformSlashCommand(skillName: string, rawInput: string, _availability?: SkillMentionAvailability): string;
 export interface ParsedTextAttachment {
     name: string;
     uploadedPath?: string;