@nextclaw/ncp-http-agent-server 0.2.0 → 0.3.0

package/README.md

@@ -16,6 +16,6 @@ pnpm -C packages/ncp-packages/nextclaw-ncp-http-agent-server build
 **Options:**
 - `agentClientEndpoint` — client endpoint to forward requests to (in-process adapter or remote HTTP client)
 - `streamProvider` (optional) — When set, `/stream` serves stored events instead of forwarding to the agent. Scenario: user reconnects after network drop and wants to continue watching the previous reply; with `streamProvider` we stream from persistence, without it we forward to the agent.
-- `basePath`, `requestTimeoutMs` — path and timeout
+- `basePath`, `requestTimeoutMs` — path and optional forward-stream timeout. By default no server-side timeout is applied; set a positive value only if you explicitly want the server to cut off long-running forward streams.
 
 For in-process agent (`NcpAgentServerEndpoint`), use `createAgentClientFromServer` from `@nextclaw/ncp-toolkit` to wrap it.

package/dist/index.d.ts

@@ -27,7 +27,11 @@ type NcpHttpAgentServerOptions = {
     /** Client endpoint to forward requests to (in-process adapter or remote HTTP client). */
     agentClientEndpoint: NcpAgentClientEndpoint;
     basePath?: string;
-    requestTimeoutMs?: number;
+    /**
+     * Optional forward-stream timeout in milliseconds.
+     * When omitted or set to a non-positive value, no server-side timeout is applied.
+     */
+    requestTimeoutMs?: number | null;
     /**
      * Optional. When set, `/stream` serves live session events from streamProvider instead of
      * forwarding to the agent.
@@ -49,7 +53,7 @@ type NcpHttpAgentHandlerOptions = {
      * See NcpHttpAgentStreamProvider for details.
      */
     streamProvider?: NcpHttpAgentStreamProvider;
-    timeoutMs: number;
+    timeoutMs: number | null;
 };
 
 /**

package/dist/index.js

@@ -3,7 +3,6 @@ import { NcpEventType } from "@nextclaw/ncp";
 
 // src/types.ts
 var DEFAULT_BASE_PATH = "/ncp/agent";
-var DEFAULT_REQUEST_TIMEOUT_MS = 12e4;
 
 // src/parsers.ts
 function normalizeBasePath(basePath) {
@@ -16,7 +15,10 @@ function normalizeBasePath(basePath) {
 }
 function sanitizeTimeout(timeoutMs) {
   if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs)) {
-    return DEFAULT_REQUEST_TIMEOUT_MS;
+    return null;
+  }
+  if (timeoutMs <= 0) {
+    return null;
   }
   return Math.max(1e3, Math.trunc(timeoutMs));
 }
@@ -296,10 +298,12 @@ async function* createForwardSseEvents(options) {
     queue.close();
   };
   requestSignal.addEventListener("abort", stop, { once: true });
-  timeoutId = setTimeout(() => {
-    push(toErrorFrame("TIMEOUT", "NCP HTTP stream timed out before terminal event."));
-    stop();
-  }, timeoutMs);
+  if (timeoutMs !== null) {
+    timeoutId = setTimeout(() => {
+      push(toErrorFrame("TIMEOUT", "NCP HTTP stream timed out before terminal event."));
+      stop();
+    }, timeoutMs);
+  }
   unsubscribe = endpoint.subscribe((event) => {
     if (!matchesScope(scope, event)) {
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-http-agent-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "description": "HTTP/SSE server transport adapter for NCP agent endpoints.",
   "type": "module",
@@ -16,7 +16,7 @@
   ],
   "dependencies": {
     "hono": "^4.9.8",
-    "@nextclaw/ncp": "0.2.0"
+    "@nextclaw/ncp": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",