@procedures/mcp-dev-tools 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @procedures/mcp-dev-tools
 
+## 0.15.0
+
+### Patch Changes
+
+- Updated dependencies [c7198ca]
+  - @procedures/client@0.15.0
+  - @procedures/bundle-mcp@0.15.0
+  - @procedures/fs@0.15.0
+  - @procedures/mcp-server@0.15.0
+  - @procedures/compiler@0.15.0
+
+## 0.14.1
+
+### Patch Changes
+
+- a96c870: The MCP hosts run under `run()` of `@mark1russell7/service` (CLI-11, step 1).
+  
+  - `McpHost.declare(svc)` gives an MCP host to a service. The server of the host is a transport part, and each storage is a dependency. A host with a stdio face declares the trigger `stdin-close`. Then the runner starts the host and stops it in stages.
+  - `McpHost.handleHttp(req, res)` answers for the Streamable HTTP face with `mount: true`. Mount it on a listener, for example an `httpTransport` of `@mark1russell7/service/http`.
+  - `runDevToolsServer()` of `@procedures/mcp-dev-tools` runs the dev-tools server under `run()`. Over stdio, the profile is `ephemeral`, and the end of the input stops the server. With HTTP, the profile is `localDev`, and a listener of the service answers at `/mcp`. `dist/server.js` and `mark mcp` use it.
+  
+  PATCH: each change adds a function or an option, and the old ones still operate.
+  
+  Deprecated, and the next MINOR removes them (decision D13):
+  
+  - The listener of the Streamable HTTP face: the options `port`, `host` and `server` of `HttpTransportOptions`, and `McpHttpTransport.listen()`. Give `mount: true`, and mount `McpHost.handleHttp` on a listener of the service.
+  - `startDevToolsServer()` of `@procedures/mcp-dev-tools`. Use `runDevToolsServer()`.
+  
+  Migration for the next MINOR: the site uses none of them. MiniMongo uses none of them. Graph mounts `mcpFace()` on its host, and its stdio host keeps `createMcpHost()` with `stdio`: no change. jarvis uses `createMcpHost()` with stdio and SDK faces: no change. A host with `faces.http: { port }` moves to `faces.http: { mount: true }` and a listener of the service.
+- Updated dependencies [85999c1]
+- Updated dependencies [fc968f6]
+- Updated dependencies [dc7a462]
+- Updated dependencies [5efe2d2]
+- Updated dependencies [e091108]
+- Updated dependencies [073e4c3]
+- Updated dependencies [6969637]
+- Updated dependencies [a96c870]
+  - @procedures/mcp-server@0.14.1
+  - @procedures/client@0.14.1
+  - @procedures/compiler@0.14.1
+  - @procedures/bundle-mcp@0.14.1
+  - @procedures/fs@0.14.1
+
 ## 0.14.0
 
 ### Patch Changes

package/README.md

@@ -51,6 +51,12 @@ When the client closes the input of stdio, the server stops: the calls in flight
 
 `mark mcp` starts the same server. Its flags replace the variables: `--bundles`, `--tool-timeout`, `--read-only`, `--http`, `--host`, `--token` and `--fs-root`.
 
+The server operates under `run()` of `@mark1russell7/service` (CLI-11). The runner owns the signals, the stop in stages and the exit of the process.
+
+- Over stdio, the profile is `ephemeral`. When the client closes the input, the server stops in stages and the process exits with the code 0. A first Ctrl-C stops the work, and a second one exits at once.
+- Over Streamable HTTP, the profile is `localDev`. A listener of the service answers on the port, and the MCP endpoint is at `/mcp`.
+- In code, `runDevToolsServer(config)` starts the server under the runner and gives the host, the service, the lifecycle and the URL. `startDevToolsServer()` is deprecated, and the next MINOR removes it.
+
 The server serves no remote events (`documentation/EVENTS.md`). Its transport carries only MCP, and `events.subscribe` is not a tool. Thus the host has no variable for the topics.
 
 ## The root of the files