network-ai 5.10.2 → 5.12.0

package/dist/esm/adapters/openai-assistants-adapter.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * OpenAI Assistants Adapter
+ *
+ * Integrates OpenAI's Assistants API (v2) with the SwarmOrchestrator.
+ * Supports function calling, code interpreter, file search, and
+ * custom assistant configurations.
+ *
+ * Usage:
+ *   const adapter = new OpenAIAssistantsAdapter();
+ *   adapter.registerAssistant("analyst", { assistantId: "asst_abc123", apiKey });
+ *   adapter.registerLocalFunction("calculator", async (params) => calculate(params));
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "openai-assistants:analyst", ... })
+ *
+ * @module OpenAIAssistantsAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAssistantsAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class OpenAIAssistantsAdapter extends base_adapter_1.BaseAdapter {
+    name = 'openai-assistants';
+    version = '1.0.0';
+    assistants = new Map();
+    defaultClient;
+    get capabilities() {
+        return {
+            streaming: true,
+            parallel: true,
+            bidirectional: true,
+            discovery: true,
+            authentication: true,
+            statefulSessions: true,
+        };
+    }
+    async initialize(config) {
+        await super.initialize(config);
+        if (config.options?.client) {
+            this.defaultClient = config.options.client;
+        }
+    }
+    // --- Registration ---
+    registerAssistant(agentId, assistantConfig, client, metadata) {
+        this.assistants.set(agentId, {
+            config: assistantConfig,
+            client,
+        });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `OpenAI Assistant: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['chat', 'function-calling', 'code-interpreter'],
+            status: 'available',
+        });
+    }
+    // --- Execution ---
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const entry = this.assistants.get(agentId);
+        if (!entry) {
+            return this.errorResult('AGENT_NOT_FOUND', `OpenAI Assistant "${agentId}" is not registered`, false);
+        }
+        const client = entry.client || this.defaultClient;
+        if (!client) {
+            return this.errorResult('NO_CLIENT', 'No OpenAI client provided. Pass a client via registerAssistant() or initialize({ options: { client } })', false);
+        }
+        const message = this.buildMessage(payload);
+        const startTime = Date.now();
+        try {
+            // Strategy 1: Simple chat helper
+            if (client.chat) {
+                const result = await client.chat(entry.config.assistantId, message, {
+                    model: entry.config.model,
+                    maxTokens: entry.config.maxTokens,
+                });
+                return this.successResult({
+                    response: result.response,
+                    usage: result.usage,
+                }, Date.now() - startTime);
+            }
+            // Strategy 2: Thread-based flow
+            if (client.createThread && client.addMessage && client.createAndPollRun) {
+                // Reuse thread for session statefulness
+                if (!entry.threadId) {
+                    const thread = await client.createThread();
+                    entry.threadId = thread.id;
+                }
+                await client.addMessage(entry.threadId, { role: 'user', content: message });
+                const run = await client.createAndPollRun(entry.threadId, entry.config.assistantId, { model: entry.config.model, maxTokens: entry.config.maxTokens });
+                if (run.status !== 'completed') {
+                    return this.errorResult('RUN_FAILED', `Run finished with status: ${run.status}. ${run.error || ''}`, run.status === 'expired');
+                }
+                const assistantMessages = run.messages.filter((m) => m.role === 'assistant');
+                const lastMessage = assistantMessages[assistantMessages.length - 1];
+                return this.successResult({
+                    response: lastMessage?.content ?? '',
+                    messages: assistantMessages,
+                    usage: run.usage,
+                    threadId: entry.threadId,
+                }, Date.now() - startTime);
+            }
+            return this.errorResult('NO_METHOD', 'Client has no callable method (chat or createThread+addMessage+createAndPollRun)', false);
+        }
+        catch (error) {
+            return this.errorResult('OPENAI_ERROR', error instanceof Error ? error.message : 'OpenAI Assistants execution failed', true, error);
+        }
+    }
+    // --- Helpers ---
+    buildMessage(payload) {
+        if (payload.handoff?.instruction) {
+            let msg = payload.handoff.instruction;
+            if (payload.handoff.constraints?.length) {
+                msg += `\n\nConstraints: ${payload.handoff.constraints.join(', ')}`;
+            }
+            if (payload.handoff.expectedOutput) {
+                msg += `\n\nExpected output format: ${payload.handoff.expectedOutput}`;
+            }
+            if (payload.blackboardSnapshot) {
+                msg += `\n\nContext: ${JSON.stringify(payload.blackboardSnapshot)}`;
+            }
+            return msg;
+        }
+        return JSON.stringify(payload.params);
+    }
+}
+exports.OpenAIAssistantsAdapter = OpenAIAssistantsAdapter;
+//# sourceMappingURL=openai-assistants-adapter.js.map

package/dist/esm/adapters/openai-assistants-adapter.js.map

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

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

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * OpenClaw Adapter — Preserves all existing OpenClaw functionality
+ *
+ * This adapter wraps the original `callSkill()` / `OpenClawSkill` interface
+ * so the SwarmOrchestrator continues to work exactly as before for OpenClaw users.
+ *
+ * @module OpenClawAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenClawAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class OpenClawAdapter extends base_adapter_1.BaseAdapter {
+    name = 'openclaw';
+    version = '1.0.0';
+    callSkill = null;
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: true,
+            discovery: false,
+            authentication: true,
+            statefulSessions: true,
+        };
+    }
+    async initialize(config) {
+        await super.initialize(config);
+        // Try to import callSkill from openclaw-core
+        try {
+            const openclawCore = await import('openclaw-core');
+            this.callSkill = openclawCore.callSkill;
+        }
+        catch {
+            // If openclaw-core is provided via config, use that
+            if (config.options?.callSkill && typeof config.options.callSkill === 'function') {
+                this.callSkill = config.options.callSkill;
+            }
+            else {
+                console.warn('[OpenClawAdapter] openclaw-core not available. Provide callSkill via config.options.callSkill');
+                this.ready = false;
+                return;
+            }
+        }
+        this.ready = true;
+    }
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        if (!this.callSkill) {
+            return this.errorResult('NO_CALLSKILL', 'callSkill function is not available', false);
+        }
+        const startTime = Date.now();
+        try {
+            // Translate universal payload → OpenClaw callSkill format
+            const openclawParams = {
+                action: payload.action,
+                ...payload.params,
+            };
+            // Include handoff context if present (preserves existing handoff protocol)
+            if (payload.handoff) {
+                openclawParams.handoff = {
+                    handoffId: payload.handoff.handoffId,
+                    sourceAgent: payload.handoff.sourceAgent,
+                    targetAgent: payload.handoff.targetAgent,
+                    taskType: payload.handoff.taskType,
+                    payload: {
+                        instruction: payload.handoff.instruction,
+                        context: payload.handoff.context,
+                        constraints: payload.handoff.constraints,
+                        expectedOutput: payload.handoff.expectedOutput,
+                    },
+                    metadata: payload.handoff.metadata,
+                };
+            }
+            // Include blackboard snapshot if present
+            if (payload.blackboardSnapshot) {
+                openclawParams.context = {
+                    ...(openclawParams.context || {}),
+                    blackboardSnapshot: payload.blackboardSnapshot,
+                };
+            }
+            // Call the OpenClaw skill
+            const result = await this.callSkill(agentId, openclawParams);
+            // Translate OpenClaw result → universal AgentResult
+            return {
+                success: result.success,
+                data: result.data,
+                error: result.error ? {
+                    code: result.error.code,
+                    message: result.error.message,
+                    recoverable: result.error.recoverable,
+                    suggestedAction: result.error.suggestedAction,
+                } : undefined,
+                metadata: {
+                    adapter: this.name,
+                    executionTimeMs: Date.now() - startTime,
+                },
+            };
+        }
+        catch (error) {
+            return this.errorResult('OPENCLAW_ERROR', error instanceof Error ? error.message : 'OpenClaw skill execution failed', true, error);
+        }
+    }
+}
+exports.OpenClawAdapter = OpenClawAdapter;
+//# sourceMappingURL=openclaw-adapter.js.map

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

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

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

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * Orchestrator Adapter — Wrap a child SwarmOrchestrator as an agent
+ *
+ * This adapter enables hierarchical multi-orchestrator coordination.
+ * A parent SwarmOrchestrator treats a child SwarmOrchestrator as just
+ * another agent via the adapter system. Each child has its own
+ * LockedBlackboard with its own filesystem mutex, so the propose →
+ * validate → commit pattern prevents overwrites at every level.
+ *
+ * Usage:
+ *   const child = new SwarmOrchestrator('./boards/child-project', childRegistry);
+ *   const adapter = new OrchestratorAdapter();
+ *   adapter.registerOrchestrator('child-team', child, {
+ *     description: 'Backend team orchestrator',
+ *   });
+ *
+ *   // Parent orchestrator delegates to the child as a normal agent
+ *   await parentOrchestrator.addAdapter(adapter);
+ *   await parentOrchestrator.execute('delegate_task', {
+ *     targetAgent: 'orchestrator:child-team',
+ *     taskPayload: { instruction: 'Refactor the auth module' },
+ *   }, { agentId: 'root' });
+ *
+ * The child orchestrator receives the task, decomposes it across its own
+ * agents, and returns the aggregated result. The parent sees it as one
+ * atomic response — the hierarchy is transparent.
+ *
+ * @module OrchestratorAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestratorAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class OrchestratorAdapter extends base_adapter_1.BaseAdapter {
+    name = 'orchestrator';
+    version = '1.0.0';
+    children = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    /**
+     * Register a child SwarmOrchestrator as an agent.
+     * The child keeps its own blackboard, adapters, and lock — full isolation.
+     */
+    registerOrchestrator(orchestratorId, orchestrator, config) {
+        if (!orchestratorId || typeof orchestratorId !== 'string') {
+            throw new Error('orchestratorId must be a non-empty string');
+        }
+        if (!orchestrator || typeof orchestrator.execute !== 'function') {
+            throw new Error('orchestrator must implement execute()');
+        }
+        const childConfig = {
+            description: config?.description ?? `Child orchestrator: ${orchestratorId}`,
+            capabilities: config?.capabilities ?? ['orchestration', 'delegation', 'parallel'],
+            defaultTargetAgent: config?.defaultTargetAgent,
+            timeout: config?.timeout ?? 120_000,
+        };
+        this.children.set(orchestratorId, {
+            orchestrator,
+            config: childConfig,
+            busy: false,
+        });
+        this.registerLocalAgent({
+            id: orchestratorId,
+            name: orchestrator.name ?? orchestratorId,
+            description: childConfig.description,
+            capabilities: childConfig.capabilities,
+            status: 'available',
+            metadata: {
+                type: 'orchestrator',
+                timeout: childConfig.timeout,
+                defaultTargetAgent: childConfig.defaultTargetAgent,
+            },
+        });
+    }
+    /**
+     * Remove a child orchestrator from this adapter.
+     */
+    removeOrchestrator(orchestratorId) {
+        const removed = this.children.delete(orchestratorId);
+        if (removed) {
+            this.unregisterAgent(orchestratorId);
+        }
+        return removed;
+    }
+    /**
+     * Execute a task on a child orchestrator.
+     *
+     * The payload is translated into a `delegate_task` call on the child.
+     * If `handoff.targetAgent` is set, it becomes the target within the child
+     * swarm. Otherwise, the child's `defaultTargetAgent` is used, or the
+     * child decides its own routing.
+     */
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const child = this.children.get(agentId);
+        if (!child) {
+            return this.errorResult('ORCHESTRATOR_NOT_FOUND', `Child orchestrator "${agentId}" is not registered. Use registerOrchestrator().`, false);
+        }
+        const startTime = Date.now();
+        child.busy = true;
+        // Update agent status
+        const agentInfo = this.registeredAgents.get(agentId);
+        if (agentInfo)
+            agentInfo.status = 'busy';
+        try {
+            const instruction = payload.handoff?.instruction
+                ?? payload.params?.instruction
+                ?? JSON.stringify(payload.params);
+            // Determine the target agent within the child swarm
+            const innerTarget = payload.handoff?.targetAgent
+                ?? child.config.defaultTargetAgent
+                ?? 'orchestrator';
+            const childParams = {
+                targetAgent: innerTarget,
+                taskPayload: {
+                    instruction,
+                    context: payload.handoff?.context ?? payload.params?.context,
+                    constraints: payload.handoff?.constraints ?? payload.params?.constraints,
+                    expectedOutput: payload.handoff?.expectedOutput ?? payload.params?.expectedOutput,
+                },
+                timeout: child.config.timeout,
+            };
+            // Forward blackboard snapshot if provided (cross-level context sharing)
+            if (payload.blackboardSnapshot) {
+                childParams.parentBlackboardSnapshot = payload.blackboardSnapshot;
+            }
+            const childContext = {
+                agentId: context.agentId,
+                taskId: context.taskId,
+                sessionId: context.sessionId,
+            };
+            // Execute on the child orchestrator with timeout
+            const result = await Promise.race([
+                child.orchestrator.execute('delegate_task', childParams, childContext),
+                this.timeoutAfter(child.config.timeout ?? 120_000),
+            ]);
+            const elapsed = Date.now() - startTime;
+            if (!result.success) {
+                return this.errorResult(result.error?.code ?? 'CHILD_EXECUTION_FAILED', result.error?.message ?? 'Child orchestrator returned failure', result.error?.recoverable ?? true, result.error);
+            }
+            return this.successResult({
+                orchestratorId: agentId,
+                childResult: result.data,
+                hierarchy: true,
+            }, elapsed);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === 'ORCHESTRATOR_TIMEOUT') {
+                return this.errorResult('CHILD_TIMEOUT', `Child orchestrator "${agentId}" timed out after ${child.config.timeout}ms`, true);
+            }
+            return this.errorResult('CHILD_EXECUTION_ERROR', error instanceof Error ? error.message : 'Child orchestrator execution failed', true, error);
+        }
+        finally {
+            child.busy = false;
+            const agentInfo2 = this.registeredAgents.get(agentId);
+            if (agentInfo2)
+                agentInfo2.status = 'available';
+        }
+    }
+    /**
+     * Query the internal state of a child orchestrator.
+     * Returns agents, blackboard snapshot, and tasks from the child swarm.
+     * The parent can use this for unified visibility across the hierarchy.
+     */
+    async queryChildState(orchestratorId, scope = 'all') {
+        const child = this.children.get(orchestratorId);
+        if (!child)
+            return null;
+        const result = await child.orchestrator.execute('query_swarm_state', { scope }, { agentId: 'parent-orchestrator' });
+        return {
+            orchestratorId,
+            busy: child.busy,
+            swarmState: result.success ? result.data : null,
+            queriedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Query state of all registered child orchestrators.
+     * This is the foundation for the unified ControlPlane view.
+     */
+    async queryAllChildStates(scope = 'all') {
+        const entries = Array.from(this.children.keys());
+        const results = await Promise.all(entries.map(id => this.queryChildState(id, scope)));
+        return results.filter((s) => s !== null);
+    }
+    /**
+     * Get the list of registered child orchestrator IDs.
+     */
+    listOrchestrators() {
+        return Array.from(this.children.keys());
+    }
+    /**
+     * Check if a specific child orchestrator is currently busy.
+     */
+    isChildBusy(orchestratorId) {
+        return this.children.get(orchestratorId)?.busy ?? false;
+    }
+    async shutdown() {
+        this.children.clear();
+        await super.shutdown();
+    }
+    timeoutAfter(ms) {
+        return new Promise((_, reject) => {
+            setTimeout(() => reject(new Error('ORCHESTRATOR_TIMEOUT')), ms);
+        });
+    }
+}
+exports.OrchestratorAdapter = OrchestratorAdapter;
+//# sourceMappingURL=orchestrator-adapter.js.map

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

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

package/dist/esm/adapters/pydantic-ai-adapter.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Pydantic AI Adapter
+ *
+ * Integrates Pydantic AI (type-safe Python agent framework) with the
+ * SwarmOrchestrator via user-supplied runner functions.
+ *
+ * Pydantic AI provides structured, validated agent responses with
+ * dependency injection, streaming, and multi-step tool use. Since
+ * it's Python-native, this adapter wraps either:
+ *   - A JS-compatible runner interface (for interop bridges)
+ *   - An HTTP endpoint that fronts a Pydantic AI agent
+ *
+ * Usage:
+ *   const adapter = new PydanticAIAdapter();
+ *   adapter.registerAgent('data-analyst', {
+ *     runner: myPydanticRunner,
+ *     resultSchema: { type: 'object', properties: { answer: { type: 'string' } } },
+ *   });
+ *
+ * @module PydanticAIAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PydanticAIAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+/**
+ * Adapter for Pydantic AI structured agent framework.
+ *
+ * Supports both direct runners (for JS/Python bridges) and
+ * HTTP endpoints (for remote Pydantic AI servers).
+ */
+class PydanticAIAdapter extends base_adapter_1.BaseAdapter {
+    name = 'pydantic-ai';
+    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 Pydantic AI agent (runner or HTTP-backed).
+     */
+    registerPydanticAgent(agentId, config) {
+        if (!config.runner && !config.http) {
+            throw new Error('PydanticAIAgentConfig requires either runner or http');
+        }
+        this.agents.set(agentId, config);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            status: 'available',
+            capabilities: ['structured-output', 'validation', 'tool-use'],
+            metadata: {
+                adapter: 'pydantic-ai',
+                model: config.model,
+                mode: config.runner ? 'direct' : 'http',
+            },
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Execution
+    // -----------------------------------------------------------------------
+    async executeAgent(agentId, payload, _context) {
+        this.ensureReady();
+        const config = this.agents.get(agentId);
+        if (!config) {
+            return this.errorResult('PYDANTIC_AGENT_NOT_FOUND', `No agent registered as '${agentId}'`);
+        }
+        const prompt = payload.handoff?.instruction
+            ?? payload.params?.instruction
+            ?? payload.params?.prompt
+            ?? payload.action;
+        const deps = {
+            ...config.defaultDeps,
+            ...payload.params,
+            ...payload.handoff?.context,
+        };
+        const timeoutMs = config.timeoutMs ?? 60_000;
+        const start = Date.now();
+        try {
+            let result;
+            if (config.runner) {
+                result = await Promise.race([
+                    config.runner.run(prompt, deps),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Pydantic AI execution timed out')), timeoutMs)),
+                ]);
+            }
+            else if (config.http) {
+                result = await this.executeHttp(config.http, prompt, deps, timeoutMs);
+            }
+            else {
+                return this.errorResult('PYDANTIC_NO_RUNNER', 'No runner or HTTP config available');
+            }
+            const durationMs = Date.now() - start;
+            return this.successResult({
+                data: result.data,
+                text: result.text,
+                validated: result.validated,
+                toolCalls: result.toolCalls,
+                usage: result.usage,
+            }, durationMs);
+        }
+        catch (err) {
+            return this.errorResult('PYDANTIC_EXECUTION_FAILED', err instanceof Error ? err.message : String(err));
+        }
+    }
+    // -----------------------------------------------------------------------
+    // HTTP runner
+    // -----------------------------------------------------------------------
+    async executeHttp(httpConfig, prompt, deps, timeoutMs) {
+        const url = `${httpConfig.baseUrl.replace(/\/$/, '')}/run`;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...httpConfig.headers,
+        };
+        if (httpConfig.authorization) {
+            headers['Authorization'] = httpConfig.authorization;
+        }
+        const body = JSON.stringify({ prompt, deps });
+        // Use dynamic import for fetch (Node 18+) or global
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`HTTP ${response.status}: ${text}`);
+            }
+            const data = await response.json();
+            return data;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    async shutdown() {
+        this.agents.clear();
+        await super.shutdown();
+    }
+}
+exports.PydanticAIAdapter = PydanticAIAdapter;
+//# sourceMappingURL=pydantic-ai-adapter.js.map

package/dist/esm/adapters/pydantic-ai-adapter.js.map

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