@theia/ai-core 1.70.0-next.12 → 1.70.0-next.15

package/lib/common/index.d.ts

@@ -9,6 +9,7 @@ export * from './language-model';
 export * from './language-model-alias';
 export * from './prompt-service';
 export * from './prompt-service-util';
+export * from './proxy-util';
 export * from './prompt-text';
 export * from './protocol';
 export * from './today-variable-contribution';

package/lib/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAeA,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAeA,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAE7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/lib/common/index.js

@@ -27,6 +27,7 @@ tslib_1.__exportStar(require("./language-model"), exports);
 tslib_1.__exportStar(require("./language-model-alias"), exports);
 tslib_1.__exportStar(require("./prompt-service"), exports);
 tslib_1.__exportStar(require("./prompt-service-util"), exports);
+tslib_1.__exportStar(require("./proxy-util"), exports);
 tslib_1.__exportStar(require("./prompt-text"), exports);
 tslib_1.__exportStar(require("./protocol"), exports);
 tslib_1.__exportStar(require("./today-variable-contribution"), exports);

package/lib/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,0DAAgC;AAChC,kDAAwB;AACxB,yEAA+C;AAC/C,gEAAsC;AACtC,qEAA2C;AAC3C,oEAA0C;AAC1C,gEAAsC;AACtC,2DAAiC;AACjC,iEAAuC;AACvC,2DAAiC;AACjC,gEAAsC;AAEtC,wDAA8B;AAC9B,qDAA2B;AAC3B,wEAA8C;AAC9C,6DAAmC;AACnC,6DAAmC;AACnC,mEAAyC;AACzC,gEAAsC;AACtC,iEAAuC;AACvC,6EAAmD;AACnD,+DAAqC;AACrC,kDAAwB;AACxB,6DAAmC;AACnC,2DAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,0DAAgC;AAChC,kDAAwB;AACxB,yEAA+C;AAC/C,gEAAsC;AACtC,qEAA2C;AAC3C,oEAA0C;AAC1C,gEAAsC;AACtC,2DAAiC;AACjC,iEAAuC;AACvC,2DAAiC;AACjC,gEAAsC;AACtC,uDAA6B;AAE7B,wDAA8B;AAC9B,qDAA2B;AAC3B,wEAA8C;AAC9C,6DAAmC;AACnC,6DAAmC;AACnC,mEAAyC;AACzC,gEAAsC;AACtC,iEAAuC;AACvC,6EAAmD;AACnD,+DAAqC;AACrC,kDAAwB;AACxB,6DAAmC;AACnC,2DAAiC"}

package/lib/common/proxy-util.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Checks whether the given target URL should bypass the proxy based on `no_proxy` rules.
+ *
+ * @param targetUrl - The URL to check against the no_proxy rules.
+ * @param noProxyValue - A comma-separated list of no_proxy rules.
+ * @returns `true` if the target URL should bypass the proxy, `false` otherwise.
+ */
+export declare function shouldBypassProxy(targetUrl: string | undefined, noProxyValue: string | undefined): boolean;
+//# sourceMappingURL=proxy-util.d.ts.map

package/lib/common/proxy-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.d.ts","sourceRoot":"","sources":["../../src/common/proxy-util.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CA6D1G"}

package/lib/common/proxy-util.js

@@ -0,0 +1,84 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldBypassProxy = shouldBypassProxy;
+/**
+ * Checks whether the given target URL should bypass the proxy based on `no_proxy` rules.
+ *
+ * @param targetUrl - The URL to check against the no_proxy rules.
+ * @param noProxyValue - A comma-separated list of no_proxy rules.
+ * @returns `true` if the target URL should bypass the proxy, `false` otherwise.
+ */
+function shouldBypassProxy(targetUrl, noProxyValue) {
+    if (!targetUrl || !noProxyValue) {
+        return false;
+    }
+    let parsed;
+    try {
+        parsed = new URL(targetUrl);
+    }
+    catch {
+        return false;
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    const port = parsed.port;
+    const rules = noProxyValue.split(',');
+    for (const rawRule of rules) {
+        const rule = rawRule.trim().toLowerCase();
+        if (!rule) {
+            continue;
+        }
+        if (rule === '*') {
+            return true;
+        }
+        let ruleHost;
+        let rulePort;
+        const portSeparatorIndex = rule.lastIndexOf(':');
+        // Check if there's a port in the rule (only if the part after ':' is numeric)
+        if (portSeparatorIndex !== -1) {
+            const possiblePort = rule.substring(portSeparatorIndex + 1);
+            if (/^\d+$/.test(possiblePort)) {
+                ruleHost = rule.substring(0, portSeparatorIndex);
+                rulePort = possiblePort;
+            }
+            else {
+                ruleHost = rule;
+            }
+        }
+        else {
+            ruleHost = rule;
+        }
+        // If the rule specifies a port, the target must match it
+        if (rulePort !== undefined && port !== rulePort) {
+            continue;
+        }
+        if (ruleHost.startsWith('.')) {
+            // Domain suffix match: .example.com matches *.example.com
+            if (hostname.endsWith(ruleHost) || hostname === ruleHost.substring(1)) {
+                return true;
+            }
+        }
+        else {
+            // Exact match or suffix match (without leading dot)
+            if (hostname === ruleHost || hostname.endsWith('.' + ruleHost)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=proxy-util.js.map

package/lib/common/proxy-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.js","sourceRoot":"","sources":["../../src/common/proxy-util.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAShF,8CA6DC;AApED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,SAA6B,EAAE,YAAgC;IAC7F,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,SAAS;QACb,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,QAAgB,CAAC;QACrB,IAAI,QAA4B,CAAC;QACjC,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,8EAA8E;QAC9E,IAAI,kBAAkB,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;YAC5D,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7B,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;gBACjD,QAAQ,GAAG,YAAY,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACJ,QAAQ,GAAG,IAAI,CAAC;YACpB,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,QAAQ,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,yDAAyD;QACzD,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,SAAS;QACb,CAAC;QAED,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,0DAA0D;YAC1D,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,oDAAoD;YACpD,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/lib/common/proxy-util.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proxy-util.spec.d.ts.map

package/lib/common/proxy-util.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.spec.d.ts","sourceRoot":"","sources":["../../src/common/proxy-util.spec.ts"],"names":[],"mappings":""}

package/lib/common/proxy-util.spec.js

@@ -0,0 +1,89 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const proxy_util_1 = require("./proxy-util");
+describe('proxy-util', () => {
+    describe('shouldBypassProxy', () => {
+        it('should return false when targetUrl is undefined', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)(undefined, 'localhost')).to.be.false;
+        });
+        it('should return false when noProxyValue is undefined', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://example.com', undefined)).to.be.false;
+        });
+        it('should return false when noProxyValue is empty', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://example.com', '')).to.be.false;
+        });
+        it('should return false when targetUrl cannot be parsed', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('not-a-url', 'localhost')).to.be.false;
+        });
+        it('should match exact hostname (case-insensitive)', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://myhost.local/v1', 'myhost.local')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://MyHost.Local/v1', 'myhost.local')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://myhost.local/v1', 'MyHost.Local')).to.be.true;
+        });
+        it('should not match partial hostname', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://notmyhost.local', 'myhost.local')).to.be.false;
+        });
+        it('should match domain suffix with leading dot', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://api.example.com/v1', '.example.com')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://deep.sub.example.com', '.example.com')).to.be.true;
+        });
+        it('should match exact domain for leading dot rule', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://example.com/v1', '.example.com')).to.be.true;
+        });
+        it('should match suffix without leading dot', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://sub.example.com/v1', 'example.com')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://example.com/v1', 'example.com')).to.be.true;
+        });
+        it('should match wildcard', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://anything.com', '*')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('https://secure.host.org/path', '*')).to.be.true;
+        });
+        it('should match IP addresses', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://192.168.1.100:8080/v1', '192.168.1.100')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://192.168.1.100/v1', '192.168.1.100')).to.be.true;
+        });
+        it('should not match different IP addresses', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://192.168.1.101/v1', '192.168.1.100')).to.be.false;
+        });
+        it('should match port-specific rules', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://myhost:8080/v1', 'myhost:8080')).to.be.true;
+        });
+        it('should not match when port differs', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://myhost:9090/v1', 'myhost:8080')).to.be.false;
+        });
+        it('should not match port-specific rule when target has no port', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://myhost/v1', 'myhost:8080')).to.be.false;
+        });
+        it('should trim whitespace around entries', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://example.com', '  example.com  ')).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://foo.com', ' foo.com , bar.com ')).to.be.true;
+        });
+        it('should handle multiple comma-separated rules', () => {
+            const noProxy = 'localhost,127.0.0.1,.internal.net';
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://localhost/api', noProxy)).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://127.0.0.1:3000', noProxy)).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://service.internal.net', noProxy)).to.be.true;
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://external.com', noProxy)).to.be.false;
+        });
+        it('should skip empty rules from consecutive commas', () => {
+            (0, chai_1.expect)((0, proxy_util_1.shouldBypassProxy)('http://example.com', 'example.com,,localhost')).to.be.true;
+        });
+    });
+});
+//# sourceMappingURL=proxy-util.spec.js.map

package/lib/common/proxy-util.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.spec.js","sourceRoot":"","sources":["../../src/common/proxy-util.spec.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,+BAA8B;AAC9B,6CAAiD;AAEjD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IACxB,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACvD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC1D,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC3D,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,wBAAwB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YAC/E,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,wBAAwB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YAC/E,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,wBAAwB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YACzC,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,wBAAwB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACnD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YAClF,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,6BAA6B,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QACxF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,uBAAuB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QAClF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YAC/C,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YACjF,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC7B,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YACjE,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QAC9E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACjC,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,8BAA8B,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YACtF,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QACrF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YAC/C,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QACtF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YACxC,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC1C,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QAClF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACnE,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC7C,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YAC9E,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QAClF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACpD,MAAM,OAAO,GAAG,mCAAmC,CAAC;YACpD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YACtE,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YACvE,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,6BAA6B,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YAC7E,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACvD,IAAA,aAAM,EAAC,IAAA,8BAAiB,EAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;QACzF,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AAEP,CAAC,CAAC,CAAC"}

package/lib/node/index.d.ts

@@ -0,0 +1,2 @@
+export * from './proxy-util';
+//# sourceMappingURL=index.d.ts.map

package/lib/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,cAAc,cAAc,CAAC"}

package/lib/node/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./proxy-util"), exports);
+//# sourceMappingURL=index.js.map

package/lib/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,uDAA6B"}

package/lib/node/proxy-util.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Creates a custom fetch function that routes requests through the given HTTP proxy.
+ * Returns `undefined` if no proxy URL is provided.
+ *
+ * @param proxyUrl - The proxy URL to use, or `undefined` for no proxy.
+ * @returns A custom fetch function using the proxy, or `undefined`.
+ */
+export declare function createProxyFetch(proxyUrl: string | undefined): typeof fetch | undefined;
+/**
+ * Resolves the proxy URL to use for a given target URL.
+ *
+ * Resolution order:
+ * 1. If `settingsProxy` is provided (e.g., from Theia `http.proxy` preference), use it.
+ * 2. Otherwise check environment variables based on the target URL scheme.
+ * 3. If a proxy is resolved, check `no_proxy`/`NO_PROXY` — if bypass, return `undefined`.
+ * 4. Return the resolved proxy URL or `undefined` if none found.
+ *
+ * @param targetUrl - The URL for which to resolve a proxy.
+ * @param settingsProxy - An optional proxy URL from application settings.
+ * @returns The proxy URL to use, or `undefined` if no proxy should be used.
+ */
+export declare function getProxyUrl(targetUrl: string | undefined, settingsProxy?: string): string | undefined;
+//# sourceMappingURL=proxy-util.d.ts.map

package/lib/node/proxy-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.d.ts","sourceRoot":"","sources":["../../src/node/proxy-util.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,KAAK,GAAG,SAAS,CAQvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmCrG"}

package/lib/node/proxy-util.js

@@ -0,0 +1,83 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProxyFetch = createProxyFetch;
+exports.getProxyUrl = getProxyUrl;
+const undici = require("undici");
+const proxy_util_1 = require("../common/proxy-util");
+/**
+ * Creates a custom fetch function that routes requests through the given HTTP proxy.
+ * Returns `undefined` if no proxy URL is provided.
+ *
+ * @param proxyUrl - The proxy URL to use, or `undefined` for no proxy.
+ * @returns A custom fetch function using the proxy, or `undefined`.
+ */
+function createProxyFetch(proxyUrl) {
+    if (!proxyUrl) {
+        return undefined;
+    }
+    const proxyAgent = new undici.ProxyAgent(proxyUrl);
+    return ((input, init) => fetch(input, { ...init, dispatcher: proxyAgent }));
+}
+/**
+ * Resolves the proxy URL to use for a given target URL.
+ *
+ * Resolution order:
+ * 1. If `settingsProxy` is provided (e.g., from Theia `http.proxy` preference), use it.
+ * 2. Otherwise check environment variables based on the target URL scheme.
+ * 3. If a proxy is resolved, check `no_proxy`/`NO_PROXY` — if bypass, return `undefined`.
+ * 4. Return the resolved proxy URL or `undefined` if none found.
+ *
+ * @param targetUrl - The URL for which to resolve a proxy.
+ * @param settingsProxy - An optional proxy URL from application settings.
+ * @returns The proxy URL to use, or `undefined` if no proxy should be used.
+ */
+function getProxyUrl(targetUrl, settingsProxy) {
+    let proxyUrl;
+    if (settingsProxy) {
+        proxyUrl = settingsProxy;
+    }
+    else if (targetUrl) {
+        let scheme;
+        try {
+            scheme = new URL(targetUrl).protocol;
+        }
+        catch {
+            return undefined;
+        }
+        if (scheme === 'https:') {
+            proxyUrl = process.env.https_proxy
+                || process.env.HTTPS_PROXY
+                || process.env.http_proxy
+                || process.env.HTTP_PROXY;
+        }
+        else if (scheme === 'http:') {
+            proxyUrl = process.env.http_proxy
+                || process.env.HTTP_PROXY;
+        }
+    }
+    if (!proxyUrl) {
+        return undefined;
+    }
+    // Check no_proxy / NO_PROXY
+    const noProxy = process.env.no_proxy ?? process.env.NO_PROXY;
+    if ((0, proxy_util_1.shouldBypassProxy)(targetUrl, noProxy)) {
+        return undefined;
+    }
+    return proxyUrl;
+}
+//# sourceMappingURL=proxy-util.js.map

package/lib/node/proxy-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.js","sourceRoot":"","sources":["../../src/node/proxy-util.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAYhF,4CAQC;AAeD,kCAmCC;AApED,iCAAiC;AACjC,qDAAyD;AAEzD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,QAA4B;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,CAAC,CAAC,KAA6B,EAAE,IAAkB,EAAE,EAAE,CAC1D,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,UAAU,EAAiB,CAAC,CACnD,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,WAAW,CAAC,SAA6B,EAAE,aAAsB;IAC7E,IAAI,QAA4B,CAAC;IAEjC,IAAI,aAAa,EAAE,CAAC;QAChB,QAAQ,GAAG,aAAa,CAAC;IAC7B,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACnB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtB,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW;mBAC3B,OAAO,CAAC,GAAG,CAAC,WAAW;mBACvB,OAAO,CAAC,GAAG,CAAC,UAAU;mBACtB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAClC,CAAC;aAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC5B,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU;mBAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAClC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,4BAA4B;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC7D,IAAI,IAAA,8BAAiB,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/lib/node/proxy-util.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proxy-util.spec.d.ts.map

package/lib/node/proxy-util.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-util.spec.d.ts","sourceRoot":"","sources":["../../src/node/proxy-util.spec.ts"],"names":[],"mappings":""}

package/lib/node/proxy-util.spec.js

@@ -0,0 +1,122 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const proxy_util_1 = require("./proxy-util");
+describe('getProxyUrl', () => {
+    const savedEnv = {};
+    const envVars = ['http_proxy', 'HTTP_PROXY', 'https_proxy', 'HTTPS_PROXY', 'no_proxy', 'NO_PROXY'];
+    beforeEach(() => {
+        for (const key of envVars) {
+            savedEnv[key] = process.env[key];
+            delete process.env[key];
+        }
+    });
+    afterEach(() => {
+        for (const key of envVars) {
+            if (savedEnv[key] !== undefined) {
+                process.env[key] = savedEnv[key];
+            }
+            else {
+                delete process.env[key];
+            }
+        }
+    });
+    it('should return settingsProxy when provided', () => {
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com', 'http://settings-proxy:8080')).to.equal('http://settings-proxy:8080');
+    });
+    it('should return undefined when no proxy is configured', () => {
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.be.undefined;
+    });
+    it('should return undefined when targetUrl is undefined and no settingsProxy', () => {
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)(undefined)).to.be.undefined;
+    });
+    it('should return undefined when targetUrl is not parseable', () => {
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('not-a-url')).to.be.undefined;
+    });
+    it('should resolve http_proxy for http URLs', () => {
+        process.env.http_proxy = 'http://http-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.equal('http://http-proxy:3128');
+    });
+    it('should resolve HTTP_PROXY for http URLs when http_proxy is not set', () => {
+        process.env.HTTP_PROXY = 'http://HTTP-PROXY:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.equal('http://HTTP-PROXY:3128');
+    });
+    (process.platform === 'win32' ? it.skip : it)('should prefer http_proxy over HTTP_PROXY for http URLs', () => {
+        process.env.http_proxy = 'http://lower-proxy:3128';
+        process.env.HTTP_PROXY = 'http://upper-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.equal('http://lower-proxy:3128');
+    });
+    it('should resolve https_proxy for https URLs', () => {
+        process.env.https_proxy = 'http://https-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://https-proxy:3128');
+    });
+    it('should fall back to http_proxy for https URLs', () => {
+        process.env.http_proxy = 'http://http-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://http-proxy:3128');
+    });
+    it('should prefer https_proxy over http_proxy for https URLs', () => {
+        process.env.https_proxy = 'http://https-proxy:3128';
+        process.env.http_proxy = 'http://http-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://https-proxy:3128');
+    });
+    it('should resolve HTTPS_PROXY for https URLs', () => {
+        process.env.HTTPS_PROXY = 'http://HTTPS-PROXY:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://HTTPS-PROXY:3128');
+    });
+    (process.platform === 'win32' ? it.skip : it)('should follow https resolution order: https_proxy > HTTPS_PROXY > http_proxy > HTTP_PROXY', () => {
+        process.env.HTTP_PROXY = 'http://HTTP-PROXY:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://HTTP-PROXY:3128');
+        process.env.http_proxy = 'http://http-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://http-proxy:3128');
+        process.env.HTTPS_PROXY = 'http://HTTPS-PROXY:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://HTTPS-PROXY:3128');
+        process.env.https_proxy = 'http://https-proxy:3128';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('https://example.com')).to.equal('http://https-proxy:3128');
+    });
+    it('should bypass proxy when no_proxy matches', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.no_proxy = 'example.com';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.be.undefined;
+    });
+    it('should bypass proxy when NO_PROXY matches', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.NO_PROXY = 'example.com';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.be.undefined;
+    });
+    (process.platform === 'win32' ? it.skip : it)('should prefer no_proxy over NO_PROXY', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.no_proxy = 'example.com';
+        process.env.NO_PROXY = 'other.com';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.be.undefined;
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://other.com')).to.equal('http://proxy:3128');
+    });
+    it('should not bypass proxy when no_proxy does not match', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.no_proxy = 'other.com';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com')).to.equal('http://proxy:3128');
+    });
+    it('should bypass proxy even when settingsProxy is provided', () => {
+        process.env.no_proxy = 'example.com';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com', 'http://settings-proxy:8080')).to.be.undefined;
+    });
+    it('should bypass proxy with NO_PROXY (uppercase) when settingsProxy is provided', () => {
+        process.env.NO_PROXY = 'example.com';
+        (0, chai_1.expect)((0, proxy_util_1.getProxyUrl)('http://example.com', 'http://settings-proxy:8080')).to.be.undefined;
+    });
+});
+//# sourceMappingURL=proxy-util.spec.js.map

package/lib/node/proxy-util.spec.js.map

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

package/package.json

@@ -1,20 +1,21 @@
 {
   "name": "@theia/ai-core",
-  "version": "1.70.0-next.12+d3daec4dd",
+  "version": "1.70.0-next.15+d81f78f65",
   "description": "Theia - AI Core",
   "dependencies": {
-    "@theia/core": "1.70.0-next.12+d3daec4dd",
-    "@theia/editor": "1.70.0-next.12+d3daec4dd",
-    "@theia/filesystem": "1.70.0-next.12+d3daec4dd",
-    "@theia/monaco": "1.70.0-next.12+d3daec4dd",
+    "@theia/core": "1.70.0-next.15+d81f78f65",
+    "@theia/editor": "1.70.0-next.15+d81f78f65",
+    "@theia/filesystem": "1.70.0-next.15+d81f78f65",
+    "@theia/monaco": "1.70.0-next.15+d81f78f65",
     "@theia/monaco-editor-core": "1.96.302",
-    "@theia/output": "1.70.0-next.12+d3daec4dd",
-    "@theia/variable-resolver": "1.70.0-next.12+d3daec4dd",
-    "@theia/workspace": "1.70.0-next.12+d3daec4dd",
+    "@theia/output": "1.70.0-next.15+d81f78f65",
+    "@theia/variable-resolver": "1.70.0-next.15+d81f78f65",
+    "@theia/workspace": "1.70.0-next.15+d81f78f65",
     "@types/js-yaml": "^4.0.9",
     "fast-deep-equal": "^3.1.3",
     "js-yaml": "^4.1.0",
-    "tslib": "^2.6.2"
+    "tslib": "^2.6.2",
+    "undici": "^7.16.0"
   },
   "main": "lib/common",
   "publishConfig": {
@@ -57,5 +58,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "d3daec4dd6cd5e57b7e04b833b1e3e964fe337fd"
+  "gitHead": "d81f78f65913085f58d8783b151a7adebb863ba2"
 }

package/src/common/index.ts

@@ -24,6 +24,7 @@ export * from './language-model';
 export * from './language-model-alias';
 export * from './prompt-service';
 export * from './prompt-service-util';
+export * from './proxy-util';
 
 export * from './prompt-text';
 export * from './protocol';

package/src/common/proxy-util.spec.ts

@@ -0,0 +1,106 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { expect } from 'chai';
+import { shouldBypassProxy } from './proxy-util';
+
+describe('proxy-util', () => {
+    describe('shouldBypassProxy', () => {
+        it('should return false when targetUrl is undefined', () => {
+            expect(shouldBypassProxy(undefined, 'localhost')).to.be.false;
+        });
+
+        it('should return false when noProxyValue is undefined', () => {
+            expect(shouldBypassProxy('http://example.com', undefined)).to.be.false;
+        });
+
+        it('should return false when noProxyValue is empty', () => {
+            expect(shouldBypassProxy('http://example.com', '')).to.be.false;
+        });
+
+        it('should return false when targetUrl cannot be parsed', () => {
+            expect(shouldBypassProxy('not-a-url', 'localhost')).to.be.false;
+        });
+
+        it('should match exact hostname (case-insensitive)', () => {
+            expect(shouldBypassProxy('http://myhost.local/v1', 'myhost.local')).to.be.true;
+            expect(shouldBypassProxy('http://MyHost.Local/v1', 'myhost.local')).to.be.true;
+            expect(shouldBypassProxy('http://myhost.local/v1', 'MyHost.Local')).to.be.true;
+        });
+
+        it('should not match partial hostname', () => {
+            expect(shouldBypassProxy('http://notmyhost.local', 'myhost.local')).to.be.false;
+        });
+
+        it('should match domain suffix with leading dot', () => {
+            expect(shouldBypassProxy('http://api.example.com/v1', '.example.com')).to.be.true;
+            expect(shouldBypassProxy('http://deep.sub.example.com', '.example.com')).to.be.true;
+        });
+
+        it('should match exact domain for leading dot rule', () => {
+            expect(shouldBypassProxy('http://example.com/v1', '.example.com')).to.be.true;
+        });
+
+        it('should match suffix without leading dot', () => {
+            expect(shouldBypassProxy('http://sub.example.com/v1', 'example.com')).to.be.true;
+            expect(shouldBypassProxy('http://example.com/v1', 'example.com')).to.be.true;
+        });
+
+        it('should match wildcard', () => {
+            expect(shouldBypassProxy('http://anything.com', '*')).to.be.true;
+            expect(shouldBypassProxy('https://secure.host.org/path', '*')).to.be.true;
+        });
+
+        it('should match IP addresses', () => {
+            expect(shouldBypassProxy('http://192.168.1.100:8080/v1', '192.168.1.100')).to.be.true;
+            expect(shouldBypassProxy('http://192.168.1.100/v1', '192.168.1.100')).to.be.true;
+        });
+
+        it('should not match different IP addresses', () => {
+            expect(shouldBypassProxy('http://192.168.1.101/v1', '192.168.1.100')).to.be.false;
+        });
+
+        it('should match port-specific rules', () => {
+            expect(shouldBypassProxy('http://myhost:8080/v1', 'myhost:8080')).to.be.true;
+        });
+
+        it('should not match when port differs', () => {
+            expect(shouldBypassProxy('http://myhost:9090/v1', 'myhost:8080')).to.be.false;
+        });
+
+        it('should not match port-specific rule when target has no port', () => {
+            expect(shouldBypassProxy('http://myhost/v1', 'myhost:8080')).to.be.false;
+        });
+
+        it('should trim whitespace around entries', () => {
+            expect(shouldBypassProxy('http://example.com', '  example.com  ')).to.be.true;
+            expect(shouldBypassProxy('http://foo.com', ' foo.com , bar.com ')).to.be.true;
+        });
+
+        it('should handle multiple comma-separated rules', () => {
+            const noProxy = 'localhost,127.0.0.1,.internal.net';
+            expect(shouldBypassProxy('http://localhost/api', noProxy)).to.be.true;
+            expect(shouldBypassProxy('http://127.0.0.1:3000', noProxy)).to.be.true;
+            expect(shouldBypassProxy('http://service.internal.net', noProxy)).to.be.true;
+            expect(shouldBypassProxy('http://external.com', noProxy)).to.be.false;
+        });
+
+        it('should skip empty rules from consecutive commas', () => {
+            expect(shouldBypassProxy('http://example.com', 'example.com,,localhost')).to.be.true;
+        });
+    });
+
+});

package/src/common/proxy-util.ts

@@ -0,0 +1,86 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+/**
+ * Checks whether the given target URL should bypass the proxy based on `no_proxy` rules.
+ *
+ * @param targetUrl - The URL to check against the no_proxy rules.
+ * @param noProxyValue - A comma-separated list of no_proxy rules.
+ * @returns `true` if the target URL should bypass the proxy, `false` otherwise.
+ */
+export function shouldBypassProxy(targetUrl: string | undefined, noProxyValue: string | undefined): boolean {
+    if (!targetUrl || !noProxyValue) {
+        return false;
+    }
+
+    let parsed: URL;
+    try {
+        parsed = new URL(targetUrl);
+    } catch {
+        return false;
+    }
+
+    const hostname = parsed.hostname.toLowerCase();
+    const port = parsed.port;
+
+    const rules = noProxyValue.split(',');
+    for (const rawRule of rules) {
+        const rule = rawRule.trim().toLowerCase();
+        if (!rule) {
+            continue;
+        }
+
+        if (rule === '*') {
+            return true;
+        }
+
+        let ruleHost: string;
+        let rulePort: string | undefined;
+        const portSeparatorIndex = rule.lastIndexOf(':');
+        // Check if there's a port in the rule (only if the part after ':' is numeric)
+        if (portSeparatorIndex !== -1) {
+            const possiblePort = rule.substring(portSeparatorIndex + 1);
+            if (/^\d+$/.test(possiblePort)) {
+                ruleHost = rule.substring(0, portSeparatorIndex);
+                rulePort = possiblePort;
+            } else {
+                ruleHost = rule;
+            }
+        } else {
+            ruleHost = rule;
+        }
+
+        // If the rule specifies a port, the target must match it
+        if (rulePort !== undefined && port !== rulePort) {
+            continue;
+        }
+
+        if (ruleHost.startsWith('.')) {
+            // Domain suffix match: .example.com matches *.example.com
+            if (hostname.endsWith(ruleHost) || hostname === ruleHost.substring(1)) {
+                return true;
+            }
+        } else {
+            // Exact match or suffix match (without leading dot)
+            if (hostname === ruleHost || hostname.endsWith('.' + ruleHost)) {
+                return true;
+            }
+        }
+    }
+
+    return false;
+}
+

package/src/node/index.ts

@@ -0,0 +1,17 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+export * from './proxy-util';

package/src/node/proxy-util.spec.ts

@@ -0,0 +1,143 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { expect } from 'chai';
+import { getProxyUrl } from './proxy-util';
+
+describe('getProxyUrl', () => {
+    const savedEnv: Record<string, string | undefined> = {};
+    const envVars = ['http_proxy', 'HTTP_PROXY', 'https_proxy', 'HTTPS_PROXY', 'no_proxy', 'NO_PROXY'];
+
+    beforeEach(() => {
+        for (const key of envVars) {
+            savedEnv[key] = process.env[key];
+            delete process.env[key];
+        }
+    });
+
+    afterEach(() => {
+        for (const key of envVars) {
+            if (savedEnv[key] !== undefined) {
+                process.env[key] = savedEnv[key];
+            } else {
+                delete process.env[key];
+            }
+        }
+    });
+
+    it('should return settingsProxy when provided', () => {
+        expect(getProxyUrl('http://example.com', 'http://settings-proxy:8080')).to.equal('http://settings-proxy:8080');
+    });
+
+    it('should return undefined when no proxy is configured', () => {
+        expect(getProxyUrl('http://example.com')).to.be.undefined;
+    });
+
+    it('should return undefined when targetUrl is undefined and no settingsProxy', () => {
+        expect(getProxyUrl(undefined)).to.be.undefined;
+    });
+
+    it('should return undefined when targetUrl is not parseable', () => {
+        expect(getProxyUrl('not-a-url')).to.be.undefined;
+    });
+
+    it('should resolve http_proxy for http URLs', () => {
+        process.env.http_proxy = 'http://http-proxy:3128';
+        expect(getProxyUrl('http://example.com')).to.equal('http://http-proxy:3128');
+    });
+
+    it('should resolve HTTP_PROXY for http URLs when http_proxy is not set', () => {
+        process.env.HTTP_PROXY = 'http://HTTP-PROXY:3128';
+        expect(getProxyUrl('http://example.com')).to.equal('http://HTTP-PROXY:3128');
+    });
+
+    (process.platform === 'win32' ? it.skip : it)('should prefer http_proxy over HTTP_PROXY for http URLs', () => {
+        process.env.http_proxy = 'http://lower-proxy:3128';
+        process.env.HTTP_PROXY = 'http://upper-proxy:3128';
+        expect(getProxyUrl('http://example.com')).to.equal('http://lower-proxy:3128');
+    });
+
+    it('should resolve https_proxy for https URLs', () => {
+        process.env.https_proxy = 'http://https-proxy:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://https-proxy:3128');
+    });
+
+    it('should fall back to http_proxy for https URLs', () => {
+        process.env.http_proxy = 'http://http-proxy:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://http-proxy:3128');
+    });
+
+    it('should prefer https_proxy over http_proxy for https URLs', () => {
+        process.env.https_proxy = 'http://https-proxy:3128';
+        process.env.http_proxy = 'http://http-proxy:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://https-proxy:3128');
+    });
+
+    it('should resolve HTTPS_PROXY for https URLs', () => {
+        process.env.HTTPS_PROXY = 'http://HTTPS-PROXY:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://HTTPS-PROXY:3128');
+    });
+
+    (process.platform === 'win32' ? it.skip : it)('should follow https resolution order: https_proxy > HTTPS_PROXY > http_proxy > HTTP_PROXY', () => {
+        process.env.HTTP_PROXY = 'http://HTTP-PROXY:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://HTTP-PROXY:3128');
+
+        process.env.http_proxy = 'http://http-proxy:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://http-proxy:3128');
+
+        process.env.HTTPS_PROXY = 'http://HTTPS-PROXY:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://HTTPS-PROXY:3128');
+
+        process.env.https_proxy = 'http://https-proxy:3128';
+        expect(getProxyUrl('https://example.com')).to.equal('http://https-proxy:3128');
+    });
+
+    it('should bypass proxy when no_proxy matches', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.no_proxy = 'example.com';
+        expect(getProxyUrl('http://example.com')).to.be.undefined;
+    });
+
+    it('should bypass proxy when NO_PROXY matches', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.NO_PROXY = 'example.com';
+        expect(getProxyUrl('http://example.com')).to.be.undefined;
+    });
+
+    (process.platform === 'win32' ? it.skip : it)('should prefer no_proxy over NO_PROXY', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.no_proxy = 'example.com';
+        process.env.NO_PROXY = 'other.com';
+        expect(getProxyUrl('http://example.com')).to.be.undefined;
+        expect(getProxyUrl('http://other.com')).to.equal('http://proxy:3128');
+    });
+
+    it('should not bypass proxy when no_proxy does not match', () => {
+        process.env.http_proxy = 'http://proxy:3128';
+        process.env.no_proxy = 'other.com';
+        expect(getProxyUrl('http://example.com')).to.equal('http://proxy:3128');
+    });
+
+    it('should bypass proxy even when settingsProxy is provided', () => {
+        process.env.no_proxy = 'example.com';
+        expect(getProxyUrl('http://example.com', 'http://settings-proxy:8080')).to.be.undefined;
+    });
+
+    it('should bypass proxy with NO_PROXY (uppercase) when settingsProxy is provided', () => {
+        process.env.NO_PROXY = 'example.com';
+        expect(getProxyUrl('http://example.com', 'http://settings-proxy:8080')).to.be.undefined;
+    });
+});

package/src/node/proxy-util.ts

@@ -0,0 +1,85 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import * as undici from 'undici';
+import { shouldBypassProxy } from '../common/proxy-util';
+
+/**
+ * Creates a custom fetch function that routes requests through the given HTTP proxy.
+ * Returns `undefined` if no proxy URL is provided.
+ *
+ * @param proxyUrl - The proxy URL to use, or `undefined` for no proxy.
+ * @returns A custom fetch function using the proxy, or `undefined`.
+ */
+export function createProxyFetch(proxyUrl: string | undefined): typeof fetch | undefined {
+    if (!proxyUrl) {
+        return undefined;
+    }
+    const proxyAgent = new undici.ProxyAgent(proxyUrl);
+    return ((input: string | URL | Request, init?: RequestInit) =>
+        fetch(input, { ...init, dispatcher: proxyAgent } as RequestInit)
+    ) as typeof fetch;
+}
+
+/**
+ * Resolves the proxy URL to use for a given target URL.
+ *
+ * Resolution order:
+ * 1. If `settingsProxy` is provided (e.g., from Theia `http.proxy` preference), use it.
+ * 2. Otherwise check environment variables based on the target URL scheme.
+ * 3. If a proxy is resolved, check `no_proxy`/`NO_PROXY` — if bypass, return `undefined`.
+ * 4. Return the resolved proxy URL or `undefined` if none found.
+ *
+ * @param targetUrl - The URL for which to resolve a proxy.
+ * @param settingsProxy - An optional proxy URL from application settings.
+ * @returns The proxy URL to use, or `undefined` if no proxy should be used.
+ */
+export function getProxyUrl(targetUrl: string | undefined, settingsProxy?: string): string | undefined {
+    let proxyUrl: string | undefined;
+
+    if (settingsProxy) {
+        proxyUrl = settingsProxy;
+    } else if (targetUrl) {
+        let scheme: string;
+        try {
+            scheme = new URL(targetUrl).protocol;
+        } catch {
+            return undefined;
+        }
+
+        if (scheme === 'https:') {
+            proxyUrl = process.env.https_proxy
+                || process.env.HTTPS_PROXY
+                || process.env.http_proxy
+                || process.env.HTTP_PROXY;
+        } else if (scheme === 'http:') {
+            proxyUrl = process.env.http_proxy
+                || process.env.HTTP_PROXY;
+        }
+    }
+
+    if (!proxyUrl) {
+        return undefined;
+    }
+
+    // Check no_proxy / NO_PROXY
+    const noProxy = process.env.no_proxy ?? process.env.NO_PROXY;
+    if (shouldBypassProxy(targetUrl, noProxy)) {
+        return undefined;
+    }
+
+    return proxyUrl;
+}