foundryLocalRuntime.ts ×14

Frontier kind: Code frontier

unlabeled · c_7781fe2258d1

3 tests · 7693 LOC · 36 files · introduces 0 tests · 89 LOC · 1 file

Introduces — evidence that enters the hierarchy at this concept

Code
14 ranges89 lines · 1 files
Tests
0 tests

Contains — complete concept membership

All code (extent)
1123 ranges7693 lines · 36 files · Browse complete extent
All tests (intent)
3 testsBrowse complete intent

Neighbourhood graph

The orange circle is the focus. Violet and green circles are every ancestor and descendant, broader and narrower, at any distance; blue squares and pink diamonds are the introduced files and exact introduced tests of every visible concept, not only the focus's. Arrows point from broader to narrower concepts and bridge only concepts omitted from this view. Undirected links show source or test introduction. Concept and file size follows LOC; exact test nodes use test-count units.

Introduced files, introduced tests, and structurally relevant concept specialization

In the embedded map, ordinary wheel input scrolls the page; use the visible controls to zoom and drag to pan. Open the full-screen map for canvas navigation: wheel pans, Ctrl/Command plus wheel zooms, and arrow keys pan when this region is focused. On touch screens, open the full-screen map to pan or pinch. If JavaScript or WebGL is unavailable, use the native relationship evidence on this page.

Introduced files, introduced tests, and structurally relevant concept specializationfoundryLocalRuntime.ts ×3 · 8 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×1 · 2 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×6 · 17 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×2 · 6 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×1 · 3 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×1 · 3 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×3 · 5 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×4 · 11 introduced LOCfoundryLocalRuntime.ts ×…foundryLocalRuntime.ts ×21 · 169 introduced LOCfoundryLocalRuntime.ts ×…pfs.ts ×1 · 2 introduced LOCpfs.ts ×1pfs.ts ×3 · 8 introduced LOCpfs.ts ×3pfs.ts ×32 · 306 introduced LOCpfs.ts ×32async.ts ×1 · 7 introduced LOCasync.ts ×1async.ts ×202 · 1247 introduced LOCasync.ts ×202testUtils.ts ×1 · 2 introduced LOCtestUtils.ts ×1extpath.ts ×1 · 2 introduced LOCextpath.ts ×1resources.ts ×23 · 253 introduced LOCresources.ts ×23extpath.ts ×2 · 6 introduced LOCextpath.ts ×2testUtils.ts ×2 · 12 introduced LOCtestUtils.ts ×2extpath.ts ×3 · 18 introduced LOCextpath.ts ×3strings.ts ×2 · 3 introduced LOCstrings.ts ×2network.ts ×20 · 292 introduced LOCnetwork.ts ×20testUtils.ts ×1 · 13 introduced LOCtestUtils.ts ×1strings.test|title=Strings trimWhitespace|occurrence=1 · 0 introduced LOCstrings.test|title=Strin…extpath.ts ×17 · 91 introduced LOCextpath.ts ×17strings.ts ×101 · 542 introduced LOCstrings.ts ×101cancellation.test|title=CancellationToken None|occurrence=1 · 0 introduced LOCcancellation.test|title=…cancellation.ts ×18 · 90 introduced LOCcancellation.ts ×18event.ts ×1 · 1 introduced LOCevent.ts ×1event.ts ×4 · 9 introduced LOCevent.ts ×4event.ts ×2 · 6 introduced LOCevent.ts ×2event.ts ×93 · 864 introduced LOCevent.ts ×93path.ts ×1 · 1 introduced LOCpath.ts ×1normalization.ts ×5 · 27 introduced LOCnormalization.ts ×5map.ts ×1 · 2 introduced LOCmap.ts ×1map.ts ×1 · 4 introduced LOCmap.ts ×1map.ts ×1 · 6 introduced LOCmap.ts ×1uri.test|title=URI URI#file, win-speciale|occurrence=1, charCode.test|title=CharCode has good values|occurrence=1, +2 · 0 introduced LOCuri.test|title=URI URI#f…utils.ts ×3 · 9 introduced LOCutils.ts ×3path.ts ×3 · 5 introduced LOCpath.ts ×3path.ts ×3 · 15 introduced LOCpath.ts ×3linkedList.ts ×13 · 44 introduced LOClinkedList.ts ×13path.ts ×1 · 2 introduced LOCpath.ts ×1path.ts ×3 · 10 introduced LOCpath.ts ×3path.ts ×3 · 14 introduced LOCpath.ts ×3lifecycle.ts ×2 · 4 introduced LOClifecycle.ts ×2path.ts ×1 · 1 introduced LOCpath.ts ×1lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1path.ts ×6 · 24 introduced LOCpath.ts ×6lifecycle.ts ×4 · 8 introduced LOClifecycle.ts ×4lifecycle.ts ×6 · 16 introduced LOClifecycle.ts ×6lazy.ts ×1 · 2 introduced LOClazy.ts ×1lazy.ts ×3 · 37 introduced LOClazy.ts ×3lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1path.ts ×2 · 3 introduced LOCpath.ts ×2testUtils.ts ×2 · 19 introduced LOCtestUtils.ts ×2uint.ts ×2 · 43 introduced LOCuint.ts ×2lifecycle.ts ×1 · 3 introduced LOClifecycle.ts ×1map.ts ×97 · 3334 introduced LOCmap.ts ×97src/vs/base/common/arrays.ts · 949 LOCcommon/arrays.tssrc/vs/base/common/arraysFind.ts · 226 LOCcommon/arraysFind.tssrc/vs/base/common/assert.ts · 91 LOCcommon/assert.tssrc/vs/base/common/async.ts · 2749 LOCcommon/async.tssrc/vs/base/common/cache.ts · 153 LOCcommon/cache.tssrc/vs/base/common/cancellation.ts · 206 LOCcommon/cancellation.tssrc/vs/base/common/charCode.ts · 450 LOCcommon/charCode.tssrc/vs/base/common/collections.ts · 176 LOCcommon/collections.tssrc/vs/base/common/errors.ts · 357 LOCcommon/errors.tssrc/vs/base/common/event.ts · 1964 LOCcommon/event.tssrc/vs/base/common/extpath.ts · 433 LOCcommon/extpath.tssrc/vs/base/common/functional.ts · 32 LOCcommon/functional.tssrc/vs/base/common/iterator.ts · 194 LOCcommon/iterator.tssrc/vs/base/common/lazy.ts · 57 LOCcommon/lazy.tssrc/vs/base/common/lifecycle.ts · 974 LOCcommon/lifecycle.tssrc/vs/base/common/linkedList.ts · 151 LOCcommon/linkedList.tssrc/vs/base/common/map.ts · 1016 LOCcommon/map.tssrc/vs/base/common/marshallingIds.ts · 33 LOCcommon/marshallingIds.tssrc/vs/base/common/network.ts · 440 LOCcommon/network.tssrc/vs/base/common/normalization.ts · 63 LOCcommon/normalization.tssrc/vs/base/common/path.ts · 1589 LOCcommon/path.tssrc/vs/base/common/platform.ts · 281 LOCcommon/platform.tssrc/vs/base/common/process.ts · 76 LOCcommon/process.tssrc/vs/base/common/resources.ts · 444 LOCcommon/resources.tssrc/vs/base/common/stopwatch.ts · 41 LOCcommon/stopwatch.tssrc/vs/base/common/strings.ts · 1413 LOCcommon/strings.tssrc/vs/base/common/symbols.ts · 9 LOCcommon/symbols.tssrc/vs/base/common/types.ts · 410 LOCcommon/types.tssrc/vs/base/common/uint.ts · 59 LOCcommon/uint.tssrc/vs/base/common/uri.ts · 754 LOCcommon/uri.tssrc/vs/base/node/pfs.ts · 866 LOCnode/pfs.tssrc/vs/base/test/common/testUtils.ts · 34 LOCcommon/testUtils.tssrc/vs/base/test/common/utils.ts · 107 LOCcommon/utils.tssrc/vs/base/test/node/testUtils.ts · 14 LOCnode/testUtils.tssrc/vs/nls.ts · 244 LOCvs/nls.tssrc/vs/platform/localTranscription/node/foundryLocalRuntime.ts · 446 LOCnode/foundryLocalRuntime…cancellation.test|title=CancellationToken None|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/cancellation.test|title=CancellationToken None|occurrence=1cancellation.test|title=…charCode.test|title=CharCode has good values|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/charCode.test|title=CharCode has good values|occurrence=1charCode.test|title=Char…path.test|title=Paths (Node Implementation) path|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/path.test|title=Paths (Node Implementation) path|occurrence=1path.test|title=Paths (N…strings.test|title=Strings trimWhitespace|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/strings.test|title=Strings trimWhitespace|occurrence=1strings.test|title=Strin…uri.test|title=URI File paths containing apostrophes break URI parsing and cannot be opened #276075|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/uri.test|title=URI File paths containing apostrophes break URI parsing and cannot be opened #276075|occurrence=1uri.test|title=URI File …uri.test|title=URI URI#file, win-speciale|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/uri.test|title=URI URI#file, win-speciale|occurrence=1uri.test|title=URI URI#f…foundryLocalRuntime.test|title=FoundryLocalRuntime isRuntimeProvisioned: false when nothing is present|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/localTranscription/test/node/foundryLocalRuntime.test|title=FoundryLocalRuntime isRuntimeProvisioned: false when nothing is present|occurrence=1foundryLocalRuntime.test…foundryLocalRuntime.test|title=FoundryLocalRuntime provisionRuntime: rejects an incomplete payload (missing core library) and writes no marker|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/localTranscription/test/node/foundryLocalRuntime.test|title=FoundryLocalRuntime provisionRuntime: rejects an incomplete payload (missing core library) and writes no marker|occurrence=1foundryLocalRuntime.test…foundryLocalRuntime.test|title=FoundryLocalRuntime provisionRuntime: rejects and writes no marker when the download 404s|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/localTranscription/test/node/foundryLocalRuntime.test|title=FoundryLocalRuntime provisionRuntime: rejects and writes no marker when the download 404s|occurrence=1foundryLocalRuntime.test…foundryLocalRuntime.test|title=FoundryLocalRuntime provisionRuntime: substitutes {target}, extracts the expected layout, writes the marker|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/localTranscription/test/node/foundryLocalRuntime.test|title=FoundryLocalRuntime provisionRuntime: substitutes {target}, extracts the expected layout, writes the marker|occurrence=1foundryLocalRuntime.test…serverMain.test|title=server.main directory creation should create nested directories with recursive option|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/server/test/node/serverMain.test|title=server.main directory creation should create nested directories with recursive option|occurrence=1serverMain.test|title=se…serverMain.test|title=server.main directory creation should handle existing directories gracefully|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/server/test/node/serverMain.test|title=server.main directory creation should handle existing directories gracefully|occurrence=1serverMain.test|title=se…serverMain.test|title=server.main directory creation should not fail when parent directories do not exist|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/server/test/node/serverMain.test|title=server.main directory creation should not fail when parent directories do not exist|occurrence=1serverMain.test|title=se…Focused concept · foundryLocalRuntime.ts ×14 · 89 introduced LOCfoundryLocalRuntime.ts ×…

Graph controls are ready.

Interactive rendering requires JavaScript and WebGL. Use the native relationship evidence on this page while the interactive map is unavailable.

Native relationship evidence

Every exact file and test below is linked only from the concept that introduces it.

Introduced tests

Every collected test enters the hierarchy at exactly one concept.

No tests are introduced at this concept. Its intent tests are introduced by other concepts.

Introduced code

Every collected source range enters the hierarchy at exactly one concept.

1 file ranked by introduced lines: 89 introduced LOC across 14 ranges. Expand a file to inspect source; the > gutter marks introduced lines.

src/vs/platform/localTranscription/node/foundryLocalRuntime.ts 89 introduced LOC · 14 ranges

Open complete file

142 * host should use `ensureFoundryLocalRuntime`, which gates and de-dupes.
143 */
144 > export async function provisionRuntime(overrideDir: string, platformKey: string, urlTemplate: string, version: string, token: CancellationToken): Promise<void> { foundryLocalRuntime.ts
145 > const addonPath = foundryAddonPath(overrideDir, platformKey);
146 > const coreDir = foundryCoreDir(overrideDir, platformKey);
147 >
148 > // The cache is shared by the utility processes of every open VS Code window,
149 > // so provision into a process-unique staging dir and atomically promote each
150 > // payload directory into place. Two concurrent first-use downloads therefore
151 > // never write to the same final path; whichever process wins the rename is
152 > // the published copy and the loser accepts it as success.
153 > const url = format2(urlTemplate, { target: platformKey });
154 > const staging = join(overrideDir, `.staging-${process.pid}-${randomSuffix()}`);
155 > const stagingAddon = join(staging, 'prebuilds', platformKey, 'foundry_local_napi.node');
156 > const stagingCore = join(staging, 'foundry-local-core', platformKey);
157 > try {
158 > await downloadAndExtractTarball(url, staging, token);
159 throwIfCancelled(token);
160
161 > if (!fs.existsSync(stagingAddon) || !hasAllCoreLibraries(stagingCore)) { foundryLocalRuntime.ts
162 throw new Error(`Foundry Local native runtime download from ${url} completed but expected files are missing.`);
163 }
165 await promoteDir(dirname(stagingAddon), dirname(addonPath));
166 await promoteDir(stagingCore, coreDir);
167 > } finally { foundryLocalRuntime.ts
168 > await fs.promises.rm(staging, { recursive: true, force: true }).catch(() => { /* best effort */ });
169 > }
170
171 // Verify the published payload — ours or a concurrent winner's — is complete.
172 > if (!fs.existsSync(addonPath) || !hasAllCoreLibraries(coreDir)) { foundryLocalRuntime.ts
173 throw new Error('Foundry Local native runtime is incomplete after provisioning.');
174 }
224 }
225
226 > function randomSuffix(): string { foundryLocalRuntime.ts
227 > return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
228 > }
229
230 /** Minimum glibc version the Foundry Local addon requires on Linux. */
271 * `build/dictation-runtime/`.
272 */
273 > async function downloadAndExtractTarball(url: string, stagingDir: string, token: CancellationToken): Promise<void> { foundryLocalRuntime.ts
274 > await fs.promises.mkdir(stagingDir, { recursive: true });
275 > const tmpDir = await fs.promises.mkdtemp(join(os.tmpdir(), 'vscode-foundry-runtime-'));
276 > try {
277 > const tarballPath = join(tmpDir, 'runtime.tgz');
278 > await downloadFile(url, tarballPath, token);
279 throwIfCancelled(token);
280
282 const tar = await import('tar');
283 await tar.x({ file: tarballPath, cwd: stagingDir });
284 > } finally { foundryLocalRuntime.ts
285 > await fs.promises.rm(tmpDir, { recursive: true, force: true }).catch(() => { /* best effort */ });
286 > }
287 > }
288
289 /** The core library filenames required for the current platform. Exported for tests. */
352 * is imported dynamically like the other runtime-only dependencies here.
353 */
354 > async function resolveProxyAgent(targetUrl: string): Promise<import('http').Agent | undefined> { foundryLocalRuntime.ts
355 > const proxyUrl = resolveProxyUrl(targetUrl);
356 > if (!proxyUrl) {
357 > return undefined;
358 > }
359 const { HttpsProxyAgent } = await import('https-proxy-agent');
360 return new HttpsProxyAgent(proxyUrl);
362
363 /** Download `url` to `dest`, following redirects, honoring cancellation. */
364 > async function downloadFile(url: string, dest: string, token: CancellationToken): Promise<void> { foundryLocalRuntime.ts
365 > // `http`/`https` are slow-to-load builtins; import them lazily at runtime.
366 > // The CDN is always `https:`; `http:` support exists only so provisioning can
367 > // be exercised against a local test server.
368 > const [https, http] = await Promise.all([import('https'), import('http')]);
369 > const getFor = (u: string) => (new URL(u).protocol === 'http:' ? http.get : https.get);
370 > // A single proxy agent tunnels to whatever host each request (including any
371 > // redirect target) addresses, so resolving it once from the initial URL is
372 > // sufficient. `undefined` means "go direct".
373 > const agent = await resolveProxyAgent(url);
374 > return new Promise<void>((resolve, reject) => {
375 > let settled = false;
376 > let timer: ReturnType<typeof setTimeout> | undefined;
377 > let activeRequest: import('http').ClientRequest | undefined;
378 > const file = fs.createWriteStream(dest);
379 >
380 > const finish = (err?: Error) => {
381 > if (settled) {
382 return;
383 }
384 > settled = true; foundryLocalRuntime.ts
385 > if (timer) {
386 > clearTimeout(timer);
387 > }
388 > activeRequest?.destroy();
389 > if (!err) {
390 resolve();
391 return;
393 // Remove the partial file before surfacing the failure.
394 file.close(() => fs.promises.rm(dest, { force: true }).catch(() => { /* best effort */ }).finally(() => reject(err)));
396 > // `https.get` has no default timeout, so a stalled connection/response
397 > // would hang forever (and, via `stop()` awaiting the open promise, hang
398 > // dictation shutdown). Bound it with an inactivity timeout that resets on
399 > // progress and tears the request/partial file down when it fires.
400 > const armTimeout = () => {
401 > if (timer) {
402 > clearTimeout(timer);
403 > }
404 > timer = setTimeout(() => finish(new Error(`Timed out downloading ${url}.`)), DOWNLOAD_INACTIVITY_TIMEOUT_MS);
405 > };
406 >
407 > const request = (currentUrl: string, redirectsLeft: number): void => {
408 > if (token.isCancellationRequested) {
409 finish(new CancellationError());
410 return;
411 }
412 > armTimeout(); foundryLocalRuntime.ts
413 > activeRequest = getFor(currentUrl)(currentUrl, { agent }, response => {
414 > armTimeout();
415 > const status = response.statusCode ?? 0;
416 > if (status >= 300 && status < 400 && response.headers.location) {
417 response.resume();
418 if (redirectsLeft <= 0) {
423 return;
424 }
425 > if (status !== 200) { foundryLocalRuntime.ts
426 response.resume();
427 finish(new Error(`Download failed with status ${status}: ${currentUrl}`));
432 response.pipe(file);
433 file.on('finish', () => file.close(err => err ? finish(err) : finish()));
435 > activeRequest.on('error', err => finish(err));
436 > };
437 > file.on('error', err => finish(err));
438 > request(url, 5);
439 > });
440 > }
441
442 function throwIfCancelled(token: CancellationToken): void {