@firfi/huly-mcp 0.55.2 → 0.55.4

package/README.md

@@ -70,24 +70,15 @@ Exact native tool names still dispatch when a client calls them directly, but ma
 <details>
 <summary>Codex</summary>
 
-Use Codex's MCP manager:
+`npx` automatically downloads and caches Huly MCP; `pnpm dlx @firfi/huly-mcp@latest` is an alternative. Huly is optional, so Codex can start without it and a cold download may leave the first turn without Huly tools. Run `/mcp` to check the connection.
 
-```bash
-codex mcp add huly \
-  --env MCP_TRANSPORT=stdio-resident \
-  --env HULY_URL=https://your-huly-instance.example.com \
-  --env HULY_TOKEN=your-huly-api-token \
-  --env HULY_WORKSPACE=yourworkspace \
-  -- npx -y @firfi/huly-mcp@latest
-```
-
-Or add it directly to `~/.codex/config.toml`:
+Add to `~/.codex/config.toml` (the 120-second startup allowance includes installation):
 
 ```toml
 [mcp_servers.huly]
+startup_timeout_sec = 120
 command = "npx"
 args = ["-y", "@firfi/huly-mcp@latest"]
-startup_timeout_sec = 60
 
 [mcp_servers.huly.env]
 MCP_TRANSPORT = "stdio-resident"
@@ -229,10 +220,7 @@ the [production release guide](docs/NPM_PRODUCTION_RELEASE.md) for preflight che
 
 ## Shared resident stdio
 
-The setup examples explicitly select `MCP_TRANSPORT=stdio-resident`. MCP clients still use stdio, while compatible clients under the same OS user share a Node backend through small native bridges. Linux and macOS arm64/x64 binaries are included; no Rust installation is needed. Resident startup has a 30-second budget. If the native bridge cannot run or resident startup fails, the connection automatically falls back to ordinary stdio with its buffered MCP input preserved. This transition happens before any MCP request is sent to the resident. A failed active resident never reconnects or replays requests.
-
-Allow at least 60 seconds for MCP startup in the client so it can wait for the resident attempt, cleanup, and ordinary stdio startup. For Codex, set `startup_timeout_sec = 60` in its Huly server configuration, including when adding the server through `codex mcp add`.
-For Claude Code, set `MCP_TIMEOUT=60000` in the environment that launches `claude`, or add `"MCP_TIMEOUT": "60000"` under `env` in `~/.claude/settings.json` ([Claude Code environment variables](https://code.claude.com/docs/en/env-vars)). Setting it only in the Huly server's `env` does not increase the parent client's startup timeout.
+The setup examples explicitly select `MCP_TRANSPORT=stdio-resident`. MCP clients still use stdio, while compatible clients under the same OS user share a Node backend through small native bridges. Linux and macOS arm64/x64 binaries are included; no Rust installation is needed. Application requests remain buffered during the 30-second resident startup budget. Startup failure launches ordinary stdio and dispatches the buffered application input once. A failed active resident never reconnects or replays application requests.
 
 Omitting `MCP_TRANSPORT` still selects ordinary `stdio`, preserving existing installations. Set `MCP_TRANSPORT=stdio` explicitly to keep a separate backend per client. Restart the MCP client after changing the setting.
 

package/dist/application.cjs

@@ -54789,7 +54789,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.55.2" : "0.0.0-dev";
+    VERSION = true ? "0.55.4" : "0.0.0-dev";
   }
 });
 
@@ -222479,7 +222479,7 @@ var init_server_startup = __esm({
       const configuration = yield* Effect_exports.result(resolveProcessConfiguration(transport, environment, captured));
       if (Result_exports.isFailure(configuration)) {
         if (transport === "stdio" && configuration.failure._tag === "CliProfileStoreError")
-          return yield* runProfileStartupDiagnostic(configuration.failure, "0.55.2");
+          return yield* runProfileStartupDiagnostic(configuration.failure, "0.55.4");
         return yield* Effect_exports.fail(configuration.failure);
       }
       const { authMethod, configLayer, runtimeConfigContext } = configuration.success;
@@ -222829,7 +222829,7 @@ var init_native_exec = __esm({
         const { main: local2 } = yield* Effect_exports.promise(() => Promise.resolve().then(() => (init_server_startup(), server_startup_exports)));
         return yield* local2;
       }).pipe(
-        Effect_exports.catchTag("CliProfileStoreError", (error3) => runProfileStartupDiagnostic(error3, "0.55.2")),
+        Effect_exports.catchTag("CliProfileStoreError", (error3) => runProfileStartupDiagnostic(error3, "0.55.4")),
         Effect_exports.provide(layer7),
         Effect_exports.tapError(
           (error3) => Effect_exports.sync(
@@ -223199,7 +223199,7 @@ ${hello}
       Effect_exports.catchTag(
         "CliProfileStoreError",
         (error3) => publish4(`${NATIVE_LOCAL_HEADER}
-`).pipe(Effect_exports.andThen(runProfileStartupDiagnostic(error3, "0.55.2")))
+`).pipe(Effect_exports.andThen(runProfileStartupDiagnostic(error3, "0.55.4")))
       ),
       Effect_exports.mapError(
         (error3) => error3 instanceof ConfigValidationError || error3 instanceof McpProcessPolicyError || error3 instanceof ManagedLaunchError || error3 instanceof ProtectedFileError || error3 instanceof BackendResponseError ? error3 : nativeBridgeFailure()
@@ -223234,7 +223234,7 @@ var init_manual_adapter_main = __esm({
         const captured = yield* captureManualResidentSelection(environment);
         yield* runManualAdapter(captured?.selection);
       }).pipe(
-        Effect_exports.catchTag("CliProfileStoreError", (error3) => runProfileStartupDiagnostic(error3, "0.55.2")),
+        Effect_exports.catchTag("CliProfileStoreError", (error3) => runProfileStartupDiagnostic(error3, "0.55.4")),
         Effect_exports.provide(layer7),
         Effect_exports.mapError(
           (error3) => error3 instanceof BackendResponseError || error3 instanceof CliProfileStoreError || error3 instanceof ConfigValidationError || error3 instanceof McpProcessPolicyError || error3 instanceof ProtectedFileError ? error3 : new BackendResponseError({
@@ -223336,7 +223336,7 @@ if (unsupportedRuntime) {
     detectedNodeVersion: process.versions.node,
     executable: process.execPath,
     requiredNodeVersion: nodeEngineRequirement,
-    serverVersion: "0.55.2"
+    serverVersion: "0.55.4"
   });
   startUnsupportedNodeMcp(config);
 } else if (process.env.MCP_TRANSPORT === "resident-child") {

package/dist/index.cjs

@@ -37,7 +37,7 @@ var probeNativeExecutable = (executable) => {
 if (process.env.MCP_TRANSPORT === "stdio-resident") {
   const executable = nativeExecutableFor({ platform: process.platform, architecture: process.arch, packageFile: __filename, execveAvailable: typeof process.execve === "function" });
   if (executable !== void 0) {
-    process.execve(executable, [executable, process.execPath, __filename], { ...process.env, MCP_NATIVE_EXPECTED_VERSION: "0.55.2" });
+    process.execve(executable, [executable, process.execPath, __filename], { ...process.env, MCP_NATIVE_EXPECTED_VERSION: "0.55.4" });
   } else {
     process.stderr.write("Native resident bridge unavailable; starting ordinary stdio\n");
     process.env.MCP_TRANSPORT = "stdio";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firfi/huly-mcp",
-  "version": "0.55.2",
+  "version": "0.55.4",
   "description": "Huly MCP: feature-complete MCP server for Huly integration",
   "mcpName": "io.github.dearlordylord/huly-mcp",
   "type": "module",