network-ai 3.0.0

package/dist/adapters/custom-adapter.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Custom Agent Adapter -- The simplest way to plug in any agent
+ *
+ * For agent systems that don't have a dedicated adapter, or for
+ * quick prototyping, this adapter lets you register plain async functions
+ * as agents. No framework dependency needed.
+ *
+ * Usage:
+ *   const adapter = new CustomAdapter();
+ *
+ *   // Register any async function as an agent
+ *   adapter.registerHandler("my-agent", async (payload, context) => {
+ *     // Your agent logic here
+ *     return { analysis: "result data" };
+ *   });
+ *
+ *   // Register an HTTP-based agent
+ *   adapter.registerHttpAgent("remote-agent", "https://api.example.com/agent");
+ *
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "custom:my-agent", ... })
+ *
+ * @module CustomAdapter
+ * @version 1.0.0
+ */
+import { BaseAdapter } from './base-adapter';
+import type { AdapterCapabilities, AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+/**
+ * A simple agent handler function.
+ * Takes the task payload and context, returns any result.
+ */
+export type AgentHandler = (payload: AgentPayload, context: AgentContext) => Promise<unknown>;
+/**
+ * HTTP agent configuration
+ */
+export interface HttpAgentConfig {
+    url: string;
+    method?: 'POST' | 'PUT';
+    headers?: Record<string, string>;
+    timeout?: number;
+    /** Transform the payload before sending */
+    transformRequest?: (payload: AgentPayload, context: AgentContext) => unknown;
+    /** Transform the response before returning */
+    transformResponse?: (response: unknown) => unknown;
+}
+export declare class CustomAdapter extends BaseAdapter {
+    readonly name = "custom";
+    readonly version = "1.0.0";
+    private handlers;
+    private httpAgents;
+    get capabilities(): AdapterCapabilities;
+    /**
+     * Register a plain async function as an agent.
+     * This is the simplest way to add custom agent logic.
+     */
+    registerHandler(agentId: string, handler: AgentHandler, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    /**
+     * Register an HTTP endpoint as an agent.
+     * The orchestrator will POST task payloads to the URL.
+     */
+    registerHttpAgent(agentId: string, urlOrConfig: string | HttpAgentConfig, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    executeAgent(agentId: string, payload: AgentPayload, context: AgentContext): Promise<AgentResult>;
+    private executeHandler;
+    private executeHttpAgent;
+}
+//# sourceMappingURL=custom-adapter.d.ts.map

package/dist/adapters/custom-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-adapter.d.ts","sourceRoot":"","sources":["../../adapters/custom-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,KAClB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;IAC7E,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;CACpD;AAED,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,OAAO,WAAW;IAC3B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,UAAU,CAA2C;IAE7D,IAAI,YAAY,IAAI,mBAAmB,CAStC;IAED;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAWP;;;OAGG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,eAAe,EACrC,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAgBD,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC;YAwBT,cAAc;YAmBd,gBAAgB;CAuD/B"}

package/dist/adapters/custom-adapter.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Custom Agent Adapter -- The simplest way to plug in any agent
+ *
+ * For agent systems that don't have a dedicated adapter, or for
+ * quick prototyping, this adapter lets you register plain async functions
+ * as agents. No framework dependency needed.
+ *
+ * Usage:
+ *   const adapter = new CustomAdapter();
+ *
+ *   // Register any async function as an agent
+ *   adapter.registerHandler("my-agent", async (payload, context) => {
+ *     // Your agent logic here
+ *     return { analysis: "result data" };
+ *   });
+ *
+ *   // Register an HTTP-based agent
+ *   adapter.registerHttpAgent("remote-agent", "https://api.example.com/agent");
+ *
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "custom:my-agent", ... })
+ *
+ * @module CustomAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class CustomAdapter extends base_adapter_1.BaseAdapter {
+    name = 'custom';
+    version = '1.0.0';
+    handlers = new Map();
+    httpAgents = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: false,
+        };
+    }
+    /**
+     * Register a plain async function as an agent.
+     * This is the simplest way to add custom agent logic.
+     */
+    registerHandler(agentId, handler, metadata) {
+        this.handlers.set(agentId, handler);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `Custom agent: ${agentId}`,
+            capabilities: metadata?.capabilities,
+            status: 'available',
+        });
+    }
+    /**
+     * Register an HTTP endpoint as an agent.
+     * The orchestrator will POST task payloads to the URL.
+     */
+    registerHttpAgent(agentId, urlOrConfig, metadata) {
+        const config = typeof urlOrConfig === 'string'
+            ? { url: urlOrConfig }
+            : urlOrConfig;
+        this.httpAgents.set(agentId, config);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `HTTP agent at ${config.url}`,
+            capabilities: metadata?.capabilities,
+            status: 'available',
+            metadata: { url: config.url },
+        });
+    }
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const startTime = Date.now();
+        // Check local handlers first
+        const handler = this.handlers.get(agentId);
+        if (handler) {
+            return this.executeHandler(handler, payload, context, startTime);
+        }
+        // Check HTTP agents
+        const httpConfig = this.httpAgents.get(agentId);
+        if (httpConfig) {
+            return this.executeHttpAgent(httpConfig, payload, context, startTime);
+        }
+        return this.errorResult('AGENT_NOT_FOUND', `Custom agent "${agentId}" is not registered. Use registerHandler() or registerHttpAgent().`, false);
+    }
+    async executeHandler(handler, payload, context, startTime) {
+        try {
+            const result = await handler(payload, context);
+            return this.successResult(result, Date.now() - startTime);
+        }
+        catch (error) {
+            return this.errorResult('HANDLER_ERROR', error instanceof Error ? error.message : 'Custom handler failed', true, error);
+        }
+    }
+    async executeHttpAgent(config, payload, context, startTime) {
+        try {
+            const body = config.transformRequest
+                ? config.transformRequest(payload, context)
+                : { payload, context };
+            const controller = new AbortController();
+            const timeoutId = config.timeout
+                ? setTimeout(() => controller.abort(), config.timeout)
+                : null;
+            const response = await fetch(config.url, {
+                method: config.method ?? 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...config.headers,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (!response.ok) {
+                return this.errorResult('HTTP_ERROR', `HTTP ${response.status}: ${response.statusText}`, response.status >= 500 // Server errors are recoverable
+                );
+            }
+            let result = await response.json();
+            if (config.transformResponse) {
+                result = config.transformResponse(result);
+            }
+            return this.successResult(result, Date.now() - startTime);
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                return this.errorResult('TIMEOUT', `HTTP agent timed out after ${config.timeout}ms`, true);
+            }
+            return this.errorResult('HTTP_ERROR', error instanceof Error ? error.message : 'HTTP agent call failed', true, error);
+        }
+    }
+}
+exports.CustomAdapter = CustomAdapter;
+//# sourceMappingURL=custom-adapter.js.map

package/dist/adapters/custom-adapter.js.map

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

package/dist/adapters/dspy-adapter.d.ts

@@ -0,0 +1,70 @@
+/**
+ * DSPy Adapter
+ *
+ * Integrates Stanford DSPy modules and programs with the SwarmOrchestrator.
+ * DSPy is a framework for algorithmically optimising LM prompts and weights,
+ * enabling systematic prompt engineering and agent compilation.
+ *
+ * Usage:
+ *   const adapter = new DSPyAdapter();
+ *   adapter.registerModule("classifier", myDSPyModule);
+ *   adapter.registerProgram("rag-pipeline", myCompiledProgram);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "dspy:classifier", ... })
+ *
+ * @module DSPyAdapter
+ * @version 1.0.0
+ */
+import { BaseAdapter } from './base-adapter';
+import type { AdapterCapabilities, AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+/** Matches DSPy Module (ChainOfThought, Predict, ReAct, etc.) */
+export interface DSPyModule {
+    /** Forward pass / inference */
+    forward(inputs: Record<string, unknown>): Promise<DSPyPrediction>;
+    /** Alternative call interface */
+    __call__?(inputs: Record<string, unknown>): Promise<DSPyPrediction>;
+}
+/** Matches a compiled DSPy program */
+export interface DSPyProgram {
+    /** Run the compiled program */
+    run(inputs: Record<string, unknown>): Promise<DSPyPrediction>;
+    /** Compile / optimise (optional) */
+    compile?(trainset?: unknown[], options?: Record<string, unknown>): Promise<void>;
+}
+/** DSPy prediction result */
+export interface DSPyPrediction {
+    /** Named output fields */
+    [key: string]: unknown;
+    /** Common output: answer, response, output */
+    answer?: string;
+    rationale?: string;
+    response?: string;
+    /** Completion metadata */
+    completions?: Record<string, unknown>;
+}
+/** A simple function-based predictor (for lightweight usage) */
+export type DSPyPredictor = (inputs: Record<string, unknown>) => Promise<DSPyPrediction>;
+export declare class DSPyAdapter extends BaseAdapter {
+    readonly name = "dspy";
+    readonly version = "1.0.0";
+    private entries;
+    get capabilities(): AdapterCapabilities;
+    registerModule(agentId: string, module: DSPyModule, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    registerProgram(agentId: string, program: DSPyProgram, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    registerPredictor(agentId: string, predictor: DSPyPredictor, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    executeAgent(agentId: string, payload: AgentPayload, context: AgentContext): Promise<AgentResult>;
+    private buildInputs;
+    private normalizePrediction;
+}
+//# sourceMappingURL=dspy-adapter.d.ts.map

package/dist/adapters/dspy-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dspy-adapter.d.ts","sourceRoot":"","sources":["../../adapters/dspy-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAMhC,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,iCAAiC;IACjC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrE;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9D,oCAAoC;IACpC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,cAAc,CAAC,CAAC;AAO7B,qBAAa,WAAY,SAAQ,WAAW;IAC1C,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,OAAO,WAAW;IAC3B,OAAO,CAAC,OAAO,CAAqC;IAEpD,IAAI,YAAY,IAAI,mBAAmB,CAStC;IAID,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAWP,eAAe,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAWP,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,EACxB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAaD,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC;IAkDvB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,mBAAmB;CAc5B"}

package/dist/adapters/dspy-adapter.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * DSPy Adapter
+ *
+ * Integrates Stanford DSPy modules and programs with the SwarmOrchestrator.
+ * DSPy is a framework for algorithmically optimising LM prompts and weights,
+ * enabling systematic prompt engineering and agent compilation.
+ *
+ * Usage:
+ *   const adapter = new DSPyAdapter();
+ *   adapter.registerModule("classifier", myDSPyModule);
+ *   adapter.registerProgram("rag-pipeline", myCompiledProgram);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "dspy:classifier", ... })
+ *
+ * @module DSPyAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DSPyAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class DSPyAdapter extends base_adapter_1.BaseAdapter {
+    name = 'dspy';
+    version = '1.0.0';
+    entries = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: false,
+        };
+    }
+    // --- Registration ---
+    registerModule(agentId, module, metadata) {
+        this.entries.set(agentId, { type: 'module', module });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `DSPy Module: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['module', 'prompt-optimization'],
+            status: 'available',
+        });
+    }
+    registerProgram(agentId, program, metadata) {
+        this.entries.set(agentId, { type: 'program', program });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `DSPy Program: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['program', 'compiled', 'optimized'],
+            status: 'available',
+        });
+    }
+    registerPredictor(agentId, predictor, metadata) {
+        this.entries.set(agentId, { type: 'predictor', predictor });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `DSPy Predictor: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['predictor'],
+            status: 'available',
+        });
+    }
+    // --- Execution ---
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const entry = this.entries.get(agentId);
+        if (!entry) {
+            return this.errorResult('AGENT_NOT_FOUND', `DSPy entry "${agentId}" is not registered`, false);
+        }
+        const inputs = this.buildInputs(payload);
+        const startTime = Date.now();
+        try {
+            let prediction;
+            switch (entry.type) {
+                case 'module':
+                    prediction = entry.module.__call__
+                        ? await entry.module.__call__(inputs)
+                        : await entry.module.forward(inputs);
+                    break;
+                case 'program':
+                    prediction = await entry.program.run(inputs);
+                    break;
+                case 'predictor':
+                    prediction = await entry.predictor(inputs);
+                    break;
+                default:
+                    return this.errorResult('UNKNOWN_TYPE', 'Unknown DSPy entry type', false);
+            }
+            return this.successResult(this.normalizePrediction(prediction), Date.now() - startTime);
+        }
+        catch (error) {
+            return this.errorResult('DSPY_ERROR', error instanceof Error ? error.message : 'DSPy execution failed', true, error);
+        }
+    }
+    // --- Private helpers ---
+    buildInputs(payload) {
+        const inputs = { ...payload.params };
+        if (payload.handoff?.instruction) {
+            inputs.question = payload.handoff.instruction;
+            inputs.query = payload.handoff.instruction;
+        }
+        if (payload.blackboardSnapshot) {
+            inputs.context = payload.blackboardSnapshot;
+        }
+        return inputs;
+    }
+    normalizePrediction(prediction) {
+        // DSPy predictions have named output fields
+        const response = prediction.answer ??
+            prediction.response ??
+            prediction.rationale ??
+            '';
+        return {
+            response,
+            prediction: { ...prediction },
+            rationale: prediction.rationale,
+        };
+    }
+}
+exports.DSPyAdapter = DSPyAdapter;
+//# sourceMappingURL=dspy-adapter.js.map

package/dist/adapters/dspy-adapter.js.map

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

package/dist/adapters/haystack-adapter.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Haystack Adapter
+ *
+ * Integrates deepset Haystack pipelines and agents with the SwarmOrchestrator.
+ * Haystack is a production-grade framework for building RAG and search
+ * pipelines with customisable components.
+ *
+ * Usage:
+ *   const adapter = new HaystackAdapter();
+ *   adapter.registerPipeline("search", myPipeline);
+ *   adapter.registerAgent("qa-agent", myHaystackAgent);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "haystack:search", ... })
+ *
+ * @module HaystackAdapter
+ * @version 1.0.0
+ */
+import { BaseAdapter } from './base-adapter';
+import type { AdapterCapabilities, AgentPayload, AgentContext, AgentResult } from '../types/agent-adapter';
+/** Matches Haystack's Pipeline.run() interface */
+export interface HaystackPipeline {
+    /** Run the pipeline with inputs */
+    run(inputs: Record<string, unknown>): Promise<HaystackPipelineResult>;
+    /** Get pipeline metadata */
+    getMetadata?(): {
+        name?: string;
+        components?: string[];
+    };
+}
+/** Pipeline result */
+export interface HaystackPipelineResult {
+    [componentName: string]: Record<string, unknown>;
+}
+/** Matches Haystack Agent interface */
+export interface HaystackAgent {
+    /** Run the agent with a query */
+    run(query: string, params?: Record<string, unknown>): Promise<HaystackAgentResult>;
+}
+/** Agent result */
+export interface HaystackAgentResult {
+    answer?: string;
+    transcript?: Array<{
+        role: string;
+        content: string;
+    }>;
+    documents?: Array<{
+        content?: string;
+        meta?: Record<string, unknown>;
+        score?: number;
+    }>;
+}
+/** Haystack component (individual node in a pipeline) */
+export interface HaystackComponent {
+    /** Run the component */
+    run(inputs: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+export declare class HaystackAdapter extends BaseAdapter {
+    readonly name = "haystack";
+    readonly version = "1.0.0";
+    private entries;
+    get capabilities(): AdapterCapabilities;
+    registerPipeline(agentId: string, pipeline: HaystackPipeline, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    registerAgent(agentId: string, agent: HaystackAgent, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    registerComponent(agentId: string, component: HaystackComponent, metadata?: {
+        description?: string;
+        capabilities?: string[];
+    }): void;
+    executeAgent(agentId: string, payload: AgentPayload, context: AgentContext): Promise<AgentResult>;
+    private executePipeline;
+    private executeHaystackAgent;
+    private executeComponent;
+    private buildPipelineInputs;
+    private normalizePipelineResult;
+}
+//# sourceMappingURL=haystack-adapter.d.ts.map

package/dist/adapters/haystack-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haystack-adapter.d.ts","sourceRoot":"","sources":["../../adapters/haystack-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAMhC,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACtE,4BAA4B;IAC5B,WAAW,CAAC,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1D;AAED,sBAAsB;AACtB,MAAM,WAAW,sBAAsB;IACrC,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACpF;AAED,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxE;AAOD,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,OAAO,WAAW;IAC3B,OAAO,CAAC,OAAO,CAAyC;IAExD,IAAI,YAAY,IAAI,mBAAmB,CAStC;IAID,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAaP,aAAa,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAWP,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3D,IAAI;IAaD,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC;YAqCT,eAAe;YAUf,oBAAoB;YAoBpB,gBAAgB;IAU9B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,uBAAuB;CAgBhC"}