@blade-hq/agent-kit 0.0.0-placeholder.0 → 0.4.1

package/dist/internal/core/lib/parent-bridge.js

@@ -0,0 +1,135 @@
+import { installPartnerSkill } from "../api/partner-skill";
+import { tapBridgeEvent } from "../devtools/bridge-devtools/tap";
+import { parsePartnerSkillInstallPayload } from "../schemas/partner-skill";
+import { resourceBridgeDispatch } from "./resource-bridge";
+function invalidateSkillStats(sessionId) {
+    const queryClient = globalThis.__agentQueryClient;
+    if (!queryClient)
+        return;
+    void queryClient.invalidateQueries({ queryKey: ["skill-stats", sessionId] });
+}
+const HOST_BRIDGE_ACTIONS = ["addContext", "appendInput", "sendMessage"];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isAllowedBridgeAction(action) {
+    return HOST_BRIDGE_ACTIONS.includes(action);
+}
+function isBladeBridgeEnvelope(value) {
+    return (isRecord(value) &&
+        value.__bladeBridge === true &&
+        typeof value.action === "string" &&
+        (value.direction === "agent-to-host" || value.direction === "host-to-agent"));
+}
+function isLegacyResourceBridgeEnvelope(value) {
+    return isRecord(value) && value.__resourceBridge === true && typeof value.action === "string";
+}
+function toBridgeActionEnvelope(value) {
+    if (isBladeBridgeEnvelope(value)) {
+        return {
+            action: value.action,
+            payload: value.payload,
+            direction: value.direction,
+            canonical: true,
+        };
+    }
+    if (isLegacyResourceBridgeEnvelope(value)) {
+        return { action: value.action, payload: value.payload, canonical: false };
+    }
+    return null;
+}
+export function isInsideIframe() {
+    return typeof window !== "undefined" && window.parent !== window;
+}
+export function postToParent(envelope) {
+    if (!isInsideIframe()) {
+        return;
+    }
+    tapBridgeEvent({
+        side: "agent",
+        direction: "agent-to-host",
+        action: envelope.action,
+        payload: envelope.payload,
+        meta: envelope.meta,
+    });
+    try {
+        window.parent.postMessage(envelope, "*");
+    }
+    catch (error) {
+        console.debug("[parent-bridge] failed to post message to parent", error);
+    }
+}
+export function attachHostBridgeListener(getState) {
+    if (typeof window === "undefined") {
+        return () => { };
+    }
+    const listener = (event) => {
+        const envelope = toBridgeActionEnvelope(event.data);
+        if (!envelope) {
+            return;
+        }
+        const { sessionId, activeSessionId, isStreaming } = getState();
+        const tap = (note, rejected) => {
+            tapBridgeEvent({
+                side: "agent",
+                direction: envelope.direction ?? "host-to-agent",
+                action: envelope.action,
+                payload: envelope.payload,
+                meta: { canonical: envelope.canonical, sessionId: sessionId ?? null },
+                note,
+                rejected,
+            });
+        };
+        if (!sessionId) {
+            tap("ignored: no active session", true);
+            return;
+        }
+        switch (envelope.action) {
+            case "installSkill":
+                // installSkill 属于高权限操作（会把可执行代码写入会话 skills 目录），
+                // 收紧信任边界：只接受带 direction=host-to-agent 的 __bladeBridge 信封。
+                // 这样一来：
+                //  - 外部 host 页面通过标准 envelope 推送 → 允许
+                //  - 内嵌 _meta.ui 卡片通过标准 envelope 推送 → 允许
+                //  - 任何 legacy __resourceBridge 或缺失 direction 的消息 → 拒绝
+                if (!envelope.canonical || envelope.direction !== "host-to-agent") {
+                    tap("installSkill rejected: requires __bladeBridge envelope with direction=host-to-agent", true);
+                    console.warn("[parent-bridge] installSkill rejected: requires __bladeBridge envelope with direction=host-to-agent");
+                    return;
+                }
+                tap(undefined, false);
+                try {
+                    const payload = parsePartnerSkillInstallPayload(envelope.payload);
+                    void installPartnerSkill(sessionId, payload)
+                        .then(() => {
+                        invalidateSkillStats(sessionId);
+                    })
+                        .catch((error) => {
+                        console.warn("[parent-bridge] installSkill request failed", error);
+                    });
+                }
+                catch (error) {
+                    console.warn("[parent-bridge] invalid installSkill payload", error);
+                }
+                return;
+            default:
+                if (!isAllowedBridgeAction(envelope.action)) {
+                    tap(`rejected: action not in allowlist [${HOST_BRIDGE_ACTIONS.join(", ")}]`, true);
+                    return;
+                }
+                tap(undefined, false);
+        }
+        resourceBridgeDispatch({
+            sessionId,
+            activeSessionId,
+            isStreaming,
+            action: envelope.action,
+            payload: envelope.payload,
+        });
+    };
+    window.addEventListener("message", listener);
+    return () => {
+        window.removeEventListener("message", listener);
+    };
+}
+//# sourceMappingURL=parent-bridge.js.map

package/dist/internal/core/lib/parent-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-bridge.js","sourceRoot":"","sources":["../../src/lib/parent-bridge.ts"],"names":[],"mappings":"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"}

package/dist/internal/core/lib/preview-dispatch.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 按文件扩展名决定预览渲染方式（R6）。
+ *
+ * 为什么按扩展名不按 MIME：当前消息 schema 里 FileContentPart / TextAttachment
+ * 都只存 `name` + `uploadedPath`，没有 mime_type（见 design.md §3.6）。
+ * 改 schema 面太大，扩展名在实际数据里足够稳定（前端上传时就是文件名）。
+ *
+ * 动图（.gif/.webp/.apng/.avif）归为 image，因为浏览器 `<img>` 原生播放。
+ * video 类扩展名本期不覆盖（见 design.md §3.6 决策："只动图，不视频"）。
+ */
+export type PreviewKind = "image" | "text" | "default";
+export interface PreviewDescriptor {
+    kind: PreviewKind;
+    filename: string;
+    url: string;
+}
+/**
+ * 判断扩展名能不能用 `<img>` 预览（含动图）。
+ * 独立导出是为了让调用方可以在不走完整 dispatchPreview 的场景（如 UserMessageBubble
+ * 已经在 render 时把图片渲染成 <img>，不需要再走 kind 分派）直接查一次。
+ */
+export declare function isImageFilename(filename: string): boolean;
+export declare function isTextFilename(filename: string): boolean;
+export declare function dispatchPreview(filename: string, url: string): PreviewDescriptor;
+//# sourceMappingURL=preview-dispatch.d.ts.map

package/dist/internal/core/lib/preview-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-dispatch.d.ts","sourceRoot":"","sources":["../../src/lib/preview-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAcD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAIhF"}

package/dist/internal/core/lib/preview-dispatch.js

@@ -0,0 +1,55 @@
+/**
+ * 按文件扩展名决定预览渲染方式（R6）。
+ *
+ * 为什么按扩展名不按 MIME：当前消息 schema 里 FileContentPart / TextAttachment
+ * 都只存 `name` + `uploadedPath`，没有 mime_type（见 design.md §3.6）。
+ * 改 schema 面太大，扩展名在实际数据里足够稳定（前端上传时就是文件名）。
+ *
+ * 动图（.gif/.webp/.apng/.avif）归为 image，因为浏览器 `<img>` 原生播放。
+ * video 类扩展名本期不覆盖（见 design.md §3.6 决策："只动图，不视频"）。
+ */
+const IMAGE_EXTS = [
+    // 静态
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".bmp",
+    ".svg",
+    ".heic",
+    // 动图（<img> 原生播放）
+    ".gif",
+    ".webp",
+    ".apng",
+    ".avif",
+];
+const TEXT_EXTS = [".md", ".json", ".txt", ".yaml", ".yml"];
+function lower(filename) {
+    return filename.toLowerCase();
+}
+function endsWithAny(name, exts) {
+    const n = lower(name);
+    for (const ext of exts) {
+        if (n.endsWith(ext))
+            return true;
+    }
+    return false;
+}
+/**
+ * 判断扩展名能不能用 `<img>` 预览（含动图）。
+ * 独立导出是为了让调用方可以在不走完整 dispatchPreview 的场景（如 UserMessageBubble
+ * 已经在 render 时把图片渲染成 <img>，不需要再走 kind 分派）直接查一次。
+ */
+export function isImageFilename(filename) {
+    return endsWithAny(filename, IMAGE_EXTS);
+}
+export function isTextFilename(filename) {
+    return endsWithAny(filename, TEXT_EXTS);
+}
+export function dispatchPreview(filename, url) {
+    if (isImageFilename(filename))
+        return { kind: "image", filename, url };
+    if (isTextFilename(filename))
+        return { kind: "text", filename, url };
+    return { kind: "default", filename, url };
+}
+//# sourceMappingURL=preview-dispatch.js.map

package/dist/internal/core/lib/preview-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-dispatch.js","sourceRoot":"","sources":["../../src/lib/preview-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,UAAU,GAAG;IACjB,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,iBAAiB;IACjB,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAA;AAEV,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAUpE,SAAS,KAAK,CAAC,QAAgB;IAC7B,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAA;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,IAAuB;IACxD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IACrB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;IAClC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAW;IAC3D,IAAI,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;IACtE,IAAI,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;IACpE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAA;AAC3C,CAAC"}

package/dist/internal/core/lib/resource-bridge.d.ts

@@ -0,0 +1,12 @@
+declare const BRIDGE_ACTIONS: readonly ["addContext", "appendInput", "sendMessage"];
+export type ResourceBridgeAction = (typeof BRIDGE_ACTIONS)[number];
+export interface ResourceBridgeDispatchParams {
+    sessionId: string;
+    activeSessionId: string | null;
+    isStreaming: boolean;
+    action: string;
+    payload?: unknown;
+}
+export declare function resourceBridgeDispatch({ sessionId, activeSessionId, isStreaming, action, payload, }: ResourceBridgeDispatchParams): boolean;
+export {};
+//# sourceMappingURL=resource-bridge.d.ts.map

package/dist/internal/core/lib/resource-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-bridge.d.ts","sourceRoot":"","sources":["../../src/lib/resource-bridge.ts"],"names":[],"mappings":"AAiBA,QAAA,MAAM,cAAc,uDAAwD,CAAA;AAE5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAElE,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,WAAW,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAMD,wBAAgB,sBAAsB,CAAC,EACrC,SAAS,EACT,eAAe,EACf,WAAW,EACX,MAAM,EACN,OAAO,GACR,EAAE,4BAA4B,GAAG,OAAO,CAkCxC"}

package/dist/internal/core/lib/resource-bridge.js

@@ -0,0 +1,51 @@
+import { useUiBridgeStore } from "../stores/ui-bridge-store";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getNonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function hasUserActivation() {
+    if (typeof navigator === "undefined") {
+        return false;
+    }
+    return navigator.userActivation?.isActive === true;
+}
+const BRIDGE_ACTIONS = ["addContext", "appendInput", "sendMessage"];
+function isBridgeAction(action) {
+    return BRIDGE_ACTIONS.includes(action);
+}
+export function resourceBridgeDispatch({ sessionId, activeSessionId, isStreaming, action, payload, }) {
+    if (!sessionId || !activeSessionId || sessionId !== activeSessionId) {
+        return false;
+    }
+    if (!isBridgeAction(action)) {
+        return false;
+    }
+    const bridgeStore = useUiBridgeStore.getState();
+    if (action === "addContext") {
+        if (!isRecord(payload))
+            return false;
+        const content = getNonEmptyString(payload.content);
+        const label = getNonEmptyString(payload.label);
+        if (!content || !label)
+            return false;
+        bridgeStore.addPendingContext(sessionId, { content, label });
+        return true;
+    }
+    if (action === "appendInput") {
+        if (!isRecord(payload))
+            return false;
+        const text = getNonEmptyString(payload.text);
+        if (!text)
+            return false;
+        bridgeStore.addDraftAppend(sessionId, text);
+        return true;
+    }
+    if (isStreaming || !hasUserActivation()) {
+        return false;
+    }
+    bridgeStore.addSendRequest(sessionId);
+    return true;
+}
+//# sourceMappingURL=resource-bridge.js.map

package/dist/internal/core/lib/resource-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-bridge.js","sourceRoot":"","sources":["../../src/lib/resource-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE5D,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACxE,CAAC;AAED,SAAS,iBAAiB;IACxB,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,SAAS,CAAC,cAAc,EAAE,QAAQ,KAAK,IAAI,CAAA;AACpD,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,aAAa,CAAU,CAAA;AAY5E,SAAS,cAAc,CAAC,MAAc;IACpC,OAAO,cAAc,CAAC,QAAQ,CAAC,MAA8B,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,SAAS,EACT,eAAe,EACf,WAAW,EACX,MAAM,EACN,OAAO,GACsB;IAC7B,IAAI,CAAC,SAAS,IAAI,CAAC,eAAe,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;QACpE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAA;IAE/C,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAA;QACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAClD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QACpC,WAAW,CAAC,iBAAiB,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAA;QACpC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACvB,WAAW,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC3C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,WAAW,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;IACrC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/internal/core/lib/session-file-preview.d.ts

@@ -0,0 +1,4 @@
+import type { PreviewTarget } from "../stores/ui-store";
+export declare function buildSessionBinaryPreviewTarget(sessionId: string, filePath: string, fileName?: string): PreviewTarget | null;
+export declare function resolveSessionFilePreviewTarget(sessionId: string, filePath: string, fileName?: string): Promise<PreviewTarget>;
+//# sourceMappingURL=session-file-preview.d.ts.map

package/dist/internal/core/lib/session-file-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file-preview.d.ts","sourceRoot":"","sources":["../../src/lib/session-file-preview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AA0BvD,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAiCtB;AAED,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAuBxB"}

package/dist/internal/core/lib/session-file-preview.js

@@ -0,0 +1,71 @@
+import { apiFetchText, getAuthedUrl } from "../api/client";
+const IMAGE_EXTS = new Set(["png", "jpg", "jpeg", "gif", "svg", "webp", "ico", "bmp"]);
+const DOCX_EXTS = new Set(["docx", "doc"]);
+const EXCEL_EXTS = new Set(["xlsx", "xls", "xlsm", "xlsb"]);
+const PPT_EXTS = new Set(["pptx", "ppt"]);
+const CSV_EXTS = new Set(["csv"]);
+const MARKDOWN_EXTS = new Set(["md", "markdown"]);
+const HTML_EXTS = new Set(["html", "htm"]);
+function getExt(fileName) {
+    return fileName.split(".").pop()?.toLowerCase() ?? "";
+}
+function getDisplayFileName(filePath, fileName) {
+    return fileName?.trim() || filePath.split("/").pop() || filePath;
+}
+function getSessionFilePath(sessionId, filePath) {
+    return `/api/sessions/${sessionId}/files/${encodeURIComponent(filePath)}`;
+}
+function getSessionFileDownloadUrl(sessionId, filePath) {
+    return getAuthedUrl(getSessionFilePath(sessionId, filePath));
+}
+export function buildSessionBinaryPreviewTarget(sessionId, filePath, fileName) {
+    const resolvedFileName = getDisplayFileName(filePath, fileName);
+    const ext = getExt(resolvedFileName);
+    const filePathUrl = getSessionFilePath(sessionId, filePath);
+    const downloadUrl = getSessionFileDownloadUrl(sessionId, filePath);
+    if (IMAGE_EXTS.has(ext)) {
+        return { type: "image", content: downloadUrl, title: resolvedFileName, key: filePath };
+    }
+    if (ext === "pdf") {
+        return { type: "pdf", content: downloadUrl, title: resolvedFileName, key: filePath };
+    }
+    if (DOCX_EXTS.has(ext)) {
+        return { type: "docx", content: downloadUrl, title: resolvedFileName, key: filePath };
+    }
+    if (EXCEL_EXTS.has(ext)) {
+        return { type: "excel", content: downloadUrl, title: resolvedFileName, key: filePath };
+    }
+    if (PPT_EXTS.has(ext)) {
+        return {
+            type: "ppt",
+            content: filePathUrl,
+            sourceUrl: downloadUrl,
+            title: resolvedFileName,
+            key: filePath,
+        };
+    }
+    return null;
+}
+export async function resolveSessionFilePreviewTarget(sessionId, filePath, fileName) {
+    const resolvedFileName = getDisplayFileName(filePath, fileName);
+    const binaryTarget = buildSessionBinaryPreviewTarget(sessionId, filePath, resolvedFileName);
+    if (binaryTarget) {
+        return binaryTarget;
+    }
+    const content = await apiFetchText(`/api/sessions/${sessionId}/files/${encodeURIComponent(filePath)}`);
+    const ext = getExt(resolvedFileName);
+    const type = MARKDOWN_EXTS.has(ext)
+        ? "markdown"
+        : CSV_EXTS.has(ext)
+            ? "csv"
+            : HTML_EXTS.has(ext)
+                ? "html"
+                : "file";
+    return {
+        type,
+        content,
+        title: resolvedFileName,
+        key: filePath,
+    };
+}
+//# sourceMappingURL=session-file-preview.js.map

package/dist/internal/core/lib/session-file-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file-preview.js","sourceRoot":"","sources":["../../src/lib/session-file-preview.ts"],"names":[],"mappings":"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"}

package/dist/internal/core/lib/step-ranges.d.ts

@@ -0,0 +1,43 @@
+import type { ChatMessage } from "../schemas/message";
+/**
+ * 每个 step 在消息流中的一段连续范围（R5 whatif 重跑的边界单位）。
+ *
+ * `[startIndex, endIndex)` 包含所有属于这个 step 的消息。
+ * - 中间段：endIndex == 下一段的 startIndex（把本段 assistant 总结纳入本段）
+ * - 末段：endIndex 停在最后一条显式 tag 该 step 的消息之后，避免把跑完 skill
+ *   后的闲聊尾段误当成 step 的一部分
+ *
+ * 同一 stepNumber 可以在 stepRanges 里出现多次（每次 what-if 重跑后 step3/4
+ * 会产生新一段），每次出现都是独立 range。
+ */
+export interface StepMessageRange {
+    stepNumber: number;
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * 把消息流切成 step-aligned 的 ranges 数组（纯函数）。
+ *
+ * 传 `steps` 只是为了拿 stepNumber 白名单，所以参数接受任何带 `stepNumber` 字段
+ * 的对象，避免引入 apps/web 的 StepInfo 依赖。
+ *
+ * 算法概述：
+ * 1. 每条消息过 `findStepInMessage`，得到 perMessageStep[]
+ * 2. 顺序扫，遇到 step transition 时开新段；往前吃紧邻的 Q&A（user/assistant），
+ *    遇到 what-if 重跑 user 消息立即停（它是边界）
+ * 3. 末段 endIndex 停在最后一条 tag 该 step 的消息之后（避免吞下尾部闲聊）
+ */
+export declare function buildStepRanges(messages: ChatMessage[], steps: ReadonlyArray<{
+    stepNumber: number;
+}>): StepMessageRange[];
+/**
+ * 从 stepRanges 里按 step 归属筛选出需作废（whatif）的消息 id。
+ *
+ * 输入 `fromStep = min(quotes.map(q => q.step_number))`，返回 stepNumber >=
+ * fromStep 的每段 range 内所有 message.entry_id，按 range.startIndex 升序。
+ * 重复 id 自动去重。
+ *
+ * 纯函数，便于放在 core 供 apps/web 的 hook 共用并独立单测。
+ */
+export declare function deriveDeprecateEntryIds(stepRanges: StepMessageRange[], messages: ChatMessage[], fromStep: number): string[];
+//# sourceMappingURL=step-ranges.d.ts.map

package/dist/internal/core/lib/step-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-ranges.d.ts","sourceRoot":"","sources":["../../src/lib/step-ranges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAuHD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3C,gBAAgB,EAAE,CAqEpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAgBV"}