@blade-hq/agent-client 2608.0.6 → 2608.0.7-beta.0

package/dist/resources/auth.d.ts

@@ -16,6 +16,24 @@ export interface ProvidersResponse {
     }>;
     password_enabled: boolean;
 }
+export interface ExchangeCodeParams {
+    /** 授权回调页 postMessage 回来的一次性 code。 */
+    code: string;
+    /** 发起授权时用的 state，必须原样传回。 */
+    state: string;
+    /** 发起授权的页面 origin，要和 authorize 时传的 `client_origin` 完全一致。 */
+    clientOrigin: string;
+}
+export interface ExchangeCodeResult {
+    access_token: string;
+    token_type: string;
+    user: {
+        id: string;
+        username: string;
+        display_name: string;
+        avatar_url: string | null;
+    };
+}
 export declare class AuthResource {
     private client;
     constructor(client: BladeClient);
@@ -24,6 +42,14 @@ export declare class AuthResource {
      * 自动取得 PAT 并热挂载到当前 client。等价于 client.login()。
      */
     login(options?: LoginOptions): Promise<LoginResult>;
+    /**
+     * 用一次性 code 换 PAT。给**服务端**用：浏览器把 code 交给你自己的后端，
+     * 后端换到的 PAT 不进浏览器。浏览器里直接用 `login()` 就够了。
+     *
+     * 服务端调用时会自己补上 `Origin` 头（浏览器会自动带，服务端不会，缺了
+     * 后端报 `missing_request_origin`）。
+     */
+    exchangeCode(params: ExchangeCodeParams): Promise<ExchangeCodeResult>;
     /** 清除 login() 存储的令牌。 */
     logoutToken(): void;
     getProviders(): Promise<ProvidersResponse>;

package/dist/resources/models.d.ts

@@ -2,10 +2,32 @@ import type { BladeClient } from "../blade-client";
 export interface ModelOption {
     id: string;
     label: string;
+    /**
+     * 把这个模型发给 `baseUrl` 时该用的名字。`id` 是平台内部标识，接了多个模型服务时
+     * 形如 `provider-xxx::name`，直接发过去会被拒。不在 `baseUrl` 那个服务上的模型
+     * 这里是空串——自己做模型选择器时据此过滤。
+     */
+    serviceModelId?: string;
 }
 export interface ModelCatalog {
     default: string;
     models: ModelOption[];
+    /**
+     * 平台默认模型服务的 OpenAI 兼容地址（Server ≥ 提供 `baseUrl` 的版本才有，否则为空）。
+     * 自建应用可以带用户的 PAT 直接调它，不必让用户自己填地址——网关端口各部署不同，
+     * 推算不出来。
+     *
+     * 这是**服务端视角**的地址：平台可能配的是 `http://127.0.0.1:30000/v1`，从自己后端
+     * 转发没问题，直接丢给浏览器就指向用户自己的机器了。默认形态是后端透传（密钥也不该
+     * 进浏览器），浏览器直连只适合这个地址对浏览器同样可达的场景。
+     */
+    baseUrl?: string;
+    /**
+     * 直接调 `baseUrl` 时该用的默认模型名。**不要用 `default`**——那是平台内部标识，
+     * 平台默认模型来自额外接的模型服务时它带 `provider-xxx::` 前缀，发过去只会得到
+     * 「模型不存在」。没有可直调的模型时为空串。
+     */
+    defaultServiceModel?: string;
 }
 /** Server 可供当前用户选择的模型目录。 */
 export declare class ModelsResource {

package/dist/resources/sessions.d.ts

@@ -1,6 +1,6 @@
 import type { BackgroundTask, BackgroundTaskStopResult } from "../schemas/background";
 import type { TurnProjection } from "../schemas/projection";
-import type { PublishedSolutionRef, SessionDetail, SessionInfo, TemplateId } from "../schemas/session";
+import type { PublishedSolutionRef, ReplayPreview, ReplaySpeed, 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";
@@ -90,6 +90,26 @@ export interface PaginatedSessionsResult {
     offset: number;
     content_match_truncated?: boolean;
 }
+export interface GlobalSearchConversationResult {
+    type: "conversation";
+    session: SessionInfo;
+    snippet: string;
+    matched: "title" | "content";
+}
+export interface GlobalSearchFileResult {
+    type: "file";
+    session: SessionInfo;
+    path: string;
+    name: string;
+    snippet: string;
+    matched: "name" | "path";
+}
+export type GlobalSearchResultItem = GlobalSearchConversationResult | GlobalSearchFileResult;
+export interface GlobalSearchResult {
+    items: GlobalSearchResultItem[];
+    truncated: boolean;
+    indexing: boolean;
+}
 export interface SkillDevSession {
     session: SessionInfo;
     skill_id: string;
@@ -106,6 +126,17 @@ export interface SessionContextStats {
     context_window: number;
     compaction_ratio: number;
 }
+export type ResultFeedbackReason = "not_solved" | "inaccurate" | "incomplete" | "needs_major_changes" | "too_slow" | "other";
+export interface ResultFeedback {
+    session_id: string;
+    assistant_entry_id: string;
+    surface: "chat" | "software_factory" | "unknown";
+    project_id: string | null;
+    helpful: boolean;
+    reason: ResultFeedbackReason | null;
+    created_at: string;
+    updated_at: string;
+}
 export interface FileEntry {
     name: string;
     path: string;
@@ -185,6 +216,10 @@ export declare class SessionsResource {
         q?: string;
     }): Promise<PaginatedSessionsResult>;
     listSessionsWithSkillData(): Promise<SkillDevSession[]>;
+    searchOwnedContent(params: {
+        q: string;
+        limit?: number;
+    }): Promise<GlobalSearchResult>;
     createSession(intent?: string, template_id?: TemplateId, primary_skill_id?: string | null): Promise<{
         session_id: string;
     }>;
@@ -203,15 +238,17 @@ export declare class SessionsResource {
     }): Promise<SessionDetail>;
     setSessionEnv(sessionId: string, env: Record<string, string>): Promise<SessionDetail>;
     pinSession(sessionId: string, pinned: boolean): Promise<SessionInfo>;
-    startReplaySession(sourceSessionId: string, speed?: 1 | 2 | 5): Promise<{
+    startReplaySession(sourceSessionId: string, speed?: ReplaySpeed): Promise<{
         session_id: string;
     }>;
     updateReplaySession(sessionId: string, payload: {
-        speed?: 1 | 2 | 5;
+        speed?: ReplaySpeed;
         status?: "autonomous";
     }): Promise<{
         replay_state: SessionInfo["replay_state"];
     }>;
+    /** 查询会话能否作为回放来源；不支持时 reason 可直接展示，用来提前禁用入口。 */
+    getReplayPreview(sessionId: string): Promise<ReplayPreview>;
     updateSharing(sessionId: string, shared: boolean): Promise<{
         shared: boolean;
     }>;
@@ -225,6 +262,11 @@ export declare class SessionsResource {
     getSharedSession(token: string): Promise<TurnProjection[]>;
     getSessionTasks(sessionId: string): Promise<Task[]>;
     getSessionTurns(sessionId: string): Promise<TurnProjection[]>;
+    listResultFeedback(sessionId: string): Promise<ResultFeedback[]>;
+    putResultFeedback(sessionId: string, assistantEntryId: string, feedback: {
+        helpful: boolean;
+        reason?: ResultFeedbackReason | null;
+    }): Promise<ResultFeedback>;
     getSessionContextStats(sessionId: string, init?: RequestInit): Promise<SessionContextStats>;
     getSessionHistory(sessionId: string, init?: RequestInit): Promise<SessionHistory>;
     tokenizePrompt(prompt: string, model?: string): Promise<TokenizeResult>;

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

@@ -12,11 +12,21 @@ export declare function buildMessageContent(text: string, attachments: Array<{
     mimeType?: string;
 }>): MessageContent;
 export declare function contentPreview(content: MessageContent, maxLen?: number): string;
+/** `/` 选中的技能当前处于什么状态，决定智能体要不要先装、先加载。 */
+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): string;
+export declare function transformSlashCommand(skillName: string, rawInput: string, { local, installed }?: SkillMentionAvailability): string;
 export interface ParsedTextAttachment {
     name: string;
     uploadedPath?: string;

package/dist/schemas/message.d.ts

@@ -70,6 +70,8 @@ export interface ChatMessage {
     duration_ms?: number;
     timestamp?: string;
     entry_id?: string;
+    /** Stable React key retained when an optimistic user message is confirmed. */
+    render_id?: string;
     parent_id?: string | null;
     loop_name?: string;
     /** Entry kind from backend -- present for non-message entries like mode changes. */

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

@@ -0,0 +1,3 @@
+import type { PostChatFollowup, TurnProjection } from "./projection";
+/** 返回最新根会话轮次的小结；新用户消息到达后旧小结立即失效。 */
+export declare function latestPostChatFollowup(turns: TurnProjection[]): PostChatFollowup | null;

package/dist/schemas/projection.d.ts

@@ -29,6 +29,19 @@ export interface MemoryRef {
     content_preview: string;
     skill_name?: string | null;
 }
+export interface FinalArtifact {
+    kind: "file" | "link";
+    target: string;
+    label: string;
+}
+export interface PostChatFollowup {
+    assistant_entry_id: string;
+    recaption?: string;
+    suggestions: string[];
+    final_artifacts?: FinalArtifact[];
+    feedback_eligible: boolean;
+    feedback_scope: "latest_result";
+}
 export interface TurnProjection {
     id: string;
     sequence: number;
@@ -46,6 +59,8 @@ export interface TurnProjection {
     context_window?: number;
     memory_refs?: MemoryRef[] | null;
     parent_fork_tool_call_id?: string | null;
+    /** Client-only stable identity for reconciling an optimistic user turn. */
+    client_render_id?: string | null;
     compaction_id?: string | null;
     summary_preview?: string | null;
     summary_full?: string | null;
@@ -58,6 +73,7 @@ export interface TurnProjection {
     trigger?: "auto" | "manual" | "forced_retry" | null;
     failure_reason?: string | null;
     fallback_applied?: boolean | null;
+    post_chat_followup?: PostChatFollowup | null;
 }
 export interface ArchivedFileInfo {
     tool_name?: string | null;

package/dist/schemas/session.d.ts

@@ -12,14 +12,31 @@ export type PublishedSolutionRef = {
     org: string;
     name: string;
 };
+/** 回放时录制内容的播放倍速。 */
+export type ReplaySpeed = 1 | 2 | 5;
+/**
+ * 新建回放会话时的默认倍速。
+ *
+ * 所有创建入口都用它——曾经侧栏走 API 默认 5x、设置菜单初始化成 1x，
+ * 同一个源对话从不同入口开出来速度不一样。
+ */
+export declare const DEFAULT_REPLAY_SPEED: ReplaySpeed;
 export interface ReplayState {
     source_session_id?: string;
     status?: "replay" | "autonomous";
-    speed?: 1 | 2 | 5;
+    speed?: ReplaySpeed;
     next_source_entry_id?: string | null;
     ended_at?: string | null;
     autonomous_reason?: string | null;
 }
+/** 某个会话能否作为回放来源。 */
+export interface ReplayPreview {
+    session_id: string;
+    intent?: string | null;
+    supported: boolean;
+    /** supported 为 false 时给出的原因，可直接展示给用户。 */
+    reason?: string | null;
+}
 export interface SessionPortMapping {
     container_port: number;
     host_port: number;

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

@@ -1,17 +1,27 @@
 import { type RawEvent } from "../shared/projection";
 import type { MessageContent } from "../schemas/message";
 import type { PatchEnvelope, TurnProjection } from "../schemas/projection";
-import type { SessionStatus } from "../schemas/session";
+import type { ReplaySpeed, ReplayState, SessionStatus } from "../schemas/session";
 import { type CommandHandler } from "../commands/registry";
 import { type AgentSessionEvents } from "./events";
 import type { AppCliAttachment, AppCliDefinition, FileEntry } from "../resources/sessions";
 import { type ConnectionStatus, type SessionState } from "./state";
 /** SessionHub 注入给 AgentSession 的运行时依赖（socket 收发 + REST 补数）。 */
 export interface SessionRuntime {
+    streamTokens: boolean;
     emitEvent(event: string, data: unknown): void;
     emitWithAck(event: string, data: unknown, timeoutMs: number): Promise<Record<string, unknown> | undefined>;
     ensureConnected(): void;
     fetchTurns(sessionId: string): Promise<TurnProjection[]>;
+    /** 会话详情，目前只用来取回放状态。 */
+    fetchSessionInfo(sessionId: string): Promise<{
+        replay_state?: ReplayState | null;
+        viewer_role?: "owner" | "viewer";
+    }>;
+    updateReplay(sessionId: string, payload: {
+        speed?: ReplaySpeed;
+        status?: "autonomous";
+    }): Promise<ReplayState | null>;
     listDir(sessionId: string, dirPath: string): Promise<FileEntry[]>;
     countFiles(sessionId: string, dirPath?: string): Promise<number>;
     downloadFile(sessionId: string, filePath: string, downloadName?: string): Promise<void>;
@@ -65,6 +75,7 @@ export declare class AgentSession {
     private patchFlushCancel;
     private joined;
     private joinPending;
+    private replayQueue;
     private pendingReplayMessage;
     private pendingReplayMode;
     private recentChatEndAt;
@@ -139,6 +150,16 @@ export declare class AgentSession {
     _rejoinAfterReconnect(): Promise<void>;
     /** @internal 首次连接：加载历史 + 加入房间。 */
     _bootstrap(): Promise<void>;
+    /** 改回放是 owner 专属（服务端 PATCH 走 _get_owned_session）。 */
+    private get canControlReplay();
+    /** 拉一次会话详情，填回放状态和只读身份；失败按非回放会话处理，不挡启动。 */
+    private syncReplayFromSession;
+    /** 调整回放倍速；不是回放会话、或只读身份时什么都不做。 */
+    setReplaySpeed(speed: ReplaySpeed): Promise<void>;
+    /** 退出回放，之后的对话交给真实模型运行；不是回放会话、或只读身份时什么都不做。 */
+    exitReplay(): Promise<void>;
+    /** 把一次回放控制请求排进队列；前一个完成后才发出，响应直接安装。 */
+    private applyReplayControl;
     /** @internal */
     _handleTurnStart(turn: TurnProjection): void;
     /** @internal */
@@ -182,6 +203,7 @@ export declare class AgentSession {
     _applyRunningState(isRunning: boolean): void;
     private markRunningIfIdle;
     private finishStreaming;
+    private completeChat;
     private applyTurn;
     private schedulePatchFlush;
     private cancelPatchFlush;

package/dist/session/state.d.ts

@@ -1,6 +1,6 @@
 import type { ChatMessage, CompactionInfo, MessageContent } from "../schemas/message";
 import type { ContentBlock, PatchEnvelope, TurnProjection } from "../schemas/projection";
-import type { SessionStatus } from "../schemas/session";
+import type { ReplaySpeed, ReplayState, SessionStatus } from "../schemas/session";
 /** 一次 AskUserQuestion 的用户作答（选项选择 + 自定义输入）。 */
 export interface AskUserAnswerData {
     selections: Record<number, number[]>;
@@ -39,9 +39,23 @@ export interface SessionState {
     askAnswers: Record<string, AskUserAnswerData>;
     agentLoops: Record<string, AgentLoopInfo>;
     activeCompaction: ActiveCompactionState | null;
+    /** 回放（演示 / 彩排）状态；不是回放会话时为 null。 */
+    replay: ReplaySnapshot | null;
+    /** 当前身份对这个会话的权限；"viewer" 表示只读（分享链接打开的）。 */
+    viewerRole: "owner" | "viewer" | null;
 }
+/** 回放会话的快照视图，由服务端的 replay_state 归一化而来。 */
+export interface ReplaySnapshot {
+    /** 仍在按录制内容走；转自主运行后为 false。 */
+    isReplay: boolean;
+    speed: ReplaySpeed;
+    sourceSessionId: string | null;
+}
+/** 把服务端的 replay_state 归一化成快照；不是回放会话时返回 null。 */
+export declare function toReplaySnapshot(raw: ReplayState | null | undefined): ReplaySnapshot | null;
 export declare function createInitialSessionState(sessionId: string): SessionState;
 export declare function extractModeFromBlocks(blocks: ContentBlock[]): "planning" | "executing" | null;
+export declare function reconcileOptimisticUserTurns(currentTurns: TurnProjection[], incomingTurns: TurnProjection[]): TurnProjection[];
 /**
  * 用一份新的 turn 列表重建会话状态。
  * addErrorMessage 注入的 role==="error" 消息不在 turns 里，默认会被物化过程抹掉；

package/dist/shared/projection/builder.d.ts

@@ -13,6 +13,11 @@ export type ProjectionUpdate = {
     toolName?: string;
     workspacePath?: string;
 };
+/**
+ * 缺失 chat:end 时的终态兜底。只有被投影接受到当前 assistant turn 的 followup
+ * 才能结束流式态；陈旧 followup 或其后已有新轮事件时均返回 false。
+ */
+export declare function acceptedPostChatFollowupCompletesLatestRun(events: RawEvent[], updates: ProjectionUpdate[]): boolean;
 export declare class ClientProjectionBuilder {
     private activeTurns;
     private lastTurnIds;

package/dist/shared/projection/helpers.d.ts

@@ -26,6 +26,13 @@ export declare function sourceLoopFor(loopId: string, loopDescriptions: Map<stri
     loop_name: string;
     description: string;
 } | null;
+/** 本轮交付给用户的成果：工作区里的文件，或可以打开的网址。 */
+export interface FinalArtifact {
+    kind: "file" | "link";
+    /** file 是文件路径（相对工作目录或容器内绝对路径）；link 是 http/https 网址。 */
+    target: string;
+    label: string;
+}
 /**
  * Shared by the streaming and history channels — both must decide "is this
  * follow-up showable" identically. Returns null when there is nothing to show.
@@ -34,6 +41,9 @@ export declare function normalizePostChatFollowup(data: Record<string, unknown>,
     assistant_entry_id: string;
     recaption: string;
     suggestions: string[];
+    final_artifacts: FinalArtifact[];
+    feedback_eligible: boolean;
+    feedback_scope: "latest_result";
 } | null;
 export declare function normalizeChildPause(pausePayload: Record<string, unknown>): {
     pauseToolData: Record<string, unknown>;

package/dist/shared/projection/index.d.ts

@@ -1,3 +1,3 @@
-export { ClientProjectionBuilder, type RawEvent, type ProjectionUpdate } from "./builder";
+export { acceptedPostChatFollowupCompletesLatestRun, ClientProjectionBuilder, type RawEvent, type ProjectionUpdate, } from "./builder";
 export { type TurnState, createTurnState, snapshot, PAUSE_TOOL_NAMES } from "./state";
 export { projectHistory, type RawHistoryEntry } from "./history";

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

@@ -93,12 +93,14 @@ export declare namespace SessionSubscribePayloadSchema {
     type EventFormat = "raw";
     type AfterSequence = number;
     type Resume = boolean;
+    type StreamTokens = boolean;
     interface SessionSubscribePayload {
         session_id: SessionId;
         mode?: Mode;
         event_format?: EventFormat;
         after_sequence?: AfterSequence;
         resume?: Resume;
+        stream_tokens?: StreamTokens;
         [k: string]: unknown;
     }
 }
@@ -114,6 +116,7 @@ export declare namespace SessionSubscribeBatchPayloadSchema {
     type EventFormat = "raw";
     type AfterSequence = number;
     type Resume = boolean;
+    type StreamTokens = boolean;
     interface SessionSubscribeBatchPayload {
         sessions: Sessions;
         [k: string]: unknown;
@@ -124,6 +127,7 @@ export declare namespace SessionSubscribeBatchPayloadSchema {
         event_format?: EventFormat;
         after_sequence?: AfterSequence;
         resume?: Resume;
+        stream_tokens?: StreamTokens;
         [k: string]: unknown;
     }
 }
@@ -154,8 +158,10 @@ export declare namespace AgentBoardProjectUnsubscribePayloadSchema {
 export type AgentBoardProjectUnsubscribePayload = AgentBoardProjectUnsubscribePayloadSchema.AgentBoardProjectUnsubscribePayload;
 export declare namespace ChatStartPayloadSchema {
     type SessionId = (string | null);
+    type ChatRunId = (string | null);
     interface ChatStartPayload {
         session_id?: SessionId;
+        chat_run_id?: ChatRunId;
         [k: string]: unknown;
     }
 }

package/package.json

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