@blade-hq/agent-client 2610.0.0-beta.0 → 2610.0.0-beta.2

package/dist/resources/sessions.d.ts

@@ -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;
     }>;
@@ -227,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/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;
@@ -58,6 +71,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/session/agent-session.d.ts

@@ -8,6 +8,7 @@ import type { AppCliAttachment, AppCliDefinition, FileEntry } from "../resources
 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;
@@ -202,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/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

@@ -42,6 +42,8 @@ export declare function normalizePostChatFollowup(data: Record<string, unknown>,
     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": "2610.0.0-beta.0",
+  "version": "2610.0.0-beta.2",
   "description": "Blade Agent 框架无关客户端：会话实时状态机、REST 通道、弹窗登录、页面协作。浏览器与 Node.js 通用。",
   "repository": {
     "type": "git",
@@ -18,7 +18,9 @@
   "files": [
     "dist",
     "README.md",
-    "public-api.md"
+    "public-api.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": [
     "**/*.css"

package/public-api.md

@@ -3,7 +3,13 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 126 个公开声明。
+共 136 个公开声明。
+
+## `acceptedPostChatFollowupCompletesLatestRun` (function)
+
+```ts
+acceptedPostChatFollowupCompletesLatestRun: (events: RawEvent[], updates: ProjectionUpdate[]) => boolean
+```
 
 ## `ActiveCompactionState` (interface)
 
@@ -240,6 +246,7 @@ baseUrl: string
 fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
 onRefreshSuccess: (() => void | Promise<void>) | undefined
 socketToken: string | (() => string | null | undefined) | undefined
+streamTokens: boolean | undefined
 token: string | (() => string | null | undefined) | undefined
 tokenStorage: TokenStorageMode | undefined
 ```
@@ -450,6 +457,14 @@ path: string
 tags: string[] | undefined
 ```
 
+## `FinalArtifact` (interface)
+
+```ts
+kind: "link" | "file"
+label: string
+target: string
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -468,6 +483,42 @@ getImageParts: (content: MessageContent) => ImageUrlContentPart[]
 getTextContent: (content: MessageContent) => string
 ```
 
+## `GlobalSearchConversationResult` (interface)
+
+```ts
+matched: "title" | "content"
+session: SessionInfo
+snippet: string
+type: "conversation"
+```
+
+## `GlobalSearchFileResult` (interface)
+
+```ts
+matched: "name" | "path"
+name: string
+path: string
+session: SessionInfo
+snippet: string
+type: "file"
+```
+
+## `GlobalSearchResult` (interface)
+
+```ts
+indexing: boolean
+items: GlobalSearchResultItem[]
+truncated: boolean
+```
+
+## `GlobalSearchResultItem` (type)
+
+```ts
+export type GlobalSearchResultItem =
+  | GlobalSearchConversationResult
+  | GlobalSearchFileResult
+```
+
 ## `groupMessagesByLoop` (function)
 
 ```ts
@@ -528,6 +579,12 @@ isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boo
 isInboundEnvelope: (value: unknown) => value is InboundEnvelope
 ```
 
+## `latestPostChatFollowup` (function)
+
+```ts
+latestPostChatFollowup: (turns: TurnProjection[]) => PostChatFollowup | null
+```
+
 ## `LayoutType` (enum)
 
 ```ts
@@ -656,6 +713,17 @@ sequence: number
 turn_id: string
 ```
 
+## `PostChatFollowup` (interface)
+
+```ts
+assistant_entry_id: string
+feedback_eligible: boolean
+feedback_scope: "latest_result"
+final_artifacts: FinalArtifact[] | undefined
+recaption: string | undefined
+suggestions: string[]
+```
+
 ## `PreparedSolution` (interface)
 
 ```ts
@@ -751,6 +819,31 @@ speed: ReplaySpeed | undefined
 status: "replay" | "autonomous" | undefined
 ```
 
+## `ResultFeedback` (interface)
+
+```ts
+assistant_entry_id: string
+created_at: string
+helpful: boolean
+project_id: string | null
+reason: ResultFeedbackReason | null
+session_id: string
+surface: "unknown" | "chat" | "software_factory"
+updated_at: string
+```
+
+## `ResultFeedbackReason` (type)
+
+```ts
+export type ResultFeedbackReason =
+  | "not_solved"
+  | "inaccurate"
+  | "incomplete"
+  | "needs_major_changes"
+  | "too_slow"
+  | "other"
+```
+
 ## `RunOptions` (interface)
 
 ```ts
@@ -998,15 +1091,18 @@ getSharedSession: (token: string) => Promise<TurnProjection[]>
 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[]>
+listResultFeedback: (sessionId: string) => Promise<ResultFeedback[]>
 listSessions: (template_id_prefix?: string, solution_id?: string) => Promise<SessionInfo[]>
 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>
 probeSessionUrl: (sessionId: string, url: string) => Promise<{ reachable: boolean; requires_proxy: boolean; }>
+putResultFeedback: (sessionId: string, assistantEntryId: string, feedback: { helpful: boolean; reason?: ResultFeedbackReason | null; }) => Promise<ResultFeedback>
 renameFile: (sessionId: string, filePath: string, newName: string) => Promise<{ path: string; }>
 revokeShare: (sessionId: string, token: string) => Promise<{ revoked: boolean; }>
 rewindSession: (sessionId: string, checkpointId: string) => Promise<{ id: string; content: string; }>
+searchOwnedContent: (params: { q: string; limit?: number; }) => Promise<GlobalSearchResult>
 setSessionEnv: (sessionId: string, env: Record<string, string>) => Promise<SessionDetail>
 shareFile: (sessionId: string, sourcePath: string, linkName?: string, shareFolder?: string) => Promise<{ path: string; target: string; }>
 startReplaySession: (sourceSessionId: string, speed?: ReplaySpeed) => Promise<{ session_id: string; }>
@@ -1243,6 +1339,7 @@ loop_id: string
 memory_refs: MemoryRef[] | null | undefined
 model: string | null | undefined
 parent_fork_tool_call_id: string | null | undefined
+post_chat_followup: PostChatFollowup | null | undefined
 role: "user" | "assistant" | "system"
 saved_ratio: number | null | undefined
 sequence: number