@claude-flow/plugin-agent-federation 1.0.0-alpha.9 → 1.0.1

package/dist/transport/midstream-aware-loader.js

@@ -0,0 +1,269 @@
+/**
+ * Midstream-aware federation transport loader (ADR-120, Step 2).
+ *
+ * Extends the agentic-flow `loadQuicTransport` loader pattern with a
+ * preferred branch that probes `midstreamer` first. When `midstreamer`
+ * ships real QUIC (currently the WASM build is a counter-tracking
+ * stub per ADR-119), this loader picks it up automatically without
+ * any change to consumer plugins.
+ *
+ * Resolution order:
+ *
+ *   1. If `MIDSTREAMER_QUIC_NATIVE=1` AND the `midstreamer` module
+ *      exposes a real `QuicMultistream`-derived `AgentTransport`,
+ *      use it. (Today: probes fail closed and we fall through.)
+ *
+ *   2. Otherwise: defer to agentic-flow's existing loader, which
+ *      itself respects `AGENTIC_FLOW_QUIC_NATIVE=1` (ADR-108) and
+ *      falls back to WebSocket (ADR-104) otherwise.
+ *
+ * The loader is opt-in: callers must explicitly invoke
+ * `loadFederationTransport()` instead of `loadQuicTransport()`.
+ * Behavior is identical to `loadQuicTransport()` until upstream
+ * `midstreamer` ships its real QUIC build AND the operator sets the
+ * env flag — so this change is safe to land before any of that
+ * happens.
+ *
+ * Re-exports the `AgentTransport` / `AgentMessage` / `QuicTransportConfig`
+ * surface from agentic-flow so consumers only import from one place.
+ */
+function isCompatibleTransport(value, requireListen = false) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const transport = value;
+    return (typeof transport.send === 'function' &&
+        typeof transport.onMessage === 'function' &&
+        (!requireListen || typeof transport.listen === 'function'));
+}
+/**
+ * Lazy loader for agentic-flow's `loadQuicTransport`. Returns `null`
+ * when `agentic-flow` is not installed — callers must then fall back
+ * to the midstream-first path or surface a clear error.
+ *
+ * Per ADR-120 + issue #1949, `agentic-flow` is now an **optional**
+ * peer dependency. Operators who only want the midstream-native
+ * transport (via `MIDSTREAMER_QUIC_NATIVE=1`) can omit it to avoid
+ * the deep `koa-router` → `cookies@0.9.1` transitive chain that
+ * hardened npm registries reject.
+ */
+async function loadAgenticFlowQuicTransport(config) {
+    // Direct dynamic `import()` (not the `new Function` trick) so
+    // test frameworks like vitest can intercept via `vi.mock`. The
+    // try/catch makes the module-not-found case a clean `null` so the
+    // caller falls back gracefully — agentic-flow is now an optional
+    // peer dependency.
+    let mod;
+    try {
+        // Cast through `unknown` because upstream's exported AgentTransport /
+        // AgentMessage carry a richer surface (InboundMessageHandler with an
+        // options bag, extra fields) that intentionally differs from our
+        // locally-declared minimal shim. The shim exists so the plugin can
+        // compile without importing agentic-flow's exports map at all
+        // (#2578). Downstream code (`plugin.ts`) uses our shim types.
+        mod = (await import('agentic-flow/transport/loader'));
+    }
+    catch {
+        return null;
+    }
+    const fn = typeof mod.loadQuicTransport === 'function'
+        ? mod.loadQuicTransport
+        : mod.default?.loadQuicTransport;
+    if (typeof fn !== 'function') {
+        return null;
+    }
+    try {
+        const transport = await fn(config);
+        return isCompatibleTransport(transport, typeof config?.port === 'number')
+            ? transport
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Plugin-owned ADR-104 WebSocket fallback. This closes issue #2618's
+ * failure mode: current `agentic-flow` releases do not export
+ * `agentic-flow/transport/loader`, so the federation plugin must not
+ * depend on that subpath for its baseline wire transport.
+ */
+class WebSocketFallbackTransport {
+    config;
+    handlers = [];
+    server = null;
+    sockets = new Set();
+    constructor(config = {}) {
+        this.config = config;
+    }
+    async send(address, message) {
+        const { default: WebSocket } = await import('ws');
+        const url = address.includes('://') ? address : `ws://${address}`;
+        const socket = new WebSocket(url);
+        await new Promise((resolve, reject) => {
+            socket.on('open', () => {
+                socket.send(JSON.stringify(message), (err) => {
+                    socket.close();
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+            socket.on('error', (err) => reject(err instanceof Error ? err : new Error(String(err))));
+        });
+    }
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    async listen(port = Number(this.config.port ?? 0), host = String(this.config.host ?? '0.0.0.0')) {
+        const { WebSocketServer } = await import('ws');
+        const server = new WebSocketServer({ port, host });
+        this.server = server;
+        await new Promise((resolve, reject) => {
+            server.on('listening', () => resolve());
+            server.on('error', (err) => reject(err instanceof Error ? err : new Error(String(err))));
+            server.on('connection', (socket, request) => {
+                const ws = socket;
+                this.sockets.add(ws);
+                const remoteAddress = (request?.socket);
+                const address = remoteAddress?.remoteAddress
+                    ? `${remoteAddress.remoteAddress}${remoteAddress.remotePort ? `:${remoteAddress.remotePort}` : ''}`
+                    : 'unknown';
+                ws.on('message', (data) => {
+                    try {
+                        const raw = typeof data === 'string'
+                            ? data
+                            : Buffer.isBuffer(data)
+                                ? data.toString('utf8')
+                                : String(data);
+                        const message = JSON.parse(raw);
+                        for (const handler of this.handlers)
+                            handler(address, message);
+                    }
+                    catch {
+                        // Drop malformed frames. Signature/envelope validation happens
+                        // above this layer in inbound-dispatcher.
+                    }
+                });
+                ws.on('close', () => this.sockets.delete(ws));
+            });
+        });
+    }
+    async close() {
+        for (const socket of this.sockets)
+            socket.close();
+        this.sockets.clear();
+        if (this.server) {
+            await new Promise((resolve) => this.server?.close(resolve));
+            this.server = null;
+        }
+    }
+}
+/**
+ * Probe the `midstreamer` npm package for a real QUIC transport.
+ * Returns `null` when the env flag is off, when the package isn't
+ * installed, when the import surface doesn't match expectations, or
+ * when the loaded module is detectably the WASM stub (per ADR-119
+ * the current shipped build is a counter-tracking stub — `isNative()`
+ * or `isStub()` probes are checked when available).
+ *
+ * The function never throws — any failure becomes `null` so the
+ * outer `loadFederationTransport` can transparently fall back.
+ */
+async function probeMidstreamerTransport(config) {
+    if (process.env.MIDSTREAMER_QUIC_NATIVE !== '1') {
+        return null;
+    }
+    let mod;
+    try {
+        // Lazy + indirect so bundlers don't try to resolve at compile time.
+        // Prefer the `midstreamer/quic` sub-path (added in midstreamer@0.3.1
+        // per upstream ruvnet/midstream#81) which exposes
+        // `loadQuicTransport` directly without WASM init. Fall back to the
+        // root `midstreamer` package for older versions that put the QUIC
+        // surface on the default export.
+        const dynamicImport = new Function('s', 'return import(s)');
+        try {
+            mod = await dynamicImport('midstreamer/quic');
+        }
+        catch {
+            mod = await dynamicImport('midstreamer');
+        }
+    }
+    catch {
+        return null;
+    }
+    const candidate = mod;
+    // CommonJS sub-path exposes its API via `module.exports = {...};
+    // module.exports.default = module.exports;` — so we also accept the
+    // `.default` form. ESM imports flatten the named exports directly.
+    const surface = (typeof candidate.loadQuicTransport === 'function'
+        ? candidate
+        : candidate.default);
+    if (!surface) {
+        return null;
+    }
+    // Refuse to use the WASM stub. ADR-119 documented the previous
+    // QuicMultistream as a counter-tracking stub with no real UDP, TLS,
+    // or protocol — using it would silently downgrade the federation
+    // path. midstreamer@0.3.1+ ships a real QUIC transport via
+    // `midstreamer/quic` (ADR-120, Step 1 — upstream PR ruvnet/midstream#81)
+    // and reports `isNative() === true`. Older versions either expose
+    // `isStub()` returning true or omit both probes.
+    if (typeof surface.isStub === 'function' && surface.isStub()) {
+        return { transport: null, reason: 'midstreamer module reports isStub() === true; refusing to bind a stub QUIC backend (ADR-119)' };
+    }
+    if (typeof surface.loadQuicTransport !== 'function') {
+        return null;
+    }
+    if (typeof surface.isNative === 'function' && !surface.isNative()) {
+        return null;
+    }
+    try {
+        const transport = await surface.loadQuicTransport(config);
+        return isCompatibleTransport(transport, typeof config?.port === 'number')
+            ? { transport }
+            : {
+                transport: null,
+                reason: 'midstreamer transport does not implement the federation send/onMessage/listen contract',
+            };
+    }
+    catch (err) {
+        return {
+            transport: null,
+            reason: `midstreamer.loadQuicTransport failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Top-level loader for federation transport. Identical signature to
+ * agentic-flow's `loadQuicTransport`, but with the midstreamer-first
+ * preference. Use this from `plugins/ruflo-federation` in place of
+ * the bare `loadQuicTransport`.
+ *
+ * Failure mode: if midstreamer is requested but rejects (stub, init
+ * error, missing package), this function falls through to the
+ * agentic-flow loader. If current agentic-flow does not export its
+ * historical loader subpath, the plugin-owned WebSocket fallback is
+ * used directly (ADR-104, #2618).
+ */
+export async function loadFederationTransport(config) {
+    const probe = await probeMidstreamerTransport(config);
+    if (probe && probe.transport) {
+        return { transport: probe.transport, source: 'midstreamer-native' };
+    }
+    const transport = await loadAgenticFlowQuicTransport(config);
+    if (transport) {
+        return {
+            transport,
+            source: 'agentic-flow-loader',
+            fallbackReason: probe?.reason,
+        };
+    }
+    return {
+        transport: new WebSocketFallbackTransport(config),
+        source: 'websocket-fallback',
+        fallbackReason: probe?.reason ?? 'agentic-flow transport loader unavailable; using plugin-owned WebSocket fallback',
+    };
+}
+//# sourceMappingURL=midstream-aware-loader.js.map

package/dist/transport/midstream-aware-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"midstream-aware-loader.js","sourceRoot":"","sources":["../../src/transport/midstream-aware-loader.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Single source of truth for runtime, manifest, CLI, and MCP version metadata. */
+export declare const FEDERATION_PLUGIN_VERSION: "1.0.0-alpha.18";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,EAAG,gBAAyB,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** Single source of truth for runtime, manifest, CLI, and MCP version metadata. */
+export const FEDERATION_PLUGIN_VERSION = '1.0.0-alpha.18';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/plugin-agent-federation",
-  "version": "1.0.0-alpha.9",
+  "version": "1.0.1",
   "description": "Cross-installation agent federation with zero-trust security, PII-gated data flow, and compliance-grade audit trails.",
   "homepage": "https://github.com/ruvnet/ruflo",
   "type": "module",
@@ -16,19 +16,35 @@
   ],
   "scripts": {
     "build": "tsc",
+    "benchmark:canonicalization": "npm run build && node scripts/benchmark-envelope-canonicalization.mjs",
+    "benchmark:planner-descriptor": "npm run build && node scripts/benchmark-planner-descriptor.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "clean": "rm -rf dist"
   },
   "dependencies": {
     "@noble/ed25519": "^2.0.0",
-    "agentic-flow": "2.0.12-fix.2"
+    "ws": "^8.20.0"
+  },
+  "peerDependencies": {
+    "agentic-flow": ">=2.0.12-fix.8 <4.0.0",
+    "midstreamer": ">=0.3.1"
+  },
+  "peerDependenciesMeta": {
+    "agentic-flow": {
+      "optional": true
+    },
+    "midstreamer": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@claude-flow/shared": "workspace:*",
-    "@claude-flow/security": "workspace:*",
+    "@claude-flow/shared": "^3.0.0",
+    "@claude-flow/security": "^3.0.0",
+    "@types/ws": "^8.18.1",
+    "agentic-flow": "2.0.12-fix.8",
     "typescript": "^5.4.0",
-    "vitest": "^4.0.16"
+    "vitest": "^4.1.0"
   },
   "keywords": [
     "federation",