network-ai 4.15.2 → 5.0.0

package/dist/lib/shared-blackboard.js

@@ -0,0 +1,249 @@
+"use strict";
+/**
+ * Namespace-scoped, identity-verified shared state for multi-agent coordination.
+ *
+ * Every write is identity-verified (agent token), namespace-checked,
+ * size-validated, input-sanitized, and atomically persisted through
+ * the pluggable {@link BlackboardBackend}.
+ *
+ * @module SharedBlackboard
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedBlackboard = void 0;
+const blackboard_backend_1 = require("./blackboard-backend");
+const security_1 = require("../security");
+const errors_1 = require("./errors");
+const orchestrator_types_1 = require("./orchestrator-types");
+/**
+ * Namespace-scoped, identity-verified shared state for multi-agent coordination.
+ *
+ * Every write is identity-verified (agent token), namespace-checked,
+ * size-validated, input-sanitized, and atomically persisted through
+ * {@link LockedBlackboard}.
+ *
+ * @example
+ * ```typescript
+ * const bb = new SharedBlackboard('./workspace');
+ * bb.registerAgent('analyst', 'secret-token', ['task:', 'analytics:']);
+ * bb.write('task:revenue', { q4: 42_000 }, 'analyst', 3600, 'secret-token');
+ * const entry = bb.read('task:revenue');
+ * ```
+ */
+class SharedBlackboard {
+    backend;
+    agentTokens = new Map(); // agentId -> verified token
+    agentNamespaces = new Map(); // agentId -> allowed prefixes
+    piiRedactor = null;
+    constructor(backendOrPath, options) {
+        if (typeof backendOrPath === 'string') {
+            if (!backendOrPath || backendOrPath.trim() === '') {
+                throw new errors_1.ValidationError('basePath must be a non-empty string');
+            }
+            this.backend = new blackboard_backend_1.FileBackend(backendOrPath);
+        }
+        else {
+            if (!backendOrPath || typeof backendOrPath !== 'object') {
+                throw new errors_1.ValidationError('backend must be a BlackboardBackend instance');
+            }
+            this.backend = backendOrPath;
+        }
+        if (options?.enablePIIRedaction) {
+            this.piiRedactor = new security_1.PIIRedactor();
+        }
+    }
+    /**
+     * Enable or disable PII redaction on writes.
+     */
+    setPIIRedaction(enabled) {
+        this.piiRedactor = enabled ? new security_1.PIIRedactor() : null;
+    }
+    /**
+     * Register a verified agent identity. Only agents with registered tokens
+     * can write to the blackboard. The orchestrator registers agents after
+     * verifying their identity through the AuthGuardian.
+     */
+    registerAgent(agentId, verificationToken, allowedNamespaces = ['*']) {
+        if (!agentId || typeof agentId !== 'string' || agentId.trim() === '') {
+            throw new errors_1.ValidationError('agentId must be a non-empty string');
+        }
+        if (!verificationToken || typeof verificationToken !== 'string') {
+            throw new errors_1.ValidationError('verificationToken must be a non-empty string');
+        }
+        if (!Array.isArray(allowedNamespaces)) {
+            throw new errors_1.ValidationError('allowedNamespaces must be an array of strings');
+        }
+        this.agentTokens.set(agentId, verificationToken);
+        this.agentNamespaces.set(agentId, allowedNamespaces);
+    }
+    /**
+     * Check if an agent is allowed to access a key based on namespace rules.
+     */
+    canAccessKey(agentId, key) {
+        const namespaces = this.agentNamespaces.get(agentId);
+        if (!namespaces)
+            return false;
+        if (namespaces.includes('*'))
+            return true;
+        return namespaces.some(ns => key.startsWith(ns));
+    }
+    /**
+     * Verify that the calling agent is who they claim to be.
+     */
+    verifyAgent(agentId, token) {
+        const registeredToken = this.agentTokens.get(agentId);
+        // If no token system is configured for this agent, allow (backward compat)
+        if (!registeredToken)
+            return true;
+        return token === registeredToken;
+    }
+    /**
+     * Validate value size and structure before writing.
+     * Prevents DoS via oversized writes and circular data.
+     */
+    validateValue(value) {
+        try {
+            const serialized = JSON.stringify(value);
+            if (serialized.length > orchestrator_types_1.CONFIG.maxBlackboardValueSize) {
+                return { valid: false, reason: `Value exceeds max size (${serialized.length} > ${orchestrator_types_1.CONFIG.maxBlackboardValueSize} bytes)` };
+            }
+            return { valid: true };
+        }
+        catch {
+            return { valid: false, reason: 'Value cannot be serialized (circular reference or invalid structure)' };
+        }
+    }
+    /**
+     * Sanitize a key to prevent markdown injection.
+     */
+    sanitizeKey(key) {
+        // Keys must be safe for markdown headings -- no #, newlines, or markdown syntax
+        return key.replace(/[#\n\r|`]/g, '_').slice(0, 256);
+    }
+    /**
+     * Read an entry from the blackboard by key.
+     *
+     * @param key - The entry key to look up
+     * @returns The entry, or `null` if not found or expired
+     * @throws {@link ValidationError} if `key` is not a non-empty string
+     */
+    read(key) {
+        if (!key || typeof key !== 'string') {
+            throw new errors_1.ValidationError('key must be a non-empty string');
+        }
+        const entry = this.backend.read(key);
+        if (!entry)
+            return null;
+        // Normalize field name for backward compatibility
+        return {
+            key: entry.key,
+            value: entry.value,
+            sourceAgent: entry.source_agent ?? entry.sourceAgent ?? 'unknown',
+            timestamp: entry.timestamp,
+            ttl: entry.ttl,
+        };
+    }
+    /**
+     * Write to the blackboard with identity verification, namespace checks,
+     * value validation, and input sanitization. Uses LockedBlackboard for
+     * atomic file-system writes.
+     *
+     * @param key - The key to write
+     * @param value - The value (will be sanitized and size-checked)
+     * @param sourceAgent - Agent claiming to write (verified against registered token)
+     * @param ttl - Optional TTL in seconds
+     * @param agentToken - Optional verification token for identity check
+     */
+    write(key, value, sourceAgent, ttl, agentToken) {
+        // 1. Verify agent identity
+        if (!this.verifyAgent(sourceAgent, agentToken)) {
+            throw new errors_1.IdentityVerificationError(sourceAgent);
+        }
+        // 2. Namespace check
+        if (!this.canAccessKey(sourceAgent, key)) {
+            throw new errors_1.NamespaceViolationError(sourceAgent, key);
+        }
+        // 3. Sanitize key
+        const safeKey = this.sanitizeKey(key);
+        // 4. Validate value size/structure
+        const validation = this.validateValue(value);
+        if (!validation.valid) {
+            throw new errors_1.ValidationError(validation.reason);
+        }
+        // 5. Sanitize value -- strip injection payloads from string content
+        let sanitizedValue;
+        try {
+            sanitizedValue = security_1.InputSanitizer.sanitizeObject(value);
+        }
+        catch {
+            sanitizedValue = value; // Fall back to raw if sanitization can't handle it
+        }
+        // 5b. PII redaction -- strip emails, SSNs, credit cards, phones, IPs
+        if (this.piiRedactor) {
+            const { redacted } = this.piiRedactor.redactObject(sanitizedValue);
+            sanitizedValue = redacted;
+        }
+        // 6. Write through backend (atomic when using FileBackend; in-memory for MemoryBackend)
+        const entry = this.backend.write(safeKey, sanitizedValue, sourceAgent, ttl);
+        // Normalize for backward compat
+        return {
+            key: entry.key,
+            value: entry.value,
+            sourceAgent: entry.source_agent ?? sourceAgent,
+            timestamp: entry.timestamp,
+            ttl: entry.ttl,
+        };
+    }
+    /**
+     * Check whether a key exists on the blackboard (not expired).
+     * @param key - The entry key to check
+     */
+    exists(key) {
+        return this.read(key) !== null;
+    }
+    /**
+     * Get a full snapshot of all blackboard entries.
+     */
+    getSnapshot() {
+        const raw = this.backend.getSnapshot();
+        const normalized = {};
+        for (const [key, entry] of Object.entries(raw)) {
+            normalized[key] = {
+                key: entry.key,
+                value: entry.value,
+                sourceAgent: entry.source_agent ?? entry.sourceAgent ?? 'unknown',
+                timestamp: entry.timestamp,
+                ttl: entry.ttl,
+            };
+        }
+        return normalized;
+    }
+    /**
+     * Get a namespace-scoped snapshot -- only returns keys an agent is allowed to see.
+     * Prevents data leakage between agents.
+     */
+    getScopedSnapshot(agentId) {
+        if (!agentId || typeof agentId !== 'string') {
+            throw new errors_1.ValidationError('agentId must be a non-empty string');
+        }
+        const full = this.getSnapshot();
+        const scoped = {};
+        for (const [key, entry] of Object.entries(full)) {
+            if (this.canAccessKey(agentId, key)) {
+                scoped[key] = entry;
+            }
+        }
+        return scoped;
+    }
+    /**
+     * Clear all entries (for testing).
+     */
+    clear() {
+        // Write an empty state through locked backend
+        const keys = this.backend.listKeys();
+        for (const key of keys) {
+            this.backend.delete(key);
+        }
+    }
+}
+exports.SharedBlackboard = SharedBlackboard;
+//# sourceMappingURL=shared-blackboard.js.map

package/dist/lib/shared-blackboard.js.map

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

package/dist/lib/speculative-executor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * SpeculativeExecutor — Dispatch the same task to multiple agents in parallel,
+ * then pick the best result via confidence scoring.
+ *
+ * Uses FanOutFanIn for parallel dispatch and ConfidenceFilter for quality-based
+ * winner selection. Optimistic concurrency: spend the extra budget up-front
+ * and discard inferior results.
+ *
+ * @module SpeculativeExecutor
+ */
+/** A candidate agent for speculative execution */
+export interface SpeculativeCandidate {
+    agentId: string;
+    /** Optional label for logging/tracing */
+    label?: string;
+    /** Per-candidate timeout override (ms) */
+    timeoutMs?: number;
+}
+/** Scored result from a speculative candidate */
+export interface SpeculativeResult {
+    agentId: string;
+    label?: string;
+    success: boolean;
+    data: unknown;
+    confidence: number;
+    durationMs: number;
+}
+/** Final outcome of speculative execution */
+export interface SpeculativeOutcome {
+    /** The winning result (highest confidence above threshold) */
+    winner: SpeculativeResult | null;
+    /** All candidate results, sorted by confidence descending */
+    candidates: SpeculativeResult[];
+    /** Whether a winner was selected */
+    hasWinner: boolean;
+    /** Total wall-clock time for the speculative run */
+    totalMs: number;
+    /** How many candidates succeeded */
+    successCount: number;
+}
+/** Configuration for speculative execution */
+export interface SpeculativeOptions {
+    /** Minimum confidence to be considered a valid winner (0-100, default 50) */
+    minConfidence?: number;
+    /** Global timeout for all candidates (ms, default 30000) */
+    timeoutMs?: number;
+    /** Maximum concurrent candidates (default: all) */
+    concurrency?: number;
+}
+/** Executor function: (agentId, payload) → { success, data, confidence } */
+export type SpeculativeExecutorFn = (agentId: string, payload: Record<string, unknown>) => Promise<{
+    success: boolean;
+    data: unknown;
+    confidence: number;
+}>;
+/**
+ * Dispatch one task to multiple agents, pick the best result.
+ *
+ * @example
+ * ```ts
+ * const executor = new SpeculativeExecutor(async (agentId, payload) => {
+ *   const result = await adapters.executeAgent(agentId, payload, ctx);
+ *   return {
+ *     success: result.success,
+ *     data: result.data,
+ *     confidence: result.data?.confidence ?? 70,
+ *   };
+ * });
+ *
+ * const outcome = await executor.race(
+ *   { instruction: 'Summarize this document', context: { doc: '...' } },
+ *   [{ agentId: 'gpt4' }, { agentId: 'claude' }, { agentId: 'gemini' }],
+ * );
+ * if (outcome.hasWinner) {
+ *   console.log(`Winner: ${outcome.winner!.agentId} (${outcome.winner!.confidence})`);
+ * }
+ * ```
+ */
+export declare class SpeculativeExecutor {
+    private executeFn;
+    constructor(executeFn: SpeculativeExecutorFn);
+    /**
+     * Race the same payload across multiple candidate agents.
+     * Returns the highest-confidence successful result.
+     */
+    race(payload: Record<string, unknown>, candidates: SpeculativeCandidate[], options?: SpeculativeOptions): Promise<SpeculativeOutcome>;
+    private executeWithTimeout;
+}
+//# sourceMappingURL=speculative-executor.d.ts.map

package/dist/lib/speculative-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculative-executor.d.ts","sourceRoot":"","sources":["../../lib/speculative-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAMtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAwB;gBAE7B,SAAS,EAAE,qBAAqB;IAI5C;;;OAGG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,EAAE,oBAAoB,EAAE,EAClC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;YA0DhB,kBAAkB;CAmBjC"}

package/dist/lib/speculative-executor.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * SpeculativeExecutor — Dispatch the same task to multiple agents in parallel,
+ * then pick the best result via confidence scoring.
+ *
+ * Uses FanOutFanIn for parallel dispatch and ConfidenceFilter for quality-based
+ * winner selection. Optimistic concurrency: spend the extra budget up-front
+ * and discard inferior results.
+ *
+ * @module SpeculativeExecutor
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpeculativeExecutor = void 0;
+// ============================================================================
+// SPECULATIVE EXECUTOR
+// ============================================================================
+/**
+ * Dispatch one task to multiple agents, pick the best result.
+ *
+ * @example
+ * ```ts
+ * const executor = new SpeculativeExecutor(async (agentId, payload) => {
+ *   const result = await adapters.executeAgent(agentId, payload, ctx);
+ *   return {
+ *     success: result.success,
+ *     data: result.data,
+ *     confidence: result.data?.confidence ?? 70,
+ *   };
+ * });
+ *
+ * const outcome = await executor.race(
+ *   { instruction: 'Summarize this document', context: { doc: '...' } },
+ *   [{ agentId: 'gpt4' }, { agentId: 'claude' }, { agentId: 'gemini' }],
+ * );
+ * if (outcome.hasWinner) {
+ *   console.log(`Winner: ${outcome.winner!.agentId} (${outcome.winner!.confidence})`);
+ * }
+ * ```
+ */
+class SpeculativeExecutor {
+    executeFn;
+    constructor(executeFn) {
+        this.executeFn = executeFn;
+    }
+    /**
+     * Race the same payload across multiple candidate agents.
+     * Returns the highest-confidence successful result.
+     */
+    async race(payload, candidates, options = {}) {
+        const minConfidence = options.minConfidence ?? 50;
+        const globalTimeout = options.timeoutMs ?? 30_000;
+        const concurrency = options.concurrency ?? candidates.length;
+        const startMs = Date.now();
+        // Build per-candidate promises with individual timeouts
+        const tasks = candidates.map(c => ({
+            candidate: c,
+            promise: this.executeWithTimeout(c.agentId, payload, c.timeoutMs ?? globalTimeout),
+        }));
+        // Execute with concurrency limit
+        const results = [];
+        for (let i = 0; i < tasks.length; i += concurrency) {
+            const batch = tasks.slice(i, i + concurrency);
+            const settled = await Promise.allSettled(batch.map(async (t) => {
+                const res = await t.promise;
+                return {
+                    agentId: t.candidate.agentId,
+                    label: t.candidate.label,
+                    ...res,
+                };
+            }));
+            for (const s of settled) {
+                if (s.status === 'fulfilled') {
+                    results.push(s.value);
+                }
+                // Rejections are silently dropped — speculative by design
+            }
+        }
+        // Sort by confidence descending
+        results.sort((a, b) => b.confidence - a.confidence);
+        // Pick winner: highest confidence that is successful and above threshold
+        const winner = results.find(r => r.success && r.confidence >= minConfidence) ?? null;
+        return {
+            winner,
+            candidates: results,
+            hasWinner: winner !== null,
+            totalMs: Date.now() - startMs,
+            successCount: results.filter(r => r.success).length,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // INTERNAL
+    // --------------------------------------------------------------------------
+    async executeWithTimeout(agentId, payload, timeoutMs) {
+        const start = Date.now();
+        const resultPromise = this.executeFn(agentId, payload);
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Speculative timeout for ${agentId}`)), timeoutMs));
+        try {
+            const result = await Promise.race([resultPromise, timeoutPromise]);
+            return { ...result, durationMs: Date.now() - start };
+        }
+        catch {
+            return { success: false, data: null, confidence: 0, durationMs: Date.now() - start };
+        }
+    }
+}
+exports.SpeculativeExecutor = SpeculativeExecutor;
+//# sourceMappingURL=speculative-executor.js.map

package/dist/lib/speculative-executor.js.map

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

package/dist/lib/swarm-transport.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Distributed Swarm Transport — HTTP/JSON-RPC transport layer
+ *
+ * Enables multi-node swarm orchestration over the network.
+ * Provides:
+ *   - SwarmTransportServer — HTTP server that exposes SwarmOrchestrator methods
+ *   - SwarmTransportClient — HTTP client that proxies calls to a remote server
+ *   - Message envelope with auth, correlation IDs, and TTL
+ *
+ * Uses Node built-in `http` module — no external dependencies.
+ * Communication format: JSON-RPC 2.0 over HTTP POST.
+ *
+ * Usage (server):
+ *   const server = new SwarmTransportServer(orchestrator, { port: 4000 });
+ *   await server.start();
+ *
+ * Usage (client):
+ *   const client = new SwarmTransportClient('http://node-2:4000');
+ *   const result = await client.delegateTask(agentId, payload);
+ *
+ * @module SwarmTransport
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+/** Transport message envelope */
+export interface TransportEnvelope {
+    /** JSON-RPC version */
+    jsonrpc: '2.0';
+    /** Unique request ID */
+    id: string;
+    /** Remote method name */
+    method: string;
+    /** Method parameters */
+    params: Record<string, unknown>;
+    /** Metadata */
+    meta?: TransportMeta;
+}
+/** Metadata attached to transport messages */
+export interface TransportMeta {
+    /** Correlation ID for request tracing */
+    correlationId: string;
+    /** Source node identifier */
+    sourceNode: string;
+    /** Timestamp of message creation */
+    timestamp: number;
+    /** Time-to-live in ms (0 = no expiry) */
+    ttlMs: number;
+    /** HMAC signature if auth is configured */
+    signature?: string;
+}
+/** Transport response */
+export interface TransportResponse {
+    jsonrpc: '2.0';
+    id: string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** Server configuration */
+export interface TransportServerConfig {
+    /** Port to listen on (default: 4000) */
+    port?: number;
+    /** Hostname to bind (default: '127.0.0.1') */
+    hostname?: string;
+    /** Shared secret for HMAC authentication (optional) */
+    sharedSecret?: string;
+    /** Maximum request body size in bytes (default: 1MB) */
+    maxBodyBytes?: number;
+    /** Allowed source nodes (empty = allow all) */
+    allowedNodes?: string[];
+    /** Node identifier for this server */
+    nodeId?: string;
+}
+/** Client configuration */
+export interface TransportClientConfig {
+    /** Remote server URL (e.g. 'http://node-2:4000') */
+    url: string;
+    /** Shared secret for HMAC authentication (must match server) */
+    sharedSecret?: string;
+    /** This node's identifier */
+    nodeId?: string;
+    /** Default request timeout in ms (default: 30000) */
+    timeoutMs?: number;
+    /** Default TTL for messages in ms (default: 60000) */
+    ttlMs?: number;
+}
+/**
+ * Handler function for swarm transport methods.
+ * Receives parsed params and returns a result.
+ */
+export type TransportHandler = (params: Record<string, unknown>) => Promise<unknown>;
+/**
+ * HTTP transport server for distributed swarm orchestration.
+ *
+ * Exposes registered methods over HTTP POST with JSON-RPC 2.0 protocol.
+ * Supports HMAC authentication, node allowlisting, TTL enforcement,
+ * and request size limits.
+ */
+export declare class SwarmTransportServer extends EventEmitter {
+    private server;
+    private handlers;
+    private readonly config;
+    constructor(config?: TransportServerConfig);
+    /** Register a method handler */
+    register(method: string, handler: TransportHandler): void;
+    /** Register multiple handlers at once */
+    registerAll(handlers: Record<string, TransportHandler>): void;
+    /** Start the transport server */
+    start(): Promise<void>;
+    /** Stop the transport server */
+    stop(): Promise<void>;
+    /** Get the node ID */
+    get nodeId(): string;
+    /** Whether the server is running */
+    get isRunning(): boolean;
+    private handleRequest;
+    private readBody;
+    private sendResponse;
+    private computeHmac;
+}
+/**
+ * HTTP transport client for distributed swarm orchestration.
+ *
+ * Proxies method calls to a remote SwarmTransportServer over HTTP POST.
+ * Supports HMAC authentication, correlation IDs, and TTL.
+ */
+export declare class SwarmTransportClient extends EventEmitter {
+    private readonly config;
+    constructor(config: TransportClientConfig);
+    /**
+     * Call a remote method.
+     * @returns The result from the remote handler.
+     * @throws If the remote returns an error or the request times out.
+     */
+    call(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** Get the node ID */
+    get nodeId(): string;
+    /** Convenience: delegate a task to a remote orchestrator */
+    delegateTask(agentId: string, payload: Record<string, unknown>): Promise<unknown>;
+    /** Convenience: read from remote blackboard */
+    blackboardRead(key: string): Promise<unknown>;
+    /** Convenience: write to remote blackboard */
+    blackboardWrite(key: string, value: unknown, proposer?: string): Promise<unknown>;
+    /** Convenience: query remote budget status */
+    budgetStatus(): Promise<unknown>;
+}
+//# sourceMappingURL=swarm-transport.d.ts.map

package/dist/lib/swarm-transport.d.ts.map

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