@yefengr/pi-reach 0.0.5 → 0.0.7

package/dist/files/image-structure.js

@@ -0,0 +1,269 @@
+import { FileAccessError } from "./safe-open.js";
+export const MAX_INSPECTION_READS = 4096;
+const MAX_STRUCTURE_STEPS = 4096;
+const MAX_METADATA_BYTES = 64 * 1024;
+const PNG_ANCILLARY = new Set(["cHRM", "gAMA", "iCCP", "sBIT", "sRGB", "bKGD", "hIST", "tRNS", "pHYs", "sPLT", "tIME", "iTXt", "tEXt", "zTXt", "eXIf", "cICP", "mDCV", "cLLI"]);
+/** 只读取结构元数据；压缩数据按长度跳过，不认证像素内容或 CRC。 */
+export class ImageStructureReader {
+    handle;
+    head;
+    byteLength;
+    reads;
+    steps = 0;
+    metadataBytes = 0;
+    constructor(handle, head, byteLength, reads) {
+        this.handle = handle;
+        this.head = head;
+        this.byteLength = byteLength;
+        this.reads = reads;
+    }
+    step() { return ++this.steps <= MAX_STRUCTURE_STEPS; }
+    async get(position, length) {
+        if (!Number.isSafeInteger(position) || position < 0 || length < 0 || position + length > this.byteLength)
+            return undefined;
+        if (position + length <= this.head.length)
+            return this.head.subarray(position, position + length);
+        const buffer = Buffer.alloc(length);
+        let offset = Math.max(0, Math.min(length, this.head.length - position));
+        if (offset)
+            this.head.copy(buffer, 0, position, position + offset);
+        while (offset < length) {
+            const requested = length - offset;
+            // 按请求字节计费，短 read 也不能反复请求而突破 metadata I/O 预算。
+            if (this.reads >= MAX_INSPECTION_READS || this.metadataBytes + requested > MAX_METADATA_BYTES)
+                return undefined;
+            this.reads++;
+            this.metadataBytes += requested;
+            const { bytesRead } = await this.handle.read(buffer, offset, requested, position + offset);
+            if (bytesRead === 0)
+                throw new FileAccessError("file_changed");
+            if (!Number.isInteger(bytesRead) || bytesRead < 0 || bytesRead > requested)
+                throw new FileAccessError("io_error");
+            offset += bytesRead;
+        }
+        return buffer;
+    }
+}
+function pngHeader(head) {
+    if (head.length < 33 || head.readUInt32BE(8) !== 13 || head.toString("latin1", 12, 16) !== "IHDR")
+        return undefined;
+    const depths = { 0: [1, 2, 4, 8, 16], 2: [8, 16], 3: [1, 2, 4, 8], 4: [8, 16], 6: [8, 16] };
+    if (!depths[head[25]]?.includes(head[24]) || head[26] !== 0 || head[27] !== 0 || head[28] > 1)
+        return undefined;
+    const width = head.readUInt32BE(16);
+    const height = head.readUInt32BE(20);
+    if (width === 0 || height === 0 || width > 0x7fffffff || height > 0x7fffffff)
+        return undefined;
+    return { width, height };
+}
+export async function staticPng(reader) {
+    const dimensions = pngHeader(reader.head);
+    if (!dimensions)
+        return undefined;
+    let position = 33;
+    let dataSeen = false;
+    let dataStarted = false;
+    let dataEnded = false;
+    let paletteSeen = false;
+    while (position < reader.byteLength && reader.step()) {
+        const header = await reader.get(position, 8);
+        if (!header)
+            return undefined;
+        const length = header.readUInt32BE(0);
+        const type = header.toString("latin1", 4, 8);
+        const end = position + 12 + length;
+        if (length > 0x7fffffff || end > reader.byteLength)
+            return undefined;
+        // 动画声明在任何位置都不能放行；IEND 后也不得保留浏览器可解释的尾部。
+        if (["acTL", "fcTL", "fdAT"].includes(type))
+            return undefined;
+        if (type === "IEND") {
+            if (length !== 0 || !dataSeen || end !== reader.byteLength)
+                return undefined;
+            return await reader.get(position + 8, 4) ? dimensions : undefined;
+        }
+        if (type === "IDAT") {
+            if (dataEnded || (reader.head[25] === 3 && !paletteSeen))
+                return undefined;
+            dataStarted = true;
+            if (length > 0)
+                dataSeen = true;
+        }
+        else {
+            if (dataStarted)
+                dataEnded = true;
+            if (type === "PLTE") {
+                if (paletteSeen || dataStarted || !length || length > 768 || length % 3 || [0, 4].includes(reader.head[25]))
+                    return undefined;
+                paletteSeen = true;
+            }
+            else if (!PNG_ANCILLARY.has(type))
+                return undefined;
+        }
+        // 中间 payload/checksum 按长度跳过，最终 IEND checksum 稀疏读确认 EOF。
+        position = end;
+    }
+    return undefined;
+}
+function webpPayload(type, data) {
+    if (type === "VP8 ") {
+        if (data.length < 10 || data[0] & 1 || data.toString("hex", 3, 6) !== "9d012a")
+            return undefined;
+        return { width: data.readUInt16LE(6) & 0x3fff, height: data.readUInt16LE(8) & 0x3fff };
+    }
+    if (data.length < 5 || data[0] !== 0x2f)
+        return undefined;
+    const bits = data.readUInt32LE(1);
+    if (bits >>> 29 !== 0)
+        return undefined;
+    return { width: (bits & 0x3fff) + 1, height: ((bits >>> 14) & 0x3fff) + 1 };
+}
+export async function staticWebp(reader) {
+    if (reader.head.readUInt32LE(4) + 8 !== reader.byteLength)
+        return undefined;
+    let position = 12;
+    let canvas;
+    let dimensions;
+    let flags = 0;
+    let imageType;
+    const seen = new Set();
+    let losslessAlpha = false;
+    while (position < reader.byteLength && reader.step()) {
+        const header = await reader.get(position, 8);
+        if (!header)
+            return undefined;
+        const type = header.toString("latin1", 0, 4);
+        const length = header.readUInt32LE(4);
+        const start = position + 8;
+        const end = start + length + (length & 1);
+        if (end > reader.byteLength || seen.has(type) || type === "ANIM" || type === "ANMF")
+            return undefined;
+        seen.add(type);
+        if (type === "VP8X") {
+            const data = length === 10 && position === 12 ? await reader.get(start, 10) : undefined;
+            if (!data || data[0] & 0xc3 || data[1] || data[2] || data[3])
+                return undefined;
+            flags = data[0];
+            canvas = { width: data.readUIntLE(4, 3) + 1, height: data.readUIntLE(7, 3) + 1 };
+        }
+        else if (type === "VP8 " || type === "VP8L") {
+            if (dimensions || (seen.has("ALPH") && type !== "VP8 "))
+                return undefined;
+            const required = type === "VP8 " ? 10 : 5;
+            const data = length >= required ? await reader.get(start, required) : undefined;
+            if (!data)
+                return undefined;
+            dimensions = webpPayload(type, data);
+            if (!dimensions || !dimensions.width || !dimensions.height)
+                return undefined;
+            imageType = type;
+            losslessAlpha = type === "VP8L" && !!(data[4] & 0x10);
+            if (canvas && (canvas.width !== dimensions.width || canvas.height !== dimensions.height))
+                return undefined;
+        }
+        else if (type === "ICCP" || type === "ALPH" || type === "EXIF" || type === "XMP ") {
+            if (!canvas || !length)
+                return undefined;
+            if ((type === "ICCP" || type === "ALPH") && dimensions)
+                return undefined;
+            if ((type === "EXIF" || type === "XMP ") && !dimensions)
+                return undefined;
+            if (type === "ALPH") {
+                const data = await reader.get(start, 1);
+                if (!data || data[0] & 0xc0 || (data[0] & 3) > 1 || ((data[0] >> 4) & 3) > 1)
+                    return undefined;
+            }
+        }
+        else
+            return undefined;
+        if (length & 1) {
+            const padding = await reader.get(end - 1, 1);
+            if (!padding || padding[0] !== 0)
+                return undefined;
+        }
+        position = end;
+    }
+    if (position !== reader.byteLength || !dimensions)
+        return undefined;
+    if (canvas && (Boolean(flags & 0x20) !== seen.has("ICCP") || Boolean(flags & 0x08) !== seen.has("EXIF")
+        || Boolean(flags & 0x04) !== seen.has("XMP ") || Boolean(flags & 0x10) !== (seen.has("ALPH") || losslessAlpha)))
+        return undefined;
+    if (!canvas && (seen.size !== 1 || (imageType !== "VP8 " && imageType !== "VP8L")))
+        return undefined;
+    // 即使最后一个压缩 payload 没有 padding，也确认声明的文件末字节存在。
+    return await reader.get(reader.byteLength - 1, 1) ? dimensions : undefined;
+}
+export function staticGif(head, byteLength) {
+    // GIF 的压缩块不能稀疏跳过证明帧数；超过已有头预算时仅提供下载。
+    if (head.length !== byteLength || head.length < 13)
+        return undefined;
+    const dimensions = { width: head.readUInt16LE(6), height: head.readUInt16LE(8) };
+    if (!dimensions.width || !dimensions.height)
+        return undefined;
+    const globalTable = !!(head[10] & 0x80);
+    let position = 13 + (globalTable ? 3 * 2 ** ((head[10] & 7) + 1) : 0);
+    let steps = 0;
+    let frames = 0;
+    let controlPending = false;
+    const step = () => ++steps <= MAX_STRUCTURE_STEPS;
+    const subblocks = (requireData) => {
+        let dataSeen = false;
+        while (position < head.length && step()) {
+            const length = head[position++];
+            if (!length)
+                return !requireData || dataSeen;
+            dataSeen = true;
+            position += length;
+            if (position > head.length)
+                return false;
+        }
+        return false;
+    };
+    while (position < head.length && step()) {
+        const type = head[position++];
+        if (type === 0x3b)
+            return frames === 1 && !controlPending && position === head.length ? dimensions : undefined;
+        if (type === 0x21) {
+            const label = head[position++];
+            if (label === 0xf9) {
+                if (controlPending || position + 6 > head.length || head[position] !== 4 || head[position + 5] !== 0)
+                    return undefined;
+                const packed = head[position + 1];
+                if (packed & 0xe0 || ((packed >> 2) & 7) > 3)
+                    return undefined;
+                controlPending = true;
+                position += 6;
+            }
+            else if (label === 0xfe) {
+                if (!subblocks(false))
+                    return undefined;
+            }
+            else {
+                // Plain Text 可产生额外渲染；应用扩展语义未知，不能证明静态。
+                return undefined;
+            }
+            continue;
+        }
+        if (type !== 0x2c || ++frames !== 1 || position + 9 > head.length)
+            return undefined;
+        const left = head.readUInt16LE(position);
+        const top = head.readUInt16LE(position + 2);
+        const width = head.readUInt16LE(position + 4);
+        const height = head.readUInt16LE(position + 6);
+        const packed = head[position + 8];
+        if (!width || !height || left + width > dimensions.width || top + height > dimensions.height || packed & 0x18)
+            return undefined;
+        const localTable = !!(packed & 0x80);
+        if (!globalTable && !localTable)
+            return undefined;
+        position += 9 + (localTable ? 3 * 2 ** ((packed & 7) + 1) : 0);
+        if (position >= head.length || head[position] < 2 || head[position] > 8)
+            return undefined;
+        position++;
+        if (!subblocks(true))
+            return undefined;
+        controlPending = false;
+    }
+    return undefined;
+}
+//# sourceMappingURL=image-structure.js.map

package/dist/files/image-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-structure.js","sourceRoot":"","sources":["../../src/files/image-structure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,CAAC;AACrC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhL,uCAAuC;AACvC,MAAM,OAAO,oBAAoB;IAGF;IAA6B;IAAuB;IAA4B;IAFrG,KAAK,GAAG,CAAC,CAAC;IACV,aAAa,GAAG,CAAC,CAAC;IAC1B,YAA6B,MAAkB,EAAW,IAAY,EAAW,UAAkB,EAAU,KAAa;QAA7F,WAAM,GAAN,MAAM,CAAY;QAAW,SAAI,GAAJ,IAAI,CAAQ;QAAW,eAAU,GAAV,UAAU,CAAQ;QAAU,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9H,IAAI,KAAc,OAAO,EAAE,IAAI,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC,CAAC;IAE/D,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,MAAc;QACxC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAC3H,IAAI,QAAQ,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;QAClG,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;QACxE,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;QACnE,OAAO,MAAM,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;YAClC,6CAA6C;YAC7C,IAAI,IAAI,CAAC,KAAK,IAAI,oBAAoB,IAAI,IAAI,CAAC,aAAa,GAAG,SAAS,GAAG,kBAAkB;gBAAE,OAAO,SAAS,CAAC;YAChH,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;YAChC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;YAC3F,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,SAAS;gBAAE,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC;YAClH,MAAM,IAAI,SAAS,CAAC;QACtB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACpH,MAAM,MAAM,GAA6B,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACtH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAE,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACnH,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,KAAK,GAAG,UAAU,IAAI,MAAM,GAAG,UAAU;QAAE,OAAO,SAAS,CAAC;IAC/F,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA4B;IAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,OAAO,QAAQ,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC;QACnC,IAAI,MAAM,GAAG,UAAU,IAAI,GAAG,GAAG,MAAM,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QACrE,uCAAuC;QACvC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9D,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,KAAK,MAAM,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAC;YAC7E,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC3E,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,MAAM,GAAG,CAAC;gBAAE,QAAQ,GAAG,IAAI,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,WAAW;gBAAE,SAAS,GAAG,IAAI,CAAC;YAClC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,IAAI,WAAW,IAAI,WAAW,IAAI,CAAC,MAAM,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAC/H,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;iBAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;QACxD,CAAC;QACD,wDAAwD;QACxD,QAAQ,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,IAAY;IAC7C,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAClG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAA4B;IAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAC5E,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,MAA8B,CAAC;IACnC,IAAI,UAAkC,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAA6B,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,OAAO,QAAQ,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;YAAE,OAAO,SAAS,CAAC;QACtG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,KAAK,EAAE,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YAChF,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;YACjB,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACnF,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9C,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,MAAM,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC1E,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChF,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YAC7E,SAAS,GAAG,IAAI,CAAC;YACjB,aAAa,GAAG,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC;YACvD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC7G,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpF,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YACzC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI,UAAU;gBAAE,OAAO,SAAS,CAAC;YACzE,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAC;YAC1E,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;oBAAE,OAAO,SAAS,CAAC;YACpG,CAAC;QACH,CAAC;;YAAM,OAAO,SAAS,CAAC;QACxB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;QACrD,CAAC;QACD,QAAQ,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,CAAC,UAAU,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;WAClG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACpI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrG,6CAA6C;IAC7C,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAkB;IACxD,oCAAoC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACrE,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,GAAG,IAAI,CAAC,CAAC;IACzC,IAAI,QAAQ,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,EAAE,KAAK,IAAI,mBAAmB,CAAC;IAClD,MAAM,SAAS,GAAG,CAAC,WAAoB,EAAW,EAAE;QAClD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAE,CAAC;YACjC,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC;YAC7C,QAAQ,GAAG,IAAI,CAAC;YAChB,QAAQ,IAAI,MAAM,CAAC;YACnB,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;QAC3C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAE,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,QAAQ,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/G,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,IAAI,cAAc,IAAI,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC;oBAAE,OAAO,SAAS,CAAC;gBACvH,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAE,CAAC;gBACnC,IAAI,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAC/D,cAAc,GAAG,IAAI,CAAC;gBACtB,QAAQ,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;oBAAE,OAAO,SAAS,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,sCAAsC;gBACtC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,MAAM,KAAK,CAAC,IAAI,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAE,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,GAAG,GAAG,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,GAAG,IAAI;YAAE,OAAO,SAAS,CAAC;QAChI,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClD,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAE,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5F,QAAQ,EAAE,CAAC;QACX,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACvC,cAAc,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/files/publications.d.ts

@@ -0,0 +1,26 @@
+import { type SessionManager } from "@earendil-works/pi-coding-agent";
+import { type PublishedFileMetadata } from "../vendor/protocol/session/index.js";
+import { z } from "zod";
+export declare const PUBLISHED_FILE_TOOL_NAME: "publish_file";
+export type ConfirmedPublication = {
+    id: string;
+    sourcePath: string;
+    metadata: PublishedFileMetadata;
+    groupId?: string;
+    timestamp: number;
+    branchPosition: number;
+};
+/** 只存于原生 custom；不能把此 schema 当作 wire payload。 */
+export declare const publicationDataSchema: z.ZodObject<{
+    file_name: z.ZodString;
+    mime_type: z.ZodString;
+    byte_length: z.ZodNumber;
+    tool_call_id: z.ZodString;
+    source_path: z.ZodString;
+    group_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * 原生成功 toolResult 是确认点，且 custom/result 两者均须已落盘。
+ * 失败 append 留下的内部孤立记录无资格；不尝试回滚 SDK 的 append-only 树。
+ */
+export declare function collectPublications(manager: SessionManager): Map<string, ConfirmedPublication>;

package/dist/files/publications.js

@@ -0,0 +1,136 @@
+import { readFileSync, statSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { parseSessionEntries } from "@earendil-works/pi-coding-agent";
+import { idSchema, PUBLISHED_FILE_TYPE, publishedFileMetadataSchema } from "../vendor/protocol/session/index.js";
+import { z } from "zod";
+export const PUBLISHED_FILE_TOOL_NAME = "publish_file";
+/** 只存于原生 custom；不能把此 schema 当作 wire payload。 */
+export const publicationDataSchema = publishedFileMetadataSchema.extend({
+    source_path: z.string().min(1).refine((path) => !path.includes("\0") && isAbsolute(path) && resolve(path) === path),
+    group_id: idSchema.optional(),
+}).strict();
+const resultDetailsSchema = z.object({ publication_id: idSchema }).strict();
+// 一个 manager 最多保留一个文件的解析结果；manager 回收时缓存随之回收。
+const diskProofs = new WeakMap();
+function sameFile(left, right) {
+    return left.dev === right.dev && left.ino === right.ino && left.size === right.size
+        && left.mtimeNs === right.mtimeNs && left.ctimeNs === right.ctimeNs;
+}
+function diskEntries(manager) {
+    try {
+        const path = manager.getSessionFile();
+        if (!path)
+            return null;
+        const before = statSync(path, { bigint: true });
+        if (!before.isFile())
+            return null;
+        const cached = diskProofs.get(manager);
+        if (cached?.path === path && sameFile(cached.stat, before))
+            return cached.entries;
+        const entries = parseSessionEntries(readFileSync(path, "utf8"));
+        const after = statSync(path, { bigint: true });
+        if (!after.isFile() || !sameFile(before, after))
+            return null;
+        diskProofs.set(manager, { path, stat: after, entries });
+        return entries;
+    }
+    catch {
+        diskProofs.delete(manager);
+        return null;
+    }
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** JSONL 不存 undefined 字段；比较完整原生记录而非只比较 publication_id。 */
+function samePersistedEntry(current, persisted) {
+    return isDeepStrictEqual(JSON.parse(JSON.stringify(current)), persisted);
+}
+function addByCall(map, callId, value) {
+    if (typeof callId !== "string")
+        return;
+    const matches = map.get(callId) ?? [];
+    matches.push(value);
+    map.set(callId, matches);
+}
+/**
+ * 原生成功 toolResult 是确认点，且 custom/result 两者均须已落盘。
+ * 失败 append 留下的内部孤立记录无资格；不尝试回滚 SDK 的 append-only 树。
+ */
+export function collectPublications(manager) {
+    const confirmed = new Map();
+    try {
+        const persisted = diskEntries(manager);
+        if (!persisted)
+            return confirmed;
+        const headers = persisted.filter((entry) => record(entry) && entry.type === "session");
+        const header = manager.getHeader();
+        if (headers.length !== 1 || persisted[0] !== headers[0] || !header
+            || header.id !== manager.getSessionId() || !samePersistedEntry(header, headers[0]))
+            return confirmed;
+        const diskById = new Map();
+        for (const entry of persisted) {
+            if (!record(entry) || !idSchema.safeParse(entry.id).success || diskById.has(entry.id))
+                return confirmed;
+            diskById.set(entry.id, entry);
+        }
+        const branch = manager.getBranch();
+        const customs = new Map();
+        const results = new Map();
+        const branchIds = new Set();
+        const persistedPrefixes = [];
+        let persistedPrefix = true;
+        for (let index = 0; index < branch.length; index++) {
+            const entry = branch[index];
+            if (branchIds.has(entry.id) || entry.parentId !== (index === 0 ? null : branch[index - 1].id))
+                return confirmed;
+            branchIds.add(entry.id);
+            const diskEntry = diskById.get(entry.id);
+            persistedPrefix = persistedPrefix && diskEntry?.type === entry.type
+                && "parentId" in diskEntry && diskEntry.parentId === entry.parentId;
+            persistedPrefixes.push(persistedPrefix);
+            if (entry.type === "custom" && entry.customType === PUBLISHED_FILE_TYPE) {
+                addByCall(customs, record(entry.data) ? entry.data.tool_call_id : undefined, { entry, index });
+            }
+            else if (entry.type === "message" && entry.message.role === "toolResult" && entry.message.toolName === PUBLISHED_FILE_TOOL_NAME) {
+                addByCall(results, entry.message.toolCallId, { entry, index });
+            }
+        }
+        const candidates = [];
+        for (const [callId, matches] of customs) {
+            const tools = results.get(callId);
+            if (matches.length !== 1 || tools?.length !== 1)
+                continue;
+            const custom = matches[0];
+            const result = tools[0];
+            const data = publicationDataSchema.safeParse(custom.entry.data);
+            const message = result.entry.message;
+            if (!data.success || message.role !== "toolResult" || message.isError !== false
+                || result.index <= custom.index || !persistedPrefixes[result.index])
+                continue;
+            const details = resultDetailsSchema.safeParse(message.details);
+            const timestamp = Date.parse(custom.entry.timestamp);
+            if (!details.success || details.data.publication_id !== custom.entry.id || !Number.isFinite(timestamp) || timestamp < 0)
+                continue;
+            if (!samePersistedEntry(custom.entry, diskById.get(custom.entry.id))
+                || !samePersistedEntry(result.entry, diskById.get(result.entry.id)))
+                continue;
+            const { source_path, group_id, ...metadata } = data.data;
+            candidates.push({
+                id: custom.entry.id, sourcePath: source_path, metadata, timestamp,
+                ...(group_id === undefined ? {} : { groupId: group_id }),
+                branchPosition: result.index + 0.5,
+            });
+        }
+        candidates.sort((left, right) => left.branchPosition - right.branchPosition);
+        for (const candidate of candidates)
+            confirmed.set(candidate.id, candidate);
+        return confirmed;
+    }
+    catch {
+        // 不可信或无法读取的原生记录只能拒绝资格，不能降级为内存证明。
+        return new Map();
+    }
+}
+//# sourceMappingURL=publications.js.map

package/dist/files/publications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publications.js","sourceRoot":"","sources":["../../src/files/publications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAoB,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAA0D,MAAM,iCAAiC,CAAC;AAC9H,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,2BAA2B,EAA8B,MAAM,4BAA4B,CAAC;AACpI,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAuB,CAAC;AAWhE,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,MAAM,CAAC;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACnH,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC,MAAM,EAAE,CAAC;AACZ,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE5E,8CAA8C;AAC9C,MAAM,UAAU,GAAG,IAAI,OAAO,EAA6B,CAAC;AAE5D,SAAS,QAAQ,CAAC,IAAiB,EAAE,KAAkB;IACrD,OAAO,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;WAC9E,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;AACxE,CAAC;AAED,SAAS,WAAW,CAAC,OAAuB;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC;QAClF,MAAM,OAAO,GAAG,mBAAmB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7D,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,0DAA0D;AAC1D,SAAS,kBAAkB,CAAC,OAAgB,EAAE,SAAkB;IAC9D,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,SAAS,CAAI,GAAqB,EAAE,MAAe,EAAE,KAAQ;IACpE,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM;eAC7D,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAEvG,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsF,CAAC;QAC9G,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuF,CAAC;QAC/G,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,MAAM,iBAAiB,GAAc,EAAE,CAAC;QACxC,IAAI,eAAe,GAAG,IAAI,CAAC;QAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAE,CAAC;YAC7B,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAC;YACjH,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzC,eAAe,GAAG,eAAe,IAAI,SAAS,EAAE,IAAI,KAAK,KAAK,CAAC,IAAI;mBAC9D,UAAU,IAAI,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;YACtE,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;gBACxE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACjG,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,wBAAwB,EAAE,CAAC;gBAClI,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAA2B,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,EAAE,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACzB,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;mBAC1E,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,SAAS;YAChF,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,cAAc,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC;gBAAE,SAAS;YAClI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;mBAC/D,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAAE,SAAS;YAChF,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;YACzD,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS;gBACjE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACxD,cAAc,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG;aACnC,CAAC,CAAC;QACL,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7E,KAAK,MAAM,SAAS,IAAI,UAAU;YAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3E,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/files/publish-tool.d.ts

@@ -0,0 +1,23 @@
+import type { SessionManager, ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+declare const parameters: Type.TObject<{
+    path: Type.TString;
+}>;
+export type PublishFileToolOptions = {
+    getManager: () => SessionManager | null;
+    isCurrent: () => boolean;
+    getGeneration: () => number;
+    getGroupId: () => string | null;
+    /** 仅在共享资源账目中完成 inspection 并关闭句柄后 resolve。 */
+    inspect: (absolutePath: string) => Promise<{
+        sourcePath: string;
+        fileName: string;
+        mimeType: string;
+        byteLength: number;
+    }>;
+};
+export type PublishFileToolDetails = {
+    publication_id: string;
+};
+export declare function createPublishFileTool(options: PublishFileToolOptions): ToolDefinition<typeof parameters, PublishFileToolDetails>;
+export {};

package/dist/files/publish-tool.js

@@ -0,0 +1,70 @@
+import { resolve } from "node:path";
+import { statSync } from "node:fs";
+import { PUBLISHED_FILE_TYPE } from "../vendor/protocol/session/index.js";
+import { Type } from "typebox";
+import { publicationDataSchema, PUBLISHED_FILE_TOOL_NAME } from "./publications.js";
+const parameters = Type.Object({ path: Type.String({ minLength: 1 }) }, { additionalProperties: false });
+const FAILURE_TEXT = "文件发布失败";
+function storedSession(manager, file) {
+    try {
+        return manager.isPersisted() && !!file && statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function createPublishFileTool(options) {
+    // SDK sequential 是调度约束；此门禁也阻止意外重入或嵌套直接调用。
+    let executing = false;
+    return {
+        name: PUBLISHED_FILE_TOOL_NAME,
+        label: "发布文件",
+        description: "仅发布面向用户交付的成果，或用户明确要求的文件；不要自动发布所有读取、修改或临时文件。已授权 PWA 可能自动获取受支持的小图片。path 相对当前工作目录或为绝对路径，允许项目外的普通文件；只保存引用，不复制原件。",
+        parameters,
+        executionMode: "sequential",
+        async execute(toolCallId, args, signal, _onUpdate, ctx) {
+            if (executing)
+                throw new Error(FAILURE_TEXT);
+            executing = true;
+            try {
+                const manager = options.getManager();
+                const generation = options.getGeneration();
+                const groupId = options.getGroupId();
+                if (!manager)
+                    throw new Error(FAILURE_TEXT);
+                const sessionId = manager.getSessionId();
+                const sessionFile = manager.getSessionFile();
+                const valid = () => options.isCurrent() && !signal?.aborted && !ctx.signal?.aborted
+                    && options.getGeneration() === generation && options.getManager() === manager
+                    && ctx.sessionManager === manager && ctx.sessionManager.getSessionId() === sessionId
+                    && manager.getSessionId() === sessionId && manager.getSessionFile() === sessionFile
+                    && storedSession(manager, sessionFile);
+                if (!valid() || typeof args.path !== "string" || !args.path || args.path.includes("\0"))
+                    throw new Error(FAILURE_TEXT);
+                const inspected = await options.inspect(resolve(ctx.cwd, args.path));
+                const data = publicationDataSchema.parse({
+                    source_path: inspected.sourcePath,
+                    file_name: inspected.fileName,
+                    mime_type: inspected.mimeType,
+                    byte_length: inspected.byteLength,
+                    tool_call_id: toolCallId,
+                    ...(groupId === null ? {} : { group_id: groupId }),
+                });
+                if (!valid())
+                    throw new Error(FAILURE_TEXT);
+                const text = `已发布文件引用：${data.file_name} · ${data.mime_type} · ${data.byte_length} B`;
+                const publicationId = manager.appendCustomEntry(PUBLISHED_FILE_TYPE, data);
+                // append 后没有可失败的 await；正式资格由随后落盘的成功原生 toolResult 建立。
+                return { content: [{ type: "text", text }], details: { publication_id: publicationId } };
+            }
+            catch {
+                // SDK 会将 throw 转为 isError；不把内部路径或 I/O 异常暴露给消息与日志。
+                throw new Error(FAILURE_TEXT);
+            }
+            finally {
+                executing = false;
+            }
+        },
+    };
+}
+//# sourceMappingURL=publish-tool.js.map

package/dist/files/publish-tool.js.map

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

package/dist/files/reader.d.ts

@@ -0,0 +1,66 @@
+import { type ClientFrame, type ServerFrame } from "../vendor/protocol/session/index.js";
+export type FileScope = {
+    ownerId: string;
+    channelId: string;
+    runtimeId: string;
+    sessionId: string;
+    generation: number;
+};
+type Request = Extract<ClientFrame, {
+    type: "file_open" | "file_read" | "file_close";
+}>;
+type Response = Extract<ServerFrame, {
+    type: "file_opened" | "file_chunk" | "file_closed" | "file_error";
+}>;
+type Options = {
+    resolve: (scope: FileScope, publicationId: string) => {
+        sourcePath: string;
+    } | null | Promise<{
+        sourcePath: string;
+    } | null>;
+    isCurrent: (scope: FileScope) => boolean;
+    idleMs?: number;
+    maxResources?: number;
+};
+/** 所有异步任务共享额度；失效不等于内核 I/O 已停止或句柄已关闭。 */
+export declare class FileReaderRuntime {
+    private readonly options;
+    private readonly resources;
+    private readonly opens;
+    private readonly idleMs;
+    private readonly maxResources;
+    private timer?;
+    private timerDeadline?;
+    private disposed;
+    constructor(options: Options);
+    get resourceCount(): number;
+    private reserve;
+    private schedule;
+    private invalidate;
+    private assertCurrent;
+    private eligible;
+    private checked;
+    private release;
+    private closeHandle;
+    private cleanup;
+    private finish;
+    private reply;
+    private failure;
+    handle(frame: Request, suppliedScope: FileScope): Promise<Response>;
+    private open;
+    private openResponse;
+    private openTask;
+    private verify;
+    private readTask;
+    private read;
+    inspectForPublication(path: string): Promise<{
+        sourcePath: string;
+        fileName: string;
+        mimeType: string;
+        byteLength: number;
+    }>;
+    private inspectTask;
+    closeWhere(predicate: (scope: FileScope) => boolean): Promise<void>;
+    dispose(): Promise<void>;
+}
+export {};