@blade-hq/agent-client 1.2.1-alpha.2 → 1.2.1-alpha.4

package/README.md

@@ -385,10 +385,10 @@ function Message({ message }: { message: ChatMessage }) {
 - **SDK 身份**：`SDK_NAME`、`SDK_VERSION`
 - **声明式会话**：`SessionDefinition`、`SolutionDefinition`、`SkillDefinition`、`SessionConfig`、`TextFile`、`SessionSetupError`、`SessionSetupStage`
 - **模型目录**：`ModelsResource`、`ModelCatalog`、`ModelOption`
-- **会话资源（REST）**：`SessionsResource`、`CreateSessionRequest`、`AppCliDefinition`、`AppCliAttachment`、`AttachAppOptions`、`PaginatedSessionsResult`、`SessionHistory`、`SessionContextStats`、`ShareLinkResult`、`FileEntry`、`UploadFileEntry`、`UploadFilesOptions`、`SessionProfile`、`SessionDetail`、`SessionInfo`、`SessionStatus`、`SessionPortMapping`、`ModeId`、`TemplateId`、`PrimarySkillSnapshot`、`PrimarySkillParallelMode`
+- **会话资源（REST）**：`SessionsResource`、`CreateSessionRequest`、`ImportSessionOptions`、`AppCliDefinition`、`AppCliAttachment`、`AttachAppOptions`、`PaginatedSessionsResult`、`SessionHistory`、`SessionContextStats`、`ShareLinkResult`、`FileEntry`、`UploadFileEntry`、`UploadFilesOptions`、`SessionProfile`、`SessionDetail`、`SessionInfo`、`SessionStatus`、`SessionPortMapping`、`ModeId`、`TemplateId`、`PrimarySkillSnapshot`、`PrimarySkillParallelMode`
 - **会话状态机**：`SessionHub`、`SessionState`、`SendOptions`、`ConnectionStatus`、`AskUserAnswerData`、`AgentLoopInfo`、`ActiveCompactionState`、`createInitialSessionState`、`AgentSessionEventName`
 - **页面协作**：`EmbeddedChat`、`EmbeddedChatOptions`、`CommandHandler`、`CommandEnvelope`、`InboundAction`、`InboundEnvelope`、`isCommandEnvelope`、`isInboundEnvelope`
 - **消息与投影协议**：`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`ToolBridgeContent`、`CompactionInfo`、`MemoryRefInfo`、`ArchivedFileInfo`、`ArchivedToolCallInfo`、`TurnProjection`、`ContentBlock`、`PatchEnvelope`、`MemoryRef`、`buildMessageContent`、`normalizeMessageContent`、`isHiddenInternalMessage`、`transformSlashCommand`、`extractTextAttachments`、`ParsedTextAttachment`、`ParsedTextContext`
-- **Solution / 任务协议**：`Solution`、`SolutionAppField`、`SolutionAppState`、`SolutionAppUiConfig`、`SolutionRef`、`ExistingSolutionRef`、`PreparedSolution`、`PreparedSolutionAsset`、`LayoutType`、`BizRole`、`TaskStatus`、`BackgroundTask`
+- **Solution / 任务协议**：`Solution`、`SolutionAppField`、`SolutionAppState`、`SolutionAppUiConfig`、`SolutionRef`、`PublishedSolutionRef`、`ExistingSolutionRef`、`PreparedSolution`、`PreparedSolutionAsset`、`LayoutType`、`BizRole`、`TaskStatus`、`BackgroundTask`
 - **Headless**：`HeadlessResource`、`RunOptions`、`RunResult`、`RunTrace`
 - **低层通道（apps/web 等高级集成）**：`createSocket`、`CreateSocketOptions`、`TypedSocket`、`AsrAudioPayload`、`ClientProjectionBuilder`、`RawEvent`

package/dist/index.d.ts

@@ -21,13 +21,13 @@ export type { HeadlessResource } from "./resources/headless";
 export { ModelsResource } from "./resources/models";
 export type { ModelCatalog, ModelOption } from "./resources/models";
 export type { SessionsResource } from "./resources/sessions";
-export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, PaginatedSessionsResult, SessionContextStats, SessionHistory, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
+export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, ImportSessionOptions, PaginatedSessionsResult, SessionContextStats, SessionHistory, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
 export type { ArchivedFileInfo, ArchivedToolCallInfo, ChatMessage, CompactionInfo, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolBridgeContent, ToolCallInfo, } from "./schemas/message";
 export { buildMessageContent, contentPreview, extractTextAttachments, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, isHiddenInternalMessage, normalizeMessageContent, transformSlashCommand, } from "./schemas/message-utils";
 export type { ParsedTextAttachment, ParsedTextContext } from "./schemas/message-utils";
 export type { ContentBlock, MemoryRef, PatchEnvelope, TurnProjection } from "./schemas/projection";
 export { SessionInfo, SessionStatus } from "./schemas/session";
-export type { ModeId, PrimarySkillParallelMode, PrimarySkillSnapshot, SessionDetail, SessionPortMapping, TemplateId, } from "./schemas/session";
+export type { ModeId, PrimarySkillParallelMode, PrimarySkillSnapshot, SessionDetail, SessionPortMapping, PublishedSolutionRef, TemplateId, } from "./schemas/session";
 export { LayoutType } from "./schemas/solution";
 export type { BizRole, Solution, SolutionAppField, SolutionAppState, SolutionAppUiConfig, } from "./schemas/solution";
 export { Task, TaskStatus } from "./schemas/task";

package/dist/index.js

@@ -1841,10 +1841,12 @@ function findLatestAssistant(turns, loopId) {
 
 // src/resources/sessions.ts
 function toCreateSessionPayload(request) {
+  const solutionRef = request.solution_ref ?? externalSolutionRef(request.solution_id);
   return {
     intent: request.intent ?? "",
     template_id: request.template_id,
-    solution_id: request.solution_id,
+    solution_id: solutionRef ? void 0 : request.solution_id,
+    solution_ref: solutionRef,
     biz_role_id: request.biz_role_id ?? null,
     model: request.model ?? null,
     enable_thinking: request.enable_thinking ?? null,
@@ -1853,11 +1855,33 @@ function toCreateSessionPayload(request) {
     env: request.env,
     disable_tools: request.disable_tools ?? null,
     session_solution_asset_id: request.session_solution_asset_id ?? null,
+    solution_snapshot_session_id: request.solution_snapshot_session_id ?? null,
     compaction_ratio: request.compaction_ratio ?? null,
     ...request.runtime_type ? { runtime_type: request.runtime_type } : {},
     ...request.daemon_id ? { daemon_id: request.daemon_id } : {}
   };
 }
+var builtinSolutionIds = /* @__PURE__ */ new Set([
+  "app-dev",
+  "general_chat",
+  "multica",
+  "night_build",
+  "skill_editor",
+  "smart_bid",
+  "solution_generate"
+]);
+function externalSolutionRef(solutionId) {
+  if (!solutionId) return void 0;
+  const normalized = solutionId === "default" ? "general_chat" : solutionId.trim();
+  if (builtinSolutionIds.has(normalized)) {
+    return { source: "builtin", name: normalized };
+  }
+  const parts = normalized.split("/");
+  if (parts.length === 2 && parts.every(Boolean)) {
+    return { source: "hub", org: parts[0], name: parts[1] };
+  }
+  return void 0;
+}
 var SessionsResource = class {
   constructor(client) {
     this.client = client;
@@ -1965,13 +1989,18 @@ var SessionsResource = class {
     offset,
     template_id_prefix,
     solution_id,
+    solution_registry_id,
     q
   }) {
     const searchParams = new URLSearchParams();
     searchParams.set("limit", String(limit));
     searchParams.set("offset", String(offset));
     if (template_id_prefix) searchParams.set("template_id_prefix", template_id_prefix);
-    if (solution_id) searchParams.set("solution_id", solution_id);
+    if (solution_registry_id) {
+      searchParams.set("solution_registry_id", solution_registry_id);
+    } else if (solution_id) {
+      searchParams.set("solution_id", solution_id);
+    }
     const trimmedQuery = q?.trim();
     if (trimmedQuery) searchParams.set("q", trimmedQuery);
     return this.client.json("GET", `/api/sessions?${searchParams.toString()}`);
@@ -2227,11 +2256,23 @@ var SessionsResource = class {
     const res = await this.client.formData("POST", "/api/sessions/preview-import", form);
     return res.json();
   }
-  async importSession(file, name, solutionId) {
+  async importSession(file, name, solutionOverride) {
     const form = new FormData();
     form.append("file", file);
     if (name) form.append("name", name);
-    if (solutionId) form.append("solution_id", solutionId);
+    if (typeof solutionOverride === "string") {
+      if (solutionOverride) form.append("solution_id", solutionOverride);
+    } else if (solutionOverride) {
+      if (solutionOverride.solution_ref) {
+        form.append("solution_ref", JSON.stringify(solutionOverride.solution_ref));
+      }
+      if (solutionOverride.solution_snapshot_session_id) {
+        form.append(
+          "solution_snapshot_session_id",
+          solutionOverride.solution_snapshot_session_id
+        );
+      }
+    }
     const res = await this.client.formData("POST", "/api/sessions/import", form);
     return res.json();
   }
@@ -3953,7 +3994,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "1.2.1-alpha.2" : "1.1.1";
+var SDK_VERSION = true ? "1.2.1-alpha.4" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -4406,6 +4447,7 @@ var SessionInfo = type({
   "model?": "string | null",
   "enable_thinking?": "boolean | null",
   "solution_id?": "string | null",
+  "solution_ref?": "unknown",
   "biz_role_id?": "string | null",
   "solution?": "unknown",
   "plan_summary?": "string | null",