network-ai 4.15.2 → 5.0.0

package/dist/adapters/openai-agents-adapter.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * OpenAI Agents SDK Adapter
+ *
+ * Integrates the OpenAI Agents SDK (Python-first, but JS-compatible API)
+ * with the SwarmOrchestrator.
+ *
+ * The OpenAI Agents SDK provides:
+ *   - Agent definition with instructions + tools
+ *   - Handoff between agents
+ *   - Guardrails (input/output validation)
+ *   - Tracing
+ *
+ * This adapter wraps user-supplied agent runners or HTTP endpoints
+ * that expose the Agents SDK interface. No hard dependency on the SDK.
+ *
+ * Usage:
+ *   const adapter = new OpenAIAgentsAdapter();
+ *   adapter.registerAgentRunner('researcher', {
+ *     runner: myAgentRunner,
+ *   });
+ *
+ * @module OpenAIAgentsAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAgentsAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+/**
+ * Adapter for the OpenAI Agents SDK.
+ *
+ * Wraps agent runners that implement the OAIAgentRunner interface.
+ * Supports tool use, handoffs, and guardrails via the SDK's execution model.
+ */
+class OpenAIAgentsAdapter extends base_adapter_1.BaseAdapter {
+    name = 'openai-agents';
+    version = '1.0.0';
+    runners = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: true,
+            statefulSessions: false,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Registration
+    // -----------------------------------------------------------------------
+    /**
+     * Register an OpenAI Agent runner as a named agent.
+     */
+    registerAgentRunner(agentId, config) {
+        this.runners.set(agentId, config);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            status: 'available',
+            capabilities: ['tool-use', 'handoff', ...(config.tools?.map((t) => t.name) ?? [])],
+            metadata: {
+                adapter: 'openai-agents',
+                model: config.model ?? 'gpt-4o',
+                handoffsEnabled: config.handoffsEnabled ?? false,
+            },
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Execution
+    // -----------------------------------------------------------------------
+    async executeAgent(agentId, payload, _context) {
+        this.ensureReady();
+        const config = this.runners.get(agentId);
+        if (!config) {
+            return this.errorResult('OAI_AGENTS_NOT_FOUND', `No agent runner registered as '${agentId}'`);
+        }
+        const input = payload.handoff?.instruction
+            ?? payload.params?.instruction
+            ?? payload.params?.input
+            ?? payload.action;
+        const runContext = {
+            ...payload.params,
+            ...payload.handoff?.context,
+        };
+        const timeoutMs = config.timeoutMs ?? 120_000;
+        const start = Date.now();
+        try {
+            const result = await Promise.race([
+                config.runner.run(input, runContext),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('OpenAI Agent execution timed out')), timeoutMs)),
+            ]);
+            const durationMs = Date.now() - start;
+            return this.successResult({
+                output: result.output,
+                toolCalls: result.toolCalls,
+                handoffs: result.handoffs,
+                guardrailTriggered: result.guardrailTriggered,
+                usage: result.usage,
+            }, durationMs);
+        }
+        catch (err) {
+            return this.errorResult('OAI_AGENTS_EXECUTION_FAILED', err instanceof Error ? err.message : String(err));
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    async shutdown() {
+        this.runners.clear();
+        await super.shutdown();
+    }
+}
+exports.OpenAIAgentsAdapter = OpenAIAgentsAdapter;
+//# sourceMappingURL=openai-agents-adapter.js.map

package/dist/adapters/openai-agents-adapter.js.map

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

package/dist/adapters/pydantic-ai-adapter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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
+ */
+import { BaseAdapter } from './base-adapter';
+import type { AdapterCapabilities, AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+/** Pydantic AI run result */
+export interface PydanticAIRunResult {
+    /** Structured data output (validated against resultSchema) */
+    data: unknown;
+    /** Raw text output if available */
+    text?: string;
+    /** Tool calls made during execution */
+    toolCalls?: Array<{
+        tool: string;
+        args: Record<string, unknown>;
+        result: unknown;
+    }>;
+    /** Message history */
+    messages?: Array<{
+        role: string;
+        content: string;
+    }>;
+    /** Token usage */
+    usage?: {
+        requestTokens: number;
+        responseTokens: number;
+        totalTokens: number;
+    };
+    /** Whether validation succeeded */
+    validated: boolean;
+}
+/**
+ * Runner interface for a Pydantic AI agent.
+ * Wraps `agent.run()` or an HTTP call to a Pydantic AI server.
+ */
+export interface PydanticAIRunner {
+    run(prompt: string, deps?: Record<string, unknown>): Promise<PydanticAIRunResult>;
+}
+/**
+ * HTTP-based runner configuration.
+ * Sends POST requests to a Pydantic AI HTTP endpoint.
+ */
+export interface PydanticAIHttpConfig {
+    /** Base URL of the Pydantic AI server */
+    baseUrl: string;
+    /** Auth header value (e.g. 'Bearer xxx') */
+    authorization?: string;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+/** Configuration for a registered Pydantic AI agent */
+export interface PydanticAIAgentConfig {
+    /** Direct runner instance */
+    runner?: PydanticAIRunner;
+    /** HTTP configuration (alternative to runner) */
+    http?: PydanticAIHttpConfig;
+    /** JSON schema for expected result structure */
+    resultSchema?: Record<string, unknown>;
+    /** Model name (for metadata) */
+    model?: string;
+    /** Dependencies to inject into each run */
+    defaultDeps?: Record<string, unknown>;
+    /** Per-invocation timeout in ms (default: 60000) */
+    timeoutMs?: number;
+}
+/**
+ * Adapter for Pydantic AI structured agent framework.
+ *
+ * Supports both direct runners (for JS/Python bridges) and
+ * HTTP endpoints (for remote Pydantic AI servers).
+ */
+export declare class PydanticAIAdapter extends BaseAdapter {
+    readonly name = "pydantic-ai";
+    readonly version = "1.0.0";
+    private agents;
+    get capabilities(): AdapterCapabilities;
+    /**
+     * Register a Pydantic AI agent (runner or HTTP-backed).
+     */
+    registerPydanticAgent(agentId: string, config: PydanticAIAgentConfig): void;
+    executeAgent(agentId: string, payload: AgentPayload, _context: AgentContext): Promise<AgentResult>;
+    private executeHttp;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=pydantic-ai-adapter.d.ts.map

package/dist/adapters/pydantic-ai-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pydantic-ai-adapter.d.ts","sourceRoot":"","sources":["../../adapters/pydantic-ai-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAMhC,6BAA6B;AAC7B,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpF,sBAAsB;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,kBAAkB;IAClB,KAAK,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CACD,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,MAAM,CAA4C;IAE1D,IAAI,YAAY,IAAI,mBAAmB,CAStC;IAMD;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAsBrE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;YA2D1F,WAAW;IA6CnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/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/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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"}

package/dist/adapters/vertex-ai-adapter.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Vertex AI Adapter
+ *
+ * Integrates Google Vertex AI (Gemini models, PaLM, custom endpoints)
+ * with the SwarmOrchestrator.
+ *
+ * Supports:
+ *   - Gemini chat/generation (via user-supplied client)
+ *   - Function calling / tool use
+ *   - Multi-modal inputs (text + images)
+ *   - Custom Vertex AI endpoints
+ *
+ * Usage:
+ *   const adapter = new VertexAIAdapter();
+ *   adapter.registerModel('analyst', {
+ *     client: myVertexClient,
+ *     model: 'gemini-2.0-flash',
+ *   });
+ *
+ * @module VertexAIAdapter
+ * @version 1.0.0
+ */
+import { BaseAdapter } from './base-adapter';
+import type { AdapterCapabilities, AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+/** Vertex AI function declaration for tool use */
+export interface VertexFunctionDeclaration {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** A content part (text or inline data) */
+export interface VertexContentPart {
+    text?: string;
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+}
+/** Response from Vertex AI */
+export interface VertexGenerateResponse {
+    /** Generated text content */
+    text: string;
+    /** Function calls requested by the model */
+    functionCalls?: Array<{
+        name: string;
+        args: Record<string, unknown>;
+    }>;
+    /** Safety ratings */
+    safetyRatings?: Array<{
+        category: string;
+        probability: string;
+    }>;
+    /** Token usage */
+    usageMetadata?: {
+        promptTokenCount: number;
+        candidatesTokenCount: number;
+        totalTokenCount: number;
+    };
+    /** Finish reason */
+    finishReason?: string;
+}
+/**
+ * Minimal interface for a Vertex AI generative model client.
+ * Compatible with `@google-cloud/vertexai` GenerativeModel.
+ */
+export interface VertexGenerativeClient {
+    generateContent(request: {
+        contents: Array<{
+            role: string;
+            parts: VertexContentPart[];
+        }>;
+        systemInstruction?: {
+            parts: VertexContentPart[];
+        };
+        tools?: Array<{
+            functionDeclarations: VertexFunctionDeclaration[];
+        }>;
+    }): Promise<{
+        response: VertexGenerateResponse;
+    }>;
+}
+/**
+ * Function executor for tool use.
+ * Called when Gemini requests a function call.
+ */
+export type VertexFunctionExecutor = (name: string, args: Record<string, unknown>) => Promise<unknown>;
+/** Configuration for a registered Vertex AI agent */
+export interface VertexAIAgentConfig {
+    /** The Vertex AI client instance */
+    client: VertexGenerativeClient;
+    /** Model name (default: 'gemini-2.0-flash') */
+    model?: string;
+    /** System instruction */
+    systemInstruction?: string;
+    /** Function declarations for tool use */
+    functions?: VertexFunctionDeclaration[];
+    /** Function executor for tool calls */
+    functionExecutor?: VertexFunctionExecutor;
+    /** Maximum tool-use loop iterations (default: 10) */
+    maxIterations?: number;
+    /** Per-invocation timeout in ms (default: 60000) */
+    timeoutMs?: number;
+}
+/**
+ * Adapter for Google Vertex AI (Gemini, PaLM, custom endpoints).
+ *
+ * Each registered model is exposed as a named agent. Supports
+ * multi-turn tool use loops when functions are configured.
+ */
+export declare class VertexAIAdapter extends BaseAdapter {
+    readonly name = "vertex-ai";
+    readonly version = "1.0.0";
+    private models;
+    get capabilities(): AdapterCapabilities;
+    /**
+     * Register a Vertex AI model as a named agent.
+     */
+    registerModel(agentId: string, config: VertexAIAgentConfig): void;
+    executeAgent(agentId: string, payload: AgentPayload, _context: AgentContext): Promise<AgentResult>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=vertex-ai-adapter.d.ts.map

package/dist/adapters/vertex-ai-adapter.d.ts.map

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