@yefengr/pi-reach 0.0.6 → 0.0.7

package/dist/vendor/protocol/session/frames.d.ts

@@ -243,6 +243,31 @@ export declare const attachmentDiscardFrameSchema: z.ZodObject<{
     type: z.ZodLiteral<"attachment_discard">;
     id: z.ZodString;
 }, z.core.$strict>;
+export declare const fileOpenFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file_open">;
+    id: z.ZodString;
+    publication_id: z.ZodString;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>;
+export declare const fileReadFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file_read">;
+    id: z.ZodString;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>;
+export declare const fileCloseFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file_close">;
+    id: z.ZodString;
+    transfer_id: z.ZodString;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>;
 export declare const pairOkFrameSchema: z.ZodObject<{
     type: z.ZodLiteral<"pair_ok">;
     in_reply_to: z.ZodString;
@@ -1459,6 +1484,7 @@ export declare const protocolErrorFrameSchema: z.ZodUnion<readonly [z.ZodObject<
     type: z.ZodLiteral<"protocol_error">;
     in_reply_to: z.ZodOptional<z.ZodString>;
     code: z.ZodEnum<{
+        too_large: "too_large";
         internal_error: "internal_error";
         protocol_upgrade_required: "protocol_upgrade_required";
         invalid_message: "invalid_message";
@@ -1467,7 +1493,6 @@ export declare const protocolErrorFrameSchema: z.ZodUnion<readonly [z.ZodObject<
         invalid_leaf: "invalid_leaf";
         invalid_cursor: "invalid_cursor";
         reset_required: "reset_required";
-        too_large: "too_large";
     }>;
     message: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
@@ -1475,6 +1500,7 @@ export declare const protocolErrorFrameSchema: z.ZodUnion<readonly [z.ZodObject<
     type: z.ZodLiteral<"protocol_error">;
     in_reply_to: z.ZodOptional<z.ZodString>;
     code: z.ZodEnum<{
+        too_large: "too_large";
         internal_error: "internal_error";
         protocol_upgrade_required: "protocol_upgrade_required";
         invalid_message: "invalid_message";
@@ -1483,7 +1509,6 @@ export declare const protocolErrorFrameSchema: z.ZodUnion<readonly [z.ZodObject<
         invalid_leaf: "invalid_leaf";
         invalid_cursor: "invalid_cursor";
         reset_required: "reset_required";
-        too_large: "too_large";
     }>;
     message: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
@@ -1652,14 +1677,14 @@ export declare const attachmentStateFrameSchema: z.ZodUnion<readonly [z.ZodObjec
 export declare const attachmentErrorCodeSchema: z.ZodEnum<{
     cancelled: "cancelled";
     too_large: "too_large";
+    offset_mismatch: "offset_mismatch";
+    busy: "busy";
+    io_error: "io_error";
     invalid_scope: "invalid_scope";
     not_found: "not_found";
     invalid_upload: "invalid_upload";
-    busy: "busy";
     no_space: "no_space";
-    io_error: "io_error";
     integrity_mismatch: "integrity_mismatch";
-    offset_mismatch: "offset_mismatch";
 }>;
 export declare const attachmentDiscardedFrameSchema: z.ZodObject<{
     type: z.ZodLiteral<"attachment_discarded">;
@@ -1681,14 +1706,14 @@ export declare const attachmentErrorFrameSchema: z.ZodObject<{
     code: z.ZodEnum<{
         cancelled: "cancelled";
         too_large: "too_large";
+        offset_mismatch: "offset_mismatch";
+        busy: "busy";
+        io_error: "io_error";
         invalid_scope: "invalid_scope";
         not_found: "not_found";
         invalid_upload: "invalid_upload";
-        busy: "busy";
         no_space: "no_space";
-        io_error: "io_error";
         integrity_mismatch: "integrity_mismatch";
-        offset_mismatch: "offset_mismatch";
     }>;
     retryable: z.ZodBoolean;
     in_reply_to: z.ZodString;
@@ -1697,6 +1722,78 @@ export declare const attachmentErrorFrameSchema: z.ZodObject<{
     target_channel_id: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
 }, z.core.$strict>;
+export declare const fileOpenedFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file_opened">;
+    publication_id: z.ZodString;
+    transfer_id: z.ZodString;
+    file_name: z.ZodString;
+    mime_type: z.ZodString;
+    byte_length: z.ZodNumber;
+    preview: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"image">;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>]>;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>;
+/** Final chunks carry the transfer digest; only a zero-length file has an empty final chunk. */
+export declare const fileChunkFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
+    data_base64: z.ZodString;
+    final: z.ZodLiteral<false>;
+    type: z.ZodLiteral<"file_chunk">;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    data_base64: z.ZodString;
+    final: z.ZodLiteral<true>;
+    total_bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    type: z.ZodLiteral<"file_chunk">;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>]>;
+export declare const fileClosedFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file_closed">;
+    transfer_id: z.ZodString;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>;
+export declare const fileErrorFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file_error">;
+    transfer_id: z.ZodOptional<z.ZodString>;
+    code: z.ZodEnum<{
+        not_available: "not_available";
+        permission_denied: "permission_denied";
+        not_regular_file: "not_regular_file";
+        too_large: "too_large";
+        file_changed: "file_changed";
+        invalid_transfer: "invalid_transfer";
+        offset_mismatch: "offset_mismatch";
+        busy: "busy";
+        io_error: "io_error";
+    }>;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>;
 export declare const clientFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"pair_request">;
     id: z.ZodString;
@@ -1916,6 +2013,28 @@ export declare const clientFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     protocol_version: z.ZodLiteral<2>;
     type: z.ZodLiteral<"attachment_discard">;
     id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_open">;
+    id: z.ZodString;
+    publication_id: z.ZodString;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_read">;
+    id: z.ZodString;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_close">;
+    id: z.ZodString;
+    transfer_id: z.ZodString;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
 }, z.core.$strict>]>;
 export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"pair_ok">;
@@ -3123,6 +3242,7 @@ export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"protocol_error">;
     in_reply_to: z.ZodOptional<z.ZodString>;
     code: z.ZodEnum<{
+        too_large: "too_large";
         internal_error: "internal_error";
         protocol_upgrade_required: "protocol_upgrade_required";
         invalid_message: "invalid_message";
@@ -3131,7 +3251,6 @@ export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
         invalid_leaf: "invalid_leaf";
         invalid_cursor: "invalid_cursor";
         reset_required: "reset_required";
-        too_large: "too_large";
     }>;
     message: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
@@ -3139,6 +3258,7 @@ export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"protocol_error">;
     in_reply_to: z.ZodOptional<z.ZodString>;
     code: z.ZodEnum<{
+        too_large: "too_large";
         internal_error: "internal_error";
         protocol_upgrade_required: "protocol_upgrade_required";
         invalid_message: "invalid_message";
@@ -3147,7 +3267,6 @@ export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
         invalid_leaf: "invalid_leaf";
         invalid_cursor: "invalid_cursor";
         reset_required: "reset_required";
-        too_large: "too_large";
     }>;
     message: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
@@ -3309,14 +3428,14 @@ export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     code: z.ZodEnum<{
         cancelled: "cancelled";
         too_large: "too_large";
+        offset_mismatch: "offset_mismatch";
+        busy: "busy";
+        io_error: "io_error";
         invalid_scope: "invalid_scope";
         not_found: "not_found";
         invalid_upload: "invalid_upload";
-        busy: "busy";
         no_space: "no_space";
-        io_error: "io_error";
         integrity_mismatch: "integrity_mismatch";
-        offset_mismatch: "offset_mismatch";
     }>;
     retryable: z.ZodBoolean;
     in_reply_to: z.ZodString;
@@ -3336,6 +3455,73 @@ export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     upload_scope: z.ZodString;
     target_channel_id: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_opened">;
+    publication_id: z.ZodString;
+    transfer_id: z.ZodString;
+    file_name: z.ZodString;
+    mime_type: z.ZodString;
+    byte_length: z.ZodNumber;
+    preview: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"image">;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>]>;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+    data_base64: z.ZodString;
+    final: z.ZodLiteral<false>;
+    type: z.ZodLiteral<"file_chunk">;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    data_base64: z.ZodString;
+    final: z.ZodLiteral<true>;
+    total_bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    type: z.ZodLiteral<"file_chunk">;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>]>, z.ZodObject<{
+    type: z.ZodLiteral<"file_closed">;
+    transfer_id: z.ZodString;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_error">;
+    transfer_id: z.ZodOptional<z.ZodString>;
+    code: z.ZodEnum<{
+        not_available: "not_available";
+        permission_denied: "permission_denied";
+        not_regular_file: "not_regular_file";
+        too_large: "too_large";
+        file_changed: "file_changed";
+        invalid_transfer: "invalid_transfer";
+        offset_mismatch: "offset_mismatch";
+        busy: "busy";
+        io_error: "io_error";
+    }>;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
 }, z.core.$strict>]>;
 export declare const ClientFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"pair_request">;
@@ -3556,6 +3742,28 @@ export declare const ClientFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     protocol_version: z.ZodLiteral<2>;
     type: z.ZodLiteral<"attachment_discard">;
     id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_open">;
+    id: z.ZodString;
+    publication_id: z.ZodString;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_read">;
+    id: z.ZodString;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_close">;
+    id: z.ZodString;
+    transfer_id: z.ZodString;
+    channel_id: z.ZodString;
+    session_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
 }, z.core.$strict>]>;
 export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"pair_ok">;
@@ -4763,6 +4971,7 @@ export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"protocol_error">;
     in_reply_to: z.ZodOptional<z.ZodString>;
     code: z.ZodEnum<{
+        too_large: "too_large";
         internal_error: "internal_error";
         protocol_upgrade_required: "protocol_upgrade_required";
         invalid_message: "invalid_message";
@@ -4771,7 +4980,6 @@ export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
         invalid_leaf: "invalid_leaf";
         invalid_cursor: "invalid_cursor";
         reset_required: "reset_required";
-        too_large: "too_large";
     }>;
     message: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
@@ -4779,6 +4987,7 @@ export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"protocol_error">;
     in_reply_to: z.ZodOptional<z.ZodString>;
     code: z.ZodEnum<{
+        too_large: "too_large";
         internal_error: "internal_error";
         protocol_upgrade_required: "protocol_upgrade_required";
         invalid_message: "invalid_message";
@@ -4787,7 +4996,6 @@ export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
         invalid_leaf: "invalid_leaf";
         invalid_cursor: "invalid_cursor";
         reset_required: "reset_required";
-        too_large: "too_large";
     }>;
     message: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
@@ -4949,14 +5157,14 @@ export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     code: z.ZodEnum<{
         cancelled: "cancelled";
         too_large: "too_large";
+        offset_mismatch: "offset_mismatch";
+        busy: "busy";
+        io_error: "io_error";
         invalid_scope: "invalid_scope";
         not_found: "not_found";
         invalid_upload: "invalid_upload";
-        busy: "busy";
         no_space: "no_space";
-        io_error: "io_error";
         integrity_mismatch: "integrity_mismatch";
-        offset_mismatch: "offset_mismatch";
     }>;
     retryable: z.ZodBoolean;
     in_reply_to: z.ZodString;
@@ -4976,6 +5184,73 @@ export declare const ServerFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
     upload_scope: z.ZodString;
     target_channel_id: z.ZodString;
     protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_opened">;
+    publication_id: z.ZodString;
+    transfer_id: z.ZodString;
+    file_name: z.ZodString;
+    mime_type: z.ZodString;
+    byte_length: z.ZodNumber;
+    preview: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"image">;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>]>;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+    data_base64: z.ZodString;
+    final: z.ZodLiteral<false>;
+    type: z.ZodLiteral<"file_chunk">;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    data_base64: z.ZodString;
+    final: z.ZodLiteral<true>;
+    total_bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    type: z.ZodLiteral<"file_chunk">;
+    transfer_id: z.ZodString;
+    offset: z.ZodNumber;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>]>, z.ZodObject<{
+    type: z.ZodLiteral<"file_closed">;
+    transfer_id: z.ZodString;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"file_error">;
+    transfer_id: z.ZodOptional<z.ZodString>;
+    code: z.ZodEnum<{
+        not_available: "not_available";
+        permission_denied: "permission_denied";
+        not_regular_file: "not_regular_file";
+        too_large: "too_large";
+        file_changed: "file_changed";
+        invalid_transfer: "invalid_transfer";
+        offset_mismatch: "offset_mismatch";
+        busy: "busy";
+        io_error: "io_error";
+    }>;
+    in_reply_to: z.ZodString;
+    session_id: z.ZodString;
+    target_channel_id: z.ZodString;
+    protocol_version: z.ZodLiteral<2>;
 }, z.core.$strict>]>;
 export declare const SessionHistoryChunkSchema: z.ZodUnion<readonly [z.ZodObject<{
     final_chunk: z.ZodLiteral<false>;

package/dist/vendor/protocol/session/frames.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { actionNameSchema, byeReasonSchema, channelIdSchema, harnessSchema, leafIdSchema, headSequenceSchema, idSchema, MAX_ARRAY_ITEMS, imageMimeSchema, pairingCodeSchema, protocolVersionSchema, eventSequenceSchema, sequencedTimelineEventSchema, timelineEventFragmentSchema, timelinePartialSchema, thinkingLevelSchema, queuedMessageItemSchema, timestampSchema, userBlockSchema, wireImageSchema, wireModelSchema, CLIENT_FRAME_TYPES, SERVER_FRAME_TYPES, strictObject, textSchema, } from "./schema.js";
 import { ATTACHMENT_CHUNK_BYTES, ATTACHMENT_MAX_COUNT, ATTACHMENT_MAX_FILE_BYTES, ATTACHMENT_MAX_IN_FLIGHT, ATTACHMENT_MAX_MESSAGE_BYTES, attachmentByteLengthSchema, attachmentChunkDataSchema, attachmentDescriptorSchema, attachmentFileNameSchema, attachmentIdsSchema, attachmentPreviewSchema, attachmentSha256Schema, } from "./attachments.js";
+import { FILE_MAX_BYTES, canonicalBase64ByteLength, fileByteLengthSchema, fileChunkDataSchema, fileErrorCodeSchema, fileFileNameSchema, fileMimeSchema, fileOffsetSchema, filePreviewSchema, fileSha256Schema, } from "./files.js";
 const wireTimelineEventSchema = sequencedTimelineEventSchema;
 const protocol = { protocol_version: protocolVersionSchema };
 const channelRequest = { ...protocol, channel_id: channelIdSchema, session_id: idSchema, leaf_id: leafIdSchema };
@@ -8,6 +9,9 @@ const directResponse = { ...protocol, target_channel_id: channelIdSchema };
 const ownerBroadcast = { ...protocol, session_id: idSchema, leaf_id: leafIdSchema };
 const attachmentUploadRequest = { ...protocol, channel_id: channelIdSchema, session_id: idSchema, upload_scope: idSchema };
 const attachmentUploadResponse = { ...directResponse, in_reply_to: idSchema, session_id: idSchema, upload_scope: idSchema };
+// Published-file reads are scoped to channel/session only: they never carry leaf or upload_scope.
+const fileChannelRequest = { ...protocol, channel_id: channelIdSchema, session_id: idSchema };
+const fileResponse = { ...directResponse, in_reply_to: idSchema, session_id: idSchema };
 const safeOffsetSchema = z.number().int().nonnegative().finite().max(Number.MAX_SAFE_INTEGER);
 export const pairRequestFrameSchema = strictObject({ ...protocol, type: z.literal("pair_request"), id: idSchema, code: pairingCodeSchema, device_name: textSchema });
 export const sessionHelloFrameSchema = strictObject({ ...protocol, type: z.literal("session_hello"), id: idSchema, channel_id: channelIdSchema });
@@ -37,6 +41,9 @@ export const attachmentFinishFrameSchema = strictObject({ ...protocol, type: z.l
 export const attachmentStatusRequestFrameSchema = strictObject({ ...protocol, type: z.literal("attachment_status_request"), id: idSchema, ...attachmentUploadRequest, upload_id: idSchema });
 export const attachmentCancelFrameSchema = strictObject({ ...protocol, type: z.literal("attachment_cancel"), id: idSchema, ...attachmentUploadRequest, upload_id: idSchema });
 export const attachmentDiscardFrameSchema = strictObject({ ...protocol, type: z.literal("attachment_discard"), id: idSchema, ...attachmentUploadRequest, attachment_id: idSchema });
+export const fileOpenFrameSchema = strictObject({ ...fileChannelRequest, type: z.literal("file_open"), id: idSchema, publication_id: idSchema });
+export const fileReadFrameSchema = strictObject({ ...fileChannelRequest, type: z.literal("file_read"), id: idSchema, transfer_id: idSchema, offset: fileOffsetSchema });
+export const fileCloseFrameSchema = strictObject({ ...fileChannelRequest, type: z.literal("file_close"), id: idSchema, transfer_id: idSchema });
 export const pairOkFrameSchema = strictObject({ ...protocol, type: z.literal("pair_ok"), in_reply_to: idSchema, session_name: textSchema, session_started_at: timestampSchema, endpoint_id: idSchema, harness: harnessSchema.optional(), hostname: textSchema.optional() });
 export const pairErrorFrameSchema = strictObject({ ...protocol, type: z.literal("pair_error"), in_reply_to: idSchema, code: z.enum(["token_expired", "token_consumed", "token_unknown", "internal_error"]), message: textSchema.min(1) });
 export const sessionReadyFrameSchema = strictObject({ ...directResponse, type: z.literal("session_ready"), in_reply_to: idSchema, session_id: idSchema, leaf_id: leafIdSchema, head_seq: headSequenceSchema, self_sender_ref: idSchema });
@@ -107,8 +114,51 @@ export const attachmentErrorFrameSchema = strictObject({ ...attachmentUploadResp
         ctx.addIssue({ code: "custom", path: ["attachment_id"], message: "upload_id and attachment_id are mutually exclusive" });
     }
 });
-export const clientFrameSchema = z.union([pairRequestFrameSchema, sessionHelloFrameSchema, extensionInfoRequestFrameSchema, userMessageFrameSchema, userMessageObservedFrameSchema, sessionSyncFrameSchema, pingFrameSchema, cancelFrameSchema, sessionNewFrameSchema, sessionCompactFrameSchema, modelSetFrameSchema, thinkingSetFrameSchema, listModelsFrameSchema, queuedMessageSetFrameSchema, queuedMessageClearFrameSchema, queuedMessageSteerFrameSchema, approveToolFrameSchema, attachmentCapabilitiesRequestFrameSchema, attachmentBeginFrameSchema, attachmentChunkFrameSchema, attachmentFinishFrameSchema, attachmentStatusRequestFrameSchema, attachmentCancelFrameSchema, attachmentDiscardFrameSchema]);
-export const serverFrameSchema = z.union([pairOkFrameSchema, pairErrorFrameSchema, sessionReadyFrameSchema, extensionInfoFrameSchema, userMessageStartedFrameSchema, userMessageStatusFrameSchema, timelineEventFrameSchema, timelinePartialFrameSchema, timelineEventFragmentFrameSchema, sessionHistoryChunkFrameSchema, protocolErrorFrameSchema, resetFrameSchema, pongFrameSchema, cancelledFrameSchema, actionOkFrameSchema, actionErrorFrameSchema, modelsListFrameSchema, queuedMessageStateFrameSchema, byeFrameSchema, attachmentCapabilitiesFrameSchema, attachmentStateFrameSchema, attachmentErrorFrameSchema, attachmentDiscardedFrameSchema]);
+export const fileOpenedFrameSchema = strictObject({
+    ...fileResponse,
+    type: z.literal("file_opened"),
+    publication_id: idSchema,
+    transfer_id: idSchema,
+    file_name: fileFileNameSchema,
+    mime_type: fileMimeSchema,
+    byte_length: fileByteLengthSchema,
+    preview: filePreviewSchema,
+});
+const fileChunkFields = {
+    ...fileResponse,
+    type: z.literal("file_chunk"),
+    transfer_id: idSchema,
+    offset: fileOffsetSchema,
+};
+/** Final chunks carry the transfer digest; only a zero-length file has an empty final chunk. */
+export const fileChunkFrameSchema = z.union([
+    strictObject({ ...fileChunkFields, data_base64: fileChunkDataSchema, final: z.literal(false) }),
+    strictObject({ ...fileChunkFields, data_base64: fileChunkDataSchema, final: z.literal(true), total_bytes: fileByteLengthSchema, sha256: fileSha256Schema }),
+]).superRefine((frame, ctx) => {
+    const decoded = canonicalBase64ByteLength(frame.data_base64);
+    if (decoded === null) {
+        ctx.addIssue({ code: "custom", path: ["data_base64"], message: "data_base64 must be canonical Base64" });
+        return;
+    }
+    if (frame.final) {
+        if (decoded === 0 && (frame.offset !== 0 || frame.total_bytes !== 0)) {
+            ctx.addIssue({ code: "custom", path: ["data_base64"], message: "empty final chunk requires offset 0 and total_bytes 0" });
+        }
+        if (frame.offset + decoded !== frame.total_bytes) {
+            ctx.addIssue({ code: "custom", path: ["total_bytes"], message: "final chunk must end at total_bytes" });
+        }
+    }
+    else if (decoded < 1) {
+        ctx.addIssue({ code: "custom", path: ["data_base64"], message: "non-final chunk data must be at least 1 byte" });
+    }
+    if (frame.offset + decoded > FILE_MAX_BYTES) {
+        ctx.addIssue({ code: "custom", path: ["offset"], message: `chunk must not exceed ${FILE_MAX_BYTES} bytes` });
+    }
+});
+export const fileClosedFrameSchema = strictObject({ ...fileResponse, type: z.literal("file_closed"), transfer_id: idSchema });
+export const fileErrorFrameSchema = strictObject({ ...fileResponse, type: z.literal("file_error"), transfer_id: idSchema.optional(), code: fileErrorCodeSchema });
+export const clientFrameSchema = z.union([pairRequestFrameSchema, sessionHelloFrameSchema, extensionInfoRequestFrameSchema, userMessageFrameSchema, userMessageObservedFrameSchema, sessionSyncFrameSchema, pingFrameSchema, cancelFrameSchema, sessionNewFrameSchema, sessionCompactFrameSchema, modelSetFrameSchema, thinkingSetFrameSchema, listModelsFrameSchema, queuedMessageSetFrameSchema, queuedMessageClearFrameSchema, queuedMessageSteerFrameSchema, approveToolFrameSchema, attachmentCapabilitiesRequestFrameSchema, attachmentBeginFrameSchema, attachmentChunkFrameSchema, attachmentFinishFrameSchema, attachmentStatusRequestFrameSchema, attachmentCancelFrameSchema, attachmentDiscardFrameSchema, fileOpenFrameSchema, fileReadFrameSchema, fileCloseFrameSchema]);
+export const serverFrameSchema = z.union([pairOkFrameSchema, pairErrorFrameSchema, sessionReadyFrameSchema, extensionInfoFrameSchema, userMessageStartedFrameSchema, userMessageStatusFrameSchema, timelineEventFrameSchema, timelinePartialFrameSchema, timelineEventFragmentFrameSchema, sessionHistoryChunkFrameSchema, protocolErrorFrameSchema, resetFrameSchema, pongFrameSchema, cancelledFrameSchema, actionOkFrameSchema, actionErrorFrameSchema, modelsListFrameSchema, queuedMessageStateFrameSchema, byeFrameSchema, attachmentCapabilitiesFrameSchema, attachmentStateFrameSchema, attachmentErrorFrameSchema, attachmentDiscardedFrameSchema, fileOpenedFrameSchema, fileChunkFrameSchema, fileClosedFrameSchema, fileErrorFrameSchema]);
 export const ClientFrameSchema = clientFrameSchema;
 export const ServerFrameSchema = serverFrameSchema;
 export const SessionHistoryChunkSchema = sessionHistoryChunkFrameSchema;

package/dist/vendor/protocol/session/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./schema.js";
 export * from "./attachments.js";
+export * from "./files.js";
 export * from "./frames.js";
 export * from "./codec.js";

package/dist/vendor/protocol/session/index.js

@@ -1,4 +1,5 @@
 export * from "./schema.js";
 export * from "./attachments.js";
+export * from "./files.js";
 export * from "./frames.js";
 export * from "./codec.js";

package/dist/vendor/protocol/session/schema.d.ts

@@ -852,7 +852,7 @@ export declare const harnessSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
 }, z.core.$strict>;
-export declare const CLIENT_FRAME_TYPES: readonly ["pair_request", "session_hello", "user_message", "user_message_observed", "session_sync", "ping", "cancel", "session_new", "session_compact", "model_set", "thinking_set", "list_models", "queued_message_set", "queued_message_clear", "queued_message_steer", "approve_tool", "extension_info_request", "attachment_capabilities_request", "attachment_begin", "attachment_chunk", "attachment_finish", "attachment_status_request", "attachment_cancel", "attachment_discard"];
-export declare const SERVER_FRAME_TYPES: readonly ["pair_ok", "pair_error", "session_ready", "user_message_started", "user_message_status", "timeline_event", "timeline_partial", "timeline_event_fragment", "session_history_chunk", "protocol_error", "reset", "pong", "cancelled", "action_ok", "action_error", "models_list", "queued_message_state", "bye", "extension_info", "attachment_capabilities", "attachment_state", "attachment_error", "attachment_discarded"];
+export declare const CLIENT_FRAME_TYPES: readonly ["pair_request", "session_hello", "user_message", "user_message_observed", "session_sync", "ping", "cancel", "session_new", "session_compact", "model_set", "thinking_set", "list_models", "queued_message_set", "queued_message_clear", "queued_message_steer", "approve_tool", "extension_info_request", "attachment_capabilities_request", "attachment_begin", "attachment_chunk", "attachment_finish", "attachment_status_request", "attachment_cancel", "attachment_discard", "file_open", "file_read", "file_close"];
+export declare const SERVER_FRAME_TYPES: readonly ["pair_ok", "pair_error", "session_ready", "user_message_started", "user_message_status", "timeline_event", "timeline_partial", "timeline_event_fragment", "session_history_chunk", "protocol_error", "reset", "pong", "cancelled", "action_ok", "action_error", "models_list", "queued_message_state", "bye", "extension_info", "attachment_capabilities", "attachment_state", "attachment_error", "attachment_discarded", "file_opened", "file_chunk", "file_closed", "file_error"];
 export type ClientFrameType = (typeof CLIENT_FRAME_TYPES)[number];
 export type ServerFrameType = (typeof SERVER_FRAME_TYPES)[number];

package/dist/vendor/protocol/session/schema.js

@@ -249,6 +249,7 @@ export const CLIENT_FRAME_TYPES = [
     "session_new", "session_compact", "model_set", "thinking_set", "list_models", "queued_message_set",
     "queued_message_clear", "queued_message_steer", "approve_tool", "extension_info_request",
     "attachment_capabilities_request", "attachment_begin", "attachment_chunk", "attachment_finish", "attachment_status_request", "attachment_cancel", "attachment_discard",
+    "file_open", "file_read", "file_close",
 ];
 export const SERVER_FRAME_TYPES = [
     "pair_ok", "pair_error", "session_ready", "user_message_started", "user_message_status", "timeline_event",
@@ -256,4 +257,5 @@ export const SERVER_FRAME_TYPES = [
     "cancelled", "action_ok", "action_error", "models_list", "queued_message_state", "bye",
     "extension_info",
     "attachment_capabilities", "attachment_state", "attachment_error", "attachment_discarded",
+    "file_opened", "file_chunk", "file_closed", "file_error",
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yefengr/pi-reach",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "publishConfig": {
     "access": "public"
   },
@@ -52,7 +52,6 @@
     "tsx": "^4.22.0",
     "typescript": "6.0.3",
     "vite": "8.2.2",
-    "typebox": "^1.1.38",
     "vitest": "4.1.11",
     "@pi-reach/protocol": "0.0.1"
   },
@@ -63,6 +62,7 @@
     "@napi-rs/keyring": "^1.3.0",
     "@noble/ed25519": "3.1.0",
     "qrcode-terminal": "^0.12.0",
+    "typebox": "^1.1.38",
     "ws": "^8.21.0",
     "zod": "4.4.3"
   },