@bxb1337/windsurf-fast-context 1.0.0

package/dist/cjs/model/devstral-language-model.test.js

@@ -0,0 +1,410 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const protobuf_js_1 = require("../protocol/protobuf.js");
+const connect_frame_js_1 = require("../protocol/connect-frame.js");
+const devstral_language_model_js_1 = require("./devstral-language-model.js");
+function bufferFromBody(body) {
+    if (body == null) {
+        return Buffer.alloc(0);
+    }
+    if (typeof body === 'string') {
+        return Buffer.from(body, 'utf8');
+    }
+    if (body instanceof ArrayBuffer) {
+        return Buffer.from(body);
+    }
+    if (ArrayBuffer.isView(body)) {
+        return Buffer.from(body.buffer, body.byteOffset, body.byteLength);
+    }
+    throw new Error(`Unsupported request body type: ${typeof body}`);
+}
+function makeJwt(exp, tag) {
+    const header = Buffer.from(JSON.stringify({ alg: 'HS256', typ: 'JWT' })).toString('base64url');
+    const payload = Buffer.from(JSON.stringify({ exp, tag })).toString('base64url');
+    return `${header}.${payload}.signature`;
+}
+function chunkBuffer(buffer, chunkSize) {
+    const chunks = [];
+    for (let offset = 0; offset < buffer.length; offset += chunkSize) {
+        chunks.push(Uint8Array.from(buffer.subarray(offset, offset + chunkSize)));
+    }
+    return chunks;
+}
+function makeChunkedBody(chunks, options = {}) {
+    let index = 0;
+    return new ReadableStream({
+        async pull(controller) {
+            if (options.signal?.aborted) {
+                controller.close();
+                return;
+            }
+            if (index >= chunks.length) {
+                controller.close();
+                return;
+            }
+            if (options.pauseAtChunkIndex === index && options.waitForChunk) {
+                await options.waitForChunk;
+            }
+            if ((options.delayMs ?? 0) > 0) {
+                await new Promise((resolve) => setTimeout(resolve, options.delayMs));
+            }
+            if (options.signal?.aborted) {
+                controller.close();
+                return;
+            }
+            const chunk = chunks[index];
+            if (chunk) {
+                controller.enqueue(chunk);
+            }
+            index += 1;
+        },
+    });
+}
+function waitFor(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function decodeRequestPayload(body) {
+    // Body is now a connect frame directly (gzip is inside the frame, not outside)
+    const decodedFrames = (0, connect_frame_js_1.connectFrameDecode)(body);
+    return decodedFrames[0] ?? Buffer.alloc(0);
+}
+async function collectStreamParts(stream) {
+    const reader = stream.getReader();
+    const parts = [];
+    while (true) {
+        const next = await reader.read();
+        if (next.done) {
+            break;
+        }
+        parts.push(next.value);
+    }
+    return parts;
+}
+(0, vitest_1.describe)('DevstralLanguageModel doGenerate', () => {
+    (0, vitest_1.it)('generate request uses connect endpoint and connect+proto gzip headers', async () => {
+        const calls = [];
+        const requestBodies = [];
+        const jwt = makeJwt(4_050_000_000, 'connect-gzip');
+        const fakeFetch = async (input, init) => {
+            const url = String(input);
+            calls.push({ url, init });
+            if (url.endsWith('/GetUserJwt')) {
+                return new Response(Uint8Array.from(Buffer.from(jwt, 'utf8')), { status: 200 });
+            }
+            requestBodies.push(bufferFromBody(init?.body));
+            return new Response(Uint8Array.from((0, connect_frame_js_1.connectFrameEncode)(Buffer.from('ok', 'utf8'))), { status: 200 });
+        };
+        const model = new devstral_language_model_js_1.DevstralLanguageModel({ apiKey: 'test-api-key', fetch: fakeFetch, baseURL: 'https://windsurf.test' });
+        await model.doGenerate({
+            prompt: [{ role: 'user', content: [{ type: 'text', text: 'Use connect route.' }] }],
+        });
+        const generateCall = calls[1];
+        (0, vitest_1.expect)(generateCall?.url).toBe('https://windsurf.test/exa.api_server_pb.ApiServerService/GetDevstralStream');
+        const headers = new Headers(generateCall?.init?.headers);
+        (0, vitest_1.expect)(headers.get('content-type')).toBe('application/connect+proto');
+        (0, vitest_1.expect)(headers.get('connect-protocol-version')).toBe('1');
+        (0, vitest_1.expect)(headers.get('connect-timeout-ms')).toBe('30000');
+        (0, vitest_1.expect)(headers.get('connect-accept-encoding')).toBe('gzip');
+        (0, vitest_1.expect)(headers.get('connect-content-encoding')).toBe('gzip');
+        (0, vitest_1.expect)(headers.get('accept-encoding')).toBe('identity');
+        const body = requestBodies[0];
+        (0, vitest_1.expect)(body?.readUInt8(0)).toBe(1);
+        const strings = (0, protobuf_js_1.extractStrings)(decodeRequestPayload(body ?? Buffer.alloc(0)));
+        const combined = strings.join('\n');
+        (0, vitest_1.expect)(combined).toContain('Use connect route.');
+    });
+    (0, vitest_1.it)('generate request returns plain text content', async () => {
+        const calls = [];
+        const requestBodies = [];
+        const jwt = makeJwt(4_100_000_000, 'generate');
+        const fakeFetch = async (input, init) => {
+            const url = String(input);
+            calls.push({ url, init });
+            if (url.endsWith('/GetUserJwt')) {
+                return new Response(Uint8Array.from(Buffer.from(`prefix:${jwt}:suffix`, 'utf8')), { status: 200 });
+            }
+            requestBodies.push(bufferFromBody(init?.body));
+            return new Response(Uint8Array.from((0, connect_frame_js_1.connectFrameEncode)(Buffer.from('generated answer', 'utf8'))), {
+                status: 200,
+            });
+        };
+        const model = new devstral_language_model_js_1.DevstralLanguageModel({ apiKey: 'test-api-key', fetch: fakeFetch, baseURL: 'https://windsurf.test' });
+        (0, vitest_1.expect)(model.specificationVersion).toBe('v3');
+        (0, vitest_1.expect)(model.supportedUrls).toEqual({});
+        const result = await model.doGenerate({
+            prompt: [{ role: 'user', content: [{ type: 'text', text: 'Find auth logic.' }] }],
+        });
+        (0, vitest_1.expect)(result.content).toEqual([{ type: 'text', text: 'generated answer' }]);
+        (0, vitest_1.expect)(result.finishReason).toEqual({ unified: 'stop', raw: 'stop' });
+        (0, vitest_1.expect)(result.usage).toEqual({
+            inputTokens: {
+                total: undefined,
+                noCache: undefined,
+                cacheRead: undefined,
+                cacheWrite: undefined,
+            },
+            outputTokens: {
+                total: undefined,
+                text: undefined,
+                reasoning: undefined,
+            },
+        });
+        (0, vitest_1.expect)(calls).toHaveLength(2);
+        (0, vitest_1.expect)(calls[0]?.url).toBe('https://windsurf.test/exa.auth_pb.AuthService/GetUserJwt');
+        (0, vitest_1.expect)(calls[1]?.url).toBe('https://windsurf.test/exa.api_server_pb.ApiServerService/GetDevstralStream');
+        const strings = (0, protobuf_js_1.extractStrings)(decodeRequestPayload(requestBodies[0] ?? Buffer.alloc(0)));
+        const combined = strings.join('\n');
+        (0, vitest_1.expect)(combined).toContain('test-api-key');
+        (0, vitest_1.expect)(combined).toContain(jwt);
+        (0, vitest_1.expect)(combined).toContain('Find auth logic.');
+    });
+    (0, vitest_1.it)('generate request with tool markers returns tool-call content parts', async () => {
+        const requestBodies = [];
+        const jwt = makeJwt(4_200_000_000, 'tools');
+        const fakeFetch = async (input, init) => {
+            const url = String(input);
+            if (url.endsWith('/GetUserJwt')) {
+                return new Response(Uint8Array.from(Buffer.from(jwt, 'utf8')), { status: 200 });
+            }
+            requestBodies.push(bufferFromBody(init?.body));
+            const payload = Buffer.from('[TOOL_CALLS]searchRepo[ARGS]{"query":"jwt manager"}', 'utf8');
+            return new Response(Uint8Array.from((0, connect_frame_js_1.connectFrameEncode)(payload)), { status: 200 });
+        };
+        const model = new devstral_language_model_js_1.DevstralLanguageModel({ apiKey: 'tools-key', fetch: fakeFetch, baseURL: 'https://windsurf.test' });
+        const result = await model.doGenerate({
+            prompt: [{ role: 'user', content: [{ type: 'text', text: 'Inspect jwt manager.' }] }],
+            tools: {
+                searchRepo: {
+                    description: 'Search repository files',
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            query: { type: 'string' },
+                        },
+                        required: ['query'],
+                    },
+                },
+            },
+        });
+        (0, vitest_1.expect)(result.content).toEqual([
+            {
+                type: 'tool-call',
+                toolCallType: 'function',
+                toolCallId: 'toolcall_1',
+                toolName: 'searchRepo',
+                args: '{"query":"jwt manager"}',
+            },
+        ]);
+        const strings = (0, protobuf_js_1.extractStrings)(decodeRequestPayload(requestBodies[0] ?? Buffer.alloc(0)));
+        const combined = strings.join('\n');
+        (0, vitest_1.expect)(combined).toContain('searchRepo');
+        (0, vitest_1.expect)(combined).toContain('Search repository files');
+        (0, vitest_1.expect)(combined).toContain('Inspect jwt manager.');
+        (0, vitest_1.expect)(combined).toContain('query');
+    });
+});
+(0, vitest_1.describe)('DevstralLanguageModel doStream', () => {
+    (0, vitest_1.it)('stream-text resolves before full body arrives and emits parts incrementally', async () => {
+        const jwt = makeJwt(4_300_000_000, 'stream-text');
+        const firstFrame = (0, connect_frame_js_1.connectFrameEncode)(Buffer.from('hello ', 'utf8'));
+        const secondFrame = (0, connect_frame_js_1.connectFrameEncode)(Buffer.from('world', 'utf8'));
+        let releaseSecondFrame;
+        const waitForSecondFrame = new Promise((resolve) => {
+            releaseSecondFrame = () => resolve();
+        });
+        const chunks = [
+            Uint8Array.from(firstFrame.subarray(0, 3)),
+            Uint8Array.from(firstFrame.subarray(3, 8)),
+            Uint8Array.from(firstFrame.subarray(8)),
+            Uint8Array.from(secondFrame.subarray(0, 4)),
+            Uint8Array.from(secondFrame.subarray(4)),
+        ];
+        const calls = [];
+        const fakeFetch = async (input, init) => {
+            const url = String(input);
+            calls.push({ url, init });
+            if (url.endsWith('/GetUserJwt')) {
+                return new Response(Uint8Array.from(Buffer.from(jwt, 'utf8')), { status: 200 });
+            }
+            return new Response(makeChunkedBody(chunks, {
+                pauseAtChunkIndex: 3,
+                waitForChunk: waitForSecondFrame,
+            }), { status: 200 });
+        };
+        const model = new devstral_language_model_js_1.DevstralLanguageModel({
+            apiKey: 'stream-api-key',
+            fetch: fakeFetch,
+            baseURL: 'https://windsurf.test',
+        });
+        const resultPromise = model.doStream({
+            prompt: [{ role: 'user', content: [{ type: 'text', text: 'Stream text.' }] }],
+        });
+        try {
+            const earlyResolution = await Promise.race([
+                resultPromise.then(() => 'resolved'),
+                waitFor(30).then(() => 'timed-out'),
+            ]);
+            (0, vitest_1.expect)(earlyResolution).toBe('resolved');
+            const result = await resultPromise;
+            const reader = result.stream.getReader();
+            const firstParts = [];
+            while (firstParts.length < 4) {
+                const next = await reader.read();
+                if (next.done) {
+                    break;
+                }
+                firstParts.push(next.value);
+                if (next.value.type === 'text-delta') {
+                    break;
+                }
+            }
+            (0, vitest_1.expect)(firstParts.map((part) => part.type)).toEqual([
+                'stream-start',
+                'response-metadata',
+                'text-start',
+                'text-delta',
+            ]);
+            (0, vitest_1.expect)(firstParts[3]).toMatchObject({ type: 'text-delta', delta: 'hello ' });
+            releaseSecondFrame?.();
+            const remainingParts = [];
+            while (true) {
+                const next = await reader.read();
+                if (next.done) {
+                    break;
+                }
+                remainingParts.push(next.value);
+            }
+            const parts = [...firstParts, ...remainingParts];
+            (0, vitest_1.expect)(parts.map((part) => part.type)).toEqual([
+                'stream-start',
+                'response-metadata',
+                'text-start',
+                'text-delta',
+                'text-delta',
+                'text-end',
+                'finish',
+            ]);
+            (0, vitest_1.expect)(parts[0]).toEqual({ type: 'stream-start', warnings: [] });
+            (0, vitest_1.expect)(parts[1]).toMatchObject({ type: 'response-metadata' });
+            (0, vitest_1.expect)(parts[4]).toMatchObject({ type: 'text-delta', delta: 'world' });
+            (0, vitest_1.expect)(parts[6]).toEqual({
+                type: 'finish',
+                finishReason: { unified: 'stop', raw: 'stop' },
+                usage: {
+                    inputTokens: {
+                        total: undefined,
+                        noCache: undefined,
+                        cacheRead: undefined,
+                        cacheWrite: undefined,
+                    },
+                    outputTokens: {
+                        total: undefined,
+                        text: undefined,
+                        reasoning: undefined,
+                    },
+                },
+            });
+        }
+        finally {
+            releaseSecondFrame?.();
+        }
+        (0, vitest_1.expect)(calls).toHaveLength(2);
+        (0, vitest_1.expect)(calls[0]?.url).toBe('https://windsurf.test/exa.auth_pb.AuthService/GetUserJwt');
+        (0, vitest_1.expect)(calls[1]?.url).toBe('https://windsurf.test/exa.api_server_pb.ApiServerService/GetDevstralStream');
+    });
+    (0, vitest_1.it)('stream-tool emits tool-input deltas before final tool-call and finish', async () => {
+        const jwt = makeJwt(4_300_000_001, 'stream-tool');
+        const toolPayload = Buffer.from('[TOOL_CALLS]searchRepo[ARGS]{"query":"jwt manager"}', 'utf8');
+        const frames = Buffer.concat([(0, connect_frame_js_1.connectFrameEncode)(toolPayload)]);
+        const fakeFetch = async (input) => {
+            const url = String(input);
+            if (url.endsWith('/GetUserJwt')) {
+                return new Response(Uint8Array.from(Buffer.from(jwt, 'utf8')), { status: 200 });
+            }
+            return new Response(makeChunkedBody(chunkBuffer(frames, 6)), { status: 200 });
+        };
+        const model = new devstral_language_model_js_1.DevstralLanguageModel({
+            apiKey: 'stream-tool-key',
+            fetch: fakeFetch,
+            baseURL: 'https://windsurf.test',
+        });
+        const result = await model.doStream({
+            prompt: [{ role: 'user', content: [{ type: 'text', text: 'Call tools.' }] }],
+            tools: {
+                searchRepo: {
+                    description: 'Search repository files',
+                    parameters: {
+                        type: 'object',
+                        properties: {
+                            query: { type: 'string' },
+                        },
+                        required: ['query'],
+                    },
+                },
+            },
+        });
+        const parts = await collectStreamParts(result.stream);
+        (0, vitest_1.expect)(parts.map((part) => part.type)).toEqual([
+            'stream-start',
+            'response-metadata',
+            'tool-input-start',
+            'tool-input-delta',
+            'tool-input-end',
+            'tool-call',
+            'finish',
+        ]);
+        (0, vitest_1.expect)(parts[3]).toMatchObject({ type: 'tool-input-delta', delta: '{"query":"jwt manager"}' });
+        (0, vitest_1.expect)(parts[5]).toEqual({
+            type: 'tool-call',
+            toolCallType: 'function',
+            toolCallId: 'toolcall_1',
+            toolName: 'searchRepo',
+            args: '{"query":"jwt manager"}',
+        });
+    });
+    (0, vitest_1.it)('abort stops stream mid-response', async () => {
+        const controller = new AbortController();
+        const jwt = makeJwt(4_300_000_002, 'abort');
+        const frames = Buffer.concat([
+            (0, connect_frame_js_1.connectFrameEncode)(Buffer.from('first ', 'utf8')),
+            (0, connect_frame_js_1.connectFrameEncode)(Buffer.from('second ', 'utf8')),
+            (0, connect_frame_js_1.connectFrameEncode)(Buffer.from('third', 'utf8')),
+        ]);
+        const fakeFetch = async (input, init) => {
+            const url = String(input);
+            if (url.endsWith('/GetUserJwt')) {
+                return new Response(Uint8Array.from(Buffer.from(jwt, 'utf8')), { status: 200 });
+            }
+            return new Response(makeChunkedBody(chunkBuffer(frames, 5), { delayMs: 10, signal: init?.signal ?? undefined }), {
+                status: 200,
+            });
+        };
+        const model = new devstral_language_model_js_1.DevstralLanguageModel({
+            apiKey: 'stream-abort-key',
+            fetch: fakeFetch,
+            baseURL: 'https://windsurf.test',
+        });
+        const result = await model.doStream({
+            prompt: [{ role: 'user', content: [{ type: 'text', text: 'Abort stream.' }] }],
+            abortSignal: controller.signal,
+        });
+        const reader = result.stream.getReader();
+        const seen = [];
+        while (true) {
+            const next = await reader.read();
+            if (next.done) {
+                break;
+            }
+            const part = next.value;
+            seen.push(part);
+            if (part.type === 'text-delta') {
+                controller.abort();
+            }
+        }
+        const types = seen.map((part) => part.type);
+        (0, vitest_1.expect)(types).toContain('text-delta');
+        (0, vitest_1.expect)(types.filter((type) => type === 'text-delta')).toHaveLength(1);
+        (0, vitest_1.expect)(types).not.toContain('finish');
+    });
+});

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/protocol/connect-frame.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectFrameEncode = connectFrameEncode;
+exports.connectFrameDecode = connectFrameDecode;
+const node_zlib_1 = require("node:zlib");
+const FRAME_HEADER_SIZE = 5;
+const FLAG_COMPRESSED = 1;
+/**
+ * Encode a protobuf payload into a Connect-RPC frame.
+ *
+ * @param payload - The raw protobuf bytes to encode
+ * @param compress - Whether to gzip-compress the payload (default: true)
+ *                   When true, the payload is gzipped and flags=1 is set
+ * @returns Buffer containing: [flags byte][4-byte length][payload (gzipped if compress=true)]
+ */
+function connectFrameEncode(payload, compress = true) {
+    const payloadBytes = compress ? (0, node_zlib_1.gzipSync)(payload) : payload;
+    const frame = Buffer.allocUnsafe(FRAME_HEADER_SIZE + payloadBytes.length);
+    frame.writeUInt8(compress ? FLAG_COMPRESSED : 0, 0);
+    frame.writeUInt32BE(payloadBytes.length, 1);
+    payloadBytes.copy(frame, FRAME_HEADER_SIZE);
+    return frame;
+}
+function connectFrameDecode(buffer) {
+    const decoded = [];
+    let offset = 0;
+    while (offset + FRAME_HEADER_SIZE <= buffer.length) {
+        const flags = buffer.readUInt8(offset);
+        const payloadLength = buffer.readUInt32BE(offset + 1);
+        const payloadStart = offset + FRAME_HEADER_SIZE;
+        const payloadEnd = payloadStart + payloadLength;
+        if (payloadEnd > buffer.length) {
+            break;
+        }
+        const payload = buffer.subarray(payloadStart, payloadEnd);
+        decoded.push(flags === FLAG_COMPRESSED ? (0, node_zlib_1.gunzipSync)(payload) : Buffer.from(payload));
+        offset = payloadEnd;
+    }
+    return decoded;
+}

package/dist/cjs/protocol/connect-frame.test.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const vitest_1 = require("vitest");
+const connect_frame_js_1 = require("./connect-frame.js");
+const fixtureSimpleFrame = (0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), 'test/fixtures/connect/frame-simple.bin'));
+const fixtureGzipFrame = (0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), 'test/fixtures/connect/frame-gzip.bin'));
+const fixtureMultiFrame = (0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), 'test/fixtures/connect/frame-multi.bin'));
+const payloadHello = Buffer.from('CONNECT\x01hello', 'utf8');
+const payloadWorld = Buffer.from('CONNECT\x02world', 'utf8');
+(0, vitest_1.describe)('connectFrameEncode', () => {
+    (0, vitest_1.it)('roundtrip encodes and decodes uncompressed payload', () => {
+        const encoded = (0, connect_frame_js_1.connectFrameEncode)(payloadHello, false);
+        (0, vitest_1.expect)(encoded.readUInt8(0)).toBe(0);
+        (0, vitest_1.expect)(encoded.readUInt32BE(1)).toBe(payloadHello.length);
+        (0, vitest_1.expect)(encoded.subarray(5)).toEqual(payloadHello);
+        (0, vitest_1.expect)((0, connect_frame_js_1.connectFrameDecode)(encoded)).toEqual([payloadHello]);
+    });
+    (0, vitest_1.it)('gzip roundtrip uses compressed frame and decodes back to source payload', () => {
+        const encoded = (0, connect_frame_js_1.connectFrameEncode)(payloadWorld, true);
+        (0, vitest_1.expect)(encoded.readUInt8(0)).toBe(1);
+        (0, vitest_1.expect)((0, connect_frame_js_1.connectFrameDecode)(encoded)).toEqual([payloadWorld]);
+    });
+});
+(0, vitest_1.describe)('connectFrameDecode fixtures', () => {
+    (0, vitest_1.it)('decodes frame-simple fixture payload', () => {
+        (0, vitest_1.expect)((0, connect_frame_js_1.connectFrameDecode)(fixtureSimpleFrame)).toEqual([payloadHello]);
+    });
+    (0, vitest_1.it)('decodes gzip fixture payload', () => {
+        (0, vitest_1.expect)((0, connect_frame_js_1.connectFrameDecode)(fixtureGzipFrame)).toEqual([payloadWorld]);
+    });
+    (0, vitest_1.it)('decodes multiple concatenated frames in order', () => {
+        (0, vitest_1.expect)((0, connect_frame_js_1.connectFrameDecode)(fixtureMultiFrame)).toEqual([payloadHello, payloadHello]);
+    });
+});

package/dist/cjs/protocol/protobuf.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtobufEncoder = void 0;
+exports.decodeVarint = decodeVarint;
+exports.extractStrings = extractStrings;
+function encodeVarint(value) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`Varint value must be a non-negative integer: ${value}`);
+    }
+    const bytes = [];
+    let remaining = value;
+    while (remaining >= 0x80) {
+        bytes.push((remaining & 0x7f) | 0x80);
+        remaining = Math.floor(remaining / 0x80);
+    }
+    bytes.push(remaining);
+    return Buffer.from(bytes);
+}
+function decodeUtf8IfValid(value) {
+    if (value.length === 0) {
+        return '';
+    }
+    const decoded = value.toString('utf8');
+    const encoded = Buffer.from(decoded, 'utf8');
+    if (!encoded.equals(value)) {
+        return null;
+    }
+    return decoded;
+}
+class ProtobufEncoder {
+    chunks = [];
+    writeVarint(field, value) {
+        this.writeTag(field, 0);
+        this.chunks.push(encodeVarint(value));
+    }
+    writeString(field, value) {
+        this.writeBytes(field, Buffer.from(value, 'utf8'));
+    }
+    writeBytes(field, data) {
+        this.writeTag(field, 2);
+        this.chunks.push(encodeVarint(data.length));
+        this.chunks.push(data);
+    }
+    writeMessage(field, encoder) {
+        this.writeBytes(field, encoder.toBuffer());
+    }
+    toBuffer() {
+        return Buffer.concat(this.chunks);
+    }
+    writeTag(field, wireType) {
+        if (!Number.isInteger(field) || field <= 0) {
+            throw new Error(`Field number must be a positive integer: ${field}`);
+        }
+        this.chunks.push(encodeVarint((field << 3) | wireType));
+    }
+}
+exports.ProtobufEncoder = ProtobufEncoder;
+function decodeVarint(buffer, offset) {
+    let value = 0;
+    let shift = 0;
+    let cursor = offset;
+    while (cursor < buffer.length) {
+        const byte = buffer.readUInt8(cursor);
+        value += (byte & 0x7f) * 2 ** shift;
+        cursor += 1;
+        if ((byte & 0x80) === 0) {
+            return [value, cursor];
+        }
+        shift += 7;
+    }
+    throw new Error('Unexpected end of buffer while decoding varint');
+}
+function extractStrings(buffer) {
+    const result = [];
+    let offset = 0;
+    while (offset < buffer.length) {
+        let key;
+        [key, offset] = decodeVarint(buffer, offset);
+        const wireType = key & 0x07;
+        if (wireType === 0) {
+            [, offset] = decodeVarint(buffer, offset);
+            continue;
+        }
+        if (wireType === 1) {
+            offset += 8;
+            continue;
+        }
+        if (wireType === 2) {
+            let length;
+            [length, offset] = decodeVarint(buffer, offset);
+            const end = offset + length;
+            if (end > buffer.length) {
+                break;
+            }
+            const slice = buffer.subarray(offset, end);
+            const candidate = decodeUtf8IfValid(slice);
+            if (candidate !== null) {
+                result.push(candidate);
+            }
+            else {
+                const nested = extractStrings(slice);
+                result.push(...nested);
+            }
+            offset = end;
+            continue;
+        }
+        if (wireType === 5) {
+            offset += 4;
+            continue;
+        }
+        break;
+    }
+    return result;
+}

package/dist/cjs/protocol/protobuf.test.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const vitest_1 = require("vitest");
+const protobuf_js_1 = require("./protobuf.js");
+const fixtureMsg1 = (0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), 'test/fixtures/protobuf/msg-1.bin'));
+const fixtureMsg2 = (0, node_fs_1.readFileSync)((0, node_path_1.join)(process.cwd(), 'test/fixtures/protobuf/msg-2.bin'));
+(0, vitest_1.describe)('ProtobufEncoder', () => {
+    (0, vitest_1.it)('matches fixture bytes for synthetic protobuf messages', () => {
+        const encoder1 = new protobuf_js_1.ProtobufEncoder();
+        encoder1.writeVarint(1, 150);
+        encoder1.writeString(2, 'alpha');
+        const encoder2 = new protobuf_js_1.ProtobufEncoder();
+        encoder2.writeVarint(1, 42);
+        encoder2.writeString(2, 'beta');
+        (0, vitest_1.expect)(encoder1.toBuffer()).toEqual(fixtureMsg1);
+        (0, vitest_1.expect)(encoder2.toBuffer()).toEqual(fixtureMsg2);
+    });
+    (0, vitest_1.it)('writes bytes and nested messages', () => {
+        const nested = new protobuf_js_1.ProtobufEncoder();
+        nested.writeString(1, 'xy');
+        const encoder = new protobuf_js_1.ProtobufEncoder();
+        encoder.writeBytes(3, Buffer.from([0xaa, 0xbb]));
+        encoder.writeMessage(4, nested);
+        (0, vitest_1.expect)(Array.from(encoder.toBuffer())).toEqual([
+            0x1a,
+            0x02,
+            0xaa,
+            0xbb,
+            0x22,
+            0x04,
+            0x0a,
+            0x02,
+            0x78,
+            0x79,
+        ]);
+    });
+});
+(0, vitest_1.describe)('decodeVarint', () => {
+    (0, vitest_1.it)('decodes varint value and returns new offset', () => {
+        const buffer = Buffer.from([0x96, 0x01, 0x2a]);
+        const [first, firstOffset] = (0, protobuf_js_1.decodeVarint)(buffer, 0);
+        const [second, secondOffset] = (0, protobuf_js_1.decodeVarint)(buffer, firstOffset);
+        (0, vitest_1.expect)(first).toBe(150);
+        (0, vitest_1.expect)(firstOffset).toBe(2);
+        (0, vitest_1.expect)(second).toBe(42);
+        (0, vitest_1.expect)(secondOffset).toBe(3);
+    });
+});
+(0, vitest_1.describe)('extractStrings', () => {
+    (0, vitest_1.it)('extractStrings returns all embedded strings from fixtures', () => {
+        const combined = Buffer.concat([fixtureMsg1, fixtureMsg2]);
+        (0, vitest_1.expect)((0, protobuf_js_1.extractStrings)(fixtureMsg1)).toEqual(['alpha']);
+        (0, vitest_1.expect)((0, protobuf_js_1.extractStrings)(fixtureMsg2)).toEqual(['beta']);
+        (0, vitest_1.expect)((0, protobuf_js_1.extractStrings)(combined)).toEqual(['alpha', 'beta']);
+    });
+});

package/dist/cjs/provider.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.windsurf = void 0;
+exports.createWindsurfProvider = createWindsurfProvider;
+const devstral_language_model_js_1 = require("./model/devstral-language-model.js");
+function createWindsurfProvider(options = {}) {
+    return (modelId) => {
+        const opts = { ...options, modelId };
+        return new devstral_language_model_js_1.DevstralLanguageModel(opts);
+    };
+}
+exports.windsurf = createWindsurfProvider();
+exports.default = exports.windsurf;