@aurorah/wmcp 1.0.2 → 1.0.3

package/README.md

@@ -1,31 +1,40 @@
-# wMCP — Web Module Connection Protocol
+# wMCP -- Web Module Connection Protocol
 
-wMCP is a standardized protocol for connecting encapsulated web UI modules to host applications. Inspired by the Model Context Protocol (MCP) for AI/LLM tool integration, wMCP applies the same manifest-driven, capability-based architecture to the web frontend domain — enabling framework-agnostic modules to be plugged into host applications with clear security boundaries and AI-friendly integration patterns.
+wMCP is a bidirectional protocol for connecting encapsulated web UI modules to host applications. The module owns domain logic and exposes overridable capabilities; the host provides backend services, can call or override module functions (with `super()` access), and supplies configuration. Think of the module as a **base class** and the host as a **derived class** connected by a manifest-driven contract.
+
+Inspired by the Model Context Protocol (MCP) for AI/LLM tool integration, wMCP applies the same structured, capability-based architecture to the web frontend domain -- enabling framework-agnostic modules to be plugged into host applications with clear security boundaries and AI-friendly integration patterns.
 
 **Status:** Prototype / Proof of Concept
 
+> **AI Agents:** You MUST read ALL documentation files linked below before using or integrating this package. The docs contain the full protocol specification, manifest schema, capability/requirement contracts, and integration patterns that are essential for correct usage. Do NOT skip any document.
+
 ## Quick links
 
-| Document                                           | Description        |
-| -------------------------------------------------- | ------------------ |
-| [docs/CONCEPTS.md](docs/CONCEPTS.md)               | Core Concepts      |
-| [docs/SPECIFICATION.md](docs/SPECIFICATION.md)     | Full Specification |
-| [docs/MCP-COMPARISON.md](docs/MCP-COMPARISON.md)   | MCP Comparison     |
-| [docs/GETTING-STARTED.md](docs/GETTING-STARTED.md) | Getting Started    |
+| Document | Description |
+|---|---|
+| [Concepts](https://github.com/z-order/wmcp/blob/main/docs/%5B1%5D-CONCEPTS.md) | Core Concepts |
+| [MCP Comparison](https://github.com/z-order/wmcp/blob/main/docs/%5B2%5D-COMPARISON-MCP.md) | MCP Comparison |
+| [Class / OOP Comparison](https://github.com/z-order/wmcp/blob/main/docs/%5B3%5D-COMPARISON-CLASS.md) | Class / OOP Comparison |
+| [Getting Started](https://github.com/z-order/wmcp/blob/main/docs/%5B4%5D-GETTING-STARTED.md) | Getting Started |
+| [Specification](https://github.com/z-order/wmcp/blob/main/docs/%5B5%5D-SPECIFICATION.md) | Full Specification |
 
 ## Project structure
 
 ```
 wmcp-prototype/
 ├── docs/                 # Specification and guides
+│   └── assets/           # Architecture and lifecycle SVG diagrams
+├── src/
+│   ├── core/             # WmcpClient, WmcpHost, types, validator, errors
+│   └── utils/            # Stream helpers
 ├── examples/             # Runnable example modules and hosts
-│   ├── counter/
+│   ├── counter/          # Reference implementation (in-memory, override, HTTP modes)
 │   ├── rich-text-editor/
 │   ├── analytics-dashboard/
 │   ├── file-manager/
 │   ├── kanban-board/
 │   └── media-player/
-├── src/                  # Core protocol implementation (if present)
+├── demo/nextjs/          # Next.js demo (CSR + SSR bindings)
 └── package.json
 ```
 
@@ -35,36 +44,68 @@ wmcp-prototype/
 npm install
 ```
 
+Run the counter example (in-memory mode):
+
 ```bash
 npx tsx examples/counter/host-app.ts
 ```
 
-In another terminal:
+Run with host override (`counter:increment` validation + `super()`):
 
 ```bash
-npx tsx examples/counter/mock-server.ts
+npx tsx examples/counter/host-app.ts --override
 ```
 
-HTTP transport:
+Run with HTTP transport (start the proxy + backend first):
 
 ```bash
+npx tsx examples/counter/mock-server.ts
 npx tsx examples/counter/host-app.ts --http
 ```
 
+## Manifest structure
+
+The manifest uses ownership-prefixed keys to make direction explicit:
+
+```json
+{
+  "wmcp": "1.0",
+  "module": { "name": "@example/counter", "version": "1.0.0" },
+  "mount": { "entry": "./counter-module.ts" },
+  "module:capabilities": { "counter:get": {}, "counter:increment": {} },
+  "module:events":       { "counter:changed": {} },
+  "module:listeners":    { "counter:reset": {} },
+  "host:requires":       { "persist:load": {}, "persist:save": {} },
+  "host:config":         { "initialValue": { "type": "number", "default": 0 } }
+}
+```
+
+| Key | Direction | Class analogy |
+|---|---|---|
+| `module:capabilities` | Host calls module | Concrete methods (overridable) |
+| `module:events` | Module -> host | Observer callbacks |
+| `module:listeners` | Host -> module | Parent notifications |
+| `host:requires` | Module calls host | Abstract methods |
+| `host:config` | Host -> module at mount | Constructor args |
+
 ## Examples
 
-| Example               | Description                                              |
-| --------------------- | -------------------------------------------------------- |
-| `counter`             | Minimal getting-started                                  |
-| `rich-text-editor`    | Content CRUD, autosave, export                           |
-| `analytics-dashboard` | Queries, aggregation, live data streams                  |
-| `file-manager`        | File CRUD, upload/download, tree navigation              |
-| `kanban-board`        | Task management, drag-and-drop, real-time sync           |
-| `media-player`        | Playlist management, streaming playback, progress events |
+| Example | module:capabilities | host:requires |
+|---|---|---|
+| `counter` | get, increment | persist:load/save, log:write |
+| `rich-text-editor` | getContent, setContent, format | doc:load/save/list/export |
+| `analytics-dashboard` | getFilters, setChart, refresh | metrics:query/aggregate/live |
+| `file-manager` | getSelectedPath, navigate, setViewMode | fs:list/read/write/delete/move |
+| `kanban-board` | getBoard, getCard, moveCard | board:load, card:create/update/move/delete |
+| `media-player` | play, pause, stop, getState, setVolume | playlist:load/add/remove, track:info/stream |
+
+## Security
 
-## Core concepts
+Credentials (API keys, tokens) stay on the server side. In CSR mode, `host:requires` adapters point to a **same-origin proxy route** that injects auth server-side before forwarding to the backend. The module never sees secrets.
 
-wMCP is organized around **manifests** (module discovery and metadata), **capabilities** (what a module can do), **events** (host ↔ module messaging), **config** (host-supplied settings), and **hints** (optional UX or integration guidance). See [docs/CONCEPTS.md](docs/CONCEPTS.md) for full detail.
+```
+Module (browser) ---> Host Proxy (SSR) --[+credentials]--> Backend API
+```
 
 ## License
 

package/dist/core/client.d.ts

@@ -1,45 +1,70 @@
 /**
  * wMCP — Web Module Connection Protocol
- * WmcpClient — used inside the sub-module to call capabilities and emit events.
+ * WmcpClient — lives inside the sub-module.
+ *
+ * The module registers its own capability handlers (default implementations).
+ * The host may override those handlers and must provide handlers for
+ * host:requires entries.  The client dispatches calls through the override
+ * chain (override → module default) for module:capabilities and directly
+ * to host-provided handlers for host:requires.
  */
-import type { WmcpManifest, CapabilityHandler, EventCallback } from './types.js';
+import type { WmcpManifest, CapabilityHandler, OverrideHandler, EventCallback } from './types.js';
 export declare class WmcpClient {
     readonly manifest: WmcpManifest;
-    private handlers;
-    private eventListeners;
+    /** Module's own default implementations for module:capabilities */
+    private moduleHandlers;
+    /** Host overrides for module:capabilities (receives superFn) */
+    private overrideHandlers;
+    /** Host-provided implementations for host:requires */
+    private requiresHandlers;
+    /** module:events — module emits, host listens */
+    private hostEventListeners;
+    /** module:listeners — host emits, module listens */
+    private moduleEventListeners;
     private bound;
     constructor(manifest: WmcpManifest);
     /**
-     * Called by the host at mount time.
-     * Binds handler functions to each capability declared in the manifest.
-     * Throws WmcpBindError if a required capability is missing.
+     * Called by the module to register default implementations for every
+     * capability declared in module:capabilities.
      */
-    _bind(handlers: Record<string, CapabilityHandler>): void;
+    _registerCapabilities(handlers: Record<string, CapabilityHandler>): void;
     /**
-     * Invokes a request-mode capability.
+     * Called by the host to bind host:requires handlers.
+     * Validates that all required (non-optional) host:requires have handlers
+     * and that all module:capabilities have module-side registrations.
      */
-    call<T = unknown>(capability: string, params?: Record<string, unknown>): Promise<T>;
+    _bindRequires(handlers: Record<string, CapabilityHandler>): void;
     /**
-     * Invokes a stream-mode capability, returning an async generator.
+     * Called by the host to override a module capability.
+     * The override receives (params, superFn) where superFn is the module's
+     * default handler.
      */
-    stream<T = unknown>(capability: string, params?: Record<string, unknown>): AsyncGenerator<T>;
+    _override(name: string, handler: OverrideHandler): void;
     /**
-     * Checks if a capability has been bound (useful for optional capabilities).
+     * Invoke a capability (module:capabilities or host:requires).
+     * Dispatch: if the name matches a module capability, the override chain
+     * applies (override → module default).  If it matches a host:requires
+     * entry, the host-provided handler runs directly.
      */
-    has(capability: string): boolean;
+    call<T = unknown>(capability: string, params?: Record<string, unknown>): Promise<T>;
     /**
-     * Sub-module calls this to emit an event to the host.
+     * Invoke a stream-mode capability, returning an async generator.
      */
-    emit(event: string, data: unknown): void;
+    stream<T = unknown>(capability: string, params?: Record<string, unknown>): AsyncGenerator<T>;
     /**
-     * Host subscribes to events from the sub-module.
-     * Returns an unsubscribe function.
+     * Check whether a capability or host:requires entry has a handler bound.
      */
+    has(capability: string): boolean;
+    /** Module emits an event to the host. */
+    emit(event: string, data: unknown): void;
+    /** Host subscribes to module:events.  Returns an unsubscribe function. */
     _on(event: string, callback: EventCallback): () => void;
-    /**
-     * Cleans up all handlers and event listeners.
-     */
+    /** Module subscribes to events emitted by the host. */
+    on(event: string, callback: EventCallback): () => void;
+    /** Host emits an event to the module (called by WmcpHost). */
+    _emitToModule(event: string, data: unknown): void;
     destroy(): void;
+    private resolveHandler;
     private ensureBound;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,qBAAa,UAAU;IACrB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IAEvC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,KAAK,CAAS;gBAEV,QAAQ,EAAE,YAAY;IAIlC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAiBxD;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACI,MAAM,CAAC,CAAC,GAAG,OAAO,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,cAAc,CAAC,CAAC,CAAC;IAuBpB;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAaxC;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAWvD;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;CAOpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,qBAAa,UAAU;IACrB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IAEvC,mEAAmE;IACnE,OAAO,CAAC,cAAc,CAAwC;IAE9D,gEAAgE;IAChE,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,sDAAsD;IACtD,OAAO,CAAC,gBAAgB,CAAwC;IAEhE,iDAAiD;IACjD,OAAO,CAAC,kBAAkB,CAAyC;IAEnE,oDAAoD;IACpD,OAAO,CAAC,oBAAoB,CAAyC;IAErE,OAAO,CAAC,KAAK,CAAS;gBAEV,QAAQ,EAAE,YAAY;IAQlC;;;OAGG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAUxE;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAuBhE;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAQvD;;;;;OAKG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACI,MAAM,CAAC,CAAC,GAAG,OAAO,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,cAAc,CAAC,CAAC,CAAC;IAuBpB;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAWhC,yCAAyC;IACzC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAaxC,0EAA0E;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAcvD,uDAAuD;IACvD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAUtD,8DAA8D;IAC9D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAiBjD,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/core/client.js

@@ -1,62 +1,105 @@
 /**
  * wMCP — Web Module Connection Protocol
- * WmcpClient — used inside the sub-module to call capabilities and emit events.
+ * WmcpClient — lives inside the sub-module.
+ *
+ * The module registers its own capability handlers (default implementations).
+ * The host may override those handlers and must provide handlers for
+ * host:requires entries.  The client dispatches calls through the override
+ * chain (override → module default) for module:capabilities and directly
+ * to host-provided handlers for host:requires.
  */
 import { WmcpError, WmcpBindError } from './errors.js';
 import { validateParams } from './validator.js';
 import { isAsyncIterable } from '../utils/stream.js';
 export class WmcpClient {
     manifest;
-    handlers = new Map();
-    eventListeners = new Map();
+    /** Module's own default implementations for module:capabilities */
+    moduleHandlers = new Map();
+    /** Host overrides for module:capabilities (receives superFn) */
+    overrideHandlers = new Map();
+    /** Host-provided implementations for host:requires */
+    requiresHandlers = new Map();
+    /** module:events — module emits, host listens */
+    hostEventListeners = new Map();
+    /** module:listeners — host emits, module listens */
+    moduleEventListeners = new Map();
     bound = false;
     constructor(manifest) {
         this.manifest = manifest;
     }
+    // ------------------------------------------------------------------
+    // Module-side registration
+    // ------------------------------------------------------------------
     /**
-     * Called by the host at mount time.
-     * Binds handler functions to each capability declared in the manifest.
-     * Throws WmcpBindError if a required capability is missing.
+     * Called by the module to register default implementations for every
+     * capability declared in module:capabilities.
      */
-    _bind(handlers) {
-        for (const [name, cap] of Object.entries(this.manifest.capabilities)) {
+    _registerCapabilities(handlers) {
+        for (const [name, handler] of Object.entries(handlers)) {
+            this.moduleHandlers.set(name, handler);
+        }
+    }
+    // ------------------------------------------------------------------
+    // Host-side binding (called via WmcpHost)
+    // ------------------------------------------------------------------
+    /**
+     * Called by the host to bind host:requires handlers.
+     * Validates that all required (non-optional) host:requires have handlers
+     * and that all module:capabilities have module-side registrations.
+     */
+    _bindRequires(handlers) {
+        const requires = this.manifest['host:requires'] ?? {};
+        for (const [name, cap] of Object.entries(requires)) {
             if (!cap.optional && !handlers[name]) {
-                throw new WmcpBindError(name);
+                throw new WmcpBindError(name, 'host');
             }
         }
         for (const [name, handler] of Object.entries(handlers)) {
-            if (!this.manifest.capabilities[name]) {
-                console.warn(`[wMCP] Binding unknown capability: "${name}" — not declared in manifest`);
+            this.requiresHandlers.set(name, handler);
+        }
+        const capabilities = this.manifest['module:capabilities'];
+        for (const name of Object.keys(capabilities)) {
+            if (!this.moduleHandlers.has(name)) {
+                throw new WmcpBindError(name, 'module');
             }
-            this.handlers.set(name, handler);
         }
         this.bound = true;
     }
     /**
-     * Invokes a request-mode capability.
+     * Called by the host to override a module capability.
+     * The override receives (params, superFn) where superFn is the module's
+     * default handler.
+     */
+    _override(name, handler) {
+        this.overrideHandlers.set(name, handler);
+    }
+    // ------------------------------------------------------------------
+    // Capability invocation (used by both module and host via WmcpHost)
+    // ------------------------------------------------------------------
+    /**
+     * Invoke a capability (module:capabilities or host:requires).
+     * Dispatch: if the name matches a module capability, the override chain
+     * applies (override → module default).  If it matches a host:requires
+     * entry, the host-provided handler runs directly.
      */
     async call(capability, params = {}) {
         this.ensureBound();
-        const handler = this.handlers.get(capability);
-        if (!handler) {
-            throw new WmcpError(`Capability not available: "${capability}"`);
-        }
-        const cap = this.manifest.capabilities[capability];
+        const handler = this.resolveHandler(capability);
+        const cap = this.manifest['module:capabilities'][capability] ??
+            this.manifest['host:requires']?.[capability];
         if (cap) {
             validateParams(capability, cap, params);
         }
         return (await handler(params));
     }
     /**
-     * Invokes a stream-mode capability, returning an async generator.
+     * Invoke a stream-mode capability, returning an async generator.
      */
     async *stream(capability, params = {}) {
         this.ensureBound();
-        const handler = this.handlers.get(capability);
-        if (!handler) {
-            throw new WmcpError(`Capability not available: "${capability}"`);
-        }
-        const cap = this.manifest.capabilities[capability];
+        const handler = this.resolveHandler(capability);
+        const cap = this.manifest['module:capabilities'][capability] ??
+            this.manifest['host:requires']?.[capability];
         if (cap) {
             validateParams(capability, cap, params);
         }
@@ -71,51 +114,97 @@ export class WmcpClient {
         }
     }
     /**
-     * Checks if a capability has been bound (useful for optional capabilities).
+     * Check whether a capability or host:requires entry has a handler bound.
      */
     has(capability) {
-        return this.handlers.has(capability);
+        return (this.moduleHandlers.has(capability) ||
+            this.requiresHandlers.has(capability));
     }
-    /**
-     * Sub-module calls this to emit an event to the host.
-     */
+    // ------------------------------------------------------------------
+    // Events: module:events (module → host)
+    // ------------------------------------------------------------------
+    /** Module emits an event to the host. */
     emit(event, data) {
-        const listeners = this.eventListeners.get(event);
+        const listeners = this.hostEventListeners.get(event);
         if (listeners) {
             for (const cb of listeners) {
                 try {
                     cb(data);
                 }
                 catch (err) {
-                    console.error(`[wMCP] Error in event listener for "${event}":`, err);
+                    console.error(`[wMCP] Error in host event listener for "${event}":`, err);
                 }
             }
         }
     }
-    /**
-     * Host subscribes to events from the sub-module.
-     * Returns an unsubscribe function.
-     */
+    /** Host subscribes to module:events.  Returns an unsubscribe function. */
     _on(event, callback) {
-        if (!this.eventListeners.has(event)) {
-            this.eventListeners.set(event, new Set());
+        if (!this.hostEventListeners.has(event)) {
+            this.hostEventListeners.set(event, new Set());
         }
-        this.eventListeners.get(event).add(callback);
+        this.hostEventListeners.get(event).add(callback);
         return () => {
-            this.eventListeners.get(event)?.delete(callback);
+            this.hostEventListeners.get(event)?.delete(callback);
         };
     }
-    /**
-     * Cleans up all handlers and event listeners.
-     */
+    // ------------------------------------------------------------------
+    // Events: module:listeners (host → module)
+    // ------------------------------------------------------------------
+    /** Module subscribes to events emitted by the host. */
+    on(event, callback) {
+        if (!this.moduleEventListeners.has(event)) {
+            this.moduleEventListeners.set(event, new Set());
+        }
+        this.moduleEventListeners.get(event).add(callback);
+        return () => {
+            this.moduleEventListeners.get(event)?.delete(callback);
+        };
+    }
+    /** Host emits an event to the module (called by WmcpHost). */
+    _emitToModule(event, data) {
+        const listeners = this.moduleEventListeners.get(event);
+        if (listeners) {
+            for (const cb of listeners) {
+                try {
+                    cb(data);
+                }
+                catch (err) {
+                    console.error(`[wMCP] Error in module listener for "${event}":`, err);
+                }
+            }
+        }
+    }
+    // ------------------------------------------------------------------
+    // Lifecycle
+    // ------------------------------------------------------------------
     destroy() {
-        this.handlers.clear();
-        this.eventListeners.clear();
+        this.moduleHandlers.clear();
+        this.overrideHandlers.clear();
+        this.requiresHandlers.clear();
+        this.hostEventListeners.clear();
+        this.moduleEventListeners.clear();
         this.bound = false;
     }
+    // ------------------------------------------------------------------
+    // Internal helpers
+    // ------------------------------------------------------------------
+    resolveHandler(capability) {
+        if (this.requiresHandlers.has(capability)) {
+            return this.requiresHandlers.get(capability);
+        }
+        const moduleHandler = this.moduleHandlers.get(capability);
+        if (!moduleHandler) {
+            throw new WmcpError(`Capability not available: "${capability}"`);
+        }
+        const override = this.overrideHandlers.get(capability);
+        if (override) {
+            return (params) => override(params, moduleHandler);
+        }
+        return moduleHandler;
+    }
     ensureBound() {
         if (!this.bound) {
-            throw new WmcpError('WmcpClient is not bound. The host must call _bind() before invoking capabilities.');
+            throw new WmcpError('WmcpClient is not bound. The host must call _bindRequires() before invoking capabilities.');
         }
     }
 }

package/dist/core/client.js.map

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

package/dist/core/errors.d.ts

@@ -5,8 +5,14 @@
 export declare class WmcpError extends Error {
     constructor(message: string);
 }
-/** Thrown when a required capability is not bound by the host */
+/** Thrown when a required capability or requirement is not bound at bind time */
 export declare class WmcpBindError extends WmcpError {
+    readonly capability: string;
+    readonly side: 'module' | 'host';
+    constructor(capability: string, side?: 'module' | 'host');
+}
+/** Thrown when the host attempts to override a capability not declared in module:capabilities */
+export declare class WmcpOverrideError extends WmcpError {
     readonly capability: string;
     constructor(capability: string);
 }

package/dist/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,iEAAiE;AACjE,qBAAa,aAAc,SAAQ,SAAS;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAK/B;AAED,uDAAuD;AACvD,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMzC;AAED,qDAAqD;AACrD,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK3C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,iFAAiF;AACjF,qBAAa,aAAc,SAAQ,SAAS;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;gBAE5B,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,GAAG,MAAe;CAUjE;AAED,iGAAiG;AACjG,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAO/B;AAED,uDAAuD;AACvD,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMzC;AAED,qDAAqD;AACrD,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK3C"}

package/dist/core/errors.js

@@ -8,13 +8,27 @@ export class WmcpError extends Error {
         this.name = 'WmcpError';
     }
 }
-/** Thrown when a required capability is not bound by the host */
+/** Thrown when a required capability or requirement is not bound at bind time */
 export class WmcpBindError extends WmcpError {
     capability;
-    constructor(capability) {
-        super(`Missing handler for required capability: "${capability}"`);
+    side;
+    constructor(capability, side = 'host') {
+        const label = side === 'host'
+            ? `Missing host handler for required host:requires "${capability}"`
+            : `Module did not register a handler for declared module:capabilities "${capability}"`;
+        super(label);
         this.name = 'WmcpBindError';
         this.capability = capability;
+        this.side = side;
+    }
+}
+/** Thrown when the host attempts to override a capability not declared in module:capabilities */
+export class WmcpOverrideError extends WmcpError {
+    capability;
+    constructor(capability) {
+        super(`Cannot override "${capability}": not declared in module:capabilities`);
+        this.name = 'WmcpOverrideError';
+        this.capability = capability;
     }
 }
 /** Thrown when an HTTP-backed capability call fails */

package/dist/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,UAAU,CAAS;IAEnC,YAAY,UAAkB;QAC5B,KAAK,CAAC,6CAA6C,UAAU,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzB,MAAM,CAAS;IACf,IAAI,CAAS;IAE7B,YAAY,MAAc,EAAE,IAAY;QACtC,KAAK,CAAC,aAAa,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChC,KAAK,CAAS;IAE9B,YAAY,KAAa,EAAE,OAAe;QACxC,KAAK,CAAC,wBAAwB,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,UAAU,CAAS;IACnB,IAAI,CAAoB;IAExC,YAAY,UAAkB,EAAE,OAA0B,MAAM;QAC9D,MAAM,KAAK,GACT,IAAI,KAAK,MAAM;YACb,CAAC,CAAC,oDAAoD,UAAU,GAAG;YACnE,CAAC,CAAC,uEAAuE,UAAU,GAAG,CAAC;QAC3F,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,iGAAiG;AACjG,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9B,UAAU,CAAS;IAEnC,YAAY,UAAkB;QAC5B,KAAK,CACH,oBAAoB,UAAU,wCAAwC,CACvE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzB,MAAM,CAAS;IACf,IAAI,CAAS;IAE7B,YAAY,MAAc,EAAE,IAAY;QACtC,KAAK,CAAC,aAAa,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChC,KAAK,CAAS;IAE9B,YAAY,KAAa,EAAE,OAAe;QACxC,KAAK,CAAC,wBAAwB,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/core/host.d.ts

@@ -1,49 +1,51 @@
 /**
  * wMCP — Web Module Connection Protocol
- * WmcpHost — used inside the host application to bind capabilities and subscribe to events.
+ * WmcpHost — used by the host application.
+ *
+ * The host binds host:requires handlers (things the module needs), can call
+ * module:capabilities, override them with super() access, subscribe to
+ * module:events, and emit module:listeners events.
  */
-import type { WmcpHostConfig, CapabilityBinding, CapabilityHandler, EventCallback } from './types.js';
+import type { WmcpHostConfig, CapabilityBinding, CapabilityHandler, OverrideHandler, EventCallback } from './types.js';
 import { WmcpClient } from './client.js';
 export declare class WmcpHost {
     private client;
     private config;
     private fetchFn;
     private unsubscribes;
-    constructor(client: WmcpClient, config: WmcpHostConfig);
+    private pendingOverrides;
+    constructor(client: WmcpClient, config?: WmcpHostConfig);
     /**
-     * Binds capability implementations to the client.
+     * Bind host:requires implementations.
      *
      * Each entry can be either:
-     * - A CapabilityAdapter object (CSR): resolved to HTTP fetch through the proxy
-     * - A CapabilityHandler function (SSR): called directly (e.g. Next.js server action with 'use server')
-     *
-     * This allows mixing CSR and SSR bindings per capability in a single call:
-     *
-     * ```ts
-     * host.connect({
-     *   'counter:get': getCounterServerAction,          // SSR — direct function
-     *   'counter:increment': {                           // CSR — HTTP adapter
-     *     resolve: (p) => ({ method: 'POST', path: '/counter/increment', body: p }),
-     *   },
-     * });
-     * ```
+     * - A CapabilityAdapter object (CSR): resolved to HTTP fetch against a
+     *   same-origin proxy — credentials are injected server-side by the proxy,
+     *   NOT in browser code.
+     * - A CapabilityHandler function (SSR): called directly on the server.
      */
     connect(bindings: Record<string, CapabilityBinding>): void;
     /**
-     * Convenience: bind all handlers as direct functions (bypass HTTP adapter layer).
-     * Useful for in-memory / mock integrations where every capability is a function.
+     * Convenience: bind all host:requires as direct functions.
      */
     connectDirect(handlers: Record<string, CapabilityHandler>): void;
+    /** Call a module:capabilities entry (respects override chain). */
+    call<T = unknown>(capability: string, params?: Record<string, unknown>): Promise<T>;
+    /** Stream a module:capabilities entry. */
+    stream<T = unknown>(capability: string, params?: Record<string, unknown>): AsyncGenerator<T>;
     /**
-     * Subscribe to an event emitted by the sub-module.
-     * Returns an unsubscribe function.
+     * Override a module capability.  The handler receives (params, superFn)
+     * where superFn is the module's default implementation.
+     *
+     * Must be called before connect()/connectDirect().
      */
+    override(capability: string, handler: OverrideHandler): void;
+    /** Subscribe to an event emitted by the module. Returns an unsubscribe function. */
     on(event: string, callback: EventCallback): () => void;
-    /**
-     * Cleans up all event subscriptions.
-     */
+    /** Emit an event to the module (module:listeners). */
+    emit(event: string, data: unknown): void;
     destroy(): void;
     private resolveHeaders;
-    private createHandler;
+    private createHttpHandler;
 }
 //# sourceMappingURL=host.d.ts.map

package/dist/core/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/core/host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,iBAAiB,EAEjB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAyB;gBAEjC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc;IAMtD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAc1D;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAIhE;;;OAGG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAMtD;;OAEG;IACH,OAAO,IAAI,IAAI;YAOD,cAAc;YAQd,aAAa;CA8C5B"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/core/host.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAEf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,gBAAgB,CAAyD;gBAErE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAE,cAAmB;IAU3D;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAmB1D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAahE,kEAAkE;IAC5D,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC;IAIb,0CAA0C;IACnC,MAAM,CAAC,CAAC,GAAG,OAAO,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,cAAc,CAAC,CAAC,CAAC;IAQpB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAY5D,oFAAoF;IACpF,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAUtD,sDAAsD;IACtD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAQxC,OAAO,IAAI,IAAI;YAWD,cAAc;YAQd,iBAAiB;CA8ChC"}

package/dist/core/host.js

@@ -1,36 +1,35 @@
 /**
  * wMCP — Web Module Connection Protocol
- * WmcpHost — used inside the host application to bind capabilities and subscribe to events.
+ * WmcpHost — used by the host application.
+ *
+ * The host binds host:requires handlers (things the module needs), can call
+ * module:capabilities, override them with super() access, subscribe to
+ * module:events, and emit module:listeners events.
  */
-import { WmcpApiError } from './errors.js';
+import { WmcpApiError, WmcpOverrideError } from './errors.js';
 import { parseSSE } from '../utils/stream.js';
 export class WmcpHost {
     client;
     config;
     fetchFn;
     unsubscribes = [];
-    constructor(client, config) {
+    pendingOverrides = [];
+    constructor(client, config = {}) {
         this.client = client;
         this.config = config;
         this.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
     }
+    // ------------------------------------------------------------------
+    // Bind host:requires handlers
+    // ------------------------------------------------------------------
     /**
-     * Binds capability implementations to the client.
+     * Bind host:requires implementations.
      *
      * Each entry can be either:
-     * - A CapabilityAdapter object (CSR): resolved to HTTP fetch through the proxy
-     * - A CapabilityHandler function (SSR): called directly (e.g. Next.js server action with 'use server')
-     *
-     * This allows mixing CSR and SSR bindings per capability in a single call:
-     *
-     * ```ts
-     * host.connect({
-     *   'counter:get': getCounterServerAction,          // SSR — direct function
-     *   'counter:increment': {                           // CSR — HTTP adapter
-     *     resolve: (p) => ({ method: 'POST', path: '/counter/increment', body: p }),
-     *   },
-     * });
-     * ```
+     * - A CapabilityAdapter object (CSR): resolved to HTTP fetch against a
+     *   same-origin proxy — credentials are injected server-side by the proxy,
+     *   NOT in browser code.
+     * - A CapabilityHandler function (SSR): called directly on the server.
      */
     connect(bindings) {
         const handlers = {};
@@ -39,36 +38,80 @@ export class WmcpHost {
                 handlers[capability] = binding;
             }
             else {
-                handlers[capability] = (params) => this.createHandler(binding, params);
+                handlers[capability] = (params) => this.createHttpHandler(binding, params);
             }
         }
-        this.client._bind(handlers);
+        for (const ov of this.pendingOverrides) {
+            this.client._override(ov.name, ov.handler);
+        }
+        this.pendingOverrides = [];
+        this.client._bindRequires(handlers);
     }
     /**
-     * Convenience: bind all handlers as direct functions (bypass HTTP adapter layer).
-     * Useful for in-memory / mock integrations where every capability is a function.
+     * Convenience: bind all host:requires as direct functions.
      */
     connectDirect(handlers) {
-        this.client._bind(handlers);
+        for (const ov of this.pendingOverrides) {
+            this.client._override(ov.name, ov.handler);
+        }
+        this.pendingOverrides = [];
+        this.client._bindRequires(handlers);
+    }
+    // ------------------------------------------------------------------
+    // Call module:capabilities
+    // ------------------------------------------------------------------
+    /** Call a module:capabilities entry (respects override chain). */
+    async call(capability, params = {}) {
+        return this.client.call(capability, params);
+    }
+    /** Stream a module:capabilities entry. */
+    async *stream(capability, params = {}) {
+        yield* this.client.stream(capability, params);
     }
+    // ------------------------------------------------------------------
+    // Override module:capabilities
+    // ------------------------------------------------------------------
     /**
-     * Subscribe to an event emitted by the sub-module.
-     * Returns an unsubscribe function.
+     * Override a module capability.  The handler receives (params, superFn)
+     * where superFn is the module's default implementation.
+     *
+     * Must be called before connect()/connectDirect().
      */
+    override(capability, handler) {
+        const caps = this.client.manifest['module:capabilities'];
+        if (!caps[capability]) {
+            throw new WmcpOverrideError(capability);
+        }
+        this.pendingOverrides.push({ name: capability, handler });
+    }
+    // ------------------------------------------------------------------
+    // Events: module:events (host listens)
+    // ------------------------------------------------------------------
+    /** Subscribe to an event emitted by the module. Returns an unsubscribe function. */
     on(event, callback) {
         const unsub = this.client._on(event, callback);
         this.unsubscribes.push(unsub);
         return unsub;
     }
-    /**
-     * Cleans up all event subscriptions.
-     */
+    // ------------------------------------------------------------------
+    // Events: module:listeners (host emits)
+    // ------------------------------------------------------------------
+    /** Emit an event to the module (module:listeners). */
+    emit(event, data) {
+        this.client._emitToModule(event, data);
+    }
+    // ------------------------------------------------------------------
+    // Lifecycle
+    // ------------------------------------------------------------------
     destroy() {
         for (const unsub of this.unsubscribes) {
             unsub();
         }
         this.unsubscribes = [];
     }
+    // ------------------------------------------------------------------
+    // HTTP adapter internals (for host:requires with CapabilityAdapter)
+    // ------------------------------------------------------------------
     async resolveHeaders(provider) {
         if (!provider)
             return {};
@@ -77,9 +120,9 @@ export class WmcpHost {
         }
         return provider;
     }
-    async createHandler(adapter, params) {
+    async createHttpHandler(adapter, params) {
         const { method, path, body, query } = adapter.resolve(params);
-        let url = `${this.config.baseUrl}${path}`;
+        let url = `${this.config.baseUrl ?? ''}${path}`;
         if (query) {
             const qs = new URLSearchParams(query).toString();
             if (qs)

package/dist/core/host.js.map

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

package/dist/core/index.d.ts

@@ -5,7 +5,7 @@
 export { WmcpClient } from './client.js';
 export { WmcpHost } from './host.js';
 export { validateManifest, validateParams } from './validator.js';
-export { WmcpError, WmcpBindError, WmcpApiError, WmcpValidationError, } from './errors.js';
+export { WmcpError, WmcpBindError, WmcpOverrideError, WmcpApiError, WmcpValidationError, } from './errors.js';
 export { parseSSE, isAsyncIterable } from '../utils/stream.js';
-export type { WmcpManifest, WmcpModuleInfo, WmcpMountConfig, WmcpCapability, WmcpParamDef, WmcpTypeDef, WmcpHint, WmcpEvent, WmcpConfigParam, CapabilityHandler, CapabilityAdapter, CapabilityBinding, HeadersProvider, WmcpHostConfig, WmcpMountOptions, EventCallback, } from './types.js';
+export type { WmcpManifest, WmcpModuleInfo, WmcpMountConfig, WmcpCapability, WmcpParamDef, WmcpTypeDef, WmcpHint, WmcpEvent, WmcpConfigParam, CapabilityHandler, OverrideHandler, CapabilityAdapter, CapabilityBinding, HeadersProvider, WmcpHostConfig, WmcpMountOptions, EventCallback, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -5,6 +5,6 @@
 export { WmcpClient } from './client.js';
 export { WmcpHost } from './host.js';
 export { validateManifest, validateParams } from './validator.js';
-export { WmcpError, WmcpBindError, WmcpApiError, WmcpValidationError, } from './errors.js';
+export { WmcpError, WmcpBindError, WmcpOverrideError, WmcpApiError, WmcpValidationError, } from './errors.js';
 export { parseSSE, isAsyncIterable } from '../utils/stream.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/types.d.ts

@@ -9,12 +9,16 @@ export interface WmcpManifest {
     module: WmcpModuleInfo;
     /** How the module mounts into the DOM */
     mount: WmcpMountConfig;
-    /** Capabilities the module requires from the host */
-    capabilities: Record<string, WmcpCapability>;
+    /** Capabilities the module provides (callable and overridable by the host) */
+    'module:capabilities': Record<string, WmcpCapability>;
     /** Events the module emits to the host */
-    events?: Record<string, WmcpEvent>;
-    /** Configuration the module accepts at mount time */
-    config?: Record<string, WmcpConfigParam>;
+    'module:events'?: Record<string, WmcpEvent>;
+    /** Events the module listens for from the host */
+    'module:listeners'?: Record<string, WmcpEvent>;
+    /** Capabilities the module requires from the host */
+    'host:requires'?: Record<string, WmcpCapability>;
+    /** Configuration the host supplies at mount time */
+    'host:config'?: Record<string, WmcpConfigParam>;
 }
 export interface WmcpModuleInfo {
     /** Package name (e.g. "@aurorah/wmcp-rich-editor") */
@@ -43,7 +47,7 @@ export interface WmcpCapability {
     params?: Record<string, WmcpParamDef>;
     /** Return type definition */
     returns?: WmcpTypeDef;
-    /** Hint for host adapter generation: suggested HTTP method + path template */
+    /** Advisory HTTP mapping hint (primarily useful on host:requires entries) */
     hint?: WmcpHint;
 }
 export interface WmcpParamDef {
@@ -73,11 +77,18 @@ export interface WmcpConfigParam {
     enum?: unknown[];
     description?: string;
 }
-/** Handler function the host provides for a capability */
+/** Handler function for a capability (module default or host:requires implementation) */
 export type CapabilityHandler = (params: Record<string, unknown>) => Promise<unknown> | AsyncIterable<unknown>;
+/**
+ * Override handler the host provides to replace a module capability.
+ * Receives the invocation params and a reference to the module's default
+ * implementation (superFn) so the host can wrap, extend, or fully replace
+ * the behaviour while retaining access to the original.
+ */
+export type OverrideHandler = (params: Record<string, unknown>, superFn: CapabilityHandler) => Promise<unknown> | AsyncIterable<unknown>;
 /** Callback for event subscriptions */
 export type EventCallback = (data: unknown) => void;
-/** Adapter definition used by WmcpHost to map capabilities to HTTP endpoints (CSR) */
+/** Adapter definition used by WmcpHost to map host:requires to HTTP endpoints (CSR) */
 export interface CapabilityAdapter {
     /** Resolves params into an HTTP request shape */
     resolve: (params: Record<string, unknown>) => {
@@ -90,23 +101,25 @@ export interface CapabilityAdapter {
     stream?: boolean;
 }
 /**
- * A capability binding can be either:
+ * A host:requires binding can be either:
  * - A CapabilityAdapter object (CSR: resolved to HTTP fetch through proxy)
  * - A CapabilityHandler function (SSR: direct server action or in-memory handler)
- *
- * This allows mixing CSR and SSR bindings per capability in a single connect() call.
  */
 export type CapabilityBinding = CapabilityAdapter | CapabilityHandler;
 /** Static headers or a sync/async function that returns headers per request */
 export type HeadersProvider = Record<string, string> | (() => Record<string, string>) | (() => Promise<Record<string, string>>);
 /** Configuration for WmcpHost */
 export interface WmcpHostConfig {
-    /** Base URL for API requests (e.g. "/api/v1" or "http://localhost:8000/api/v1") */
-    baseUrl: string;
+    /** Base URL for HTTP-backed host:requires requests (typically a same-origin proxy) */
+    baseUrl?: string;
     /**
-     * Headers to inject into HTTP-backed capability requests.
-     * Can be a static object or a sync/async function for per-request headers
-     * (e.g. reading API keys from env, session cookies, or token refresh).
+     * Headers to inject into HTTP-backed host:requires requests.
+     * Can be a static object or a sync/async function for per-request headers.
+     *
+     * IMPORTANT: This is intended for SSR / server-side proxy contexts where
+     * credentials stay on the server. In browser (CSR) code, use a same-origin
+     * proxy route instead — the proxy injects auth server-side so secrets never
+     * reach the client.
      */
     headers?: HeadersProvider;
     /** Custom fetch implementation (defaults to globalThis.fetch) */

package/dist/core/types.d.ts.map

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

package/dist/core/validator.d.ts

@@ -6,7 +6,6 @@ import type { WmcpManifest, WmcpCapability } from './types.js';
 export declare function validateManifest(manifest: unknown): asserts manifest is WmcpManifest;
 /**
  * Validates params against a capability's param definitions.
- * Checks that all required params are present and have correct types.
  */
 export declare function validateParams(capabilityName: string, capability: WmcpCapability, params: Record<string, unknown>): void;
 //# sourceMappingURL=validator.d.ts.map

package/dist/core/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK/D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,YAAY,CAwCpF;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAiCN"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK/D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,YAAY,CA0EpF;AAkCD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAiCN"}

package/dist/core/validator.js

@@ -29,28 +29,71 @@ export function validateManifest(manifest) {
     if (typeof mount.entry !== 'string' || !mount.entry) {
         throw new WmcpValidationError('mount.entry', 'Must be a non-empty string');
     }
-    if (!m.capabilities || typeof m.capabilities !== 'object') {
-        throw new WmcpValidationError('capabilities', 'Must be an object');
+    // module:capabilities (REQUIRED)
+    const caps = m['module:capabilities'];
+    if (!caps || typeof caps !== 'object') {
+        throw new WmcpValidationError('module:capabilities', 'Must be an object');
     }
-    for (const [name, cap] of Object.entries(m.capabilities)) {
-        validateCapability(name, cap);
+    for (const [name, cap] of Object.entries(caps)) {
+        validateCapability(`module:capabilities.${name}`, cap);
+    }
+    // host:requires (OPTIONAL)
+    const requires = m['host:requires'];
+    if (requires !== undefined) {
+        if (typeof requires !== 'object' || requires === null) {
+            throw new WmcpValidationError('host:requires', 'Must be an object');
+        }
+        for (const [name, cap] of Object.entries(requires)) {
+            validateCapability(`host:requires.${name}`, cap);
+        }
+    }
+    // module:events (OPTIONAL)
+    const events = m['module:events'];
+    if (events !== undefined) {
+        if (typeof events !== 'object' || events === null) {
+            throw new WmcpValidationError('module:events', 'Must be an object');
+        }
+        for (const [name, ev] of Object.entries(events)) {
+            validateEvent(`module:events.${name}`, ev);
+        }
+    }
+    // module:listeners (OPTIONAL)
+    const listeners = m['module:listeners'];
+    if (listeners !== undefined) {
+        if (typeof listeners !== 'object' || listeners === null) {
+            throw new WmcpValidationError('module:listeners', 'Must be an object');
+        }
+        for (const [name, ev] of Object.entries(listeners)) {
+            validateEvent(`module:listeners.${name}`, ev);
+        }
     }
 }
-function validateCapability(name, cap) {
+function validateCapability(path, cap) {
     if (!cap || typeof cap !== 'object') {
-        throw new WmcpValidationError(`capabilities.${name}`, 'Must be an object');
+        throw new WmcpValidationError(path, 'Must be an object');
     }
     const c = cap;
     if (typeof c.description !== 'string') {
-        throw new WmcpValidationError(`capabilities.${name}.description`, 'Must be a string');
+        throw new WmcpValidationError(`${path}.description`, 'Must be a string');
     }
     if (c.mode !== 'request' && c.mode !== 'stream') {
-        throw new WmcpValidationError(`capabilities.${name}.mode`, 'Must be "request" or "stream"');
+        throw new WmcpValidationError(`${path}.mode`, 'Must be "request" or "stream"');
+    }
+}
+function validateEvent(path, ev) {
+    if (!ev || typeof ev !== 'object') {
+        throw new WmcpValidationError(path, 'Must be an object');
+    }
+    const e = ev;
+    if (typeof e.description !== 'string') {
+        throw new WmcpValidationError(`${path}.description`, 'Must be a string');
+    }
+    if (e.data !== undefined && (typeof e.data !== 'object' || e.data === null)) {
+        throw new WmcpValidationError(`${path}.data`, 'Must be an object');
     }
 }
 /**
  * Validates params against a capability's param definitions.
- * Checks that all required params are present and have correct types.
  */
 export function validateParams(capabilityName, capability, params) {
     if (!capability.params)

package/dist/core/validator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurorah/wmcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Web Module Connection Protocol (wMCP) — a standardized protocol for connecting encapsulated web UI modules to host applications",
   "type": "module",
   "main": "./dist/core/index.js",
@@ -32,8 +32,22 @@
     "type": "git",
     "url": "https://github.com/z-order/wmcp.git"
   },
+  "homepage": "https://github.com/z-order/wmcp#readme",
+  "ai": {
+    "important": "Before using this package, AI agents MUST read ALL documentation files listed below to fully understand the wMCP protocol, its manifest structure, capability/requirement contracts, and integration patterns.",
+    "docs": [
+      "https://github.com/z-order/wmcp/blob/main/docs/%5B1%5D-CONCEPTS.md",
+      "https://github.com/z-order/wmcp/blob/main/docs/%5B2%5D-COMPARISON-MCP.md",
+      "https://github.com/z-order/wmcp/blob/main/docs/%5B3%5D-COMPARISON-CLASS.md",
+      "https://github.com/z-order/wmcp/blob/main/docs/%5B4%5D-GETTING-STARTED.md",
+      "https://github.com/z-order/wmcp/blob/main/docs/%5B5%5D-SPECIFICATION.md"
+    ],
+    "examples": "https://github.com/z-order/wmcp/tree/main/examples",
+    "demo": "https://github.com/z-order/wmcp/tree/main/demo/nextjs"
+  },
   "license": "MIT",
   "devDependencies": {
+    "@types/node": "^25.5.2",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   }