@blade-hq/agent-react 2610.0.0-beta.7 → 2610.0.0-beta.71

package/dist/lib/agent-computer-command.d.ts

@@ -0,0 +1,34 @@
+export declare function isAgentComputerCommand(command: string): boolean;
+/** 工具调用的 JSON 参数里是不是一条 computer launch 命令。 */
+export declare function isAgentComputerToolCall(argumentsJson: string | null | undefined): boolean;
+export type AgentComputerLaunchOutcome = "pending" | "succeeded" | "failed" | "unknown";
+/** `computer launch` 这条 Bash 工具调用最终是不是真的启动成功了——不能只看
+ * `isAgentComputerToolCall` 命中参数就当作成功：可执行文件缺失/不可执行、
+ * 启动后随即退出这些 appmirrord 侧的失败，Bash 工具调用本身仍然会走完
+ * `status: "done"`（Bash 工具的职责是"跑完这条命令"，命令自己返回非零退出码
+ * 不算工具调用失败）。
+ *
+ * 唯一的判据是输出里有没有出现 `LAUNCH_SUCCESS_MARKER`——launch.go 的
+ * cmdLaunch 只要走到成功分支就一定会打印这行文本，不存在"成功了但没打印"
+ * 的路径。标记缺失就等价于没有走到那条成功路径，不再退回看 `result.exit_code`
+ * 当兜底：那样会给 `computer launch ... || echo failed` 这类复合命令开口子，
+ * 让真实失败的 launch 被误判成 succeeded。
+ *
+ * "pending"：还没跑完（status 既不是终态失败也不是 done），调用方不该现在
+ * 就下结论，也不该把这次调用标记成"已处理"——等下一次状态更新再重新判断。
+ *
+ * "unknown"：`status: "done"` 但 `result` 本身缺失（不是"有 result、没有标记"，
+ * 是根本没有 result 这个字段）——历史会话被整理（compaction）之后，归档的
+ * 工具调用只保留 `arguments`/`status` 这类摘要字段，完整 `result` payload 不
+ * 会重新序列化进历史投影，这是已知且刻意的压缩形状，不是数据丢失异常。这种
+ * 情况下"没看到成功标记"不能说明"这次 launch 失败了"，只能说明"证据被裁剪
+ * 了"——跟"result 确实回来了、里面就是没有这行文本"是两种不同性质的证据，
+ * 前者不能定性为 failed，接入方要按自己的场景（标签页展示可以偏宽松，自动
+ * 跳转/替用户做决定的场景应该偏保守）自己决定怎么用。
+ *
+ * 与 apps/web/src/agent/lib/agent-computer-command.ts 保持同名同签名——两边
+ * 内容目前完全一致，改一处记得同步另一处。 */
+export declare function classifyAgentComputerLaunchOutcome(toolCall: {
+    status?: string;
+    result?: unknown;
+}): AgentComputerLaunchOutcome;

package/dist/lib/random-id.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 生成随机标识。
+ *
+ * `crypto.randomUUID` 只在安全上下文（HTTPS 或 localhost）可用：部署成
+ * `http://<host>:<port>` 时它是 undefined，直接调用会让调用方整个挂掉
+ * （MCP App 卡片就是这么坏的）。`crypto.getRandomValues` 不受这条限制，
+ * 这里用它拼出等价的 UUID v4，只有在完全没有 Web Crypto 的环境才退回
+ * 时间戳 + 随机数——那只是为了不抛异常，不保证全局唯一性。
+ */
+export declare function randomId(): string;

package/dist/lib/utils.d.ts

@@ -1,5 +1,20 @@
 import { type ClassValue } from "clsx";
-/** 合并 className（SDK 内不引入 tailwind-merge，按序拼接即可）。 */
+/**
+ * 合并 className：clsx 处理条件写法，twMerge 消掉互相冲突的 Tailwind 工具类。
+ *
+ * tailwind-merge 用 3.x：本包的样式由 Tailwind 4 编译，2.x 只认 3.x 的类名词表，
+ * v4 新增或改过语义的类（`outline-hidden`、`rounded-4xl`、`size-*`）它看不出冲突，
+ * 会两条都留下、再交给 CSS 输出顺序决定——那正是 cn 要消掉的东西。
+ *
+ * 只有 clsx 时，接入方传进来的 `p-0` 与组件内部的 `p-4` 会同时落在元素上，
+ * 谁生效取决于 CSS 输出顺序——SDK 自己编译的那份里 p-4 在前、宿主的那份里
+ * 又反过来，同一个类名组合在不同宿主里表现不一致。twMerge 按"后者胜"在
+ * 类名层就定下来，接入方的类于是稳定覆盖 SDK 默认样式。
+ *
+ * 因此 SDK 内所有 className 拼接都必须走 cn，且接入方的类放在最后一个参数。
+ */
 export declare function cn(...inputs: ClassValue[]): string;
-/** 复制文本到剪贴板，返回是否成功。 */
+/** 复制文本到剪贴板，返回是否成功。
+ * 与 apps/web/src/lib/utils.ts 保持同名同签名和相同降级语义。
+ */
 export declare function copyToClipboard(text: string): Promise<boolean>;

package/dist/lib/whatif-prompt.d.ts

@@ -0,0 +1,18 @@
+/** 一条 canonical what-if 消息中的引用快照。 */
+export interface WhatIfQuote {
+    stepNumber: number | null;
+    label: string;
+    snapshot: string;
+}
+export interface ParsedWhatIfPrompt {
+    fromStep: number | null;
+    quotes: WhatIfQuote[];
+    userText: string;
+}
+/**
+ * 解析 Server 历史与流式消息共用的 canonical what-if 文本。
+ *
+ * 无 `[用户输入]` 标签的历史消息仍按最后一条快照尾部的空行切分，保持内置
+ * Web 原有兼容行为。
+ */
+export declare function parseWhatIfPrompt(text: string): ParsedWhatIfPrompt | null;

package/dist/mermaid-3ZIDBTTL-QL4YGD6I.js

@@ -0,0 +1,9 @@
+"use client";
+import {
+  Nt
+} from "./chunk-IA6J2NTB.js";
+import "./chunk-G3PMV62Z.js";
+export {
+  Nt as Mermaid
+};
+//# sourceMappingURL=mermaid-3ZIDBTTL-QL4YGD6I.js.map

package/dist/mermaid-3ZIDBTTL-QL4YGD6I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}