@apnex/network-adapter 0.1.0

package/dist/wire/transport.js

@@ -0,0 +1,43 @@
+/**
+ * ITransport — Layer-4 wire surface for the network-adapter package.
+ *
+ * Phase 1: types only. Zero runtime change. The real implementation
+ * (`McpTransport`) lands in Phase 2, extracted out of the current
+ * `McpConnectionManager`.
+ *
+ * ## Responsibility boundary
+ *
+ * A Transport owns exactly one logical wire to a Hub. It is responsible
+ * for:
+ *
+ *   1. Opening and closing that wire.
+ *   2. Shipping untyped request/response pairs over it (`request`).
+ *   3. Enumerating what method names the remote peer advertises
+ *      (`listMethods` — used by the adapter for discovery translation).
+ *   4. Surfacing liveness: a coarse 3-value `wireState` and a stream of
+ *      `WireEvent`s (connected, disconnected, peer-closed, etc.).
+ *   5. Wire-level reconnect policy: it transparently reconnects the
+ *      underlying socket/HTTP/SSE stream on transient failure. It does
+ *      NOT know about sessions, roles, handshakes, or FSM.
+ *
+ * It is NOT responsible for:
+ *
+ *   - Session lifecycle (bind/rebind/teardown). That lives on the
+ *     `IAgentClient` above it.
+ *   - Authentication and handshake semantics (register_role, enriched handshake).
+ *   - Event classification, dedup, or state sync.
+ *   - Retry-on-session-invalid (that policy is above the wire).
+ *
+ * ## Why untyped `request(method, params)`
+ *
+ * The adapter and shim above must be transport-agnostic. By keeping the
+ * request surface a plain string-keyed call, the same adapter code can
+ * run against a future gRPC or QUIC transport without leaking protocol
+ * detail. MCP-specific encodings (tool calls, list_tools, etc.) are
+ * translated inside `McpTransport`, not exposed here.
+ *
+ * The trade-off: type safety on the wire is the transport's problem.
+ * Callers (the adapter) validate response shapes at the L7 seam.
+ */
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/wire/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/wire/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@apnex/network-adapter",
+  "version": "0.1.0",
+  "description": "Universal MCP Network Adapter — L4/L7 transport for OIS agentic network",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@apnex/cognitive-layer": "*",
+    "@apnex/message-router": "*"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.0.0",
+    "express": "^5.2.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.4",
+    "zod": "^4.3.6"
+  }
+}