@openclaw/proxyline 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 
-## Unreleased
+## 0.3.0 - 2026-05-15
+
+- Added branded Proxyline dispatcher detection, reusable active-runtime installs, scoped dynamic bypass registration, first-class undici dispatcher tuning options, and a side-effect-light dispatcher detection subpath.
+- Fixed async scoped bypass lifetimes, ambient runtime reuse compatibility checks, WebSocket surface matching, and zero-valued undici timeout handling.
+- Moved `undici` to a peer dependency so host applications share one global dispatcher runtime with Proxyline.
 
 ## 0.2.0 - 2026-05-14
 

package/LICENSE

@@ -1,5 +1,6 @@
 MIT License
 
+Copyright (c) 2026 OpenClaw Foundation
 Copyright (c) 2026 Jesse Merhi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/README.md

@@ -1,4 +1,4 @@
-# Proxyline
+# 🌐 Proxyline
 
 [![npm](https://img.shields.io/npm/v/%40openclaw%2Fproxyline.svg)](https://www.npmjs.com/package/@openclaw/proxyline)
 [![node](https://img.shields.io/node/v/%40openclaw%2Fproxyline.svg)](https://nodejs.org/)
@@ -17,9 +17,11 @@ Website: [proxyline.dev](https://proxyline.dev)
 - **Two modes.** `managed` forces traffic through a configured proxy and fails closed on bad config. `ambient` reads `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` / `NO_PROXY` for tooling that needs environment compatibility.
 - **Covers the surfaces that matter.** `http.request`, `http.get`, `https.request`, `https.get`, both global agents, the undici global dispatcher, and helpers for WebSocket agents and HTTP CONNECT sockets.
 - **Replaces caller agents.** In managed mode and active ambient mode, a per-request `http.Agent` passed by a library does not bypass the proxy. TLS options on the caller agent (`ca`, `cert`, `key`, `rejectUnauthorized`, …) are preserved so destination TLS still validates.
+- **Intentional bypasses only.** Managed mode can accept a `bypassPolicy` callback or scoped `registerBypass()` / `withBypass()` calls for trusted loopback or control-plane traffic that must stay direct; every bypass is visible through `explain()`.
+- **Embeddable runtime controls.** `ifActive` handles process singleton reuse/replacement, `undici` options tune dispatcher defaults, and `isProxylineDispatcher()` identifies Proxyline-owned dispatchers without constructor-name checks.
 - **Scoped proxy CA trust.** `proxyTls.ca` / `proxyTls.caFile` trust a private CA for the proxy endpoint only — no `NODE_EXTRA_CA_CERTS` and no `NODE_TLS_REJECT_UNAUTHORIZED=0`.
 - **Observable.** `proxy.explain(url)` returns a structured decision (`proxied` / `direct` with a `reason`), and an `onEvent` callback receives `runtime.installed`, `runtime.stopped`, and per-decision events. Proxy URLs are credential-redacted.
-- **Restoreable.** `proxy.stop()` restores the captured Node HTTP(S) methods, global agents, undici dispatcher, and fetch globals. The runtime is a process-wide singleton — a second install throws `RUNTIME_ALREADY_ACTIVE`.
+- **Restoreable.** `proxy.stop()` restores the captured Node HTTP(S) methods, global agents, undici dispatcher, and fetch globals. The runtime is a process-wide singleton; by default a second active install throws `RUNTIME_ALREADY_ACTIVE`, while `ifActive` can reuse or replace intentionally.
 
 ## Install
 
@@ -29,7 +31,7 @@ pnpm add @openclaw/proxyline
 npm install @openclaw/proxyline
 ```
 
-Requires Node 20.18.1+.
+Requires Node 20.18.1+ and a host `undici` dependency compatible with `>=7.25.0 <9`.
 
 ## Quick start
 

package/dist/dispatcher-brand.d.ts

@@ -0,0 +1,3 @@
+export declare const PROXYLINE_DISPATCHER_BRAND: unique symbol;
+export declare function isProxylineDispatcher(dispatcher: unknown): boolean;
+//# sourceMappingURL=dispatcher-brand.d.ts.map

package/dist/dispatcher-brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-brand.d.ts","sourceRoot":"","sources":["../src/dispatcher-brand.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B,eAA+C,CAAC;AAMvF,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAIlE"}

package/dist/dispatcher-brand.js

@@ -0,0 +1,6 @@
+export const PROXYLINE_DISPATCHER_BRAND = Symbol.for("@openclaw/proxyline.dispatcher");
+export function isProxylineDispatcher(dispatcher) {
+    return typeof dispatcher === "object" &&
+        dispatcher !== null &&
+        dispatcher[PROXYLINE_DISPATCHER_BRAND] === true;
+}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { openProxyConnectTunnel, type OpenProxyConnectTunnelOptions } from "./connect.js";
 export { createAmbientNodeProxyAgent, hasAmbientNodeProxyConfigured, type AmbientNodeProxyAgentOptions, } from "./node-http.js";
 export { installGlobalProxy, installProxyline } from "./runtime.js";
+export { isProxylineDispatcher, PROXYLINE_DISPATCHER_BRAND } from "./dispatcher-brand.js";
 export { ProxylineError, redactProxyUrl, resolveProxyTlsCa, type ProxylineTlsOptions, } from "./shared.js";
-export type { ExplainOptions, ProxylineBypassPolicy, ProxylineBypassRequest, ProxylineDecision, ProxylineEvent, ProxylineHandle, ProxylineMode, ProxylineOptions, ProxylineSurface, } from "./types.js";
+export type { ExplainOptions, ProxylineBypassRegistration, ProxylineBypassPolicy, ProxylineBypassRequest, ProxylineDecision, ProxylineEvent, ProxylineHandle, ProxylineMode, ProxylineOptions, ProxylineSurface, ProxylineUndiciOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { openProxyConnectTunnel } from "./connect.js";
 export { createAmbientNodeProxyAgent, hasAmbientNodeProxyConfigured, } from "./node-http.js";
 export { installGlobalProxy, installProxyline } from "./runtime.js";
+export { isProxylineDispatcher, PROXYLINE_DISPATCHER_BRAND } from "./dispatcher-brand.js";
 export { ProxylineError, redactProxyUrl, resolveProxyTlsCa, } from "./shared.js";

package/dist/node-http.d.ts

@@ -2,7 +2,7 @@ import http from "node:http";
 import https from "node:https";
 import { type ProxyEnvSnapshot } from "./env.js";
 import { type ProxylineTlsOptions } from "./shared.js";
-import type { ProxyResolver } from "./types.js";
+import type { ProxylineSurface, ProxyResolver } from "./types.js";
 export type NodeHttpRequestOptions = http.RequestOptions & https.RequestOptions & {
     agent?: http.Agent | false;
 };
@@ -14,7 +14,7 @@ type NodeAgentRequestOptions = http.RequestOptions & https.RequestOptions & {
 };
 type NodeProxyAgentOptions = NodeAgentOptions & {
     defaultProtocol?: "http" | "https";
-    getProxyForUrl: (url: string, request?: http.ClientRequest) => string;
+    getProxyForUrl: (url: string, surface?: ProxylineSurface, request?: http.ClientRequest) => string;
     proxyTls?: ProxylineTlsOptions;
 };
 export declare const CALLER_AGENT_TLS_OPTION_KEYS: readonly ["ca", "cert", "ciphers", "clientCertEngine", "crl", "dhparam", "ecdhCurve", "honorCipherOrder", "key", "maxVersion", "minVersion", "passphrase", "pfx", "rejectUnauthorized", "secureOptions", "secureProtocol", "sessionIdContext"];

package/dist/node-http.d.ts.map

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

package/dist/node-http.js

@@ -227,6 +227,12 @@ function isSecureEndpoint(options, stackProtocol) {
 function shouldTunnelRequest(req, options, stackProtocol) {
     return isSecureEndpoint(options, stackProtocol) || isWebSocketRequest(req);
 }
+function requestSurface(req, options, stackProtocol) {
+    if (isWebSocketRequest(req)) {
+        return "websocket";
+    }
+    return isSecureEndpoint(options, stackProtocol) ? "node-https" : "node-http";
+}
 function splitHostPort(value) {
     const bracketed = value.match(/^\[([^\]]+)\](?::(\d+))?$/);
     if (bracketed) {
@@ -595,7 +601,7 @@ export class ProxylineNodeProxyAgent extends http.Agent {
         // Node's http.Agent constructor assigns this, but this wrapper is dual-use.
     }
     getProxyForUrl(url, request) {
-        return this.#getProxyForUrl(url, request);
+        return this.#getProxyForUrl(url, undefined, request);
     }
     #callStackProtocol() {
         const originalStackTraceLimit = Error.stackTraceLimit;
@@ -638,7 +644,8 @@ export class ProxylineNodeProxyAgent extends http.Agent {
             ? { ...options, secureEndpoint: true }
             : options;
         const url = requestDestinationUrl(req, agentOptions, stackProtocol);
-        const proxy = this.#getProxyForUrl(url, req);
+        const surface = requestSurface(req, agentOptions, stackProtocol);
+        const proxy = this.#getProxyForUrl(url, surface, req);
         if (!proxy) {
             (isSecureEndpoint(agentOptions, stackProtocol) ? this.#httpsAgent : this.#httpAgent)
                 .addRequest(req, agentOptions);

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAGV,eAAe,EACf,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AA6kBpB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAqF3E;AAED,eAAO,MAAM,kBAAkB,yBAAmB,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAIV,eAAe,EACf,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AA4sBpB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAyI3E;AAED,eAAO,MAAM,kBAAkB,yBAAmB,CAAC"}

package/dist/runtime.js

@@ -4,7 +4,9 @@ import { Agent as UndiciAgent, Dispatcher, FormData as UndiciFormData, Headers a
 import { createAmbientProxyResolver, EMPTY_PROXY_ENV, resolveAmbientProxyForUrl, readProxyEnv, } from "./env.js";
 import { bindNodeHttpMethod, createDirectNodeAgent, createNodeProxyAgent, } from "./node-http.js";
 import { formatUrl, ProxylineError, redactProxyUrl, resolveProxyTlsCa, } from "./shared.js";
+import { PROXYLINE_DISPATCHER_BRAND } from "./dispatcher-brand.js";
 let activeRuntime;
+let activeHandle;
 // Node's global fetch types come from bundled undici-types, while the runtime
 // implementation intentionally delegates to this package's undici dependency.
 const proxylineHeaders = UndiciHeaders;
@@ -140,13 +142,47 @@ function isProxyableUrlProtocol(protocol) {
         protocol === "ws:" ||
         protocol === "wss:";
 }
-function shouldBypassManagedProxy(bypassPolicy, url, surface) {
+function shouldBypassManagedProxy(bypassPolicy, bypasses, url, surface) {
+    if (bypasses.has(url, surface)) {
+        return true;
+    }
     if (bypassPolicy === undefined) {
         return false;
     }
     return bypassPolicy({ surface, url: formatUrl(url) });
 }
-function createManagedProxyResolver(proxyUrl, bypassPolicy) {
+function bypassKey(url, surface) {
+    return `${surface ?? "*"}\n${formatUrl(url)}`;
+}
+function createDynamicBypassRegistry() {
+    const counts = new Map();
+    return {
+        add: (registration) => {
+            const key = bypassKey(registration.url, registration.surface);
+            counts.set(key, (counts.get(key) ?? 0) + 1);
+            let stopped = false;
+            return () => {
+                if (stopped) {
+                    return;
+                }
+                stopped = true;
+                const next = (counts.get(key) ?? 1) - 1;
+                if (next <= 0) {
+                    counts.delete(key);
+                }
+                else {
+                    counts.set(key, next);
+                }
+            };
+        },
+        has: (url, surface) => (counts.get(bypassKey(url, surface)) ?? 0) > 0 ||
+            (counts.get(bypassKey(url, undefined)) ?? 0) > 0,
+    };
+}
+function proxyEnvSnapshotKey(env) {
+    return JSON.stringify(env ?? EMPTY_PROXY_ENV);
+}
+function createManagedProxyResolver(proxyUrl, bypassPolicy, bypasses) {
     const redactedProxyUrl = redactProxyUrl(proxyUrl);
     return {
         active: true,
@@ -161,7 +197,7 @@ function createManagedProxyResolver(proxyUrl, bypassPolicy) {
                     url: formattedUrl,
                 };
             }
-            if (shouldBypassManagedProxy(bypassPolicy, url, surface)) {
+            if (shouldBypassManagedProxy(bypassPolicy, bypasses, url, surface)) {
                 return {
                     kind: "direct",
                     reason: "managed-proxy-bypass-policy",
@@ -177,34 +213,79 @@ function createManagedProxyResolver(proxyUrl, bypassPolicy) {
                 proxyUrl: redactedProxyUrl,
             };
         },
-        getProxyForUrl: (url) => {
+        getProxyForUrl: (url, surface = "unknown") => {
             const protocol = new URL(url).protocol;
             return isProxyableUrlProtocol(protocol) &&
-                !shouldBypassManagedProxy(bypassPolicy, url, "unknown")
+                !shouldBypassManagedProxy(bypassPolicy, bypasses, url, surface)
                 ? proxyUrl.href
                 : "";
         },
     };
 }
-function createUndiciProxyDispatcher(options, proxyCa) {
+function finiteNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0
+        ? Math.floor(value)
+        : undefined;
+}
+function finitePositiveInteger(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0
+        ? Math.floor(value)
+        : undefined;
+}
+function resolveUndiciBaseOptions(options) {
+    const bodyTimeout = finiteNonNegativeInteger(options?.bodyTimeout);
+    const headersTimeout = finiteNonNegativeInteger(options?.headersTimeout);
+    return {
+        ...(options?.allowH2 !== undefined ? { allowH2: options.allowH2 } : {}),
+        ...(bodyTimeout !== undefined ? { bodyTimeout } : {}),
+        ...(headersTimeout !== undefined ? { headersTimeout } : {}),
+        ...(options?.connect !== undefined
+            ? {
+                connect: {
+                    ...(options.connect.autoSelectFamily !== undefined
+                        ? { autoSelectFamily: options.connect.autoSelectFamily }
+                        : {}),
+                    ...(finitePositiveInteger(options.connect.autoSelectFamilyAttemptTimeout) !== undefined
+                        ? {
+                            autoSelectFamilyAttemptTimeout: finitePositiveInteger(options.connect.autoSelectFamilyAttemptTimeout),
+                        }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+}
+function createUndiciAgent(options) {
+    return new UndiciAgent(resolveUndiciBaseOptions(options));
+}
+function createUndiciProxyAgent(proxyUrl, options) {
+    return new UndiciProxyAgent({
+        ...resolveUndiciBaseOptions(options.undici),
+        uri: proxyUrl,
+        ...(options.proxyCa !== undefined ? { proxyTls: { ca: options.proxyCa } } : {}),
+    });
+}
+function createUndiciProxyDispatcher(options, dispatcherOptions) {
     if (options.mode === "ambient") {
         if (!options.active) {
-            return new UndiciAgent();
+            return createUndiciAgent(dispatcherOptions.undici);
         }
-        return new AmbientUndiciDispatcher(options.env, proxyCa);
+        return new AmbientUndiciDispatcher(options.env, dispatcherOptions);
     }
-    return new ManagedUndiciDispatcher(options.resolver, proxyCa);
+    return new ManagedUndiciDispatcher(options.resolver, dispatcherOptions);
 }
 class ManagedUndiciDispatcher extends Dispatcher {
-    #directDispatcher = new UndiciAgent();
-    #proxyCa;
+    [PROXYLINE_DISPATCHER_BRAND] = true;
+    #directDispatcher;
+    #dispatcherOptions;
     #proxyDispatchers = new Map();
     #resolver;
     #closedError;
-    constructor(resolver, proxyCa) {
+    constructor(resolver, dispatcherOptions) {
         super();
         this.#resolver = resolver;
-        this.#proxyCa = proxyCa;
+        this.#dispatcherOptions = dispatcherOptions;
+        this.#directDispatcher = createUndiciAgent(dispatcherOptions.undici);
     }
     dispatch(options, handler) {
         if (this.#closedError !== undefined) {
@@ -215,7 +296,7 @@ class ManagedUndiciDispatcher extends Dispatcher {
             return false;
         }
         const url = resolveUndiciDispatchUrl(options);
-        const proxyUrl = url === undefined ? "" : this.#resolver.getProxyForUrl(url);
+        const proxyUrl = url === undefined ? "" : this.#resolver.getProxyForUrl(url, "undici");
         const dispatcher = proxyUrl === "" ? this.#directDispatcher : this.#proxyDispatcher(proxyUrl);
         return dispatcher.dispatch(options, handler);
     }
@@ -240,10 +321,7 @@ class ManagedUndiciDispatcher extends Dispatcher {
         if (existing !== undefined) {
             return existing;
         }
-        const dispatcher = new UndiciProxyAgent({
-            uri: proxyUrl,
-            ...(this.#proxyCa !== undefined ? { proxyTls: { ca: this.#proxyCa } } : {}),
-        });
+        const dispatcher = createUndiciProxyAgent(proxyUrl, this.#dispatcherOptions);
         this.#proxyDispatchers.set(proxyUrl, dispatcher);
         return dispatcher;
     }
@@ -267,15 +345,17 @@ class ManagedUndiciDispatcher extends Dispatcher {
     }
 }
 class AmbientUndiciDispatcher extends Dispatcher {
-    #directDispatcher = new UndiciAgent();
+    [PROXYLINE_DISPATCHER_BRAND] = true;
+    #directDispatcher;
+    #dispatcherOptions;
     #env;
-    #proxyCa;
     #proxyDispatchers = new Map();
     #closedError;
-    constructor(env, proxyCa) {
+    constructor(env, dispatcherOptions) {
         super();
         this.#env = env;
-        this.#proxyCa = proxyCa;
+        this.#dispatcherOptions = dispatcherOptions;
+        this.#directDispatcher = createUndiciAgent(dispatcherOptions.undici);
     }
     dispatch(options, handler) {
         if (this.#closedError !== undefined) {
@@ -311,10 +391,7 @@ class AmbientUndiciDispatcher extends Dispatcher {
         if (existing !== undefined) {
             return existing;
         }
-        const dispatcher = new UndiciProxyAgent({
-            uri: proxyUrl,
-            ...(this.#proxyCa !== undefined ? { proxyTls: { ca: this.#proxyCa } } : {}),
-        });
+        const dispatcher = createUndiciProxyAgent(proxyUrl, this.#dispatcherOptions);
         this.#proxyDispatchers.set(proxyUrl, dispatcher);
         return dispatcher;
     }
@@ -358,7 +435,7 @@ function restoreNodeHttpSnapshot(snapshot) {
     https.get = snapshot.httpsGet;
     https.globalAgent = snapshot.httpsGlobalAgent;
 }
-function installRuntime(resolver, dispatcherOptions, proxyCa) {
+function installRuntime(resolver, dispatcherOptions, proxyCa, options) {
     if (activeRuntime !== undefined) {
         throw new ProxylineError("RUNTIME_ALREADY_ACTIVE", "Proxyline already has an active runtime.");
     }
@@ -378,8 +455,13 @@ function installRuntime(resolver, dispatcherOptions, proxyCa) {
     const originalHeaders = globalThis.Headers;
     const originalRequest = globalThis.Request;
     const originalResponse = globalThis.Response;
-    const installedDispatcher = createUndiciProxyDispatcher(dispatcherOptions, proxyCa);
+    const installedDispatcher = createUndiciProxyDispatcher(dispatcherOptions, {
+        proxyCa,
+        undici: options.undici,
+    });
     const runtime = {
+        ambientEnv: options.ambientEnv,
+        bypassPolicy: options.bypassPolicy,
         installedDispatcher,
         mode: dispatcherOptions.mode,
         nodeHttpAgent,
@@ -390,7 +472,10 @@ function installRuntime(resolver, dispatcherOptions, proxyCa) {
         originalHeaders,
         originalRequest,
         originalResponse,
+        proxyCa,
+        proxyUrl: options.proxyUrl?.href,
         snapshot,
+        undiciOptions: options.undici,
     };
     activeRuntime = runtime;
     try {
@@ -438,24 +523,50 @@ function stopRuntime(runtime) {
     runtime.nodeHttpAgent.destroy();
     runtime.nodeHttpsAgent.destroy();
     activeRuntime = undefined;
+    activeHandle = undefined;
 }
 export function installProxyline(options) {
     const proxyUrl = options.mode === "managed" ? normalizeProxyUrl(options.proxyUrl) : undefined;
+    const ambientEnv = proxyUrl === undefined ? readProxyEnv() : undefined;
     if (options.mode === "managed" && proxyUrl === undefined) {
         throw new ProxylineError("MANAGED_PROXY_URL_REQUIRED", "Proxyline managed mode requires an explicit proxyUrl.");
     }
+    const activePolicy = options.ifActive ?? "error";
+    if (activeRuntime !== undefined) {
+        if (activePolicy === "replace") {
+            activeHandle?.stop();
+        }
+        else if (activePolicy === "reuse-compatible" &&
+            activeHandle !== undefined &&
+            activeRuntime.mode === options.mode &&
+            activeRuntime.proxyUrl === proxyUrl?.href &&
+            proxyEnvSnapshotKey(activeRuntime.ambientEnv) === proxyEnvSnapshotKey(ambientEnv) &&
+            activeRuntime.proxyCa === resolveProxyTlsCa(options.proxyTls) &&
+            activeRuntime.bypassPolicy === options.bypassPolicy &&
+            JSON.stringify(activeRuntime.undiciOptions ?? {}) === JSON.stringify(options.undici ?? {})) {
+            return activeHandle;
+        }
+        else {
+            throw new ProxylineError("RUNTIME_ALREADY_ACTIVE", "Proxyline already has an active runtime.");
+        }
+    }
     let stopped = false;
     const proxyCa = resolveProxyTlsCa(options.proxyTls);
-    const ambientEnv = proxyUrl === undefined ? readProxyEnv() : undefined;
+    const dynamicBypasses = createDynamicBypassRegistry();
     const resolver = proxyUrl !== undefined
-        ? createManagedProxyResolver(proxyUrl, options.bypassPolicy)
+        ? createManagedProxyResolver(proxyUrl, options.bypassPolicy, dynamicBypasses)
         : createAmbientProxyResolver(ambientEnv ?? EMPTY_PROXY_ENV);
     const redactedProxyUrl = resolver.describeProxy();
     const hasActiveProxy = resolver.active;
     const runtime = hasActiveProxy
         ? installRuntime(resolver, proxyUrl !== undefined
             ? { mode: "managed", resolver }
-            : { mode: "ambient", env: ambientEnv ?? EMPTY_PROXY_ENV, active: hasActiveProxy }, proxyCa)
+            : { mode: "ambient", env: ambientEnv ?? EMPTY_PROXY_ENV, active: hasActiveProxy }, proxyCa, {
+            ambientEnv,
+            bypassPolicy: options.bypassPolicy,
+            proxyUrl,
+            undici: options.undici,
+        })
         : undefined;
     emit(options.onEvent, {
         type: "runtime.installed",
@@ -474,10 +585,10 @@ export function installProxyline(options) {
             return createNodeProxyAgent(resolver, proxyCa);
         },
         createUndiciDispatcher: () => stopped
-            ? new UndiciAgent()
+            ? createUndiciAgent(options.undici)
             : createUndiciProxyDispatcher(proxyUrl !== undefined
                 ? { mode: "managed", resolver }
-                : { mode: "ambient", env: ambientEnv ?? EMPTY_PROXY_ENV, active: hasActiveProxy }, proxyCa),
+                : { mode: "ambient", env: ambientEnv ?? EMPTY_PROXY_ENV, active: hasActiveProxy }, { proxyCa, undici: options.undici }),
         createWebSocketAgent: () => {
             if (!hasActiveProxy || stopped) {
                 return createDirectNodeAgent();
@@ -496,6 +607,12 @@ export function installProxyline(options) {
             emit(options.onEvent, { type: "decision", decision });
             return decision;
         },
+        registerBypass: (registration) => {
+            if (stopped || proxyUrl === undefined) {
+                return () => { };
+            }
+            return dynamicBypasses.add(registration);
+        },
         stop: () => {
             if (stopped) {
                 return;
@@ -506,7 +623,29 @@ export function installProxyline(options) {
             }
             emit(options.onEvent, { type: "runtime.stopped", mode: options.mode });
         },
+        withBypass: (registration, run) => {
+            const unregister = handle.registerBypass(registration);
+            try {
+                const result = run();
+                if (isPromiseLike(result)) {
+                    void Promise.resolve(result).then(unregister, unregister);
+                    return result;
+                }
+                unregister();
+                return result;
+            }
+            catch (error) {
+                unregister();
+                throw error;
+            }
+        },
     };
+    activeHandle = hasActiveProxy ? handle : activeHandle;
     return handle;
 }
 export const installGlobalProxy = installProxyline;
+function isPromiseLike(value) {
+    return typeof value === "object" &&
+        value !== null &&
+        typeof value.then === "function";
+}

package/dist/types.d.ts

@@ -8,7 +8,9 @@ export type ProxylineOptions = Readonly<{
     proxyUrl?: string | URL;
     proxyTls?: ProxylineTlsOptions;
     bypassPolicy?: ProxylineBypassPolicy;
+    ifActive?: "error" | "reuse-compatible" | "replace";
     onEvent?: (event: ProxylineEvent) => void;
+    undici?: ProxylineUndiciOptions;
 }>;
 export type ProxylineDecision = Readonly<{
     kind: "proxied" | "direct" | "blocked";
@@ -41,6 +43,19 @@ export type ProxylineEvent = Readonly<{
 export type ExplainOptions = Readonly<{
     surface?: ProxylineSurface;
 }>;
+export type ProxylineBypassRegistration = Readonly<{
+    surface?: ProxylineSurface;
+    url: string | URL;
+}>;
+export type ProxylineUndiciOptions = Readonly<{
+    allowH2?: boolean;
+    bodyTimeout?: number;
+    headersTimeout?: number;
+    connect?: Readonly<{
+        autoSelectFamily?: boolean;
+        autoSelectFamilyAttemptTimeout?: number;
+    }>;
+}>;
 export type ProxylineHandle = Readonly<{
     mode: ProxylineMode;
     active: boolean;
@@ -49,12 +64,14 @@ export type ProxylineHandle = Readonly<{
     createUndiciDispatcher: () => Dispatcher;
     createWebSocketAgent: () => HttpAgent;
     explain: (url: string | URL, options?: ExplainOptions) => ProxylineDecision;
+    registerBypass: (registration: ProxylineBypassRegistration) => () => void;
     stop: () => void;
+    withBypass: <T>(registration: ProxylineBypassRegistration, run: () => T) => T;
 }>;
 export type ProxyResolver = Readonly<{
     active: boolean;
     describeProxy: () => string | undefined;
     explain: (url: string | URL, surface: ProxylineSurface) => ProxylineDecision;
-    getProxyForUrl: (url: string) => string;
+    getProxyForUrl: (url: string, surface?: ProxylineSurface) => string;
 }>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/proxyline",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Process-global proxy routing for Node.js.",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./dispatcher-brand": {
+      "types": "./dist/dispatcher-brand.d.ts",
+      "default": "./dist/dispatcher-brand.js"
     }
   },
   "files": [
@@ -40,6 +44,7 @@
     "docs:build": "node scripts/build-docs-site.mjs",
     "package:dry-run": "pnpm pack --dry-run",
     "prepack": "node scripts/prepack-build.mjs",
+    "prepare": "node scripts/prepack-build.mjs",
     "publish:dry-run": "pnpm publish --dry-run --access public",
     "test": "pnpm build && tsx --test test/index.test.ts test/e2e.test.ts test/package.test.ts",
     "typecheck": "pnpm build && tsc --noEmit"
@@ -49,12 +54,13 @@
     "@types/ws": "^8.18.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
+    "undici": "^7.25.0",
     "ws": "^8.20.0"
   },
   "engines": {
     "node": ">=20.18.1"
   },
-  "dependencies": {
-    "undici": "^7.25.0"
+  "peerDependencies": {
+    "undici": ">=7.25.0 <9"
   }
 }