Sims local-server channel implementation investigation — 2026-11-15

Outcome: genuine LocalServer32 activation and its cross-process channel remain unimplemented. No production change or ISetupMedia qualification is claimed. The new native diagnostic reaches the actual automation stub's wire path and fails at unimplemented CoMarshalHresult; this is a concrete additional transport blocker, not a successful activation implementation. The ordinary original, installation progress and native Quit are withheld.

Both current predecessors released before native work: GTA2 release 67f6e10d…d54f and ReVolt release 201be716…4ac0. Their receipts and recorded processes/groups were personally checked, along with free locks and disk. The prior Sims historical UNKNOWN entries remain unchanged.

Implementation boundary

lib/storage.js owns a per-process sharedCom class/cookie table. Its com_create_instance first searches that table; without CLSCTX_INPROC_SERVER it immediately clears the output and returns REGDB_E_CLASSNOTREG. There is no LocalServer32 resolver or activation wait here. test/run.js's spawnVfsChild snapshots the registry at launch and merges only on native child close. Its IPC listener receives readiness and exit messages, not live class registrations or method calls. Publishing registry metadata earlier would not supply the missing live factory.

The existing comPendingScope in lib/guest-rpc.js isolates an in-process DLL name per calling thread. It is not an object channel. The existing _invokeComCallback rejects a callback that yields instead of returning to its exact sentinel. Server calls must therefore be scheduled on their actual guest owner, with process, thread, generation, module/source and invocation identity checked throughout suspension and return. A host shadow cannot borrow a blocked guest stack.

The real ISetupMedia type information reports two HRESULT methods at vtable offsets 12 and 16, both with interface-pointer outputs; the latter also takes BSTR. Genuine OLEAUT32 CreateProxy success says nothing about either method. The exact OLEAUT32 PE imports CoMarshalInterface, CoUnmarshalInterface, CoMarshalHresult and CoUnmarshalHresult from OLE32; none has an entry in the current API table. The native diagnostic below identifies CoMarshalHresult as its first fatal missing API. The in-process inter-thread pointer stream in src/09a7b-ole.wat cannot marshal these outputs across independent memories.

Prepared test inputs

test/test-sims-localserver-channel-implementation.cjs exports prepare(dir) for an authored separate server/client pair derived from the predecessor's public IDispatch fixture. The client checks a different real server process ID, a four-code-unit BSTR containing an embedded NUL and lambda, then an interface output used after releasing its original object and factory. The server requires the actual -Embedding command suffix and sleeps in factory creation and Invoke. The client checks stdcall stack cleanup and callee-saved registers around the actual Invoke call. These checks require the future owner scheduler to handle real yielding guest code. Only real guest implementations produce the output. A successful eventual run must use the actual registered proxy/stub and owned byte transport; the fixture itself does not implement either.

The same file exports a static PE import census so the exact DLL's marshaler dependencies can be pinned without launching a guest. Preparing or compiling these inputs is not activation qualification. The unchanged genuine IKernel client remains a separate required qualification before any ordinary original.

A third authored candidate queries the four standard-marshaler exports using public LoadLibrary/GetProcAddress calls. Its exit mask identifies actually absent exports. Its observed result is below; it does not invoke or qualify a remote object.

Two further candidates resolve the actual interface output type information and exercise the public call sequence visible in unchanged Setup at 0x405f89 and 0x406067. The latter launches genuine IKernel -RegServer, waits for its native child completion, requests the exact ISetupMedia IID, and, if successful, queries {f4817e4b-04b6-11d3-8862-00c04f72f303} and calls its actual vtable slot 3 with GUID_NULL and the registered ISetupInfo IID. It writes no registry values. This authored client is a diagnostic for the genuine server; it does not replace the required unchanged-client qualification. These candidates were compiled. The separate deep server/client pair remains unrun: there is no production channel capable of transporting their calls.

An additional local diagnostic connects a real OLEAUT32 IDispatch proxy and stub with an authored IRpcChannelBuffer. SendReceive calls the actual stub's Invoke and records request/reply sizes. The actual guest object supplies its process ID, echoes the deep BSTR and returns an interface. This isolates the real marshaler ABI from native transport, and remains explicitly a local loopback test rather than cross-process activation.

Native observations

Evidence is in scratch/runs/20261115-sims-localserver-channel-implementation/. The HEAD-plus-whole-owned build uses source HEAD 74fa0f977893fbd430ee52f37604290bdfcfd7bd and produces module SHA-256 ed7abcb17bc968d876e8d5ca598f4cb947c6a020dc9039c99ec31f86277c2bf6. Foreign source WIP, including the op5 dispatcher, is excluded from that source view and preserved byte-for-byte in the shared checkout.

marshal-exports loads OLE32 through public APIs and observes NULL for CoMarshalInterface, CoUnmarshalInterface, CoMarshalHresult and CoUnmarshalHresult. Its real guest exit is 15, the four missing-export bits. This is an observed capability absence, not an activation pass.

oleaut-loopback-debug loads the pinned real OLEAUT32 and runs its initializer. Public OutputDebugString traces record DllGetClassObject, CreateStub, CreateProxy and Connect returning S_OK. Connect makes a 16-byte method-7 request whose actual stub Invoke returns S_OK. The first ordinary IDispatch Invoke then sends method 6 with 46 request bytes. Inside this actual stub path, OLEAUT32 calls CoMarshalHresult and the interpreter fails fast:

UNIMPLEMENTED API: CoMarshalHresult
call site: oleaut32+0x6537d6fc (loaded address 0x005446fc)
native host exit: 1; independent watchdog did not fire

There is no returned Invoke HRESULT or completed BSTR/interface round trip. This local diagnostic does not establish a cross-process factory/object call or any genuine ISetupMedia invocation. Earlier file-only and virtual-console reports did not preserve progress on the fatal exit; the debug-string run is the selected evidence for the exact boundary. The metadata probe exited 0, but its report export filter was too narrow and its output IIDs were not recovered; no new output-type qualification is claimed from that run.

kernel-client mounts genuine read-only Disc1, the exact IKernel, COMMCTRL and stdole32, and writes no registry entries itself. Genuine IKernel -RegServer exits 0; actual native child close precedes the guarded merge of five files and 298 real registry/INI keys. The real SetupKernel LocalServer32 value, ISetupMedia ProxyStubClsid32 and TypeLib mappings are present. The parent's single exact-IID CoCreateInstance still returns 0x80040154, output NULL, guest exit 110. Only the registrar child launches. No activation server or follow-on QI/service call occurs. This authored public-sequence client is diagnostic; it is not the unchanged original client qualification.

The entry requires exactly the two pinned Worker-safe preloads and the source-qualified module hash. Removing either preload independently exits 1 before the runner or guest loads. Five focused retained-evidence checks pass. Compiler declaration errors were corrected before guest execution; all six authored inputs compile. Native/watchdog/supervisor-child actual waits, both EOFs, recorded process/group absence and lock checks are retained separately.

The required shared-checkout flock /tmp/wine-build.lock bash tools/build.sh also passes and restores shared module SHA-256 878e49103bdeff048d0685ecc47a23d4f769310d66776a7e9fdbb2e884c9d7dc. It includes preserved foreign WIP and was not used for these native probes. Source verification checks 16,278 recorded source pins in 62 files against the exact committed source view. Current media, DLL and preload hashes are recorded by path; no source tree, media or module archive is retained.

The next implementation must supply the real IStream-based HRESULT and interface marshaling operations as part of the actual owned proxy/stub transport, alongside LocalServer32 launch, live publication and owner-side factory/object scheduling. A successful bootstrap packet, export addition or same-process method pass cannot substitute for that full route. Delayed registration, timeout/early exit, remote refcounts/revoke and replacement refusals remain unqualified. No new ordinary original is authorized.

Transport contract to exercise

Microsoft's IRpcChannelBuffer contract places GetBuffer, SendReceive, FreeBuffer, GetDestCtx and IsConnected on the channel. The RPCOLEMESSAGE layout carries the data representation, byte buffer, size and method number. Only those bytes and validated identities may cross the process channel; Buffer, reserved fields and interface pointers are process-local addresses. The server's actual IPSFactoryBuffer::CreateStub must connect the actual server interface to an IRpcStubBuffer. Its Invoke executes on the owning server guest and returns bytes to the client proxy.

For interface outputs, the standard marshaler must publish an owned remote object identity and construct a real client proxy through the registered proxy factory. Neither copying the output pointer nor extending the in-process pointer stream meets that contract. Revoke stops new activation; outstanding interface references still own their server objects until actual Release. Server retirement invalidates the endpoint generation and pending calls; replacing a source/module, process, thread or generation must refuse the old invocation rather than replay it.

The run-specific scratch/runs/20261115-sims-localserver-channel-implementation/supervise.py prepares an independent watchdog before releasing a command through a pipe gate. It records actual native/watchdog/supervisor-child waits and both pipe EOFs. It was used for the native diagnostics and builds. No box was created.

Existing transport candidate

lib/process-desktop.js already starts an authority and a bridge in native Workers. Related CLI processes inherit its authenticated endpoint through ProcessDesktop.environment(). The authority assigns a distinct session and guest process ID, never recycles session identity, and retires sessions on socket closure. Its current operation set concerns USER windows only. It is a candidate carrier for live COM publication and bounded request delivery; it is not an existing COM channel. Its synchronous metadata operations must not execute a guest callback from a host import or a shadow instance.

COM dispatch would need a separate scheduler service on the actual registered guest thread. The service must retain the current wait/callback ownership, copy RPC bytes into server-local storage, call the real stub, drive allowed yield/loader work on that owner, and revalidate identity before restoring the interrupted state. The existing process-send broker demonstrates owned request queues and nested wait reservations, but its WndProc adapter is not an arbitrary COM invocation adapter. Neither existing component can be relabeled as implemented activation.