network-ai 5.10.2 → 5.12.0

package/dist/esm/adapters/minimax-adapter.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * MiniMax Adapter
+ *
+ * Integrates MiniMax LLM API (OpenAI-compatible chat completions) with
+ * the SwarmOrchestrator. Supports MiniMax-M2.5 and MiniMax-M2.5-highspeed
+ * models with 204K context window.
+ *
+ * Usage — built-in fetch:
+ *   const adapter = new MiniMaxAdapter();
+ *   adapter.registerAgent('analyst', {
+ *     model: 'MiniMax-M2.5',
+ *     apiKey: process.env.MINIMAX_API_KEY,
+ *     systemPrompt: 'You are an expert analyst.',
+ *   });
+ *
+ * Usage — bring-your-own client (any OpenAI-compatible SDK):
+ *   adapter.registerAgent('fast', {
+ *     model: 'MiniMax-M2.5-highspeed',
+ *     client: openaiCompatibleInstance.chat.completions,
+ *   });
+ *
+ * @module MiniMaxAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiniMaxAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Build the prompt string from an AgentPayload */
+function buildPrompt(payload) {
+    const parts = [];
+    const instruction = payload.handoff?.instruction;
+    if (instruction)
+        parts.push(instruction);
+    if (payload.action)
+        parts.push(`Task: ${payload.action}`);
+    if (payload.params && Object.keys(payload.params).length > 0) {
+        parts.push(`Parameters: ${JSON.stringify(payload.params, null, 2)}`);
+    }
+    if (payload.blackboardSnapshot && Object.keys(payload.blackboardSnapshot).length > 0) {
+        const relevant = Object.entries(payload.blackboardSnapshot)
+            .slice(0, 10)
+            .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+        parts.push(`Context from blackboard:\n${relevant}`);
+    }
+    return parts.join('\n\n') || 'Complete the task.';
+}
+/** Resolve API key — config first, then env */
+function resolveApiKey(config) {
+    return config.apiKey ?? process.env['MINIMAX_API_KEY'] ?? '';
+}
+/**
+ * Clamp temperature to MiniMax's valid range (0.0, 1.0].
+ * MiniMax rejects exactly 0, so we use a small epsilon.
+ */
+function clampTemperature(temp) {
+    const t = temp ?? 0.7;
+    if (t <= 0)
+        return 0.01;
+    if (t > 1)
+        return 1.0;
+    return t;
+}
+// ---------------------------------------------------------------------------
+// MiniMaxAdapter
+// ---------------------------------------------------------------------------
+/**
+ * Adapter that connects MiniMax LLM models to the SwarmOrchestrator.
+ * Uses MiniMax's OpenAI-compatible chat completions API.
+ *
+ * Available models:
+ * - MiniMax-M2.5 — flagship model with 204K context
+ * - MiniMax-M2.5-highspeed — faster variant optimised for throughput
+ */
+class MiniMaxAdapter extends base_adapter_1.BaseAdapter {
+    name = 'minimax';
+    version = '1.0.0';
+    agents = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: true,
+            statefulSessions: false,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Registration
+    // -------------------------------------------------------------------------
+    /**
+     * Register a MiniMax-powered agent.
+     *
+     * @param agentId   Unique identifier used in `delegateTask` calls.
+     * @param config    MiniMax agent configuration.
+     */
+    registerAgent(agentId, config = {}) {
+        if (!this.ready) {
+            this.ready = true;
+        }
+        this.agents.set(agentId, { config });
+        this.registeredAgents.set(agentId, {
+            id: agentId,
+            name: agentId,
+            description: `MiniMax agent (model: ${config.model ?? 'MiniMax-M2.5'})`,
+            capabilities: ['chat', 'analysis', 'code-generation', 'reasoning'],
+            adapter: this.name,
+            status: 'available',
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Execution
+    // -------------------------------------------------------------------------
+    async executeAgent(agentId, payload, context) {
+        if (!this.ready) {
+            throw new Error('MiniMaxAdapter: adapter not initialized. Call initialize() first.');
+        }
+        const entry = this.agents.get(agentId);
+        if (!entry) {
+            return {
+                success: false,
+                error: {
+                    code: 'AGENT_NOT_FOUND',
+                    message: `MiniMaxAdapter: no agent registered with id "${agentId}"`,
+                    recoverable: false,
+                },
+                metadata: { adapter: this.name },
+            };
+        }
+        const cfg = entry.config;
+        try {
+            const { output, usage } = await this._executeChat(cfg, payload);
+            return {
+                success: true,
+                data: { output, model: cfg.model ?? 'MiniMax-M2.5' },
+                metadata: {
+                    adapter: this.name,
+                    trace: {
+                        taskId: context.taskId,
+                        ...(usage ? { usage } : {}),
+                    },
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                error: {
+                    code: 'EXECUTION_ERROR',
+                    message,
+                    recoverable: true,
+                },
+                metadata: { adapter: this.name },
+            };
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private execution
+    // -------------------------------------------------------------------------
+    async _executeChat(cfg, payload) {
+        const prompt = buildPrompt(payload);
+        const model = cfg.model ?? 'MiniMax-M2.5';
+        const temperature = clampTemperature(cfg.temperature);
+        // Bring-your-own SDK client
+        if (cfg.client) {
+            const messages = [];
+            if (cfg.systemPrompt)
+                messages.push({ role: 'system', content: cfg.systemPrompt });
+            messages.push({ role: 'user', content: prompt });
+            const resp = await cfg.client.create({
+                model,
+                messages,
+                max_tokens: cfg.maxTokens,
+                temperature,
+                stop: cfg.stop,
+            });
+            const output = resp.choices[0]?.message?.content ?? resp.choices[0]?.text ?? '';
+            return { output, usage: resp.usage };
+        }
+        // Built-in fetch path
+        const apiKey = resolveApiKey(cfg);
+        if (!apiKey) {
+            throw new Error('MiniMaxAdapter: no API key provided. Set apiKey in config or MINIMAX_API_KEY env var.');
+        }
+        const base = (cfg.baseUrl ?? 'https://api.minimax.io/v1').replace(/\/+$/, '');
+        const url = `${base}/chat/completions`;
+        const messages = [];
+        if (cfg.systemPrompt)
+            messages.push({ role: 'system', content: cfg.systemPrompt });
+        messages.push({ role: 'user', content: prompt });
+        const body = {
+            model,
+            messages,
+            ...(cfg.maxTokens != null ? { max_tokens: cfg.maxTokens } : {}),
+            temperature,
+            ...(cfg.stop ? { stop: cfg.stop } : {}),
+        };
+        const timeoutMs = cfg.timeout ?? 120_000;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let resp;
+        try {
+            resp = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${apiKey}`,
+                    ...cfg.headers,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => '');
+            throw new Error(`MiniMaxAdapter: HTTP ${resp.status} from MiniMax API — ${text.slice(0, 200)}`);
+        }
+        const json = await resp.json();
+        const output = json.choices[0]?.message?.content ?? '';
+        return { output, usage: json.usage };
+    }
+}
+exports.MiniMaxAdapter = MiniMaxAdapter;
+//# sourceMappingURL=minimax-adapter.js.map

package/dist/esm/adapters/minimax-adapter.js.map

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