@volter/world-runtime 3.0.35 → 3.0.37

package/dist/src/browsers.d.ts

@@ -8,7 +8,7 @@ export type WorldBrowser = {
 export declare const browsersDir: (data: string) => string;
 export declare function worldBrowser(data: string, name: string): WorldBrowser | null;
 export declare function worldBrowsers(data: string): WorldBrowser[];
-export declare function putWorldBrowser(data: string, name: string, state: BrowserState): WorldBrowser;
+export declare function putWorldBrowser(data: string, name: string, state: unknown): WorldBrowser;
 export declare function deleteWorldBrowser(data: string, name: string): void;
 export declare function inheritWorldBrowsers(fromData: string, toData: string): void;
 /** Derived files under the World state directory, written only by its current branch. */

package/dist/src/browsers.js

@@ -26,7 +26,7 @@ export function worldBrowser(data, name) {
         held.text = text;
         return held.record;
     }
-    validateBrowserState(record.state);
+    record.state = validateBrowserState(record.state);
     const freeze = (value) => {
         if (!value || typeof value !== 'object')
             return;

package/dist/src/init.js

@@ -1159,15 +1159,15 @@ export async function seed(): Promise<void> {
         if (!door || !token) throw new Error('browser defaults run in a World seed with its browsers door and credential');
         const held = await fetch(\`\${door}/\${encodeURIComponent(call.browser)}\`, { headers: { 'x-volter-token': token } });
         if (!held.ok && held.status !== 404) throw new Error(\`browser \${call.browser}: \${held.status} \${await held.text()}\`);
-        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { cookies: [], origins: [] });
+        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { storageState: { cookies: [], origins: [] }, context: {} });
       }
       browserHelper ??= await import('@volter/world-core/browser').catch(error => {
-        throw new Error('Install @volter/world-core 3.0.31 or later in this project to seed browsers.', { cause: error });
+        throw new Error('Install @volter/world-core 3.0.37 or later in this project to seed browsers.', { cause: error });
       });
       const initial = snapshots.get(call.browser)!;
       const hostname = new URL(call.path).hostname;
-      if (initial.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
-        || initial.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
+      if (initial.storageState.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
+        || initial.storageState.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
     }
     const headers = { ...(call.body !== undefined ? { 'content-type': 'application/json' } : {}), ...(call.headers ?? {}) };
     const form = /^application\\/x-www-form-urlencoded\\b/i.test(new Headers(headers).get('content-type') ?? '');

package/dist/src/local-branches.js

@@ -3,9 +3,9 @@
 // parent through its own doors (its history cut at an instant, when one is asked), its clock frozen at
 // that instant so no twin's catch-up walks it forward, and removed when its time runs out. world-host
 // and `volter world view` both make them with this; a hosted World's supervisor makes its own.
-import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { stateDirName, withStateRemoval } from '@volter/world-core/runtime';
+import { readBranchMeta, stateDirName, withHistoryLock, withStateRemoval, worldPaths, worldStateRoot, writeBranchMeta } from '@volter/world-core/runtime';
 import { inheritWorldBrowsers, materializeBrowserFiles } from "./browsers.js";
 import { clockFile, statusWorld } from "./runtime.js";
 import { loadWorldConfig } from "./configs.js";
@@ -169,7 +169,25 @@ export class LocalBranches {
                 writeFileSync(file, `${clock}\n`);
             }
             const child = statusWorld(id, root);
-            inheritWorldBrowsers(statusWorld(world, from.root).dirs.data, child.dirs.data);
+            // The HTTP clone holds the history view here, but its URL parent holds no local resources.
+            // Retain the actual parent's state through the kernel's pointer/pin protocol: blob reads can
+            // follow it without copying uploads, while history keeps using the downloaded immutable view.
+            const base = statusWorld(world, from.root);
+            for (const service of Object.keys(child.services)) {
+                const control = join(child.dirs.data, service);
+                for (const state of readdirSync(worldStateRoot(control), { withFileTypes: true })) {
+                    if (!state.isDirectory())
+                        continue;
+                    const directory = worldPaths(state.name, control).dir;
+                    withHistoryLock(directory, () => {
+                        const meta = readBranchMeta(state.name, control);
+                        if (!meta?.parent)
+                            throw new Error(`cloning ${parent}: ${service}/${state.name} has no parent`);
+                        writeBranchMeta(state.name, { ...meta, parent: { ...meta.parent, at: join(base.dirs.data, service), viewDirectory: directory } }, control);
+                    });
+                }
+            }
+            inheritWorldBrowsers(base.dirs.data, child.dirs.data);
             materializeBrowserFiles(child.dirs.data, root, id, child.config);
             const createdAt = new Date().toISOString();
             const expiresAt = ttlSeconds === null ? null : new Date(Date.now() + ttlSeconds * 1000).toISOString();

package/dist/src/served-world.js

@@ -32,7 +32,7 @@ import { boardFrameKey, getActiveWorldStore, withHistoryLocks, captureHistory, h
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
 import { CALLER_HEADER, callerForHeader, newTraceparent, parseTraceparent, traceparentForDelivery, readTwinRequestJournalFrom, assertSafeChangesetName, blobDigest, destinationOf, getActiveBlobStore, journalTwinRequest, loadCheck, twinRequestJournalFailures, openSealedAt, readTwinRequestJournal, serveHttp, twinRequestCredentials, TWIN_PREFIX_HEADER, TWIN_SITES_HEADER, TWIN_SITE_HEADER, siteUrlOf, ORIGINAL_PATH_HEADER, validateRemoteOrigin } from '@volter/world-core/runtime';
 import { resolveTwinHost } from '@volter/world-core/host-routing';
-import { assertBrowserName, validateBrowserState, cookieMatchesHost } from '@volter/world-core';
+import { assertBrowserName, validateBrowserState, browserAcceptLanguage, cookieMatchesHost } from '@volter/world-core';
 import { worldBrowser, worldBrowsers, putWorldBrowser, deleteWorldBrowser, materializeBrowserFiles, browserLoad, putBrowserLoad, browserLoadId } from "./browsers.js";
 import { APP_READ_ENDPOINT_ENV } from "./init.js";
 import { packFacts, packHostRules } from "./pack-facts.js";
@@ -1129,8 +1129,8 @@ export class WorldDoors {
             return null;
         if (request.method !== 'GET' || !['document', 'iframe'].includes(request.headers.get('sec-fetch-dest') ?? ''))
             return null;
-        const cookies = browser.state.cookies.filter(c => cookieMatchesHost(c, site));
-        const storage = browser.state.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
+        const cookies = browser.state.storageState.cookies.filter(c => cookieMatchesHost(c, site));
+        const storage = browser.state.storageState.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
         const headers = new Headers({ 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store', 'referrer-policy': 'no-referrer' });
         const protectedCookie = (key) => /^(?:__Host-)?volter_(?:world|pages|browser)$/.test(key);
         const expired = new Map();
@@ -1240,6 +1240,10 @@ export class WorldDoors {
                     headers.set(name, v);
             }
             if (browser) {
+                const profile = worldBrowser(this.up().dirs.data, browser)?.state;
+                const language = profile ? browserAcceptLanguage(profile.context) : undefined;
+                if (language !== undefined)
+                    headers.set('accept-language', language);
                 const cookies = (request.headers.get('cookie') ?? '').split(/;\s*/).filter(c => !/^(?:__Host-)?volter_(?:world|pages|browser)=/.test(c));
                 if (cookies.length)
                     headers.set('cookie', cookies.join('; '));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "3.0.35",
+  "version": "3.0.37",
   "description": "World configs for twins: boot named local runtimes, allocate ports, generate world.env/instance.json, and run apps against fake-key twin worlds.",
   "keywords": [
     "twin",
@@ -68,14 +68,14 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.35",
-    "@volter/world-console": "3.0.30"
+    "@volter/world-core": "3.0.37",
+    "@volter/world-console": "3.0.32"
   },
   "dependencies": {
     "@electric-sql/pglite": "0.5.8",
     "@electric-sql/pglite-pgvector": "0.0.9",
     "@volter/world-access": "3.0.1",
-    "@volter/world-core": "3.0.35",
+    "@volter/world-core": "3.0.37",
     "pg-gateway": "0.3.0-beta.4",
     "smol-toml": "^1.8.0",
     "yaml": "2.9.0"

package/src/browsers.ts

@@ -20,7 +20,7 @@ export function worldBrowser(data: string, name: string): WorldBrowser | null {
   const record = JSON.parse(text) as WorldBrowser;
   if (record.name !== name || typeof record.version !== 'string') throw new Error(`invalid browser record: ${name}`);
   if (held?.version === record.version) { held.text = text; return held.record; }
-  validateBrowserState(record.state);
+  record.state = validateBrowserState(record.state);
   const freeze = (value: unknown): void => {
     if (!value || typeof value !== 'object') return;
     for (const item of Object.values(value)) freeze(item);
@@ -33,7 +33,7 @@ export function worldBrowser(data: string, name: string): WorldBrowser | null {
 export function worldBrowsers(data: string): WorldBrowser[] {
   return getActiveWorldStore().list(browsersDir(data)).filter(f => f.endsWith('.json')).sort().map(f => worldBrowser(data, f.slice(0, -5))!);
 }
-export function putWorldBrowser(data: string, name: string, state: BrowserState): WorldBrowser {
+export function putWorldBrowser(data: string, name: string, state: unknown): WorldBrowser {
   const record = { name, state: validateBrowserState(state), version: randomUUID() };
   getActiveWorldStore().writeAtomic(path(data, name), `${JSON.stringify(record)}\n`, { secret: true });
   retireBrowserLoads(data, name, record);

package/src/init.ts

@@ -1346,15 +1346,15 @@ export async function seed(): Promise<void> {
         if (!door || !token) throw new Error('browser defaults run in a World seed with its browsers door and credential');
         const held = await fetch(\`\${door}/\${encodeURIComponent(call.browser)}\`, { headers: { 'x-volter-token': token } });
         if (!held.ok && held.status !== 404) throw new Error(\`browser \${call.browser}: \${held.status} \${await held.text()}\`);
-        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { cookies: [], origins: [] });
+        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { storageState: { cookies: [], origins: [] }, context: {} });
       }
       browserHelper ??= await import('@volter/world-core/browser').catch(error => {
-        throw new Error('Install @volter/world-core 3.0.31 or later in this project to seed browsers.', { cause: error });
+        throw new Error('Install @volter/world-core 3.0.37 or later in this project to seed browsers.', { cause: error });
       });
       const initial = snapshots.get(call.browser)!;
       const hostname = new URL(call.path).hostname;
-      if (initial.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
-        || initial.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
+      if (initial.storageState.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
+        || initial.storageState.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
     }
     const headers = { ...(call.body !== undefined ? { 'content-type': 'application/json' } : {}), ...(call.headers ?? {}) };
     const form = /^application\\/x-www-form-urlencoded\\b/i.test(new Headers(headers).get('content-type') ?? '');

package/src/local-branches.ts

@@ -3,9 +3,9 @@
 // parent through its own doors (its history cut at an instant, when one is asked), its clock frozen at
 // that instant so no twin's catch-up walks it forward, and removed when its time runs out. world-host
 // and `volter world view` both make them with this; a hosted World's supervisor makes its own.
-import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { stateDirName, withStateRemoval } from '@volter/world-core/runtime';
+import { readBranchMeta, stateDirName, withHistoryLock, withStateRemoval, worldPaths, worldStateRoot, writeBranchMeta } from '@volter/world-core/runtime';
 import { inheritWorldBrowsers, materializeBrowserFiles } from './browsers.ts';
 import { clockFile, statusWorld } from './runtime.ts';
 import { loadWorldConfig } from './configs.ts';
@@ -162,7 +162,23 @@ export class LocalBranches {
       const clock = at.instant ?? this.frozenClock(from) ?? (at.live ? null : new Date().toISOString());
       if (clock) { const file = clockFile(root, id); mkdirSync(dirname(file), { recursive: true }); writeFileSync(file, `${clock}\n`); }
       const child = statusWorld(id, root);
-      inheritWorldBrowsers(statusWorld(world, from.root).dirs.data, child.dirs.data);
+      // The HTTP clone holds the history view here, but its URL parent holds no local resources.
+      // Retain the actual parent's state through the kernel's pointer/pin protocol: blob reads can
+      // follow it without copying uploads, while history keeps using the downloaded immutable view.
+      const base = statusWorld(world, from.root);
+      for (const service of Object.keys(child.services)) {
+        const control = join(child.dirs.data, service);
+        for (const state of readdirSync(worldStateRoot(control), { withFileTypes: true })) {
+          if (!state.isDirectory()) continue;
+          const directory = worldPaths(state.name, control).dir;
+          withHistoryLock(directory, () => {
+            const meta = readBranchMeta(state.name, control);
+            if (!meta?.parent) throw new Error(`cloning ${parent}: ${service}/${state.name} has no parent`);
+            writeBranchMeta(state.name, { ...meta, parent: { ...meta.parent, at: join(base.dirs.data, service), viewDirectory: directory } }, control);
+          });
+        }
+      }
+      inheritWorldBrowsers(base.dirs.data, child.dirs.data);
       materializeBrowserFiles(child.dirs.data, root, id, child.config);
       const createdAt = new Date().toISOString();
       const expiresAt = ttlSeconds === null ? null : new Date(Date.now() + ttlSeconds * 1000).toISOString();

package/src/served-world.ts

@@ -32,7 +32,7 @@ import { boardFrameKey, getActiveWorldStore, withHistoryLocks, captureHistory, h
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync , rmSync} from 'node:fs';
 import { CALLER_HEADER, callerForHeader, newTraceparent, parseTraceparent, traceparentForDelivery, readTwinRequestJournalFrom, type TwinRequestJournalCursor, assertSafeChangesetName, blobDigest, destinationOf, getActiveBlobStore, journalTwinRequest, loadCheck, twinRequestJournalFailures, openSealedAt, readTwinRequestJournal, serveHttp, twinRequestCredentials, TWIN_PREFIX_HEADER, TWIN_SITES_HEADER, TWIN_SITE_HEADER, siteLabel, siteUrlOf, ORIGINAL_PATH_HEADER, validateRemoteOrigin, type SealedCredential, type TwinStreamConnection, type TwinStreamSink, type BoardFrame } from '@volter/world-core/runtime';
 import { resolveTwinHost, type HostPredicate } from '@volter/world-core/host-routing';
-import { assertBrowserName, validateBrowserState, cookieMatchesHost } from '@volter/world-core';
+import { assertBrowserName, validateBrowserState, browserAcceptLanguage, cookieMatchesHost } from '@volter/world-core';
 import { worldBrowser, worldBrowsers, putWorldBrowser, deleteWorldBrowser, materializeBrowserFiles, browserLoad, putBrowserLoad, browserLoadId } from './browsers.ts';
 import { APP_READ_ENDPOINT_ENV } from './init.ts';
 import { packFacts, packHostRules } from './pack-facts.ts';
@@ -1024,8 +1024,8 @@ export class WorldDoors {
     const carried = [current, previous].filter(load => load?.name === name && load.site === site);
     if (id === loadId && current?.name === name && current.site === site && current.version === browser.version) return null;
     if (request.method !== 'GET' || !['document', 'iframe'].includes(request.headers.get('sec-fetch-dest') ?? '')) return null;
-    const cookies = browser.state.cookies.filter(c => cookieMatchesHost(c, site));
-    const storage = browser.state.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
+    const cookies = browser.state.storageState.cookies.filter(c => cookieMatchesHost(c, site));
+    const storage = browser.state.storageState.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
     const headers = new Headers({ 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store', 'referrer-policy': 'no-referrer' });
     const protectedCookie = (key: string): boolean => /^(?:__Host-)?volter_(?:world|pages|browser)$/.test(key);
     const expired = new Map<string, { name: string; path: string }>();
@@ -1111,6 +1111,9 @@ export class WorldDoors {
       for (const key of [TOKEN_HEADER, TWINS_KEY_HEADER, CALLER_HEADER, ORIGINAL_PATH_HEADER, READ_ONLY_HEADER, 'host', TWIN_PREFIX_HEADER, TWIN_SITES_HEADER, TWIN_SITE_HEADER]) headers.delete(key);
       for (const name of ['accept', 'accept-language', 'if-none-match', 'range', 'user-agent']) { const v = request.headers.get(name); if (v !== null) headers.set(name, v); }
       if (browser) {
+        const profile = worldBrowser(this.up().dirs.data, browser)?.state;
+        const language = profile ? browserAcceptLanguage(profile.context) : undefined;
+        if (language !== undefined) headers.set('accept-language', language);
         const cookies = (request.headers.get('cookie') ?? '').split(/;\s*/).filter(c => !/^(?:__Host-)?volter_(?:world|pages|browser)=/.test(c));
         if (cookies.length) headers.set('cookie', cookies.join('; '));
         headers.set('x-volter-world-browser', browser);