@hileeon/mcc 0.1.0

package/lib/proxy/glmt/locale-enforcer.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * LocaleEnforcer - Force English output from GLM models
+ *
+ * Purpose: GLM models default to Chinese when prompts are ambiguous or contain Chinese context.
+ * This module always injects "MUST respond in English" instruction into system prompt or first user message.
+ *
+ * Usage:
+ *   const enforcer = new LocaleEnforcer();
+ *   const modifiedMessages = enforcer.injectInstruction(messages);
+ *
+ * Strategy:
+ *   1. If system prompt exists: Prepend instruction
+ *   2. If no system prompt: Prepend to first user message
+ *   3. Preserve message structure (string vs array content)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocaleEnforcer = void 0;
+class LocaleEnforcer {
+    constructor(options = {}) {
+        this.instruction =
+            options.instruction ||
+                'CRITICAL: You MUST respond in English only, regardless of the input language or context. This is a strict requirement.';
+    }
+    /**
+     * Inject English instruction into messages
+     * @param messages - Messages array to modify
+     * @returns Modified messages array
+     */
+    injectInstruction(messages) {
+        // Clone messages to avoid mutation
+        const modifiedMessages = JSON.parse(JSON.stringify(messages));
+        // Strategy 1: Inject into system prompt (preferred)
+        const systemIndex = modifiedMessages.findIndex((m) => m.role === 'system');
+        if (systemIndex >= 0) {
+            const systemMsg = modifiedMessages[systemIndex];
+            if (typeof systemMsg.content === 'string') {
+                systemMsg.content = `${this.instruction}\n\n${systemMsg.content}`;
+            }
+            else if (Array.isArray(systemMsg.content)) {
+                systemMsg.content.unshift({
+                    type: 'text',
+                    text: this.instruction,
+                });
+            }
+            return modifiedMessages;
+        }
+        // Strategy 2: Prepend to first user message
+        const userIndex = modifiedMessages.findIndex((m) => m.role === 'user');
+        if (userIndex >= 0) {
+            const userMsg = modifiedMessages[userIndex];
+            if (typeof userMsg.content === 'string') {
+                userMsg.content = `${this.instruction}\n\n${userMsg.content}`;
+            }
+            else if (Array.isArray(userMsg.content)) {
+                userMsg.content.unshift({
+                    type: 'text',
+                    text: this.instruction,
+                });
+            }
+            return modifiedMessages;
+        }
+        // No system or user messages found (edge case)
+        return modifiedMessages;
+    }
+}
+exports.LocaleEnforcer = LocaleEnforcer;
+//# sourceMappingURL=locale-enforcer.js.map

package/lib/proxy/glmt/pipeline/content-transformer.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * ContentTransformer - Handle message sanitization and content transformations
+ *
+ * Responsibilities:
+ * - Sanitize messages for OpenAI API compatibility
+ * - Extract thinking control tags from messages
+ * - Detect think keywords in user prompts
+ * - Transform tools between Anthropic and OpenAI formats
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentTransformer = void 0;
+class ContentTransformer {
+    constructor(defaultThinking = true) {
+        this.defaultThinking = defaultThinking;
+    }
+    /**
+     * Sanitize messages for OpenAI API compatibility
+     */
+    sanitizeMessages(messages) {
+        const result = [];
+        for (const msg of messages) {
+            // If content is a string, add as-is
+            if (typeof msg.content === 'string') {
+                result.push(msg);
+                continue;
+            }
+            // If content is an array, process blocks
+            if (Array.isArray(msg.content)) {
+                // Separate tool_result blocks from other content
+                const toolResults = msg.content.filter((block) => block.type === 'tool_result');
+                const textBlocks = msg.content.filter((block) => block.type === 'text');
+                // CRITICAL: Tool messages must come BEFORE user text in OpenAI API
+                for (const toolResult of toolResults) {
+                    result.push({
+                        role: 'tool',
+                        content: typeof toolResult.content === 'string'
+                            ? toolResult.content
+                            : JSON.stringify(toolResult.content),
+                    });
+                }
+                // Add text content as user/assistant message AFTER tool messages
+                if (textBlocks.length > 0) {
+                    const textContent = textBlocks.length === 1
+                        ? textBlocks[0].text || ''
+                        : textBlocks.map((b) => b.text || '').join('\n');
+                    result.push({
+                        role: msg.role,
+                        content: textContent,
+                    });
+                }
+                // If no content at all, add empty message
+                if (textBlocks.length === 0 && toolResults.length === 0) {
+                    result.push({
+                        role: msg.role,
+                        content: '',
+                    });
+                }
+                continue;
+            }
+            // Fallback: return message as-is
+            result.push(msg);
+        }
+        return result;
+    }
+    /**
+     * Transform Anthropic tools to OpenAI tools format
+     */
+    transformTools(anthropicTools) {
+        return anthropicTools.map((tool) => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.input_schema || {},
+            },
+        }));
+    }
+    /**
+     * Check if messages contain thinking control tags
+     */
+    hasThinkingTags(messages) {
+        for (const msg of messages) {
+            if (msg.role !== 'user')
+                continue;
+            const content = msg.content;
+            if (typeof content !== 'string')
+                continue;
+            // Check for control tags
+            if (/<Thinking:(On|Off)>/i.test(content) || /<Effort:(Low|Medium|High)>/i.test(content)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Extract thinking control tags from user messages
+     */
+    extractThinkingControl(messages) {
+        const config = {
+            thinking: this.defaultThinking,
+            effort: 'medium',
+        };
+        // Scan user messages for control tags
+        for (const msg of messages) {
+            if (msg.role !== 'user')
+                continue;
+            const content = msg.content;
+            if (typeof content !== 'string')
+                continue;
+            // Check for <Thinking:On|Off>
+            const thinkingMatch = content.match(/<Thinking:(On|Off)>/i);
+            if (thinkingMatch) {
+                config.thinking = thinkingMatch[1].toLowerCase() === 'on';
+            }
+            // Check for <Effort:Low|Medium|High>
+            const effortMatch = content.match(/<Effort:(Low|Medium|High)>/i);
+            if (effortMatch) {
+                config.effort = effortMatch[1].toLowerCase();
+            }
+        }
+        return config;
+    }
+    /**
+     * Detect Anthropic-style "think" keywords in user prompts
+     */
+    detectThinkKeywords(messages) {
+        if (!messages || messages.length === 0)
+            return null;
+        // Extract text from user messages
+        const text = messages
+            .filter((m) => m.role === 'user')
+            .map((m) => {
+            if (typeof m.content === 'string')
+                return m.content;
+            if (Array.isArray(m.content)) {
+                return m.content
+                    .filter((block) => block.type === 'text')
+                    .map((block) => block.text || '')
+                    .join(' ');
+            }
+            return '';
+        })
+            .join(' ');
+        // Priority: ultrathink > think harder > think hard > think
+        if (/\bultrathink\b/i.test(text)) {
+            return { thinking: true, effort: 'max', keyword: 'ultrathink' };
+        }
+        if (/\bthink\s+harder\b/i.test(text)) {
+            return { thinking: true, effort: 'high', keyword: 'think harder' };
+        }
+        if (/\bthink\s+hard\b/i.test(text)) {
+            return { thinking: true, effort: 'medium', keyword: 'think hard' };
+        }
+        if (/\bthink\b/i.test(text)) {
+            return { thinking: true, effort: 'low', keyword: 'think' };
+        }
+        return null; // No keywords detected
+    }
+}
+exports.ContentTransformer = ContentTransformer;
+//# sourceMappingURL=content-transformer.js.map

package/lib/proxy/glmt/pipeline/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Pipeline Module Exports
+ *
+ * Barrel file for the GLMT transformation pipeline
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestTransformer = exports.StreamParser = exports.ResponseBuilder = exports.ToolCallHandler = exports.ContentTransformer = void 0;
+// Pipeline components
+var content_transformer_1 = require("./content-transformer");
+Object.defineProperty(exports, "ContentTransformer", { enumerable: true, get: function () { return content_transformer_1.ContentTransformer; } });
+var tool_call_handler_1 = require("./tool-call-handler");
+Object.defineProperty(exports, "ToolCallHandler", { enumerable: true, get: function () { return tool_call_handler_1.ToolCallHandler; } });
+var response_builder_1 = require("./response-builder");
+Object.defineProperty(exports, "ResponseBuilder", { enumerable: true, get: function () { return response_builder_1.ResponseBuilder; } });
+var stream_parser_1 = require("./stream-parser");
+Object.defineProperty(exports, "StreamParser", { enumerable: true, get: function () { return stream_parser_1.StreamParser; } });
+var request_transformer_1 = require("./request-transformer");
+Object.defineProperty(exports, "RequestTransformer", { enumerable: true, get: function () { return request_transformer_1.RequestTransformer; } });
+//# sourceMappingURL=index.js.map

package/lib/proxy/glmt/pipeline/request-transformer.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * RequestTransformer - Handle Anthropic → OpenAI request transformation
+ *
+ * Responsibilities:
+ * - Transform Anthropic request format to OpenAI format
+ * - Inject locale and reasoning instructions
+ * - Map models and configure parameters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestTransformer = void 0;
+const locale_enforcer_1 = require("../locale-enforcer");
+const reasoning_enforcer_1 = require("../reasoning-enforcer");
+const content_transformer_1 = require("./content-transformer");
+class RequestTransformer {
+    constructor(config = {}) {
+        const defaultThinking = config.defaultThinking ?? true;
+        this.log = config.log || (() => { });
+        this.localeEnforcer = new locale_enforcer_1.LocaleEnforcer();
+        this.reasoningEnforcer = new reasoning_enforcer_1.ReasoningEnforcer({
+            enabled: config.explicitReasoning ?? true,
+        });
+        this.contentTransformer = new content_transformer_1.ContentTransformer(defaultThinking);
+        this.modelMaxTokens = {
+            'GLM-4.6': 128000,
+            'GLM-4.5': 96000,
+            'GLM-4.5-air': 16000,
+        };
+    }
+    /**
+     * Transform Anthropic request to OpenAI format
+     */
+    transform(anthropicRequest) {
+        try {
+            const messages = anthropicRequest.messages || [];
+            // 1. Extract thinking control from messages
+            const thinkingConfig = this.contentTransformer.extractThinkingControl(messages);
+            const hasControlTags = this.contentTransformer.hasThinkingTags(messages);
+            // 2. Detect "think" keywords in user prompts
+            const keywordConfig = this.contentTransformer.detectThinkKeywords(messages);
+            if (keywordConfig && !anthropicRequest.thinking && !hasControlTags) {
+                thinkingConfig.thinking = keywordConfig.thinking;
+                thinkingConfig.effort = keywordConfig.effort;
+                this.log(`Detected think keyword: ${keywordConfig.keyword}, effort=${keywordConfig.effort}`);
+            }
+            // 3. Check anthropicRequest.thinking parameter (takes precedence)
+            if (anthropicRequest.thinking) {
+                if (anthropicRequest.thinking.type === 'enabled') {
+                    thinkingConfig.thinking = true;
+                    this.log('Claude CLI explicitly enabled thinking');
+                }
+                else if (anthropicRequest.thinking.type === 'disabled') {
+                    thinkingConfig.thinking = false;
+                    this.log('Claude CLI explicitly disabled thinking');
+                }
+            }
+            this.log(`Final thinking control: ${JSON.stringify(thinkingConfig)}`);
+            // 4. Map model
+            const glmModel = this.mapModel(anthropicRequest.model);
+            // 5. Inject locale instruction
+            const messagesWithLocale = this.localeEnforcer.injectInstruction(messages);
+            // 6. Inject reasoning instruction
+            const messagesWithReasoning = this.reasoningEnforcer.injectInstruction(messagesWithLocale, thinkingConfig);
+            // 7. Build OpenAI request
+            const openaiRequest = {
+                model: glmModel,
+                messages: this.contentTransformer.sanitizeMessages(messagesWithReasoning),
+                max_tokens: this.getMaxTokens(glmModel),
+                stream: anthropicRequest.stream ?? false,
+            };
+            // 8. Transform tools if present
+            if (anthropicRequest.tools && anthropicRequest.tools.length > 0) {
+                openaiRequest.tools = this.contentTransformer.transformTools(anthropicRequest.tools);
+                openaiRequest.tool_choice = 'auto';
+                this.log(`Transformed ${anthropicRequest.tools.length} tools for OpenAI format`);
+            }
+            // 9. Preserve optional parameters
+            if (anthropicRequest.temperature !== undefined) {
+                openaiRequest.temperature = anthropicRequest.temperature;
+            }
+            if (anthropicRequest.top_p !== undefined) {
+                openaiRequest.top_p = anthropicRequest.top_p;
+            }
+            if (anthropicRequest.stream !== undefined) {
+                openaiRequest.stream = anthropicRequest.stream;
+            }
+            // 10. Inject reasoning parameters
+            this.injectReasoningParams(openaiRequest, thinkingConfig);
+            return { openaiRequest, thinkingConfig };
+        }
+        catch (error) {
+            const err = error;
+            console.error('[RequestTransformer] Transformation error:', err);
+            return {
+                openaiRequest: anthropicRequest,
+                thinkingConfig: { thinking: false, effort: 'medium' },
+                error: err.message,
+            };
+        }
+    }
+    injectReasoningParams(openaiRequest, thinkingConfig) {
+        openaiRequest.do_sample = true;
+        if (thinkingConfig.thinking) {
+            openaiRequest.reasoning = true;
+            openaiRequest.reasoning_effort = thinkingConfig.effort;
+        }
+    }
+    mapModel(_anthropicModel) {
+        return 'GLM-4.6';
+    }
+    getMaxTokens(model) {
+        return this.modelMaxTokens[model] || 128000;
+    }
+}
+exports.RequestTransformer = RequestTransformer;
+//# sourceMappingURL=request-transformer.js.map

package/lib/proxy/glmt/pipeline/response-builder.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * ResponseBuilder - Create SSE events for Anthropic streaming format
+ *
+ * Responsibilities:
+ * - Create message_start, message_delta, message_stop events
+ * - Create content_block_start, content_block_delta, content_block_stop events
+ * - Generate thinking signatures
+ * - Map stop reasons between formats
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseBuilder = void 0;
+const crypto = __importStar(require("crypto"));
+class ResponseBuilder {
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    /**
+     * Create message_start event
+     */
+    createMessageStartEvent(accumulator) {
+        return {
+            event: 'message_start',
+            data: {
+                type: 'message_start',
+                message: {
+                    id: accumulator.getMessageId(),
+                    type: 'message',
+                    role: accumulator.getRole(),
+                    content: [],
+                    model: accumulator.getModel() || 'glm-5',
+                    stop_reason: null,
+                    usage: {
+                        input_tokens: accumulator.getInputTokens(),
+                        output_tokens: 0,
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Create content_block_start event
+     */
+    createContentBlockStartEvent(block) {
+        return {
+            event: 'content_block_start',
+            data: {
+                type: 'content_block_start',
+                index: block.index,
+                content_block: {
+                    type: block.type,
+                    [block.type]: '',
+                },
+            },
+        };
+    }
+    /**
+     * Create thinking_delta event
+     */
+    createThinkingDeltaEvent(block, delta) {
+        return {
+            event: 'content_block_delta',
+            data: {
+                type: 'content_block_delta',
+                index: block.index,
+                delta: {
+                    type: 'thinking_delta',
+                    thinking: delta,
+                },
+            },
+        };
+    }
+    /**
+     * Create text_delta event
+     */
+    createTextDeltaEvent(block, delta) {
+        return {
+            event: 'content_block_delta',
+            data: {
+                type: 'content_block_delta',
+                index: block.index,
+                delta: {
+                    type: 'text_delta',
+                    text: delta,
+                },
+            },
+        };
+    }
+    /**
+     * Create thinking signature delta event
+     */
+    createSignatureDeltaEvent(block) {
+        // FIX: Guard against empty content (signature timing race)
+        if (!block.content || block.content.length === 0) {
+            if (this.verbose) {
+                console.error(`[ResponseBuilder] WARNING: Skipping signature for empty thinking block ${block.index}`);
+                console.error(`This indicates a race condition - signature requested before content accumulated`);
+            }
+            return null;
+        }
+        const signature = this.generateThinkingSignature(block.content);
+        if (this.verbose) {
+            console.error(`[ResponseBuilder] Generating signature for block ${block.index}: ${block.content.length} chars`);
+        }
+        return {
+            event: 'content_block_delta',
+            data: {
+                type: 'content_block_delta',
+                index: block.index,
+                delta: {
+                    type: 'thinking_signature_delta',
+                    signature: signature,
+                },
+            },
+        };
+    }
+    /**
+     * Create content_block_stop event
+     */
+    createContentBlockStopEvent(block) {
+        return {
+            event: 'content_block_stop',
+            data: {
+                type: 'content_block_stop',
+                index: block.index,
+            },
+        };
+    }
+    /**
+     * Generate finalization events (message_delta + message_stop)
+     */
+    createFinalizationEvents(accumulator, stopReason) {
+        return [
+            {
+                event: 'message_delta',
+                data: {
+                    type: 'message_delta',
+                    delta: {
+                        stop_reason: stopReason,
+                    },
+                    usage: {
+                        input_tokens: accumulator.getInputTokens(),
+                        output_tokens: accumulator.getOutputTokens(),
+                    },
+                },
+            },
+            {
+                event: 'message_stop',
+                data: {
+                    type: 'message_stop',
+                },
+            },
+        ];
+    }
+    /**
+     * Generate thinking signature for Claude Code UI
+     */
+    generateThinkingSignature(thinking) {
+        // Generate signature hash
+        const hash = crypto.createHash('sha256').update(thinking).digest('hex').substring(0, 16);
+        return {
+            type: 'thinking_signature',
+            hash: hash,
+            length: thinking.length,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Map OpenAI stop reason to Anthropic stop reason
+     */
+    mapStopReason(openaiReason) {
+        const mapping = {
+            stop: 'end_turn',
+            length: 'max_tokens',
+            tool_calls: 'tool_use',
+            content_filter: 'stop_sequence',
+        };
+        return mapping[openaiReason] || 'end_turn';
+    }
+}
+exports.ResponseBuilder = ResponseBuilder;
+//# sourceMappingURL=response-builder.js.map