network-ai 5.10.1 → 5.11.0

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

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * AutoGen / AG2 Adapter
+ *
+ * Allows Microsoft AutoGen (AG2) agents to plug into the SwarmOrchestrator.
+ * AutoGen agents communicate via message-passing conversations, so this
+ * adapter translates the orchestrator's task payloads into AutoGen messages.
+ *
+ * Usage:
+ *   const adapter = new AutoGenAdapter();
+ *   adapter.registerAgent("coder", myAutoGenAgent);
+ *   adapter.registerAgent("critic", myCriticAgent);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "autogen:coder", ... })
+ *
+ * @module AutoGenAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoGenAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class AutoGenAdapter extends base_adapter_1.BaseAdapter {
+    name = 'autogen';
+    version = '1.0.0';
+    agents = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: true,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    /**
+     * Register an AutoGen agent.
+     * The agent should implement at least one of: generateReply, run, or initiateChat.
+     */
+    registerAgent(agentId, agent, metadata) {
+        this.agents.set(agentId, agent);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agent.name || agentId,
+            description: metadata?.description ?? `AutoGen agent: ${agent.name || agentId}`,
+            capabilities: metadata?.capabilities,
+            status: 'available',
+        });
+    }
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const agent = this.agents.get(agentId);
+        if (!agent) {
+            return this.errorResult('AGENT_NOT_FOUND', `AutoGen agent "${agentId}" is not registered`, false);
+        }
+        const startTime = Date.now();
+        try {
+            let result;
+            // Strategy 1: Use .run() if available (simplest interface)
+            if (agent.run) {
+                const task = this.buildTaskString(payload);
+                result = await agent.run(task, {
+                    agentId: context.agentId,
+                    taskId: context.taskId,
+                    blackboard: payload.blackboardSnapshot,
+                });
+            }
+            // Strategy 2: Use .generateReply() with message format
+            else if (agent.generateReply) {
+                const messages = this.buildMessages(payload, context);
+                result = await agent.generateReply(messages);
+            }
+            // Strategy 3: Fallback error
+            else {
+                return this.errorResult('NO_METHOD', `AutoGen agent "${agentId}" has no callable method (run, generateReply, or initiateChat)`, false);
+            }
+            return this.normalizeResult(result, startTime);
+        }
+        catch (error) {
+            return this.errorResult('AUTOGEN_ERROR', error instanceof Error ? error.message : 'AutoGen execution failed', true, error);
+        }
+    }
+    buildTaskString(payload) {
+        if (payload.handoff?.instruction) {
+            let task = payload.handoff.instruction;
+            if (payload.handoff.constraints?.length) {
+                task += `\n\nConstraints: ${payload.handoff.constraints.join(', ')}`;
+            }
+            if (payload.handoff.expectedOutput) {
+                task += `\n\nExpected output: ${payload.handoff.expectedOutput}`;
+            }
+            return task;
+        }
+        return JSON.stringify(payload.params);
+    }
+    buildMessages(payload, context) {
+        const messages = [];
+        // System context
+        if (payload.blackboardSnapshot) {
+            messages.push({
+                role: 'system',
+                content: `Shared state: ${JSON.stringify(payload.blackboardSnapshot)}`,
+            });
+        }
+        // The actual task
+        const taskContent = payload.handoff?.instruction || JSON.stringify(payload.params);
+        messages.push({
+            role: 'user',
+            content: taskContent,
+            name: context.agentId,
+        });
+        return messages;
+    }
+    normalizeResult(result, startTime) {
+        if (result === null || result === undefined) {
+            return this.successResult({ response: 'No response generated' }, Date.now() - startTime);
+        }
+        if (typeof result === 'string') {
+            return this.successResult({ response: result }, Date.now() - startTime);
+        }
+        if (typeof result === 'object') {
+            const obj = result;
+            // AutoGen chat result format
+            if ('chat_history' in obj) {
+                return this.successResult({
+                    response: obj.summary || obj.chat_history,
+                    chatHistory: obj.chat_history,
+                }, Date.now() - startTime);
+            }
+            // generateReply format
+            if ('content' in obj) {
+                return this.successResult(obj.content, Date.now() - startTime);
+            }
+        }
+        return this.successResult(result, Date.now() - startTime);
+    }
+}
+exports.AutoGenAdapter = AutoGenAdapter;
+//# sourceMappingURL=autogen-adapter.js.map

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

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

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

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Base Adapter - Abstract base class for all agent system adapters
+ *
+ * Provides sensible defaults so adapter authors only need to implement
+ * the core `executeAgent` method. Everything else works out of the box.
+ *
+ * @module BaseAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAdapter = void 0;
+const errors_1 = require("../lib/errors");
+class BaseAdapter {
+    config = {};
+    ready = false;
+    registeredAgents = new Map();
+    /** Override to declare what your adapter supports */
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: false,
+            authentication: false,
+            statefulSessions: false,
+        };
+    }
+    // --- Lifecycle ---
+    async initialize(config) {
+        this.config = config;
+        this.ready = true;
+    }
+    async shutdown() {
+        this.ready = false;
+        this.registeredAgents.clear();
+    }
+    isReady() {
+        return this.ready;
+    }
+    // --- Agent Discovery (default: use registered agents) ---
+    async listAgents() {
+        return Array.from(this.registeredAgents.values());
+    }
+    async isAgentAvailable(agentId) {
+        return this.registeredAgents.has(agentId);
+    }
+    // --- Health ---
+    async healthCheck() {
+        return { healthy: this.ready, details: this.ready ? 'Adapter is ready' : 'Adapter not initialized' };
+    }
+    // --- Helpers for subclasses ---
+    /**
+     * Register an agent as available through this adapter.
+     * Adapters call this during init or discovery to declare their agents.
+     */
+    registerLocalAgent(agent) {
+        this.registeredAgents.set(agent.id, { ...agent, adapter: this.name });
+    }
+    /**
+     * Remove an agent from the registry
+     */
+    unregisterAgent(agentId) {
+        this.registeredAgents.delete(agentId);
+    }
+    /**
+     * Create a standard success result
+     */
+    successResult(data, executionTimeMs) {
+        return {
+            success: true,
+            data,
+            metadata: {
+                adapter: this.name,
+                executionTimeMs,
+            },
+        };
+    }
+    /**
+     * Create a standard error result
+     */
+    errorResult(code, message, recoverable = true, nativeError) {
+        return {
+            success: false,
+            error: {
+                code,
+                message,
+                recoverable,
+                nativeError,
+            },
+            metadata: { adapter: this.name },
+        };
+    }
+    /**
+     * Ensures the adapter is initialized before use
+     */
+    ensureReady() {
+        if (!this.ready) {
+            throw new errors_1.AdapterNotInitializedError(this.name);
+        }
+    }
+}
+exports.BaseAdapter = BaseAdapter;
+//# sourceMappingURL=base-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../../../adapters/base-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAWH,0CAA2D;AAE3D,MAAsB,WAAW;IAIrB,MAAM,GAAkB,EAAE,CAAC;IAC3B,KAAK,GAAG,KAAK,CAAC;IACd,gBAAgB,GAA2B,IAAI,GAAG,EAAE,CAAC;IAE/D,qDAAqD;IACrD,IAAI,YAAY;QACd,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,KAAK;YACpB,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,KAAK;YACrB,gBAAgB,EAAE,KAAK;SACxB,CAAC;IACJ,CAAC;IAED,oBAAoB;IAEpB,KAAK,CAAC,UAAU,CAAC,MAAqB;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAUD,2DAA2D;IAE3D,KAAK,CAAC,UAAU;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB;IAEjB,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,yBAAyB,EAAE,CAAC;IACvG,CAAC;IAED,iCAAiC;IAEjC;;;OAGG;IACO,kBAAkB,CAAC,KAAiC;QAC5D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACO,eAAe,CAAC,OAAe;QACvC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,IAAa,EAAE,eAAwB;QAC7D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,eAAe;aAChB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,WAAW,CACnB,IAAY,EACZ,OAAe,EACf,WAAW,GAAG,IAAI,EAClB,WAAqB;QAErB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI;gBACJ,OAAO;gBACP,WAAW;gBACX,WAAW;aACZ;YACD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,WAAW;QACnB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,mCAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAxHD,kCAwHC"}

package/dist/esm/adapters/browser-agent-adapter.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Browser Agent Adapter
+ *
+ * Integrates browser automation agents (Playwright, Puppeteer, or
+ * any CDP-compatible driver) with the SwarmOrchestrator.
+ *
+ * Provides a BYOC (bring your own client) interface for browser
+ * agents that navigate, scrape, interact with, and test web pages.
+ *
+ * Usage:
+ *   const adapter = new BrowserAgentAdapter();
+ *   adapter.registerBrowser('scraper', {
+ *     driver: myPlaywrightDriver,
+ *     mode: 'scrape',
+ *   });
+ *
+ * @module BrowserAgentAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserAgentAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+/**
+ * Adapter for browser automation agents.
+ *
+ * Supports scripted step sequences or single-action modes
+ * (navigate, scrape, screenshot, interact, test).
+ */
+class BrowserAgentAdapter extends base_adapter_1.BaseAdapter {
+    name = 'browser-agent';
+    version = '1.0.0';
+    browsers = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Registration
+    // -----------------------------------------------------------------------
+    /**
+     * Register a browser agent with a driver.
+     */
+    registerBrowser(agentId, config) {
+        this.browsers.set(agentId, config);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            status: 'available',
+            capabilities: ['browser', config.mode ?? 'navigate', 'web'],
+            metadata: {
+                adapter: 'browser-agent',
+                mode: config.mode ?? 'navigate',
+            },
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Execution
+    // -----------------------------------------------------------------------
+    async executeAgent(agentId, payload, _context) {
+        this.ensureReady();
+        const config = this.browsers.get(agentId);
+        if (!config) {
+            return this.errorResult('BROWSER_AGENT_NOT_FOUND', `No browser registered as '${agentId}'`);
+        }
+        const mode = payload.params?.mode ?? config.mode ?? 'navigate';
+        const url = payload.params?.url ?? payload.handoff?.instruction ?? payload.action;
+        const steps = payload.params?.steps ?? config.steps;
+        const timeoutMs = config.timeoutMs ?? 60_000;
+        const start = Date.now();
+        try {
+            let result;
+            const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Browser agent timed out')), timeoutMs));
+            if (steps?.length) {
+                result = await Promise.race([
+                    this.executeSteps(config.driver, steps, config.screenshotPerStep ?? false),
+                    timeoutPromise,
+                ]);
+            }
+            else {
+                result = await Promise.race([
+                    this.executeSingleMode(config.driver, mode, url),
+                    timeoutPromise,
+                ]);
+            }
+            const durationMs = Date.now() - start;
+            return this.successResult({ ...result, mode }, durationMs);
+        }
+        catch (err) {
+            return this.errorResult('BROWSER_EXECUTION_FAILED', err instanceof Error ? err.message : String(err));
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Single mode execution
+    // -----------------------------------------------------------------------
+    async executeSingleMode(driver, mode, target) {
+        switch (mode) {
+            case 'navigate': {
+                const result = await driver.goto(target);
+                return { url: result.url, title: result.title };
+            }
+            case 'scrape': {
+                await driver.goto(target);
+                const text = await driver.getTextContent();
+                const currentUrl = await driver.getCurrentUrl();
+                const title = await driver.getTitle();
+                return { url: currentUrl, title, textContent: text };
+            }
+            case 'screenshot': {
+                await driver.goto(target);
+                const screenshot = await driver.screenshot();
+                const ssUrl = await driver.getCurrentUrl();
+                return { url: ssUrl, screenshot };
+            }
+            case 'interact': {
+                const result = await driver.goto(target);
+                return { url: result.url, title: result.title, ready: true };
+            }
+            case 'test': {
+                await driver.goto(target);
+                const testUrl = await driver.getCurrentUrl();
+                const testTitle = await driver.getTitle();
+                return { url: testUrl, title: testTitle, tested: true };
+            }
+            default:
+                return { error: `Unknown mode: ${mode}` };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Step-based execution
+    // -----------------------------------------------------------------------
+    async executeSteps(driver, steps, screenshotPerStep) {
+        const results = [];
+        for (const step of steps) {
+            const stepStart = Date.now();
+            let stepResult = { action: step.action };
+            switch (step.action) {
+                case 'goto':
+                    if (step.value) {
+                        const r = await driver.goto(step.value);
+                        stepResult = { ...stepResult, url: r.url, title: r.title };
+                    }
+                    break;
+                case 'click':
+                    if (step.selector) {
+                        const r = await driver.click(step.selector);
+                        stepResult = { ...stepResult, url: r.url };
+                    }
+                    break;
+                case 'type':
+                    if (step.selector && step.value) {
+                        await driver.type(step.selector, step.value);
+                        stepResult = { ...stepResult, typed: step.value };
+                    }
+                    break;
+                case 'select':
+                    if (step.selector && step.value) {
+                        await driver.select(step.selector, step.value);
+                        stepResult = { ...stepResult, selected: step.value };
+                    }
+                    break;
+                case 'wait':
+                    await driver.wait(step.waitMs ?? 1000);
+                    stepResult = { ...stepResult, waited: step.waitMs ?? 1000 };
+                    break;
+                case 'screenshot': {
+                    const ss = await driver.screenshot();
+                    stepResult = { ...stepResult, screenshot: ss };
+                    break;
+                }
+                case 'evaluate':
+                    if (step.script) {
+                        const evalResult = await driver.evaluate(step.script);
+                        stepResult = { ...stepResult, evalResult };
+                    }
+                    break;
+                case 'scroll':
+                    await driver.evaluate(`window.scrollBy(0, ${step.value ? parseInt(step.value, 10) : 500})`);
+                    stepResult = { ...stepResult, scrolled: true };
+                    break;
+            }
+            stepResult['durationMs'] = Date.now() - stepStart;
+            if (screenshotPerStep && step.action !== 'screenshot') {
+                stepResult['screenshot'] = await driver.screenshot();
+            }
+            results.push(stepResult);
+        }
+        const finalUrl = await driver.getCurrentUrl();
+        const finalTitle = await driver.getTitle();
+        return { steps: results, finalUrl, finalTitle, stepCount: results.length };
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    async shutdown() {
+        // Close all browser drivers
+        for (const [, config] of this.browsers) {
+            try {
+                await config.driver.close();
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        }
+        this.browsers.clear();
+        await super.shutdown();
+    }
+}
+exports.BrowserAgentAdapter = BrowserAgentAdapter;
+//# sourceMappingURL=browser-agent-adapter.js.map

package/dist/esm/adapters/browser-agent-adapter.js.map

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