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

package/dist/resources/sessions.d.ts

@@ -1,6 +1,6 @@
 import type { BackgroundTask } from "../schemas/background";
 import type { TurnProjection } from "../schemas/projection";
-import type { SessionDetail, SessionInfo, TemplateId } from "../schemas/session";
+import type { PublishedSolutionRef, SessionDetail, SessionInfo, TemplateId } from "../schemas/session";
 import type { Task } from "../schemas/task";
 import type { BladeClient, UploadProgress } from "../blade-client";
 import type { AgentSession } from "../session/agent-session";
@@ -9,7 +9,12 @@ import type { SessionProfile } from "../types/sdk-profile";
 export interface CreateSessionRequest {
     intent?: string;
     template_id?: TemplateId;
+    /** 正式 Solution 来源。Hub 使用 { source: "hub", org, name }。 */
+    solution_ref?: PublishedSolutionRef;
+    /** @deprecated 请使用结构化的 solution_ref；继续支持以保证现有 SDK 调用无感升级。 */
     solution_id?: string;
+    /** 从已有会话复制其不可变 Solution 与 Skill 运行快照。 */
+    solution_snapshot_session_id?: string;
     biz_role_id?: string | null;
     primary_skill_id?: string | null;
     model?: string | null;
@@ -150,6 +155,12 @@ export interface ImportPreview {
     skills: ImportPreviewSkill[];
     scenario: ImportPreviewScenario | null;
 }
+export interface ImportSessionOptions {
+    /** 导入后改用这个正式 Solution 的最新版。 */
+    solution_ref?: PublishedSolutionRef;
+    /** 导入后改用已有会话的完整运行快照。 */
+    solution_snapshot_session_id?: string;
+}
 export declare class SessionsResource {
     private client;
     constructor(client: BladeClient);
@@ -170,6 +181,7 @@ export declare class SessionsResource {
         offset: number;
         template_id_prefix?: string;
         solution_id?: string;
+        solution_registry_id?: string;
         q?: string;
     }): Promise<PaginatedSessionsResult>;
     listSessionsWithSkillData(): Promise<SkillDevSession[]>;
@@ -285,7 +297,7 @@ export declare class SessionsResource {
     getDownloadDirUrl(sessionId: string, dirPath: string): string;
     exportSession(sessionId: string): Promise<void>;
     previewImport(file: File): Promise<ImportPreview>;
-    importSession(file: File, name?: string, solutionId?: string | null): Promise<{
+    importSession(file: File, name?: string, solutionOverride?: string | null | ImportSessionOptions): Promise<{
         session_id: string;
     }>;
 }

package/dist/schemas/session.d.ts

@@ -4,6 +4,14 @@ export type SessionStatus = typeof SessionStatus.infer;
 export type TemplateId = "default" | "skill_editor" | "ship_attack";
 export type SkillEditorTemplateId = "skill_editor";
 export type ModeId = "planning" | "executing";
+export type PublishedSolutionRef = {
+    source: "builtin";
+    name: string;
+} | {
+    source: "hub";
+    org: string;
+    name: string;
+};
 export interface ReplayState {
     source_session_id?: string;
     status?: "replay" | "autonomous";
@@ -43,6 +51,7 @@ export declare const SessionInfo: import("arktype/internal/variants/object.ts").
     model?: string | null | undefined;
     enable_thinking?: boolean | null | undefined;
     solution_id?: string | null | undefined;
+    solution_ref?: unknown;
     biz_role_id?: string | null | undefined;
     solution?: unknown;
     plan_summary?: string | null | undefined;
@@ -69,6 +78,7 @@ export type SessionInfo = Omit<typeof SessionInfo.infer, "template_id" | "soluti
     model?: string | null;
     enable_thinking?: boolean | null;
     solution_id?: string | null;
+    solution_ref?: PublishedSolutionRef | null;
     biz_role_id?: string | null;
     solution?: Solution | null;
     primary_skill_id?: string | null;

package/package.json

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

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 114 个公开声明。
+共 116 个公开声明。
 
 ## `ActiveCompactionState` (interface)
 
@@ -349,6 +349,8 @@ primary_skill_id: string | null | undefined
 runtime_type: "sandbox" | "daemon" | null | undefined
 session_solution_asset_id: string | null | undefined
 solution_id: string | undefined
+solution_ref: PublishedSolutionRef | undefined
+solution_snapshot_session_id: string | undefined
 template_id: TemplateId | undefined
 ```
 
@@ -454,6 +456,13 @@ image_url: { url: string; }
 type: "image_url"
 ```
 
+## `ImportSessionOptions` (interface)
+
+```ts
+solution_ref: PublishedSolutionRef | undefined
+solution_snapshot_session_id: string | undefined
+```
+
 ## `InboundAction` (type)
 
 ```ts
@@ -657,6 +666,14 @@ password_enabled: boolean
 providers: { name: string; authorize_url: string; }[]
 ```
 
+## `PublishedSolutionRef` (type)
+
+```ts
+export type PublishedSolutionRef =
+  | { source: "builtin"; name: string }
+  | { source: "hub"; org: string; name: string }
+```
+
 ## `RawEvent` (interface)
 
 ```ts
@@ -775,6 +792,7 @@ runtime_type: string | null | undefined
 shared: boolean | undefined
 solution: Solution | null | undefined
 solution_id: string | null | undefined
+solution_ref: PublishedSolutionRef | null | undefined
 status: "completed" | "failed" | "interrupted" | "running" | "created" | "waiting_for_input"
 template_id: TemplateId | null | undefined
 updated_at: string
@@ -823,6 +841,7 @@ 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",
@@ -905,11 +924,11 @@ getSessionHistory: (sessionId: string, init?: RequestInit) => Promise<SessionHis
 getSessionTasks: (sessionId: string) => Promise<Task[]>
 getSessionTurns: (sessionId: string) => Promise<TurnProjection[]>
 getSharedSession: (token: string) => Promise<TurnProjection[]>
-importSession: (file: File, name?: string, solutionId?: string | null) => Promise<{ session_id: string; }>
+importSession: (file: File, name?: string, solutionOverride?: string | null | ImportSessionOptions) => Promise<{ session_id: string; }>
 listBackgroundTasks: (sessionId: string, init?: RequestInit) => Promise<BackgroundTask[]>
 listDir: (sessionId: string, dirPath: string) => Promise<FileEntry[]>
 listSessions: (template_id_prefix?: string, solution_id?: string) => Promise<SessionInfo[]>
-listSessionsPaginated: (params: { limit: number; offset: number; template_id_prefix?: string; solution_id?: string; q?: string; }) => Promise<PaginatedSessionsResult>
+listSessionsPaginated: (params: { limit: number; offset: number; template_id_prefix?: string; solution_id?: string; solution_registry_id?: string; q?: string; }) => Promise<PaginatedSessionsResult>
 listSessionsWithSkillData: () => Promise<SkillDevSession[]>
 pinSession: (sessionId: string, pinned: boolean) => Promise<SessionInfo>
 previewImport: (file: File) => Promise<ImportPreview>