@volter/world-runtime 3.0.63 → 3.0.64

package/dist/src/catalog.d.ts

@@ -27,7 +27,10 @@ export declare function packCli(dir: string): string | undefined;
 /** The nearest `node_modules/<name>` above `from` that holds a package.json — node's own walk. */
 export declare const findInstalledPackage: typeof installedPackageDir;
 export declare function checkoutCatalog(root: string): Catalog;
-export declare function installedCatalog(root: string): Catalog;
+export declare function installedCatalog(root: string, options?: {
+    sources?: Readonly<Record<string, string>>;
+    vendors?: readonly string[];
+}): Catalog;
 /**
  * One catalog over several sources (docs/contributing/architecture.md, "The catalog: where twins come from"): each
  * vendor is served by the pack of the higher major; on a tie the earlier source keeps it. `kind` is the first source's.
@@ -39,6 +42,9 @@ export declare function overlayPackFactsFile(file: string): void;
 export declare function packFactsFile(dir: string): string | undefined;
 /** The catalog for a World root: its pack repository (or the one beside its platform checkout), merged with installed
  *  packages. Only the selected packs' own facts are overlaid on the kernel's. */
-export declare function resolveCatalog(root: string): Catalog;
+export declare function resolveCatalog(root: string, options?: {
+    sources?: Readonly<Record<string, string>>;
+    vendors?: readonly string[];
+}): Catalog;
 /** The pack directory a service boots from: its `package` resolved from the world root at boot. */
 export declare function resolveServicePackage(root: string, pkg: string): string;

package/dist/src/catalog.js

@@ -84,8 +84,8 @@ export function checkoutCatalog(root) {
         },
     };
 }
-export function installedCatalog(root) {
-    const twins = new Map([...installedVendorPacks(root)].filter(([, dir]) => packCli(dir) !== undefined));
+export function installedCatalog(root, options = {}) {
+    const twins = new Map([...installedVendorPacks(root, options)].filter(([, dir]) => packCli(dir) !== undefined));
     return {
         kind: 'installed',
         root: resolve(root),
@@ -149,9 +149,9 @@ export function packFactsFile(dir) {
 }
 /** The catalog for a World root: its pack repository (or the one beside its platform checkout), merged with installed
  *  packages. Only the selected packs' own facts are overlaid on the kernel's. */
-export function resolveCatalog(root) {
+export function resolveCatalog(root, options = {}) {
     const resolved = resolve(root);
-    const installed = installedCatalog(resolved);
+    const installed = installedCatalog(resolved, options);
     const repo = packRepository(resolved);
     const catalog = repo === undefined ? installed : mergedCatalog([checkoutCatalog(repo), installed]);
     for (const vendor of catalog.vendors()) {

package/dist/src/init.d.ts

@@ -183,9 +183,10 @@ export type InitOptions = {
     force?: boolean;
     allowUnknown?: boolean;
     acknowledge?: Record<string, string>;
-    /** The twins, named outright instead of detected from the repo (a bare world: `init --bare
-     *  <org>/<world> --twins a,b`). */
+    /** The twins deliberately selected instead of including every detected vendor. */
     vendors?: string[];
+    /** Installed package choices by vendor, before discovery resolves competing publishers. */
+    sources?: Record<string, string>;
     /** A world with no app: served as `/<org>/<world>/`. */
     bare?: string;
 };

package/dist/src/init.js

@@ -518,7 +518,7 @@ export function planWorldInit(name, repoPath, options = {}) {
     /** a path the config carries: relative to the world root when the config lives under it
      *  (portable between teammates), absolute otherwise (a pilot emitted away from its root) */
     const carried = (path) => (isInside(root, path) ? relative(root, path) : path);
-    const catalogSource = resolveCatalog(root);
+    const catalogSource = resolveCatalog(root, { sources: options.sources, vendors: options.vendors });
     const catalog = new Set(catalogSource.vendors());
     // the catalog index's defaults (the installed `@volter/twin-catalog`), which name the twin to install for a vendor
     // this catalog lacks
@@ -604,9 +604,12 @@ export function planWorldInit(name, repoPath, options = {}) {
                 return null;
             }
         })();
-        const handlersTo = starterHandlers !== null ? ownedPath(out, `handlers/${vendor}.json`) : null;
+        const handlersPath = ownedPath(out, `handlers/${vendor}.json`);
+        // A published generative pack need not ship its author's journeys. Its scenario file is
+        // still a World-owned input, including one the user writes after init.
+        const handlersTo = starterHandlers !== null || packFacts()[vendor]?.archetype === 'generative' || existsSync(handlersPath) ? handlersPath : null;
         if (handlersTo !== null)
-            defaultsCopies.push({ vendor, kind: 'handlers', content: starterHandlers, to: handlersTo });
+            defaultsCopies.push({ vendor, kind: 'handlers', content: starterHandlers ?? `${JSON.stringify({ handlers: [] }, null, 2)}\n`, to: handlersTo });
         const handlersArg = handlersTo === null ? null : carried(handlersTo);
         // a pack's default data (src/semantics/seed.ts: calls to the vendor's own operations, as data) is copied beside a
         // runner that makes each call against the twin, both the author's from then on

package/dist/src/pack-facts.d.ts

@@ -22,6 +22,8 @@ export type PackFacts = {
     maxRequestBodySize?: number;
     /** Existing descriptor transport, compiled into the same artifact as endpoint/adoption facts. */
     transport?: string;
+    /** Descriptor serve family, compiled into the same artifact as transport and adoption facts. */
+    archetype?: string;
     adoption?: PackAdoption;
     hosts?: Array<{
         host?: string;

package/dist/src/runtime.js

@@ -1450,6 +1450,7 @@ async function startService(config, service, worldEnv, paths, allocatedPorts, bo
         url,
         ...sidesRecord(sides),
         ...(mounted.version !== undefined ? { resolvedVersion: mounted.version } : {}),
+        ...(mounted.name !== undefined ? { resolvedPackage: mounted.name } : {}),
         ...(mounted.protocol !== undefined ? { protocol: mounted.protocol } : {}),
         pid: child.pid ?? 0,
         log,
@@ -1471,9 +1472,11 @@ function mountedPackage(modulePath, serviceId) {
         const p = join(dir, 'package.json');
         if (existsSync(p)) {
             try {
-                const v = JSON.parse(readFileSync(p, 'utf8')).version;
-                if (typeof v === 'string') {
-                    out.version = v;
+                const manifest = JSON.parse(readFileSync(p, 'utf8'));
+                if (typeof manifest.name === 'string')
+                    out.name = manifest.name;
+                if (typeof manifest.version === 'string') {
+                    out.version = manifest.version;
                     out.packagePath = p;
                 }
             }
@@ -1503,7 +1506,7 @@ function lockfileCheck(service, modulePath) {
         if (mounted.version === undefined)
             throw new Error(`Twin "${service.id}" pins version ${service.version} but no package.json was found above ${modulePath} — nothing to hold the pin against`);
         if (!versionSatisfies(mounted.version, service.version))
-            throw new Error(`Twin "${service.id}" pins version ${service.version} and the mounted package is ${mounted.version} (${mounted.packagePath}) — install the version the World names (npm install -D @volter/twin-${service.id}@${service.version}, as a committed lockfile does), or move the pin to it: "version" on the service in .volter/world.json (volter-world outdated lists both)`);
+            throw new Error(`Twin "${service.id}" pins version ${service.version} and the mounted package is ${mounted.version} (${mounted.packagePath}) — install the version the World names (npm install -D --save-exact ${service.package ?? mounted.name ?? `@volter/twin-${service.id}`}@${service.version}), or trial an update in a separate app directory before changing source.version in .volter/world.json (volter-world outdated lists both)`);
     }
     if (mounted.protocol?.standing === 'refused')
         throw new Error(`Twin "${service.id}" targets protocol major ${mounted.protocol.major}; this platform serves ${PROTOCOL_VERSION} only (runtime contract R16)`);
@@ -1846,6 +1849,7 @@ async function startColocatedServices(config, colocated, isolation, worldEnv, pa
             url,
             ...sidesRecord(sides),
             ...(mounted.version !== undefined ? { resolvedVersion: mounted.version } : {}),
+            ...(mounted.name !== undefined ? { resolvedPackage: mounted.name } : {}),
             ...(mounted.protocol !== undefined ? { protocol: mounted.protocol } : {}),
             pid: child.pid ?? 0,
             log,
@@ -2140,8 +2144,10 @@ export async function upWorld(configId, options = {}, abort) {
     try {
         const services = {};
         const recordService = (started) => {
-            const branchState = loaded.config.services.find(service => service.id === started.id)?.branchState;
-            services[started.id] = { ...started, branchState: branchState ?? 'supported' };
+            const selected = loaded.config.services.find(service => service.id === started.id);
+            services[started.id] = { ...started, branchState: selected?.branchState ?? 'supported',
+                ...(selected?.package || selected?.version ? { pinnedSource: { ...(selected.package ? { package: selected.package } : {}), ...(selected.version ? { version: selected.version } : {}) } } : {}),
+            };
         };
         const inheritedEnv = admittedEnv(loaded.config.stripEnv);
         const env = {

package/dist/src/schema.d.ts

@@ -345,6 +345,13 @@ export type WorldServiceInstance = {
     /** R17 — what the host actually mounted for a colocated twin: the package version read from
      *  the module's own package.json, and the protocol standing (R16) it declared. */
     resolvedVersion?: string;
+    /** Package identity captured before boot, never inferred from a later installation. */
+    resolvedPackage?: string;
+    /** Configured selection at boot; distinct from the package actually mounted. */
+    pinnedSource?: {
+        package?: string;
+        version?: string;
+    };
     protocol?: {
         declared?: string;
         major: number;

package/dist/src/schema.js

@@ -214,8 +214,8 @@ function assertLegacyWorldConfig(value, path) {
             assertExternalServiceConfig(service, path);
         }
         else {
-            if (service.package !== undefined && !(typeof service.package === 'string' && /^@volter\/twin-[a-z0-9][a-z0-9-]*$/.test(service.package))) {
-                throw new Error(`Service "${service.id}" package must name a twin package (@volter/twin-<vendor>) in ${path}`);
+            if (service.package !== undefined && !(typeof service.package === 'string' && /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/.test(service.package))) {
+                throw new Error(`Service "${service.id}" package must be an npm package name; the installed descriptor establishes its vendor and protocol in ${path}`);
             }
             if (service.package === undefined && (!service.command || typeof service.command !== 'string')) {
                 throw new Error(`Service "${service.id}" must define command (or package) in ${path}`);

package/dist/src/served-world.d.ts

@@ -120,6 +120,12 @@ export type WorldLayout = {
     services: Record<string, {
         url?: string;
         protocol?: unknown;
+        resolvedPackage?: string;
+        resolvedVersion?: string;
+        pinnedSource?: {
+            package?: string;
+            version?: string;
+        };
     }>;
 };
 /** The host a world's doors run in: its layout, and how a request reaches a twin's wire — a local

package/dist/src/served-world.js

@@ -2352,7 +2352,11 @@ export class WorldDoors {
                     refresh = null;
                 }
                 const last = [...parentEntries(state, this.controlRoot(name))].reverse().find((e) => e.landsId && e.receipt);
-                return Response.json({ twin: name, state, protocol: this.up().services[name]?.protocol ?? null, screens: await this.screensOf(name), root: root ?? null, credential: sealedCredentialInfo(this.worldRoot, name), refresh, position: wholeLog(state, this.controlRoot(name)).length, lastReceipt: last?.receipt ?? null });
+                const mounted = this.up().services[name];
+                const origin = readBranchMeta(state, this.controlRoot(name))?.origin;
+                const identity = { mounted: mounted?.resolvedPackage ? { package: mounted.resolvedPackage, version: mounted.resolvedVersion ?? null } : null, pinned: mounted?.pinnedSource ?? null };
+                const dataOrigin = origin ? { kind: 'shared-history', url: origin.at } : refresh ? { kind: 'vendor-refresh', url: root?.url ?? null } : { kind: 'unrecorded', url: null };
+                return Response.json({ twin: name, state, identity, dataOrigin, execution: { rootConnected: Boolean(root), deploy: root?.deploy ?? null }, protocol: mounted?.protocol ?? null, screens: await this.screensOf(name), root: root ?? null, credential: sealedCredentialInfo(this.worldRoot, name), refresh, position: wholeLog(state, this.controlRoot(name)).length, lastReceipt: last?.receipt ?? null });
             }
             if (verb === 'refresh' && request.method === 'POST') {
                 const root = rootForControlRoot(this.controlRoot(name), name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "3.0.63",
+  "version": "3.0.64",
   "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",
@@ -69,14 +69,14 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.63",
-    "@volter/world-console": "3.0.58"
+    "@volter/world-core": "3.0.64",
+    "@volter/world-console": "3.0.59"
   },
   "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.63",
+    "@volter/world-core": "3.0.64",
     "mongodb": "~6.20.0",
     "pg-gateway": "0.3.0-beta.4",
     "smol-toml": "^1.8.0",

package/src/catalog.ts

@@ -98,8 +98,8 @@ export function checkoutCatalog(root: string): Catalog {
   };
 }
 
-export function installedCatalog(root: string): Catalog {
-  const twins = new Map([...installedVendorPacks(root)].filter(([, dir]) => packCli(dir) !== undefined));
+export function installedCatalog(root: string, options: { sources?: Readonly<Record<string, string>>; vendors?: readonly string[] } = {}): Catalog {
+  const twins = new Map([...installedVendorPacks(root, options)].filter(([, dir]) => packCli(dir) !== undefined));
   return {
     kind: 'installed',
     root: resolve(root),
@@ -156,9 +156,9 @@ export function packFactsFile(dir: string): string | undefined {
 
 /** The catalog for a World root: its pack repository (or the one beside its platform checkout), merged with installed
  *  packages. Only the selected packs' own facts are overlaid on the kernel's. */
-export function resolveCatalog(root: string): Catalog {
+export function resolveCatalog(root: string, options: { sources?: Readonly<Record<string, string>>; vendors?: readonly string[] } = {}): Catalog {
   const resolved = resolve(root);
-  const installed = installedCatalog(resolved);
+  const installed = installedCatalog(resolved, options);
   const repo = packRepository(resolved);
   const catalog = repo === undefined ? installed : mergedCatalog([checkoutCatalog(repo), installed]);
   for (const vendor of catalog.vendors()) {

package/src/init.ts

@@ -258,9 +258,10 @@ export type InitOptions = {
   force?: boolean;
   allowUnknown?: boolean;
   acknowledge?: Record<string, string>;
-  /** The twins, named outright instead of detected from the repo (a bare world: `init --bare
-   *  <org>/<world> --twins a,b`). */
+  /** The twins deliberately selected instead of including every detected vendor. */
   vendors?: string[];
+  /** Installed package choices by vendor, before discovery resolves competing publishers. */
+  sources?: Record<string, string>;
   /** A world with no app: served as `/<org>/<world>/`. */
   bare?: string;
 };
@@ -721,7 +722,7 @@ export function planWorldInit(name: string, repoPath: string, options: InitOptio
    *  (portable between teammates), absolute otherwise (a pilot emitted away from its root) */
   const carried = (path: string): string => (isInside(root, path) ? relative(root, path) : path);
 
-  const catalogSource: Catalog = resolveCatalog(root);
+  const catalogSource: Catalog = resolveCatalog(root, { sources: options.sources, vendors: options.vendors });
   const catalog = new Set(catalogSource.vendors());
   // the catalog index's defaults (the installed `@volter/twin-catalog`), which name the twin to install for a vendor
   // this catalog lacks
@@ -800,8 +801,11 @@ export function planWorldInit(name: string, repoPath: string, options: InitOptio
         return answering.length ? `${JSON.stringify({ ...doc, handlers: answering }, null, 2)}\n` : null;
       } catch { return null; }
     })();
-    const handlersTo = starterHandlers !== null ? ownedPath(out, `handlers/${vendor}.json`) : null;
-    if (handlersTo !== null) defaultsCopies.push({ vendor, kind: 'handlers', content: starterHandlers!, to: handlersTo });
+    const handlersPath = ownedPath(out, `handlers/${vendor}.json`);
+    // A published generative pack need not ship its author's journeys. Its scenario file is
+    // still a World-owned input, including one the user writes after init.
+    const handlersTo = starterHandlers !== null || packFacts()[vendor]?.archetype === 'generative' || existsSync(handlersPath) ? handlersPath : null;
+    if (handlersTo !== null) defaultsCopies.push({ vendor, kind: 'handlers', content: starterHandlers ?? `${JSON.stringify({ handlers: [] }, null, 2)}\n`, to: handlersTo });
     const handlersArg = handlersTo === null ? null : carried(handlersTo);
     // a pack's default data (src/semantics/seed.ts: calls to the vendor's own operations, as data) is copied beside a
     // runner that makes each call against the twin, both the author's from then on

package/src/pack-facts.ts

@@ -17,6 +17,8 @@ export type PackFacts = {
   maxRequestBodySize?: number;
   /** Existing descriptor transport, compiled into the same artifact as endpoint/adoption facts. */
   transport?: string;
+  /** Descriptor serve family, compiled into the same artifact as transport and adoption facts. */
+  archetype?: string;
   adoption?: PackAdoption;
   hosts?: Array<{ host?: string; suffix?: string; hostPattern?: string; pathPattern?: string; key?: string; exclude?: true }>;
   hostsNone?: string;

package/src/runtime.ts

@@ -1441,6 +1441,7 @@ async function startService(
     url,
     ...sidesRecord(sides),
     ...(mounted.version !== undefined ? { resolvedVersion: mounted.version } : {}),
+    ...(mounted.name !== undefined ? { resolvedPackage: mounted.name } : {}),
     ...(mounted.protocol !== undefined ? { protocol: mounted.protocol } : {}),
     pid: child.pid ?? 0,
     log,
@@ -1452,7 +1453,7 @@ async function startService(
   };
 }
 
-type MountedPackage = { version?: string; packagePath?: string; protocol?: { declared?: string; major: number; standing: string } };
+type MountedPackage = { name?: string; version?: string; packagePath?: string; protocol?: { declared?: string; major: number; standing: string } };
 /** What the host is about to mount, read WITHOUT importing the pack (the kernel never imports
  *  packs): the nearest package.json above the module for the version, pack-facts for the
  *  protocol standing the catalog recorded — keyed by the vendor dir the module sits in, else
@@ -1463,7 +1464,7 @@ function mountedPackage(modulePath: string, serviceId: string): MountedPackage {
   for (let i = 0; i < 6; i++) {
     const p = join(dir, 'package.json');
     if (existsSync(p)) {
-      try { const v = (JSON.parse(readFileSync(p, 'utf8')) as { version?: unknown }).version; if (typeof v === 'string') { out.version = v; out.packagePath = p; } } catch { /* unreadable: no version to hold a pin against */ }
+      try { const manifest = JSON.parse(readFileSync(p, 'utf8')) as { name?: unknown; version?: unknown }; if (typeof manifest.name === 'string') out.name = manifest.name; if (typeof manifest.version === 'string') { out.version = manifest.version; out.packagePath = p; } } catch { /* unreadable: no version to hold a pin against */ }
       break;
     }
     const up = dirname(dir); if (up === dir) break; dir = up;
@@ -1479,7 +1480,7 @@ function lockfileCheck(service: WorldServiceConfig, modulePath: string): Mounted
   const mounted = mountedPackage(modulePath, service.id);
   if (service.version !== undefined) {
     if (mounted.version === undefined) throw new Error(`Twin "${service.id}" pins version ${service.version} but no package.json was found above ${modulePath} — nothing to hold the pin against`);
-    if (!versionSatisfies(mounted.version, service.version)) throw new Error(`Twin "${service.id}" pins version ${service.version} and the mounted package is ${mounted.version} (${mounted.packagePath}) — install the version the World names (npm install -D @volter/twin-${service.id}@${service.version}, as a committed lockfile does), or move the pin to it: "version" on the service in .volter/world.json (volter-world outdated lists both)`);
+    if (!versionSatisfies(mounted.version, service.version)) throw new Error(`Twin "${service.id}" pins version ${service.version} and the mounted package is ${mounted.version} (${mounted.packagePath}) — install the version the World names (npm install -D --save-exact ${service.package ?? mounted.name ?? `@volter/twin-${service.id}`}@${service.version}), or trial an update in a separate app directory before changing source.version in .volter/world.json (volter-world outdated lists both)`);
   }
   if (mounted.protocol?.standing === 'refused') throw new Error(`Twin "${service.id}" targets protocol major ${mounted.protocol.major}; this platform serves ${PROTOCOL_VERSION} only (runtime contract R16)`);
   return mounted;
@@ -1789,6 +1790,7 @@ async function startColocatedServices(
       url,
       ...sidesRecord(sides),
       ...(mounted.version !== undefined ? { resolvedVersion: mounted.version } : {}),
+    ...(mounted.name !== undefined ? { resolvedPackage: mounted.name } : {}),
       ...(mounted.protocol !== undefined ? { protocol: mounted.protocol } : {}),
       pid: child.pid ?? 0,
       log,
@@ -2028,8 +2030,10 @@ export async function upWorld(configId: string, options: UpWorldOptions = {}, ab
   try {
     const services: Record<string, WorldServiceInstance> = {};
     const recordService = (started: WorldServiceInstance) => {
-      const branchState = loaded.config.services.find(service => service.id === started.id)?.branchState;
-      services[started.id] = { ...started, branchState: branchState ?? 'supported' };
+      const selected = loaded.config.services.find(service => service.id === started.id);
+      services[started.id] = { ...started, branchState: selected?.branchState ?? 'supported',
+        ...(selected?.package || selected?.version ? { pinnedSource: { ...(selected.package ? { package: selected.package } : {}), ...(selected.version ? { version: selected.version } : {}) } } : {}),
+      };
     };
     const inheritedEnv = admittedEnv(loaded.config.stripEnv);
     const env: Record<string, string> = {

package/src/schema.ts

@@ -308,6 +308,10 @@ export type WorldServiceInstance = {
   /** R17 — what the host actually mounted for a colocated twin: the package version read from
    *  the module's own package.json, and the protocol standing (R16) it declared. */
   resolvedVersion?: string;
+  /** Package identity captured before boot, never inferred from a later installation. */
+  resolvedPackage?: string;
+  /** Configured selection at boot; distinct from the package actually mounted. */
+  pinnedSource?: { package?: string; version?: string };
   protocol?: { declared?: string; major: number; standing: string };
   /** Absent for 'external' services — we do not assign them a port. */
   port?: number;
@@ -607,8 +611,8 @@ function assertLegacyWorldConfig(value: unknown, path: string): WorldConfig {
     if (service.type === 'external') {
       assertExternalServiceConfig(service, path);
     } else {
-      if (service.package !== undefined && !(typeof service.package === 'string' && /^@volter\/twin-[a-z0-9][a-z0-9-]*$/.test(service.package))) {
-        throw new Error(`Service "${service.id}" package must name a twin package (@volter/twin-<vendor>) in ${path}`);
+      if (service.package !== undefined && !(typeof service.package === 'string' && /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/.test(service.package))) {
+        throw new Error(`Service "${service.id}" package must be an npm package name; the installed descriptor establishes its vendor and protocol in ${path}`);
       }
       if (service.package === undefined && (!service.command || typeof service.command !== 'string')) {
         throw new Error(`Service "${service.id}" must define command (or package) in ${path}`);

package/src/served-world.ts

@@ -351,7 +351,7 @@ function streamEnv(id: string, protocol: string): Record<string, string> {
 
 /** What the doors need of a world: where each twin's state lives and which twins it has. A booted
  *  local instance is one; a hosted World describes itself. */
-export type WorldLayout = { dirs: { data: string }; envFile?: string; services: Record<string, { url?: string; protocol?: unknown }> };
+export type WorldLayout = { dirs: { data: string }; envFile?: string; services: Record<string, { url?: string; protocol?: unknown; resolvedPackage?: string; resolvedVersion?: string; pinnedSource?: { package?: string; version?: string } }> };
 /** The host a world's doors run in: its layout, and how a request reaches a twin's wire — a local
  *  host forwards to the twin's own port, a hosted World calls the pack in-process. */
 export type DoorHost = {
@@ -1961,7 +1961,11 @@ export class WorldDoors {
         const marker = getActiveWorldStore().read(join(this.controlRoot(name), stateDirName(), 'world', name, 'refresh.json'));
         let refresh: unknown = null; try { if (marker !== null) refresh = JSON.parse(marker); } catch { refresh = null; }
         const last = [...parentEntries(state, this.controlRoot(name))].reverse().find((e) => e.landsId && e.receipt);
-        return Response.json({ twin: name, state, protocol: this.up().services[name]?.protocol ?? null, screens: await this.screensOf(name), root: root ?? null, credential: sealedCredentialInfo(this.worldRoot, name), refresh, position: wholeLog(state, this.controlRoot(name)).length, lastReceipt: last?.receipt ?? null });
+        const mounted = this.up().services[name];
+        const origin = readBranchMeta(state, this.controlRoot(name))?.origin;
+        const identity = { mounted: mounted?.resolvedPackage ? { package: mounted.resolvedPackage, version: mounted.resolvedVersion ?? null } : null, pinned: mounted?.pinnedSource ?? null };
+        const dataOrigin = origin ? { kind: 'shared-history', url: origin.at } : refresh ? { kind: 'vendor-refresh', url: root?.url ?? null } : { kind: 'unrecorded', url: null };
+        return Response.json({ twin: name, state, identity, dataOrigin, execution: { rootConnected: Boolean(root), deploy: root?.deploy ?? null }, protocol: mounted?.protocol ?? null, screens: await this.screensOf(name), root: root ?? null, credential: sealedCredentialInfo(this.worldRoot, name), refresh, position: wholeLog(state, this.controlRoot(name)).length, lastReceipt: last?.receipt ?? null });
       }
       if (verb === 'refresh' && request.method === 'POST') {
         const root = rootForControlRoot(this.controlRoot(name), name);