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

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;

package/dist/schemas/message.d.ts

@@ -1,4 +1,4 @@
-import type { ContentBlock, PendingQuestionRef, ToolBridgeContent } from "./projection";
+import type { ToolEvidence, ContentBlock, PendingQuestionRef, ToolBridgeContent } from "./projection";
 import type { ContextProjectionData } from "./context";
 export interface TextContentPart {
     type: "text";
@@ -20,7 +20,19 @@ export interface FileContentPart {
 }
 export type MessageContentPart = TextContentPart | ImageUrlContentPart | FileContentPart;
 export type MessageContent = string | MessageContentPart[];
+/** 固定流程解释执行落史的一步(workflow:run 专用):刷新后时间线从这里重建。 */
+export interface WorkflowStepInfo {
+    step_id: string;
+    desc?: string;
+    step_kind?: string;
+    status?: string;
+    output?: string;
+    /** 直播时的先后:步骤宣告与它的输出/失败行(条目按终态落盘,重建按这两个值排回去) */
+    seq?: number;
+    log_seq?: number;
+}
 export interface ToolCallInfo {
+    evidence?: ToolEvidence[];
     id: string;
     name: string;
     display_name?: string | null;
@@ -29,6 +41,7 @@ export interface ToolCallInfo {
     status?: "pending" | "done" | "error" | "cancelled" | "awaiting_answer";
     duration_ms?: number | null;
     pending_question_ref?: PendingQuestionRef | null;
+    workflow_steps?: WorkflowStepInfo[] | null;
 }
 export type { ToolBridgeContent };
 /** Derive tool status from the result content string. */
@@ -74,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;
@@ -81,6 +95,9 @@ export interface ChatMessage {
     /** Entry kind from backend -- present for non-message entries like mode changes. */
     kind?: string;
     /** Memory references injected into this turn's context */
+    refs?: import("./plugin-refs").MessageRef[];
+    context_attachments?: import("./context-attachments").ContextAttachment[];
+    topic_asset_refs?: import("./topic-assets").TopicAssetRef[];
     memory_refs?: MemoryRefInfo[];
     /** Raw projection blocks for block-level UI rendering. */
     blocks?: ContentBlock[];

package/dist/schemas/plugin-refs.d.ts

@@ -0,0 +1,15 @@
+export interface PluginRef {
+    provider: "plugin";
+    plugin: string;
+    server: string;
+    id: string;
+    label: string;
+}
+export declare function normalizePluginRefs(value: unknown): PluginRef[];
+export interface SkillRef {
+    provider: "skill";
+    id: string;
+    label: string;
+}
+export type MessageRef = PluginRef | SkillRef;
+export declare function normalizeMessageRefs(value: unknown): MessageRef[];

package/dist/schemas/projection.d.ts

@@ -25,7 +25,34 @@ export interface RunTiming {
     duration_ms?: number | null;
     status: "completed" | "failed" | "cancelled" | "paused" | "incomplete";
 }
+/** 固定流程解释执行时落史的一步:刷新/重启后时间线的真相源。 */
+export interface WorkflowStepProjection {
+    step_id: string;
+    desc?: string;
+    step_kind?: string;
+    status?: string;
+    output?: string;
+    /** 直播时的先后:步骤宣告与它的输出/失败行(条目按终态落盘,重建按这两个值排回去) */
+    seq?: number;
+    log_seq?: number;
+}
+export interface ToolEvidence {
+    n: number;
+    id: string;
+    title: string;
+    text: string;
+    url?: string;
+    plugin: string;
+    server: string;
+    source: string;
+    digest: string;
+    tool_call_id: string;
+    parent_tool_call_id?: string;
+    loop: string;
+    branch: string;
+}
 export interface ToolCallProjection {
+    evidence?: ToolEvidence[];
     id: string;
     tool_name: string;
     display_name: string;
@@ -39,6 +66,7 @@ export interface ToolCallProjection {
     /** 该工具派生的子智能体运行区间，仅作外层展示。 */
     subagent_runs?: RunTiming[];
     pending_question_ref?: PendingQuestionRef | null;
+    workflow_steps?: WorkflowStepProjection[] | null;
 }
 export interface MemoryRef {
     id: number;
@@ -80,6 +108,9 @@ export interface TurnProjection {
     /** started_at 是否来自生产者上报（而非旧会话的落盘回落）。瀑布只承认前者。 */
     has_reported_timing?: boolean;
     context_window?: number;
+    refs?: import("./plugin-refs").MessageRef[] | null;
+    context_attachments?: import("./context-attachments").ContextAttachment[];
+    topic_asset_refs?: import("./topic-assets").TopicAssetRef[] | null;
     memory_refs?: MemoryRef[] | null;
     parent_fork_tool_call_id?: string | null;
     context_kind?: string | null;

package/dist/schemas/session.d.ts

@@ -1,8 +1,6 @@
 import type { Solution } from "./solution";
 export declare const SessionStatus: import("arktype/internal/variants/string.ts").StringType<"completed" | "created" | "failed" | "interrupted" | "running" | "waiting_for_input", {}>;
 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";
@@ -60,12 +58,12 @@ 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;
     is_headless?: boolean | undefined;
     viewer_role?: "owner" | "viewer" | undefined;
-    template_id?: string | null | undefined;
     model?: string | null | undefined;
     enable_thinking?: boolean | null | undefined;
     solution_id?: string | null | undefined;
@@ -73,8 +71,6 @@ export declare const SessionInfo: import("arktype/internal/variants/object.ts").
     biz_role_id?: string | null | undefined;
     solution?: unknown;
     plan_summary?: string | null | undefined;
-    primary_skill_id?: string | null | undefined;
-    bound_skill_id?: string | null | undefined;
     replay_state?: unknown;
     is_pinned?: boolean | undefined;
     pinned_at?: string | null | undefined;
@@ -90,21 +86,18 @@ export declare const SessionInfo: import("arktype/internal/variants/object.ts").
     chat_group_id?: string | null | undefined;
     match?: unknown;
 }, {}>;
-export type SessionInfo = Omit<typeof SessionInfo.infer, "template_id" | "solution" | "ports" | "match"> & {
+export type SessionInfo = Omit<typeof SessionInfo.infer, "solution" | "ports" | "match"> & {
     shared?: boolean;
     memory_enabled?: boolean;
     is_persistent?: boolean;
     is_headless?: boolean;
     viewer_role?: "owner" | "viewer";
-    template_id?: TemplateId | null;
     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;
-    bound_skill_id?: string | null;
     replay_state?: ReplayState | null;
     is_pinned?: boolean;
     pinned_at?: string | null;
@@ -121,40 +114,7 @@ export type SessionInfo = Omit<typeof SessionInfo.infer, "template_id" | "soluti
     /** 仅在带 q 搜索的列表响应中出现；普通列表里此字段缺省。 */
     match?: SessionSearchMatch | null;
 };
-/**
- * 主 skill 配置快照（v2）。创建 session 时从 SKILL.md frontmatter 抽出并
- * 固化到 session_root/.blade/primary-skill.json；ship-attack 页面骨架的唯
- * 一数据源。
- */
-export interface PrimarySkillStepSpec {
-    n: number;
-    label: string;
-}
-export interface PrimarySkillStageSpec {
-    id: string;
-    name: string;
-    steps: PrimarySkillStepSpec[];
-}
-export interface PrimarySkillParallelMode {
-    id: string;
-    name: string;
-    prompt_hint: string;
-}
-export interface PrimarySkillSnapshot {
-    version: number;
-    skill_id: string;
-    title: string;
-    description: string;
-    stages: PrimarySkillStageSpec[];
-    parallel_modes: PrimarySkillParallelMode[];
-    captured_at: string;
-}
-/**
- * 单 session detail（GET /api/sessions/:id）。列表接口返回 SessionInfo，
- * detail 在此基础上附加 primary_skill_snapshot。
- */
 export interface SessionDetail extends SessionInfo {
-    primary_skill_snapshot?: PrimarySkillSnapshot | null;
     preview_url?: string | null;
     /**
      * 会话级环境变量（owner-only）。后端仅在 GET detail 和 PUT /env 响应中返回，

package/dist/schemas/topic-assets.d.ts

@@ -0,0 +1,7 @@
+/** An explicit asset selection for one user message, never a persistent session choice. */
+export interface TopicAssetRef {
+    topic_id: string;
+    path: string;
+}
+/** Read display identities only. The server rechecks access and resolves current metadata. */
+export declare function normalizeTopicAssetRefs(value: unknown): TopicAssetRef[];

package/dist/server-clock.d.ts

@@ -0,0 +1,2 @@
+export declare function syncServerTime(client: object, timestamp: unknown, receivedAt?: number): void;
+export declare function getServerTime(client: object | null, now?: number): number | null;

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

@@ -1,3 +1,5 @@
+import { type ContextAttachment } from "../schemas/context-attachments";
+import type { TopicAssetRef } from "../schemas/topic-assets";
 import { type RawEvent } from "../shared/projection";
 import type { MessageContent } from "../schemas/message";
 import type { PatchEnvelope, TurnProjection } from "../schemas/projection";
@@ -57,6 +59,7 @@ export interface AttachAppOptions {
     getContext: () => Record<string, unknown> | Promise<Record<string, unknown>>;
 }
 export interface SendOptions {
+    contextAttachments?: ContextAttachment[];
     /** planning / executing 模式。 */
     mode?: string;
     /** AskUserQuestion 的作答（tool_call_id + 选项）。 */
@@ -74,13 +77,37 @@ export interface SendOptions {
     };
     replayDecision?: "keep_replay" | "continue_replay";
     /** 用户显式选择的知识库 id；后端将元信息作为 once Context 提供给模型。 */
-    kbIds?: number[];
+    /** Explicit topic assets for this message only. */
+    refs?: import("../schemas/plugin-refs").MessageRef[];
+    topicAssetRefs?: TopicAssetRef[];
     /**
      * 声明"会话在跑就把这条消息放进等待队列"。默认不排队、运行中直接报错：
      * 是否真的入队由服务端按运行状态判定（等待回答时发送即作答，不会被误排队）。
      */
     queueWhenRunning?: boolean;
 }
+/** Durable text input with message-scoped application data. Persist this JSON value before calling sendPrepared. */
+export interface PreparedSend {
+    sessionId: string;
+    requestId: string;
+    content: string;
+    options: PreparedSendOptions;
+}
+export interface PreparedSendOptions {
+    contextAttachments?: ContextAttachment[];
+    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 订阅、历史 + 流式合流、断线补数，
@@ -90,6 +117,7 @@ export declare function sessionStatusFromChatEnd(status: string | undefined): Se
  * 状态完全归属实例：同一页面创建多个 AgentSession 互不干扰。
  */
 export declare class AgentSession {
+    private readonly logCursor;
     readonly sessionId: string;
     private state;
     /** status 每变化一次加一（单调递增）。异步读取会话详情时据此判断请求期间状态是否变过，避免 running→终态→running 这类来回被误认为「没变」。 */
@@ -100,6 +128,7 @@ export declare class AgentSession {
     private readonly emitter;
     private readonly commands;
     private readonly runtime;
+    private activeReplayPlaybackId;
     private readonly projectionBuilder;
     private readonly pendingTurnPatches;
     private patchFlushHandle;
@@ -128,7 +157,10 @@ export declare class AgentSession {
     private bufferedCommandDeliveries;
     private pendingReplayMessage;
     private pendingReplayMode;
-    private pendingReplayKbIds;
+    private pendingReplayRequestId;
+    private pendingReplayAttachments;
+    private pendingReplayRefs;
+    private pendingReplayTopicAssetRefs;
     private recentChatEndAt;
     /**
      * 最近一次已经通过 `error` 事件投递过的服务端失败（`message` + `code`）。
@@ -148,9 +180,14 @@ export declare class AgentSession {
     private disposed;
     private getAppContext;
     private sendPending;
-    private manualCompactionPending;
+    private manualCompactionRequest;
+    /** Reload requests from retracts/epoch changes; done only when a reload started after the latest one succeeds. */
+    private epochReloadRequested;
+    private epochReloadDone;
+    private epochReloadRunning;
     /** 手动整理的在途标记，同时写进状态（界面据此保持「正在整理」，见 SessionState.compactionPending）。 */
-    private setManualCompactionPending;
+    private setManualCompactionRequest;
+    private handleManualCompactionFinished;
     /** 最近一次还在等服务端结果的发送请求 id；排队中断的 chat:end 据此判断回滚是否过期。 */
     private pendingChatRequestId;
     /** 会话详情给出的运行时类型；"native" 时启用原生智能体的投影规则（见 _handleTurnEvents / _handleChatEnd）。 */
@@ -215,6 +252,7 @@ export declare class AgentSession {
      * chat:end 会让界面停在「运行中」）。
      */
     reloadHistory(): Promise<boolean>;
+    private reloadHistoryWindow;
     /**
      * 向服务端确认会话此刻是否在运行，校准流式状态（残留的「运行中」会被清掉）。只在已加入房间时
      * 生效；不带 resume，服务端不会重发上一轮的终态事件（否则会被当成一次新的结束）。
@@ -253,6 +291,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>;
     /**
@@ -348,8 +392,9 @@ export declare class AgentSession {
     _handleTurnPatch(patch: PatchEnvelope): void;
     /** @internal */
     _handleTurnEnd(turn: TurnProjection): void;
+    private runEpochReload;
     /** @internal 历史回放通道（event_format: raw）。 */
-    _handleTurnEvents(events: RawEvent[], replayed?: boolean): void;
+    _handleTurnEvents(incoming: RawEvent[], replayed?: boolean): void;
     /** @internal */
     _handleChatStart(): void;
     /**
@@ -370,7 +415,6 @@ export declare class AgentSession {
         intent?: string;
         status?: SessionStatus;
         model?: string | null;
-        bound_skill_id?: string | null;
         replay_state?: Record<string, unknown> | null;
     }): void;
     /** @internal */
@@ -385,7 +429,7 @@ export declare class AgentSession {
     /** @internal */
     _handleBackgroundTask(task: AgentSessionEvents["backgroundTask"]): void;
     /** @internal */
-    _handleArtifact(event: AgentSessionEvents["artifact"]): void;
+    _handleArtifact(data: Record<string, unknown>, kind: "created" | "updated", replayed?: boolean): void;
     /** @internal 加入房间的应答里带 is_running，据此校准流式状态。 */
     _applyRunningState(isRunning: boolean, liveRevisionAtJoin?: number): void;
     private markRunningIfIdle;

package/dist/session/background.d.ts

@@ -0,0 +1,14 @@
+import type { AgentSessionEvents } from "./events";
+export type BackgroundTaskEvent = {
+    id?: string;
+    task_id?: string;
+    command?: string;
+    description?: string;
+    status?: string;
+    failure_reason?: string | null;
+    exit_code?: number | null;
+    elapsed_seconds?: number;
+    output_lines_count?: number;
+    output_preview?: string[];
+};
+export declare function completedBackgroundTask(task: BackgroundTaskEvent): AgentSessionEvents["backgroundTask"] | null;

package/dist/session/events.d.ts

@@ -137,7 +137,6 @@ export interface AgentSessionEvents {
         intent?: string;
         status?: SessionStatus;
         model?: string | null;
-        boundSkillId?: string | null;
         replayState?: Record<string, unknown> | null;
     };
     /** 回放输入不匹配，需要决定保持回放还是转自主模式。 */

package/dist/session/hub.d.ts

@@ -71,6 +71,8 @@ export declare class SessionHub {
     private streamTokens;
     /** 状态订阅（mode: "status"）的持有计数。 */
     private readonly statusWatchCounts;
+    private readonly statusLogCursors;
+    private readonly replayPlaybackIds;
     /** 启动连接门控：扣住期间只登记「需要连接」，放开后连一次。 */
     private connectionHeld;
     private connectDeferred;
@@ -143,6 +145,7 @@ export declare class SessionHub {
      * 归零才退订房间并从路由表移除。
      */
     private release;
+    private statusCursor;
     private emitStatusSubscribe;
     /** 不管还有几方持有都立即释放（启动失败、切换身份）。 */
     private forceRelease;

package/dist/session/log-cursor.d.ts

@@ -0,0 +1,14 @@
+import type { RawEvent } from "../shared/projection";
+/** Shared by full and status subscriptions. UI sequence and run_id are unrelated. */
+export declare class LogCursor {
+    private sequence;
+    private epoch;
+    private readonly deltas;
+    subscription(): {
+        after_log_seq?: number;
+    };
+    consume(events: RawEvent[]): {
+        events: RawEvent[];
+        reload: boolean;
+    };
+}

package/dist/session/state.d.ts

@@ -1,3 +1,4 @@
+import type { TopicAssetRef } from "../schemas/topic-assets";
 import type { ChatMessage, CompactionInfo, MessageContent } from "../schemas/message";
 import type { ContentBlock, PatchEnvelope, TurnProjection } from "../schemas/projection";
 import type { ReplaySpeed, ReplayState, SessionStatus } from "../schemas/session";
@@ -106,7 +107,7 @@ export declare function withTurns(state: SessionState, turns: TurnProjection[]):
  * 直接返回原 state——引用不变，订阅者不会收到多余通知。
  */
 export declare function withQueue(state: SessionState, snapshot: SessionQueueSnapshot): SessionState;
-export declare function addUserMessage(state: SessionState, content: MessageContent, clientRequestId?: string): SessionState;
+export declare function addUserMessage(state: SessionState, content: MessageContent, clientRequestId?: string, topicAssetRefs?: TopicAssetRef[], refs?: import("../schemas/plugin-refs").MessageRef[], contextAttachments?: import("../schemas/context-attachments").ContextAttachment[]): SessionState;
 export declare function upsertTurn(state: SessionState, turn: TurnProjection): SessionState;
 export declare function applyTurnPatch(state: SessionState, patch: PatchEnvelope): SessionState;
 export declare function addErrorMessage(state: SessionState, content: string): SessionState;

package/dist/session/workflow.d.ts

@@ -8,14 +8,20 @@ import type { TurnProjection } from "../schemas/projection";
  * - 工具调用结束后：一律用工具结果里留存的 `[workflow] …` 行重建（落盘，历史也只有这一份）。
  * 这样实时、历史、重连、回放在运行结束后得到同一份时间线。
  */
-export type WorkflowRunEntry = {
+export type WorkflowRunEntry = 
+/** status:步骤终态(done / error / cancelled);落史与直播的终态更新都会带上。 */
+{
     kind: "step";
     stepId: string;
     desc: string;
     stepKind: string;
-} | {
+    status?: string;
+}
+/** stepId:这行属于哪一步。并行分支的输出不按宣告顺序到达,不能按位置归到上一步。 */
+ | {
     kind: "log";
     text: string;
+    stepId?: string;
 };
 export interface WorkflowRunState {
     /** 触发它的 workflow:run 工具调用 id。 */
@@ -35,7 +41,8 @@ export declare function isWorkflowRunToolName(name: string): boolean;
  * 非前缀行（最终输出 / traceback）不参与，由界面在外层展示。
  */
 export declare function workflowEntriesFromOutput(output: string): WorkflowRunEntry[];
-/** 工作流名只从工具参数取：历史没有实时事件，两条路径都用这一个来源。 */
+/** 运行的标题只从工具参数取：历史没有实时事件，两条路径都用这一个来源。
+ * 与 host 起跑时发的 label 同款:「技能「org/x」」,非 main 流程再带「 · 流程 x」。 */
 export declare function workflowNameFromArguments(argumentsJson: string): string;
 export declare function isWorkflowEvent(type: string): boolean;
 /**

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

@@ -1,5 +1,8 @@
 import type { TurnProjection } from "../../schemas/projection";
 export interface RawEvent {
+    log_seq?: number;
+    step_log_seq?: number;
+    delta_seq?: number;
     type: string;
     payload: Record<string, unknown>;
 }
@@ -45,6 +48,8 @@ export declare class ClientProjectionBuilder {
     processBatch(events: RawEvent[]): ProjectionUpdate[];
     processEvent(event: RawEvent): ProjectionUpdate[] | null;
     reset(): void;
+    /** A durable snapshot supersedes only this turn's temporary overlay. */
+    acceptDurableTurn(turn: TurnProjection): void;
     seedSequence(maxSeq: number): void;
     _seedTurns(turns: TurnProjection[]): void;
     private onMemoryInject;

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

@@ -54,3 +54,5 @@ export declare function normalizeChildPause(pausePayload: Record<string, unknown
     childToolCallId: string;
     description: string;
 };
+/** Copy only the trusted protocol field, never evidence embedded in output. */
+export declare function attachToolEvidence(call: ToolCallProjection | undefined, evidence: unknown): void;

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

@@ -1,4 +1,5 @@
 export { acceptedPostChatFollowupCompletesLatestRun, acknowledgeTurnEvents, ClientProjectionBuilder, hasChatRunEvent, type RawEvent, type ProjectionUpdate, } from "./builder";
 export { type TurnState, createTurnState, snapshot, PAUSE_TOOL_NAMES } from "./state";
 export { projectHistory, type RawHistoryEntry } from "./history";
+export { workflowEntriesFromSteps, workflowRunCancelled, type WorkflowTimelineEntry, } from "./workflow";
 export { buildContextTurn } from "./context";

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

@@ -0,0 +1,24 @@
+import type { WorkflowStepProjection } from "../../schemas/projection";
+/** 固定流程时间线的一条事件:step 开一张步骤卡,log 归并进上一张卡。
+ * 形状与 session/workflow.ts 的 WorkflowRunEntry 一致(结构化兼容,直接互喂)。 */
+export type WorkflowTimelineEntry = {
+    kind: "step";
+    stepId: string;
+    desc: string;
+    stepKind: string;
+    status?: string;
+} | {
+    kind: "log";
+    text: string;
+    stepId?: string;
+};
+/** 解释执行落史的结构化步骤 → 时间线事件流:与 host live 事件逐行同文案、同顺序。
+ * 命令步骤的「└ 输出」行从同一 4KiB 截断串推导(含 …(共N字) 记号),叶子步骤的
+ * 「失败:」行还原 error 条目里存的失败说明(容器步骤的 error 条目不带说明)。
+ * 条目按终态落盘(容器晚于子步骤、并行分支按完成先后),带 seq / log_seq 时按它们
+ * 排回直播时的顺序;旧记录没有序号就按落盘顺序。流式与刷新重建必须渲染出相同结果。 */
+export declare function workflowEntriesFromSteps(steps: readonly WorkflowStepProjection[]): WorkflowTimelineEntry[];
+/** 取消的运行在工具层留档是通用错误串(status=error),真相在步骤条目里:有步骤标记
+ * cancelled 且没有步骤失败,整次运行按「已取消」呈现。并行分支失败时兄弟分支也会被
+ * 取消,那是失败不是取消。 */
+export declare function workflowRunCancelled(steps: readonly WorkflowStepProjection[]): 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;
+}