@contextvm/sdk 0.7.8 → 0.8.0-next.0

package/dist/esm/transport/oversized-transfer/receiver.js

@@ -0,0 +1,367 @@
+import { sha256 } from '@noble/hashes/sha2.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
+import { DEFAULT_MAX_ACCEPTABLE_BYTES, DEFAULT_MAX_CONCURRENT_TRANSFERS, DEFAULT_MAX_OUT_OF_ORDER_CHUNKS, DEFAULT_MAX_OUT_OF_ORDER_WINDOW, DEFAULT_MAX_TRANSFER_CHUNKS, DEFAULT_TRANSFER_TIMEOUT_MS, DIGEST_PREFIX, } from './constants.js';
+import { JSONRPCMessageSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { OversizedTransferAbortError, OversizedTransferDigestError, OversizedTransferError, OversizedTransferPolicyError, OversizedTransferReassemblyError, OversizedTransferSequenceError, } from './errors.js';
+// Narrows an unknown value to `OversizedTransferFrame` via structural check.
+function isOversizedTransferFrame(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.type === 'oversized-transfer' &&
+        typeof value.frameType === 'string');
+}
+//Stateful reassembly engine for CEP-22 oversized transfers.
+export class OversizedTransferReceiver {
+    //sets all the settings and policy constraints
+    constructor(policy, logger) {
+        var _a, _b, _c, _d, _e, _f;
+        this.transfers = new Map();
+        this.acceptWaiters = new Map();
+        this.maxTransferBytes =
+            (_a = policy.maxTransferBytes) !== null && _a !== void 0 ? _a : DEFAULT_MAX_ACCEPTABLE_BYTES;
+        this.maxTransferChunks =
+            (_b = policy.maxTransferChunks) !== null && _b !== void 0 ? _b : DEFAULT_MAX_TRANSFER_CHUNKS;
+        this.maxConcurrentTransfers =
+            (_c = policy.maxConcurrentTransfers) !== null && _c !== void 0 ? _c : DEFAULT_MAX_CONCURRENT_TRANSFERS;
+        this.maxOutOfOrderWindow =
+            (_d = policy.maxOutOfOrderWindow) !== null && _d !== void 0 ? _d : DEFAULT_MAX_OUT_OF_ORDER_WINDOW;
+        this.maxOutOfOrderChunks =
+            (_e = policy.maxOutOfOrderChunks) !== null && _e !== void 0 ? _e : DEFAULT_MAX_OUT_OF_ORDER_CHUNKS;
+        this.transferTimeoutMs =
+            (_f = policy.transferTimeoutMs) !== null && _f !== void 0 ? _f : DEFAULT_TRANSFER_TIMEOUT_MS;
+        this.logger = logger;
+    }
+    //Returns true if the notification contains an oversized-transfer frame
+    //in its `params.cvm` field.
+    static isOversizedFrame(notification) {
+        var _a;
+        return isOversizedTransferFrame((_a = notification.params) === null || _a === void 0 ? void 0 : _a.cvm);
+    }
+    /**
+     * Process one inbound `notifications/progress` frame.
+     *
+     * @returns The reassembled `JSONRPCMessage` when the transfer is complete,
+     *          or `null` when more frames are needed.
+     * @throws `OversizedTransferAbortError` on `abort` frame.
+     * @throws `OversizedTransferPolicyError` when limits are exceeded.
+     * @throws `OversizedTransferDigestError` on integrity failure.
+     * @throws `OversizedTransferReassemblyError` on structural failure.
+     */
+    //Process one inbound `notifications/progress` frame.
+    async processFrame(notification) {
+        var _a, _b, _c, _d, _e;
+        const cvm = (_a = notification.params) === null || _a === void 0 ? void 0 : _a.cvm;
+        if (!isOversizedTransferFrame(cvm))
+            return null;
+        const token = String((_c = (_b = notification.params) === null || _b === void 0 ? void 0 : _b.progressToken) !== null && _c !== void 0 ? _c : '');
+        // The outer `progress` value is the canonical ordering key for chunks.
+        const progress = Number((_e = (_d = notification.params) === null || _d === void 0 ? void 0 : _d.progress) !== null && _e !== void 0 ? _e : 0);
+        this.assertValidToken(token);
+        this.assertValidProgress(progress, token);
+        switch (cvm.frameType) {
+            case 'start':
+                return this.handleStart(token, progress, cvm);
+            case 'accept':
+                return this.handleAccept(token, progress);
+            case 'chunk':
+                return this.handleChunk(token, progress, cvm);
+            case 'end':
+                return this.handleEnd(token, progress);
+            case 'abort':
+                return this.handleAbort(token, cvm);
+        }
+    }
+    //Returns a Promise that resolves when the remote peer sends an `accept` frame
+    //or rejects on timeout.
+    waitForAccept(token, timeoutMs = this.transferTimeoutMs) {
+        return new Promise((resolve, reject) => {
+            this.rejectAcceptWaiter(token, new OversizedTransferError(`Superseded wait for accept (token: ${token})`));
+            const timer = setTimeout(() => {
+                this.acceptWaiters.delete(token);
+                reject(new OversizedTransferError(`Timeout waiting for accept (token: ${token})`));
+            }, timeoutMs);
+            this.acceptWaiters.set(token, { resolve, reject, timer });
+        });
+    }
+    //Returns the number of currently active in-flight transfers.
+    get activeTransferCount() {
+        return this.transfers.size;
+    }
+    /** Releases all in-flight transfers and their watchdog timers. */
+    clear() {
+        for (const t of this.transfers.values()) {
+            clearTimeout(t.abortTimer);
+        }
+        for (const waiter of this.acceptWaiters.values()) {
+            clearTimeout(waiter.timer);
+            waiter.reject(new OversizedTransferError('Receiver cleared'));
+        }
+        this.transfers.clear();
+        this.acceptWaiters.clear();
+    }
+    //Handles the start frame
+    handleStart(token, progress, frame) {
+        if (this.transfers.has(token)) {
+            throw new OversizedTransferSequenceError(`Duplicate start frame for active transfer (token: ${token})`);
+        }
+        if (frame.totalBytes > this.maxTransferBytes) {
+            throw new OversizedTransferPolicyError(`totalBytes ${frame.totalBytes} exceeds policy limit ${this.maxTransferBytes} (token: ${token})`);
+        }
+        if (frame.totalChunks > this.maxTransferChunks) {
+            throw new OversizedTransferPolicyError(`totalChunks ${frame.totalChunks} exceeds policy limit ${this.maxTransferChunks} (token: ${token})`);
+        }
+        if (this.transfers.size >= this.maxConcurrentTransfers) {
+            throw new OversizedTransferPolicyError(`Active transfers exceed policy limit ${this.maxConcurrentTransfers} (token: ${token})`);
+        }
+        if (!frame.digest.startsWith(DIGEST_PREFIX)) {
+            throw new OversizedTransferReassemblyError(`Invalid digest format in start frame (token: ${token})`);
+        }
+        const abortTimer = setTimeout(() => {
+            this.logger.warn('Transfer timed out; cleaning up', { token });
+            this.rejectAcceptWaiter(token, new OversizedTransferError(`Transfer timed out (token: ${token})`));
+            this.cleanup(token);
+        }, this.transferTimeoutMs);
+        this.transfers.set(token, {
+            progressToken: token,
+            digest: frame.digest,
+            totalBytes: frame.totalBytes,
+            totalChunks: frame.totalChunks,
+            startProgress: progress,
+            acceptProgress: null,
+            firstChunkProgress: null,
+            nextExpectedChunkProgress: null,
+            highestObservedProgress: progress,
+            chunks: new Map(),
+            abortTimer,
+        });
+        this.logger.debug('Oversized transfer started', {
+            token,
+            totalBytes: frame.totalBytes,
+            totalChunks: frame.totalChunks,
+        });
+        return null;
+    }
+    handleAccept(token, progress) {
+        const transfer = this.transfers.get(token);
+        if (!transfer) {
+            // Late or duplicated accept frames are ignored after transfer cleanup.
+            if (!this.resolveAcceptWaiter(token)) {
+                this.logger.warn('Accept frame with no active transfer', { token });
+            }
+            return null;
+        }
+        if (progress <= transfer.startProgress) {
+            this.failTransfer(token, new OversizedTransferSequenceError(`Accept frame progress must be greater than start progress (token: ${token})`));
+        }
+        transfer.highestObservedProgress = Math.max(transfer.highestObservedProgress, progress);
+        transfer.acceptProgress = progress;
+        this.resolveAcceptWaiter(token);
+        return null;
+    }
+    handleChunk(token, progress, frame) {
+        const transfer = this.transfers.get(token);
+        if (!transfer) {
+            // Late or duplicated chunk frames are ignored after transfer cleanup.
+            this.logger.warn('Chunk frame with no active transfer', {
+                token,
+                progress,
+            });
+            return null;
+        }
+        const minimumChunkProgress = transfer.startProgress + 1;
+        const maximumChunkProgress = transfer.startProgress + transfer.totalChunks + 1;
+        if (progress < minimumChunkProgress) {
+            this.failTransfer(token, new OversizedTransferSequenceError(`Chunk progress must be greater than start progress (token: ${token})`));
+        }
+        const nextExpectedChunkProgress = this.getNextExpectedChunkProgress(transfer);
+        const forwardGap = progress - nextExpectedChunkProgress;
+        if (forwardGap > this.maxOutOfOrderWindow) {
+            this.failTransfer(token, new OversizedTransferPolicyError(`Out-of-order gap ${forwardGap} exceeds policy limit ${this.maxOutOfOrderWindow} (token: ${token})`));
+        }
+        if (progress > maximumChunkProgress) {
+            this.failTransfer(token, new OversizedTransferSequenceError(`Chunk progress exceeds declared transfer bounds (token: ${token})`));
+        }
+        if (progress > transfer.startProgress + 2 &&
+            !transfer.chunks.has(transfer.startProgress + 1) &&
+            !transfer.chunks.has(transfer.startProgress + 2)) {
+            this.failTransfer(token, new OversizedTransferSequenceError(`First chunk skips beyond the reserved accept slot (token: ${token})`));
+        }
+        const existingChunk = transfer.chunks.get(progress);
+        if (existingChunk !== undefined) {
+            if (existingChunk !== frame.data) {
+                this.failTransfer(token, new OversizedTransferSequenceError(`Conflicting duplicate chunk detected (token: ${token}, progress: ${progress})`));
+            }
+            return null;
+        }
+        transfer.chunks.set(progress, frame.data);
+        transfer.highestObservedProgress = Math.max(transfer.highestObservedProgress, progress);
+        this.refreshChunkProgressState(transfer);
+        if (forwardGap > 0) {
+            if (this.getBufferedOutOfOrderChunkCount(transfer) >
+                this.maxOutOfOrderChunks) {
+                this.failTransfer(token, new OversizedTransferPolicyError(`Buffered out-of-order chunks exceed policy limit ${this.maxOutOfOrderChunks} (token: ${token})`));
+            }
+        }
+        this.logger.debug('Chunk received', {
+            token,
+            progress,
+            received: transfer.chunks.size,
+            total: transfer.totalChunks,
+        });
+        return null;
+    }
+    async handleEnd(token, progress) {
+        const transfer = this.transfers.get(token);
+        if (!transfer) {
+            // Late or duplicated end frames are ignored after transfer cleanup.
+            this.logger.warn('End frame with no active transfer', { token });
+            return null;
+        }
+        if (progress <= transfer.highestObservedProgress) {
+            this.failTransfer(token, new OversizedTransferSequenceError(`End frame progress must be greater than all prior transfer frames (token: ${token})`));
+        }
+        if (transfer.totalChunks > 0 && transfer.chunks.size === 0) {
+            this.failTransfer(token, new OversizedTransferReassemblyError(`Transfer ended before any chunks were received (token: ${token})`));
+        }
+        if (transfer.chunks.size !== transfer.totalChunks) {
+            this.failTransfer(token, new OversizedTransferReassemblyError(`Expected ${transfer.totalChunks} chunks but received ${transfer.chunks.size} (token: ${token})`));
+        }
+        const assembled = this.assembleTransferPayload(transfer, token);
+        // 1. Byte-length validation.
+        const encodedBytes = new TextEncoder().encode(assembled);
+        if (encodedBytes.byteLength !== transfer.totalBytes) {
+            this.cleanup(token);
+            throw new OversizedTransferDigestError(`Byte length mismatch: expected ${transfer.totalBytes}, got ${encodedBytes.byteLength} (token: ${token})`);
+        }
+        // 2. SHA-256 digest validation.
+        const actualDigest = DIGEST_PREFIX + bytesToHex(sha256(encodedBytes));
+        if (actualDigest !== transfer.digest) {
+            this.cleanup(token);
+            throw new OversizedTransferDigestError(`SHA-256 digest mismatch (token: ${token})`);
+        }
+        // 3. Parse and validate as a JSON-RPC message.
+        let validated;
+        try {
+            const parsed = JSON.parse(assembled);
+            validated = JSONRPCMessageSchema.parse(parsed);
+        }
+        catch (err) {
+            this.cleanup(token);
+            throw new OversizedTransferReassemblyError(`Reassembled payload is not a valid JSON-RPC message (token: ${token}): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        this.cleanup(token);
+        this.logger.debug('Oversized transfer complete', { token });
+        return validated;
+    }
+    handleAbort(token, frame) {
+        const error = new OversizedTransferAbortError(token, frame.reason);
+        this.rejectAcceptWaiter(token, error);
+        this.cleanup(token);
+        throw error;
+    }
+    assertValidToken(token) {
+        if (token.length === 0) {
+            throw new OversizedTransferSequenceError('Oversized transfer frame is missing progressToken');
+        }
+    }
+    assertValidProgress(progress, token) {
+        if (!Number.isInteger(progress) || progress <= 0) {
+            throw new OversizedTransferSequenceError(`Invalid progress value ${String(progress)} (token: ${token})`);
+        }
+    }
+    refreshChunkProgressState(transfer) {
+        if (transfer.chunks.size === 0) {
+            transfer.firstChunkProgress = null;
+            transfer.nextExpectedChunkProgress = null;
+            return;
+        }
+        const firstChunkProgress = transfer.acceptProgress !== null
+            ? transfer.startProgress + 2
+            : transfer.startProgress + 1;
+        let nextExpectedChunkProgress = firstChunkProgress;
+        while (transfer.chunks.has(nextExpectedChunkProgress)) {
+            nextExpectedChunkProgress++;
+        }
+        transfer.firstChunkProgress = firstChunkProgress;
+        transfer.nextExpectedChunkProgress = nextExpectedChunkProgress;
+    }
+    getBufferedOutOfOrderChunkCount(transfer) {
+        if (transfer.firstChunkProgress === null ||
+            transfer.nextExpectedChunkProgress === null) {
+            return 0;
+        }
+        const contiguousChunkCount = transfer.nextExpectedChunkProgress - transfer.firstChunkProgress;
+        return transfer.chunks.size - contiguousChunkCount;
+    }
+    getNextExpectedChunkProgress(transfer) {
+        if (transfer.nextExpectedChunkProgress !== null) {
+            return transfer.nextExpectedChunkProgress;
+        }
+        return transfer.acceptProgress !== null
+            ? transfer.startProgress + 2
+            : transfer.startProgress + 1;
+    }
+    assembleTransferPayload(transfer, token) {
+        const firstChunkProgress = this.getAssemblyFirstChunkProgress(transfer, token);
+        const chunks = [];
+        for (let progress = firstChunkProgress; progress < firstChunkProgress + transfer.totalChunks; progress++) {
+            const chunk = transfer.chunks.get(progress);
+            if (chunk === undefined) {
+                throw new OversizedTransferReassemblyError(`Missing chunk during assembly (token: ${token}, progress: ${progress})`);
+            }
+            chunks.push(chunk);
+        }
+        return chunks.join('');
+    }
+    getAssemblyFirstChunkProgress(transfer, token) {
+        const directStartProgress = transfer.startProgress + 1;
+        const acceptGatedStartProgress = transfer.startProgress + 2;
+        if (this.hasCompleteChunkRange(transfer, directStartProgress)) {
+            return directStartProgress;
+        }
+        if (this.hasCompleteChunkRange(transfer, acceptGatedStartProgress)) {
+            return acceptGatedStartProgress;
+        }
+        throw new OversizedTransferReassemblyError(`Transfer ended with unresolved chunk gaps (token: ${token})`);
+    }
+    hasCompleteChunkRange(transfer, firstChunkProgress) {
+        for (let progress = firstChunkProgress; progress < firstChunkProgress + transfer.totalChunks; progress++) {
+            if (!transfer.chunks.has(progress)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    failTransfer(token, error) {
+        this.rejectAcceptWaiter(token, error);
+        this.cleanup(token);
+        throw error;
+    }
+    resolveAcceptWaiter(token) {
+        const waiter = this.acceptWaiters.get(token);
+        if (!waiter) {
+            return false;
+        }
+        clearTimeout(waiter.timer);
+        this.acceptWaiters.delete(token);
+        waiter.resolve();
+        return true;
+    }
+    rejectAcceptWaiter(token, error) {
+        const waiter = this.acceptWaiters.get(token);
+        if (!waiter) {
+            return false;
+        }
+        clearTimeout(waiter.timer);
+        this.acceptWaiters.delete(token);
+        waiter.reject(error);
+        return true;
+    }
+    cleanup(token) {
+        const t = this.transfers.get(token);
+        if (t)
+            clearTimeout(t.abortTimer);
+        this.transfers.delete(token);
+    }
+}
+//# sourceMappingURL=receiver.js.map

package/dist/esm/transport/oversized-transfer/receiver.js.map

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

package/dist/esm/transport/oversized-transfer/sender-session.d.ts

@@ -0,0 +1,16 @@
+import { type SenderOptions } from './sender.js';
+import type { OversizedTransferProgress } from './types.js';
+export interface OversizedFramePublishContext {
+    isStartFrame: boolean;
+}
+export type OversizedFramePublisher = (frame: OversizedTransferProgress, ctx: OversizedFramePublishContext) => Promise<string | undefined>;
+export type OversizedAcceptWaiter = (progressToken: string) => Promise<void>;
+export interface OversizedSendOptions extends SenderOptions {
+    publishFrame: OversizedFramePublisher;
+    waitForAccept?: OversizedAcceptWaiter;
+}
+/**
+ * Builds and publishes a full CEP-22 oversized transfer sequence.
+ */
+export declare function sendOversizedTransfer(serialized: string, options: OversizedSendOptions): Promise<string | undefined>;
+//# sourceMappingURL=sender-session.d.ts.map

package/dist/esm/transport/oversized-transfer/sender-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-session.d.ts","sourceRoot":"","sources":["../../../../src/transport/oversized-transfer/sender-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,yBAAyB,EAChC,GAAG,EAAE,4BAA4B,KAC9B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,YAAY,EAAE,uBAAuB,CAAC;IACtC,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB7B"}

package/dist/esm/transport/oversized-transfer/sender-session.js

@@ -0,0 +1,22 @@
+import { buildOversizedTransferFrames } from './sender.js';
+/**
+ * Builds and publishes a full CEP-22 oversized transfer sequence.
+ */
+export async function sendOversizedTransfer(serialized, options) {
+    var _a;
+    const { startFrame, chunkFrames, endFrame } = await buildOversizedTransferFrames(serialized, options);
+    await options.publishFrame(startFrame, {
+        isStartFrame: true,
+    });
+    if (options.needsAcceptHandshake) {
+        await ((_a = options.waitForAccept) === null || _a === void 0 ? void 0 : _a.call(options, options.progressToken));
+    }
+    for (const chunk of chunkFrames) {
+        await options.publishFrame(chunk, { isStartFrame: false });
+    }
+    const endEventId = await options.publishFrame(endFrame, {
+        isStartFrame: false,
+    });
+    return typeof endEventId === 'string' ? endEventId : undefined;
+}
+//# sourceMappingURL=sender-session.js.map

package/dist/esm/transport/oversized-transfer/sender-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-session.js","sourceRoot":"","sources":["../../../../src/transport/oversized-transfer/sender-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAsB,MAAM,aAAa,CAAC;AAmB/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,OAA6B;;IAE7B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,GACzC,MAAM,4BAA4B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAE1D,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE;QACrC,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACjC,MAAM,CAAA,MAAA,OAAO,CAAC,aAAa,wDAAG,OAAO,CAAC,aAAa,CAAC,CAAA,CAAC;IACvD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE;QACtD,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,OAAO,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC"}

package/dist/esm/transport/oversized-transfer/sender.d.ts

@@ -0,0 +1,15 @@
+import { OversizedTransferProgress } from './types.js';
+export interface SenderOptions {
+    progressToken: string;
+    chunkSizeBytes?: number;
+    needsAcceptHandshake?: boolean;
+}
+export interface SenderResult {
+    startFrame: OversizedTransferProgress;
+    chunkFrames: OversizedTransferProgress[];
+    endFrame: OversizedTransferProgress;
+}
+export declare function utf8ByteLength(value: string): number;
+export declare function sha256Digest(value: string): string;
+export declare function buildOversizedTransferFrames(serialized: string, options: SenderOptions): Promise<SenderResult>;
+//# sourceMappingURL=sender.d.ts.map

package/dist/esm/transport/oversized-transfer/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../../../src/transport/oversized-transfer/sender.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,yBAAyB,CAAC;IACtC,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAwCD,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAiDvB"}

package/dist/esm/transport/oversized-transfer/sender.js

@@ -0,0 +1,81 @@
+import { sha256 } from '@noble/hashes/sha2.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
+import { DEFAULT_CHUNK_SIZE, DIGEST_PREFIX } from './constants.js';
+export function utf8ByteLength(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+export function sha256Digest(value) {
+    return DIGEST_PREFIX + bytesToHex(sha256(new TextEncoder().encode(value)));
+}
+// Splits a string into multiple chunks based on byte size.
+function splitStringByByteSize(str, maxBytes) {
+    if (!Number.isInteger(maxBytes) || maxBytes <= 0) {
+        throw new Error(`Invalid chunkSizeBytes: ${String(maxBytes)}`);
+    }
+    const chunks = [];
+    let currentChunk = '';
+    let currentChunkBytes = 0;
+    for (const char of str) {
+        const charBytes = utf8ByteLength(char);
+        if (charBytes > maxBytes) {
+            throw new Error(`Unable to split message: single character exceeds chunk size (${charBytes} > ${maxBytes})`);
+        }
+        if (currentChunkBytes > 0 && currentChunkBytes + charBytes > maxBytes) {
+            chunks.push(currentChunk);
+            currentChunk = char;
+            currentChunkBytes = charBytes;
+            continue;
+        }
+        currentChunk += char;
+        currentChunkBytes += charBytes;
+    }
+    if (currentChunk.length > 0) {
+        chunks.push(currentChunk);
+    }
+    return chunks;
+}
+// Splits serialized into an ordered sequence of oversized-transfer frames ready to be sent as notifications/progress messages.
+export async function buildOversizedTransferFrames(serialized, options) {
+    var _a;
+    const totalBytes = utf8ByteLength(serialized);
+    const digest = sha256Digest(serialized);
+    const chunkSize = (_a = options.chunkSizeBytes) !== null && _a !== void 0 ? _a : DEFAULT_CHUNK_SIZE;
+    const textChunks = splitStringByByteSize(serialized, chunkSize);
+    const totalChunks = textChunks.length;
+    // When accept handshake is needed, progress=2 is reserved for the server's
+    // accept frame, so chunks begin at 3.
+    const chunkBaseProgress = options.needsAcceptHandshake ? 3 : 2;
+    const startFrame = {
+        progressToken: options.progressToken,
+        progress: 1,
+        message: 'starting oversized transfer',
+        cvm: {
+            type: 'oversized-transfer',
+            frameType: 'start',
+            completionMode: 'render',
+            digest,
+            totalBytes,
+            totalChunks,
+        },
+    };
+    const chunkFrames = textChunks.map((data, i) => ({
+        progressToken: options.progressToken,
+        progress: chunkBaseProgress + i,
+        cvm: {
+            type: 'oversized-transfer',
+            frameType: 'chunk',
+            data,
+        },
+    }));
+    const endFrame = {
+        progressToken: options.progressToken,
+        progress: chunkBaseProgress + totalChunks,
+        message: 'oversized transfer complete',
+        cvm: {
+            type: 'oversized-transfer',
+            frameType: 'end',
+        },
+    };
+    return { startFrame, chunkFrames, endFrame };
+}
+//# sourceMappingURL=sender.js.map

package/dist/esm/transport/oversized-transfer/sender.js.map

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

package/dist/esm/transport/oversized-transfer/types.d.ts

@@ -0,0 +1,39 @@
+export type OversizedTransferCommon = {
+    type: 'oversized-transfer';
+    frameType: 'start' | 'end' | 'chunk' | 'accept' | 'abort';
+};
+export type StartFrame = OversizedTransferCommon & {
+    frameType: 'start';
+    completionMode: 'render';
+    digest: string;
+    totalBytes: number;
+    totalChunks: number;
+};
+export type AcceptFrame = OversizedTransferCommon & {
+    frameType: 'accept';
+};
+/** `data` is one ordered fragment of the serialized JSON-RPC string. */
+export type ChunkFrame = OversizedTransferCommon & {
+    frameType: 'chunk';
+    data: string;
+};
+export type EndFrame = OversizedTransferCommon & {
+    frameType: 'end';
+};
+export type AbortFrame = OversizedTransferCommon & {
+    frameType: 'abort';
+    reason?: string;
+};
+export type OversizedTransferFrame = StartFrame | AcceptFrame | ChunkFrame | EndFrame | AbortFrame;
+/**
+ * Shape of a `notifications/progress` params object that carries
+ * a CEP-22 oversized-transfer frame inside the `cvm` extension field.
+ */
+export type OversizedTransferProgress = {
+    progressToken: string | number;
+    progress: number;
+    message?: string;
+    total?: number;
+    cvm: OversizedTransferFrame;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/transport/oversized-transfer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/transport/oversized-transfer/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,uBAAuB,GAAG;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,QAAQ,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG;IAClD,SAAS,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,uBAAuB,GAAG;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,uBAAuB,GAAG;IAC/C,SAAS,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,uBAAuB,GAAG;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,WAAW,GACX,UAAU,GACV,QAAQ,GACR,UAAU,CAAC;AAEf;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,sBAAsB,CAAC;CAC7B,CAAC"}

package/dist/esm/transport/oversized-transfer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/transport/oversized-transfer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/transport/oversized-transfer/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextvm/sdk",
-  "version": "0.7.8",
+  "version": "0.8.0-next.0",
   "description": "CtxVM SDK for JavaScript/TypeScript",
   "license": "LGPL-3.0-1",
   "author": "ContextVM",
@@ -102,6 +102,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "@noble/hashes": "^2.0.1",
     "applesauce-relay": "^5.1.0",
     "nostr-tools": "~2.18.2",
     "pino": "^10.3.1",