@zlink-systems/framework 0.29.1 → 0.30.1

package/src/runtime/protocol/service_wire_pilot_codec.generated.ts

@@ -1,4 +1,4 @@
-// <auto-generated> DO NOT EDIT. schema-sha256: 818fcd2f767793be8b5f626e5ac688807e671e546af2b11786e6fbaa02010ba5
+// <auto-generated> DO NOT EDIT. schema-sha256: c9a343a64d205ce666d1e866df72538c11b3b52cf4bff41562e46d4aeaf20df6
 export interface ServiceWireRouteFence { readonly id: string; readonly generation: bigint; readonly targetNodeRid: Uint8Array; readonly targetNodeGeneration: bigint; readonly expectedAuthorityOwnerGeneration: bigint; readonly expectedOwnerLeaseGeneration: bigint; }
 	export interface ApplicationPayloadEnvelopeV1 { readonly packetName: string; readonly contentType: string; readonly payload: Uint8Array; }
 	export interface ActorJoin28 { readonly correlation: bigint; readonly actor: ServiceWireRouteFence; readonly entry: boolean; readonly targetSpot: ServiceWireRouteFence; readonly payload?: ApplicationPayloadEnvelopeV1; }
@@ -19,7 +19,7 @@ export interface ServiceWireRouteFence { readonly id: string; readonly generatio
 	export function encodeActorJoin28(value: ActorJoin28): readonly Uint8Array[] { const out=[90,77,1,28,0]; if(value.correlation===0n) throw new RangeError("correlation"); u64(out,value.correlation); fence(out,value.actor); out.push(value.entry?1:0); fence(out,value.targetSpot); return value.payload===undefined?[Uint8Array.from(out)]:[Uint8Array.from(out),encodePayload(value.payload)]; }
 	export function decodeActorJoin28(frames: readonly Uint8Array[]): ActorJoin28 { if(frames.length<1||frames.length>2)throw new RangeError("actorJoin frames");const bytes=frames[0]!; const at={value:0}; if(bytes.length<5 || bytes[at.value++]!==90 || bytes[at.value++]!==77 || bytes[at.value++]!==1 || bytes[at.value++]!==28 || bytes[at.value++]!==0) throw new RangeError("actorJoin header"); const correlation=read64(bytes,at); const actor=readFence(bytes,at); const entry=bytes[at.value++]; const targetSpot=readFence(bytes,at); if(correlation===0n || entry>1 || at.value!==bytes.length) throw new RangeError("actorJoin body"); const payload=frames.length===2?decodePayload(frames[1]!):undefined; return payload===undefined?{ correlation, actor, entry:entry===1, targetSpot }:{ correlation, actor, entry:entry===1, targetSpot,payload }; }
 export type RelocationObjectIdentity = { readonly objectKind:"actor";readonly actorId:string;readonly objectGeneration:bigint;readonly expectedAuthorityOwnerGeneration:bigint; }|{ readonly objectKind:"userSpot";readonly spotId:string;readonly objectGeneration:bigint;readonly expectedAuthorityOwnerGeneration:bigint; }|{ readonly objectKind:"instanceSpot";readonly instanceType:string;readonly spotId:string;readonly objectGeneration:bigint; };
-export interface RelocationEnvelopeV1 { readonly relocationHigh: bigint; readonly relocationLow: bigint; readonly object: RelocationObjectIdentity; readonly applicationVersion: bigint; readonly applicationStates: readonly { readonly participantId: bigint; readonly hasState: boolean; readonly payload: Uint8Array; }[]; readonly savedWork: readonly { readonly participantId: bigint; readonly order: bigint; readonly frozenRecord: Uint8Array; }[]; readonly timerRegistrations: readonly { readonly participantId: bigint; readonly name: string; readonly handlerType: string; readonly periodMilliseconds: bigint; readonly overrunPolicy: 1|2|3; readonly maxCatchUpTicks: bigint; readonly stopOnUnhandledException: boolean; readonly lastCompletedDeliveryIndex: bigint; readonly lastCompletedScheduledIndex: bigint; readonly nextScheduledAtUnixMilliseconds: bigint; }[]; readonly pendingTimerTicks: readonly { readonly participantId: bigint; readonly order: bigint; readonly timerName: string; readonly deliveryIndex: bigint; readonly scheduledIndex: bigint; readonly scheduledAtUnixMilliseconds: bigint; readonly skippedTicks: bigint; }[]; }
+export interface RelocationEnvelopeV1 { readonly relocationHigh: bigint; readonly relocationLow: bigint; readonly object: RelocationObjectIdentity; readonly applicationVersion: bigint; readonly applicationStates: readonly { readonly participantId: bigint; readonly hasState: boolean; readonly payload: Uint8Array; }[]; readonly savedWork: readonly { readonly participantId: bigint; readonly order: bigint; readonly frozenRecord: Uint8Array; }[]; readonly timerRegistrations: readonly { readonly participantId: bigint; readonly name: string; readonly handlerType: string; readonly periodMilliseconds: bigint; readonly overrunPolicy: 1|2|3; readonly maxCatchUpTicks: bigint; readonly stopOnUnhandledException: boolean; readonly lastCompletedDeliveryIndex: bigint; readonly lastCompletedScheduledIndex: bigint; readonly nextScheduledAtUnixMilliseconds: bigint; }[]; readonly pendingTimerTicks: readonly { readonly participantId: bigint; readonly order: bigint; readonly timerName: string; readonly deliveryIndex: bigint; readonly scheduledIndex: bigint; readonly scheduledAtUnixMilliseconds: bigint; readonly skippedTicks: bigint; }[]; readonly sessionBindings: readonly {readonly participantId:bigint;readonly sessionOwnerNodeRid:Uint8Array;readonly sessionOwnerNodeGeneration:bigint;readonly sessionOwnerId:string;readonly sessionOwnerLeaseGeneration:bigint;readonly sessionRid:Uint8Array;readonly bindingGeneration:bigint;}[]; }
 export interface RelocationDataChunkV1 { readonly order:number;readonly data:Uint8Array; }
 export interface RelocationChunkEntryV1 { readonly order:number;readonly reference:string;readonly length:bigint;readonly checksumCrc32c:number; }
 export interface RelocationManifestV1 { readonly logicalFormatVersion:1;readonly totalLength:bigint;readonly totalChecksumCrc32c:number;readonly inventoryDigestSha256:Uint8Array;readonly chunks:readonly RelocationChunkEntryV1[]; }
@@ -51,8 +51,8 @@ function skipFrozenRecord(bytes:Uint8Array,at:{value:number}):void{const kind=re
 function compareUtf8(a:string,b:string):number{const x=text.encode(a),y=text.encode(b),n=Math.min(x.length,y.length);for(let i=0;i<n;i++)if(x[i]!==y[i])return x[i]!-y[i]!;return x.length-y.length;}
 function writeRelocationObject(out:number[],value:RelocationObjectIdentity):void{const kind=value.objectKind==="actor"?1:value.objectKind==="userSpot"?2:3;out.push(kind);body16(out,b=>{if(value.objectKind==="actor"){text8(b,value.actorId);if(value.objectGeneration===0n||value.expectedAuthorityOwnerGeneration===0n)throw new RangeError("object");u64(b,value.objectGeneration);u64(b,value.expectedAuthorityOwnerGeneration);}else if(value.objectKind==="userSpot"){text8(b,value.spotId);if(value.objectGeneration===0n||value.expectedAuthorityOwnerGeneration===0n)throw new RangeError("object");u64(b,value.objectGeneration);u64(b,value.expectedAuthorityOwnerGeneration);}else{text8(b,value.instanceType);text8(b,value.spotId);if(value.objectGeneration===0n)throw new RangeError("object");u64(b,value.objectGeneration);}});}
 function readRelocationObject(bytes:Uint8Array,at:{value:number}):RelocationObjectIdentity{const kind=read8(bytes,at),end=boundedEnd(bytes,at,read16(bytes,at),"relocation object");let value:RelocationObjectIdentity;if(kind===1)value={objectKind:"actor",actorId:readText8(bytes,at),objectGeneration:nonzero64(bytes,at,"object generation"),expectedAuthorityOwnerGeneration:nonzero64(bytes,at,"authority generation")};else if(kind===2)value={objectKind:"userSpot",spotId:readText8(bytes,at),objectGeneration:nonzero64(bytes,at,"object generation"),expectedAuthorityOwnerGeneration:nonzero64(bytes,at,"authority generation")};else if(kind===3)value={objectKind:"instanceSpot",instanceType:readText8(bytes,at),spotId:readText8(bytes,at),objectGeneration:nonzero64(bytes,at,"object generation")};else throw new RangeError("object kind");exactEnd(at,end,"relocation object");return value;}
-export function encodeRelocationEnvelopeV1(value:RelocationEnvelopeV1):Uint8Array{const out:number[]=[];if(value.relocationHigh===0n&&value.relocationLow===0n)throw new RangeError("relocation");u64(out,value.relocationHigh);u64(out,value.relocationLow);writeRelocationObject(out,value.object);if(value.applicationVersion<0n||value.applicationVersion>9223372036854775807n)throw new RangeError("application version");u64(out,value.applicationVersion);sorted(value.applicationStates,(a,b)=>a.participantId<b.participantId?-1:a.participantId>b.participantId?1:0,"applicationStates");if(value.applicationStates.length===0)throw new RangeError("applicationStates");u32(out,value.applicationStates.length);for(const s of value.applicationStates){if(s.participantId===0n)throw new RangeError("participant");u64(out,s.participantId);out.push(s.hasState?1:0);body64(out,b=>{if(s.hasState)bytes64(b,s.payload);else if(s.payload.length!==0)throw new RangeError("absent state payload");});}sorted(value.savedWork,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"savedWork");u32(out,value.savedWork.length);for(const w of value.savedWork){if(w.participantId===0n||w.order===0n)throw new RangeError("saved work");const at={value:0};skipFrozenRecord(w.frozenRecord,at);exactEnd(at,w.frozenRecord.length,"frozen record");u64(out,w.participantId);u64(out,w.order);appendBytes(out,w.frozenRecord);}sorted(value.timerRegistrations,(a,b)=>a.participantId===b.participantId?compareUtf8(a.name,b.name):a.participantId<b.participantId?-1:1,"timerRegistrations");u32(out,value.timerRegistrations.length);for(const t of value.timerRegistrations){if(t.participantId===0n||t.periodMilliseconds===0n||t.maxCatchUpTicks===0n||t.overrunPolicy<1||t.overrunPolicy>3)throw new RangeError("timer");u64(out,t.participantId);text8(out,t.name);text8(out,t.handlerType);u64(out,t.periodMilliseconds);out.push(t.overrunPolicy);u64(out,t.maxCatchUpTicks);out.push(t.stopOnUnhandledException?1:0);u64(out,t.lastCompletedDeliveryIndex);u64(out,t.lastCompletedScheduledIndex);u64(out,t.nextScheduledAtUnixMilliseconds);}sorted(value.pendingTimerTicks,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"pendingTimerTicks");u32(out,value.pendingTimerTicks.length);for(const p of value.pendingTimerTicks){if(p.participantId===0n||p.order===0n||p.deliveryIndex===0n||p.scheduledIndex===0n)throw new RangeError("pending timer");u64(out,p.participantId);u64(out,p.order);text8(out,p.timerName);u64(out,p.deliveryIndex);u64(out,p.scheduledIndex);u64(out,p.scheduledAtUnixMilliseconds);u64(out,p.skippedTicks);}if(out.length>274877906944)throw new RangeError("relocation logical bytes");return Uint8Array.from(out);}
-export function decodeRelocationEnvelopeV1(chunks:readonly Uint8Array[]):RelocationEnvelopeV1{const n=chunks.reduce((s,c)=>s+c.length,0);if(n>274877906944)throw new RangeError("relocation logical bytes");const bytes=new Uint8Array(n);let offset=0;for(const c of chunks){bytes.set(c,offset);offset+=c.length;}const at={value:0},relocationHigh=read64(bytes,at),relocationLow=read64(bytes,at);if(relocationHigh===0n&&relocationLow===0n)throw new RangeError("relocation");const object=readRelocationObject(bytes,at),applicationVersion=read64(bytes,at);if(applicationVersion>9223372036854775807n)throw new RangeError("application version");const applicationStates:RelocationEnvelopeV1["applicationStates"][number][]=[];const stateCount=read32(bytes,at);if(stateCount===0)throw new RangeError("applicationStates");for(let i=0,count=stateCount;i<count;i++){const participantId=nonzero64(bytes,at,"participant"),has=read8(bytes,at),end=boundedEnd(bytes,at,Number(read64(bytes,at)),"application state");if(has>1)throw new RangeError("application state");let payload=new Uint8Array();if(has===1)payload=take(bytes,at,Number(read64(bytes,at)),"state payload");exactEnd(at,end,"application state");applicationStates.push({participantId,hasState:has===1,payload});}const participants=new Set(applicationStates.map((s)=>s.participantId));const savedWork:RelocationEnvelopeV1["savedWork"][number][]=[];for(let i=0,count=read32(bytes,at);i<count;i++){const participantId=nonzero64(bytes,at,"participant");if(!participants.has(participantId))throw new RangeError("saved work participant");const order=nonzero64(bytes,at,"order"),start=at.value;skipFrozenRecord(bytes,at);savedWork.push({participantId,order,frozenRecord:bytes.slice(start,at.value)});}const timerRegistrations:RelocationEnvelopeV1["timerRegistrations"][number][]=[],registeredTimerNames=new Map<bigint,Set<string>>();for(let i=0,count=read32(bytes,at);i<count;i++){const participantId=nonzero64(bytes,at,"participant");if(!participants.has(participantId))throw new RangeError("timer participant");const name=readText8(bytes,at),handlerType=readText8(bytes,at),periodMilliseconds=nonzero64(bytes,at,"period"),overrunPolicy=read8(bytes,at);if(overrunPolicy<1||overrunPolicy>3)throw new RangeError("overrun policy");const maxCatchUpTicks=nonzero64(bytes,at,"catch-up"),stop=read8(bytes,at);if(stop>1)throw new RangeError("stop flag");let names=registeredTimerNames.get(participantId);if(names===undefined){names=new Set<string>();registeredTimerNames.set(participantId,names);}names.add(name);timerRegistrations.push({participantId,name,handlerType,periodMilliseconds,overrunPolicy:overrunPolicy as 1|2|3,maxCatchUpTicks,stopOnUnhandledException:stop===1,lastCompletedDeliveryIndex:read64(bytes,at),lastCompletedScheduledIndex:read64(bytes,at),nextScheduledAtUnixMilliseconds:read64(bytes,at)});}const pendingTimerTicks:RelocationEnvelopeV1["pendingTimerTicks"][number][]=[];for(let i=0,count=read32(bytes,at);i<count;i++){const participantId=nonzero64(bytes,at,"participant");if(!participants.has(participantId))throw new RangeError("pending timer participant");const order=nonzero64(bytes,at,"order"),timerName=readText8(bytes,at);if(registeredTimerNames.get(participantId)?.has(timerName)!==true)throw new RangeError("pending timer registration");pendingTimerTicks.push({participantId,order,timerName,deliveryIndex:nonzero64(bytes,at,"delivery"),scheduledIndex:nonzero64(bytes,at,"scheduled"),scheduledAtUnixMilliseconds:read64(bytes,at),skippedTicks:read64(bytes,at)});}exactEnd(at,bytes.length,"relocation envelope");sorted(applicationStates,(a,b)=>a.participantId<b.participantId?-1:a.participantId>b.participantId?1:0,"applicationStates");sorted(savedWork,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"savedWork");sorted(timerRegistrations,(a,b)=>a.participantId===b.participantId?compareUtf8(a.name,b.name):a.participantId<b.participantId?-1:1,"timerRegistrations");sorted(pendingTimerTicks,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"pendingTimerTicks");return{relocationHigh,relocationLow,object,applicationVersion,applicationStates,savedWork,timerRegistrations,pendingTimerTicks};}
+export function encodeRelocationEnvelopeV1(value:RelocationEnvelopeV1):Uint8Array{const out:number[]=[];if(value.relocationHigh===0n&&value.relocationLow===0n)throw new RangeError("relocation");u64(out,value.relocationHigh);u64(out,value.relocationLow);writeRelocationObject(out,value.object);if(value.applicationVersion<0n||value.applicationVersion>9223372036854775807n)throw new RangeError("application version");u64(out,value.applicationVersion);sorted(value.applicationStates,(a,b)=>a.participantId<b.participantId?-1:a.participantId>b.participantId?1:0,"applicationStates");if(value.applicationStates.length===0)throw new RangeError("applicationStates");u32(out,value.applicationStates.length);for(const s of value.applicationStates){if(s.participantId===0n)throw new RangeError("participant");u64(out,s.participantId);out.push(s.hasState?1:0);body64(out,b=>{if(s.hasState)bytes64(b,s.payload);else if(s.payload.length!==0)throw new RangeError("absent state payload");});}sorted(value.savedWork,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"savedWork");u32(out,value.savedWork.length);for(const w of value.savedWork){if(w.participantId===0n||w.order===0n)throw new RangeError("saved work");const at={value:0};skipFrozenRecord(w.frozenRecord,at);exactEnd(at,w.frozenRecord.length,"frozen record");u64(out,w.participantId);u64(out,w.order);appendBytes(out,w.frozenRecord);}sorted(value.timerRegistrations,(a,b)=>a.participantId===b.participantId?compareUtf8(a.name,b.name):a.participantId<b.participantId?-1:1,"timerRegistrations");u32(out,value.timerRegistrations.length);for(const t of value.timerRegistrations){if(t.participantId===0n||t.periodMilliseconds===0n||t.maxCatchUpTicks===0n||t.overrunPolicy<1||t.overrunPolicy>3)throw new RangeError("timer");u64(out,t.participantId);text8(out,t.name);text8(out,t.handlerType);u64(out,t.periodMilliseconds);out.push(t.overrunPolicy);u64(out,t.maxCatchUpTicks);out.push(t.stopOnUnhandledException?1:0);u64(out,t.lastCompletedDeliveryIndex);u64(out,t.lastCompletedScheduledIndex);u64(out,t.nextScheduledAtUnixMilliseconds);}sorted(value.pendingTimerTicks,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"pendingTimerTicks");u32(out,value.pendingTimerTicks.length);for(const p of value.pendingTimerTicks){if(p.participantId===0n||p.order===0n||p.deliveryIndex===0n||p.scheduledIndex===0n)throw new RangeError("pending timer");u64(out,p.participantId);u64(out,p.order);text8(out,p.timerName);u64(out,p.deliveryIndex);u64(out,p.scheduledIndex);u64(out,p.scheduledAtUnixMilliseconds);u64(out,p.skippedTicks);}sorted(value.sessionBindings,(a,b)=>a.participantId<b.participantId?-1:a.participantId>b.participantId?1:0,"sessionBindings");if(value.sessionBindings.length>1024)throw new RangeError("bindings count");u32(out,value.sessionBindings.length);for(const b of value.sessionBindings){if(b.participantId===0n||b.sessionOwnerNodeGeneration===0n||b.sessionOwnerLeaseGeneration===0n||b.bindingGeneration===0n)throw new RangeError("binding");u64(out,b.participantId);rid(out,b.sessionOwnerNodeRid);u64(out,b.sessionOwnerNodeGeneration);text8(out,b.sessionOwnerId);u64(out,b.sessionOwnerLeaseGeneration);rid(out,b.sessionRid);u64(out,b.bindingGeneration);}if(out.length>274877906944)throw new RangeError("relocation logical bytes");return Uint8Array.from(out);}
+export function decodeRelocationEnvelopeV1(chunks:readonly Uint8Array[]):RelocationEnvelopeV1{const n=chunks.reduce((s,c)=>s+c.length,0);if(n>274877906944)throw new RangeError("relocation logical bytes");const bytes=new Uint8Array(n);let offset=0;for(const c of chunks){bytes.set(c,offset);offset+=c.length;}const at={value:0},relocationHigh=read64(bytes,at),relocationLow=read64(bytes,at);if(relocationHigh===0n&&relocationLow===0n)throw new RangeError("relocation");const object=readRelocationObject(bytes,at),applicationVersion=read64(bytes,at);if(applicationVersion>9223372036854775807n)throw new RangeError("application version");const applicationStates:RelocationEnvelopeV1["applicationStates"][number][]=[];const stateCount=read32(bytes,at);if(stateCount===0)throw new RangeError("applicationStates");for(let i=0,count=stateCount;i<count;i++){const participantId=nonzero64(bytes,at,"participant"),has=read8(bytes,at),end=boundedEnd(bytes,at,Number(read64(bytes,at)),"application state");if(has>1)throw new RangeError("application state");let payload=new Uint8Array();if(has===1)payload=take(bytes,at,Number(read64(bytes,at)),"state payload");exactEnd(at,end,"application state");applicationStates.push({participantId,hasState:has===1,payload});}const participants=new Set(applicationStates.map((s)=>s.participantId));const savedWork:RelocationEnvelopeV1["savedWork"][number][]=[];for(let i=0,count=read32(bytes,at);i<count;i++){const participantId=nonzero64(bytes,at,"participant");if(!participants.has(participantId))throw new RangeError("saved work participant");const order=nonzero64(bytes,at,"order"),start=at.value;skipFrozenRecord(bytes,at);savedWork.push({participantId,order,frozenRecord:bytes.slice(start,at.value)});}const timerRegistrations:RelocationEnvelopeV1["timerRegistrations"][number][]=[],registeredTimerNames=new Map<bigint,Set<string>>();for(let i=0,count=read32(bytes,at);i<count;i++){const participantId=nonzero64(bytes,at,"participant");if(!participants.has(participantId))throw new RangeError("timer participant");const name=readText8(bytes,at),handlerType=readText8(bytes,at),periodMilliseconds=nonzero64(bytes,at,"period"),overrunPolicy=read8(bytes,at);if(overrunPolicy<1||overrunPolicy>3)throw new RangeError("overrun policy");const maxCatchUpTicks=nonzero64(bytes,at,"catch-up"),stop=read8(bytes,at);if(stop>1)throw new RangeError("stop flag");let names=registeredTimerNames.get(participantId);if(names===undefined){names=new Set<string>();registeredTimerNames.set(participantId,names);}names.add(name);timerRegistrations.push({participantId,name,handlerType,periodMilliseconds,overrunPolicy:overrunPolicy as 1|2|3,maxCatchUpTicks,stopOnUnhandledException:stop===1,lastCompletedDeliveryIndex:read64(bytes,at),lastCompletedScheduledIndex:read64(bytes,at),nextScheduledAtUnixMilliseconds:read64(bytes,at)});}const pendingTimerTicks:RelocationEnvelopeV1["pendingTimerTicks"][number][]=[];for(let i=0,count=read32(bytes,at);i<count;i++){const participantId=nonzero64(bytes,at,"participant");if(!participants.has(participantId))throw new RangeError("pending timer participant");const order=nonzero64(bytes,at,"order"),timerName=readText8(bytes,at);if(registeredTimerNames.get(participantId)?.has(timerName)!==true)throw new RangeError("pending timer registration");pendingTimerTicks.push({participantId,order,timerName,deliveryIndex:nonzero64(bytes,at,"delivery"),scheduledIndex:nonzero64(bytes,at,"scheduled"),scheduledAtUnixMilliseconds:read64(bytes,at),skippedTicks:read64(bytes,at)});}const sessionBindings:RelocationEnvelopeV1["sessionBindings"][number][]=[];const bindingCount=read32(bytes,at);if(bindingCount>1024)throw new RangeError("bindings count");for(let n=0;n<bindingCount;n++)sessionBindings.push({participantId:nonzero64(bytes,at,"participant"),sessionOwnerNodeRid:readRid(bytes,at),sessionOwnerNodeGeneration:nonzero64(bytes,at,"session node"),sessionOwnerId:readText8(bytes,at),sessionOwnerLeaseGeneration:nonzero64(bytes,at,"session lease"),sessionRid:readRid(bytes,at),bindingGeneration:nonzero64(bytes,at,"binding")});sorted(sessionBindings,(a,b)=>a.participantId<b.participantId?-1:a.participantId>b.participantId?1:0,"sessionBindings");exactEnd(at,bytes.length,"relocation envelope");sorted(applicationStates,(a,b)=>a.participantId<b.participantId?-1:a.participantId>b.participantId?1:0,"applicationStates");sorted(savedWork,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"savedWork");sorted(timerRegistrations,(a,b)=>a.participantId===b.participantId?compareUtf8(a.name,b.name):a.participantId<b.participantId?-1:1,"timerRegistrations");sorted(pendingTimerTicks,(a,b)=>a.participantId===b.participantId?(a.order<b.order?-1:a.order>b.order?1:0):(a.participantId<b.participantId?-1:1),"pendingTimerTicks");return{relocationHigh,relocationLow,object,applicationVersion,applicationStates,savedWork,timerRegistrations,pendingTimerTicks,sessionBindings};}
 function crc32c(bytes:Uint8Array):number{let crc=0xffffffff;for(const octet of bytes){crc^=octet;for(let bit=0;bit<8;bit++)crc=(crc>>>1)^((crc&1)!==0?0x82f63b78:0);}return(~crc)>>>0;}
 function encodeDurable(magic:readonly number[],body:readonly number[],maximum:number):Uint8Array{const out=[...magic,1,0,0];u32(out,body.length);appendBytes(out,body);if(out.length+4>maximum)throw new RangeError("durable format bytes");u32(out,crc32c(Uint8Array.from(out)));return Uint8Array.from(out);}
 function decodeDurable(bytes:Uint8Array,magic:readonly number[],maximum:number):Uint8Array{if(bytes.length>maximum||bytes.length<15||magic.some((v,i)=>bytes[i]!==v)||bytes[4]!==1||bytes[5]!==0||bytes[6]!==0)throw new RangeError("durable header");const at={value:7},length=read32(bytes,at),end=boundedEnd(bytes,at,length,"durable body");if(end+4!==bytes.length)throw new RangeError("durable length");const body=bytes.slice(at.value,end);at.value=end;const expected=read32(bytes,at);if(crc32c(bytes.slice(0,end))!==expected)throw new RangeError("durable checksum");return body;}

package/src/runtime/spots/formal-remote-actor-admission-registry.ts

@@ -1,3 +1,4 @@
+import type { ApplicationJobOrigin } from '../application-jobs/contracts';
 import type { ActorRef, RoutingId, ZLinkActor, ZLinkActorJoinOperationId } from '../../contracts';
 import type { ZLinkRemoteBoundSessionTarget } from '../actors/actor-runtime-state';
 import type { ZLinkDeferredJoinCompletion } from '../actors/deferred-join-completion';
@@ -13,6 +14,7 @@ const ADMISSION_RETENTION_MS = 30_000;
  * how long the underlying buffer stays valid.
  */
 export interface ZLinkParkedActorArrival {
+  readonly origin: ApplicationJobOrigin;
   readonly header: Buffer;
   readonly payload: Buffer;
   readonly returnResponse: boolean;
@@ -31,7 +33,14 @@ function objectKey(actorId: string, objectGeneration: bigint): string {
 }
 
 export type ZLinkFormalRemoteActorAdmissionState =
-  'provisional' | 'admitting' | 'admitted' | 'rejected' | 'committed' | 'aborted' | 'failed';
+  | 'provisional'
+  | 'admitting'
+  | 'admitted'
+  | 'restoring'
+  | 'rejected'
+  | 'committed'
+  | 'aborted'
+  | 'failed';
 
 export interface ZLinkFormalRemoteActorAdmission {
   readonly actorId: string;
@@ -76,7 +85,7 @@ export interface ZLinkFormalRemoteActorAdmissionRecord {
 }
 
 interface ZLinkFormalRemoteActorAdmissionEntry extends ZLinkFormalRemoteActorAdmissionRecord {
-  readonly timer: ReturnType<typeof setTimeout>;
+  timer: ReturnType<typeof setTimeout>;
   readonly resolveResult: (result: ZLinkFormalRemoteActorAdmissionResult) => void;
   admission: ZLinkFormalRemoteActorAdmission;
   state: ZLinkFormalRemoteActorAdmissionState;
@@ -105,6 +114,35 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     return this.admissions.get(transferId);
   }
 
+  /** PREPARE transfers prepared resources to the target attempt until its terminal. */
+  beginRestore(transferId: string): void {
+    const entry = this.admissions.get(transferId);
+    if (entry === undefined || (entry.state !== 'admitted' && entry.state !== 'restoring')) {
+      throw new Error(`Remote actor admission '${transferId}' is not ready to restore.`);
+    }
+    clearTimeout(entry.timer);
+    entry.state = 'restoring';
+  }
+
+  /** Retains successful commit replay; unsuccessful attempts release their resources now. */
+  finishRestore(transferId: string): void {
+    const entry = this.admissions.get(transferId);
+    if (entry === undefined) return;
+    if (entry.state === 'committed') {
+      clearTimeout(entry.timer);
+      entry.timer = this.scheduleExpiry(transferId);
+    } else {
+      this.abort(transferId);
+      this.delete(transferId);
+    }
+  }
+
+  private scheduleExpiry(transferId: string): ReturnType<typeof setTimeout> {
+    const timer = setTimeout(() => this.delete(transferId), ADMISSION_RETENTION_MS);
+    timer.unref();
+    return timer;
+  }
+
   begin(input: ZLinkFormalRemoteActorAdmission): {
     readonly record: ZLinkFormalRemoteActorAdmissionEntry;
     readonly created: boolean;
@@ -180,10 +218,7 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     const resultTask = new Promise<ZLinkFormalRemoteActorAdmissionResult>((resolve) => {
       resolveResult = resolve;
     });
-    const timer = setTimeout(() => {
-      this.delete(input.transferId);
-    }, ADMISSION_RETENTION_MS);
-    timer.unref();
+    const timer = this.scheduleExpiry(input.transferId);
     const entry = {
       admission: input,
       state,
@@ -307,7 +342,7 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
   markCommitted(transferId: string, actor: ZLinkActor): void {
     const entry = this.admissions.get(transferId);
     if (entry === undefined) return;
-    if (entry.state !== 'admitted' && entry.state !== 'committed') {
+    if (entry.state !== 'admitted' && entry.state !== 'restoring' && entry.state !== 'committed') {
       throw new Error(`Remote actor admission '${transferId}' is not ready to commit.`);
     }
     entry.state = 'committed';
@@ -318,7 +353,7 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     const entry = this.admissions.get(transferId);
     if (
       entry === undefined ||
-      entry.state !== 'admitted' ||
+      (entry.state !== 'admitted' && entry.state !== 'restoring') ||
       entry.result === undefined ||
       'error' in entry.result ||
       !entry.result.accepted
@@ -352,7 +387,7 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
    */
   delete(transferId: string): void {
     const pending = this.admissions.get(transferId);
-    if (pending === undefined) return;
+    if (pending === undefined || pending.state === 'restoring') return;
     clearTimeout(pending.timer);
     this.admissions.delete(transferId);
     this.failParked(pending);
@@ -367,20 +402,7 @@ function sameAdmission(
   left: ZLinkFormalRemoteActorAdmission,
   right: ZLinkFormalRemoteActorAdmission
 ): boolean {
-  return (
-    left.actorId === right.actorId &&
-    left.actorType === right.actorType &&
-    String(left.spotId) === String(right.spotId) &&
-    left.targetSpotGeneration === right.targetSpotGeneration &&
-    left.expectedMembershipEpoch === right.expectedMembershipEpoch &&
-    left.requestFingerprint === right.requestFingerprint &&
-    sameOperationId(left.completionOperationId, right.completionOperationId) &&
-    String(left.sourceSpotId ?? '') === String(right.sourceSpotId ?? '') &&
-    String(left.sourceActorNodeRid ?? '') === String(right.sourceActorNodeRid ?? '') &&
-    left.actorRef.actorId === right.actorRef.actorId &&
-    String(left.actorRef.nodeRid) === String(right.actorRef.nodeRid) &&
-    left.actorRef.objectGeneration === right.actorRef.objectGeneration
-  );
+  return left.actorType === right.actorType && sameProvisionalAdmission(left, right);
 }
 
 function sameProvisionalAdmission(

package/src/runtime/spots/index.ts

@@ -1,3 +1,4 @@
+import type { ApplicationJobOrigin } from '../application-jobs/contracts';
 import { dispatchReasonFromError } from '../diagnostics/dispatch-error-details';
 import type {
   ActorRef,
@@ -190,6 +191,7 @@ export interface ZLinkSpotManagerOptions {
     ): Promise<void>;
   };
   readonly dispatchEntryActorPacket?: (
+    origin: ApplicationJobOrigin,
     actorId: string,
     parts: readonly Message[],
     returnResponse?: boolean,
@@ -213,6 +215,7 @@ export interface ZLinkSpotManagerOptions {
     operation: () => Promise<T>
   ) => Promise<T>;
   readonly actorCountProvider?: (spotId: RoutingId) => number;
+  readonly releaseActorMembers?: (meshName: string, spotId: RoutingId) => Promise<void>;
   readonly userSpotExecutionMode?: (
     meshName: string,
     spotType: Type<ZLinkSpot>
@@ -406,6 +409,7 @@ export class DefaultZLinkSpotManager {
       nodeRid: options.nodeRid,
       nodeRidProvider: options.nodeRidProvider,
       actorCountProvider: options.actorCountProvider,
+      releaseActorMembers: options.releaseActorMembers,
       userSpotExecutionMode: options.userSpotExecutionMode,
       userSpotRelocationCoordinationMode: options.userSpotRelocationCoordinationMode,
       channelClient: options.channelClient,
@@ -1532,6 +1536,7 @@ export class DefaultZLinkSpotManager {
   }
 
   dispatchRoutedActorPacket(
+    origin: ApplicationJobOrigin,
     spotId: RoutingId,
     actorId: string,
     parts: readonly Message[],
@@ -1544,6 +1549,7 @@ export class DefaultZLinkSpotManager {
       throw new ZLinkConfigurationException(`Spot '${spotId}' is not active.`);
     }
     return this.dispatchActorPacket(
+      origin,
       activation,
       actorId,
       parts,
@@ -1555,6 +1561,7 @@ export class DefaultZLinkSpotManager {
 
   /** @internal Replays a record already owned by the Actor handoff queue. */
   dispatchRoutedActorPacketDirect(
+    origin: ApplicationJobOrigin,
     spotId: RoutingId,
     actorId: string,
     parts: readonly Message[],
@@ -1567,6 +1574,7 @@ export class DefaultZLinkSpotManager {
       throw new ZLinkConfigurationException(`Spot '${spotId}' is not active.`);
     }
     return this.activationLifecycle.dispatchActorPacketDirect(
+      origin,
       activation,
       actorId,
       parts,
@@ -1614,6 +1622,7 @@ export class DefaultZLinkSpotManager {
       readonly workOptions?: import('../execution/serial-execution-queue').ZLinkSerialWorkOptions;
       readonly admissionTimeoutMs?: number;
       readonly signal?: AbortSignal;
+      readonly onAdmitted?: () => void;
     }
   ): Promise<TReply> {
     return await this.routedSpotPackets.request<TReply>(spotId, packetName, request, context);
@@ -1965,6 +1974,7 @@ export class DefaultZLinkSpotManager {
   }
 
   async dispatchMeshActor(
+    origin: ApplicationJobOrigin,
     meshName: string,
     owner: ReadyRecord,
     record: ReceiveRecord
@@ -2027,6 +2037,7 @@ export class DefaultZLinkSpotManager {
       }
       const response = targetsEntrySpot
         ? await this.options.dispatchEntryActorPacket?.(
+            origin,
             actor.actorId,
             record.parts,
             request,
@@ -2036,6 +2047,7 @@ export class DefaultZLinkSpotManager {
             record.messageFollowOrigin
           )
         : await this.dispatchMeshActorPacket(
+            origin,
             meshName,
             spotId,
             actor.actorId,
@@ -2693,6 +2705,7 @@ export class DefaultZLinkSpotManager {
                     );
                   }
                   return await this.options.dispatchEntryActorPacket(
+                    'remote',
                     entryActor.context.actorId,
                     parts,
                     returnResponse,
@@ -2922,6 +2935,7 @@ export class DefaultZLinkSpotManager {
               pendingTransfer.handoffBacklog,
               (parts, returnResponse, remoteBoundSessionTarget, _fallbackActorRef) =>
                 this.dispatchActorPacket(
+                  'remote',
                   activation,
                   actor.context.actorId,
                   parts,
@@ -3064,7 +3078,7 @@ export class DefaultZLinkSpotManager {
     }
     const outcome = admission.result ?? (await admission.resultTask);
     if ('error' in outcome) throw outcome.error;
-    if (!outcome.accepted || admission.state !== 'admitted') {
+    if (!outcome.accepted || (admission.state !== 'admitted' && admission.state !== 'restoring')) {
       throw new Error(`Actor Join relocation '${relocationId}' has no accepted admission.`);
     }
     const entrySpotId = this.options.entryNodeRidProvider?.() ?? this.options.entryNodeRid;
@@ -3124,6 +3138,11 @@ export class DefaultZLinkSpotManager {
     return true;
   }
 
+  beginActorJoinRelocation(relocationId: string): () => void {
+    this.formalRemoteActorAdmissions.beginRestore(relocationId);
+    return () => this.formalRemoteActorAdmissions.finishRestore(relocationId);
+  }
+
   async restoreCanonicalActorJoinRecovery(
     recovery: CanonicalActorJoinRecovery,
     signal?: AbortSignal
@@ -3136,7 +3155,11 @@ export class DefaultZLinkSpotManager {
       );
     }
     const outcome = admission.result ?? (await admission.resultTask);
-    if ('error' in outcome || !outcome.accepted || admission.state !== 'admitted') {
+    if (
+      'error' in outcome ||
+      !outcome.accepted ||
+      (admission.state !== 'admitted' && admission.state !== 'restoring')
+    ) {
       throw new Error(
         `Actor Join recovery '${recovery.request.handoffId}' has no accepted admission.`
       );
@@ -3271,6 +3294,7 @@ export class DefaultZLinkSpotManager {
   }
 
   private async dispatchActorPacket(
+    origin: ApplicationJobOrigin,
     activation: ZLinkSpotActivation,
     actorId: string,
     parts: readonly Message[],
@@ -3281,6 +3305,7 @@ export class DefaultZLinkSpotManager {
     messageFollowOrigin?: ZLinkMessageFollowOrigin
   ): Promise<unknown> {
     return await this.activationLifecycle.dispatchActorPacket(
+      origin,
       activation,
       actorId,
       parts,
@@ -3311,6 +3336,7 @@ export class DefaultZLinkSpotManager {
     for (const arrival of drained) {
       try {
         const response = await this.dispatchActorPacket(
+          arrival.origin,
           activation,
           actor.context.actorId,
           [RuntimeMessage.from(arrival.header), RuntimeMessage.from(arrival.payload)],
@@ -3327,6 +3353,7 @@ export class DefaultZLinkSpotManager {
   }
 
   private async dispatchMeshActorPacket(
+    origin: ApplicationJobOrigin,
     meshName: string,
     spotId: RoutingId,
     actorId: string,
@@ -3343,6 +3370,7 @@ export class DefaultZLinkSpotManager {
       );
     }
     return await this.dispatchActorPacket(
+      origin,
       activation,
       actorId,
       parts,

package/src/runtime/spots/spot-activation.ts

@@ -1,3 +1,4 @@
+import type { ApplicationJobOrigin } from '../application-jobs/contracts';
 import type {
   ActorRef,
   RoutingId,
@@ -100,6 +101,7 @@ export interface ZLinkSpotActivationLifecycleOptions {
   readonly nodeRid?: RoutingId;
   readonly nodeRidProvider?: (meshName: string) => RoutingId | undefined;
   readonly actorCountProvider?: (spotId: RoutingId) => number;
+  readonly releaseActorMembers?: (meshName: string, spotId: RoutingId) => Promise<void>;
   readonly userSpotExecutionMode?: (
     meshName: string,
     spotType: Type<ZLinkSpot>
@@ -214,7 +216,10 @@ export class ZLinkSpotActivationLifecycle {
     );
     const serialExecutor = new ZLinkSpotSerialExecutor(serial, executionMode, spotId);
     const actorHandlers = new ZLinkSpotActorHandlerRegistryRuntime();
-    const handlers = new DefaultZLinkSpotHandlerRegistry(actorHandlers);
+    const handlers = new DefaultZLinkSpotHandlerRegistry(
+      actorHandlers,
+      this.options.providerResolver
+    );
     applySpotHandlerRegistrations(
       handlers,
       implementation as unknown as Type<ZLinkSpot>,
@@ -380,7 +385,10 @@ export class ZLinkSpotActivationLifecycle {
       spotId
     );
     const actorHandlers = new ZLinkSpotActorHandlerRegistryRuntime();
-    const handlers = new DefaultZLinkSpotHandlerRegistry(actorHandlers);
+    const handlers = new DefaultZLinkSpotHandlerRegistry(
+      actorHandlers,
+      this.options.providerResolver
+    );
     const instanceHandlers = new DefaultZLinkInstanceSpotHandlerRegistry(handlers);
     applySpotHandlerRegistrations(handlers, implementation as unknown as Type<ZLinkSpot>, {
       packetHandlers: this.options.spotPacketHandlers
@@ -532,7 +540,10 @@ export class ZLinkSpotActivationLifecycle {
     );
     const serialExecutor = new ZLinkSpotSerialExecutor(serial, executionMode, spotId);
     const actorHandlers = new ZLinkSpotActorHandlerRegistryRuntime();
-    const handlers = new DefaultZLinkSpotHandlerRegistry(actorHandlers);
+    const handlers = new DefaultZLinkSpotHandlerRegistry(
+      actorHandlers,
+      this.options.providerResolver
+    );
     applySpotHandlerRegistrations(handlers, spotType, {
       actorSendHandlers: this.options.spotActorSendHandlers,
       actorRequestHandlers: this.options.spotActorRequestHandlers,
@@ -857,6 +868,7 @@ export class ZLinkSpotActivationLifecycle {
   }
 
   async dispatchActorPacket(
+    origin: ApplicationJobOrigin,
     activation: ZLinkSpotActivation,
     actorId: string,
     parts: readonly Message[],
@@ -867,6 +879,7 @@ export class ZLinkSpotActivationLifecycle {
     messageFollowOrigin?: ZLinkMessageFollowOrigin
   ): Promise<unknown> {
     return await this.actorAdmission.dispatchActorPacket(
+      origin,
       activation,
       actorId,
       parts,
@@ -880,6 +893,7 @@ export class ZLinkSpotActivationLifecycle {
 
   /** @internal Dispatches a held Actor record after its handoff owner releases it. */
   dispatchActorPacketDirect(
+    origin: ApplicationJobOrigin,
     activation: ZLinkSpotActivation,
     actorId: string,
     parts: readonly Message[],
@@ -888,6 +902,7 @@ export class ZLinkSpotActivationLifecycle {
     fallbackActorRef?: ActorRef
   ): Promise<unknown> {
     return this.actorAdmission.dispatchActorPacketDirect(
+      origin,
       activation,
       actorId,
       parts,
@@ -1044,10 +1059,12 @@ export class ZLinkSpotActivationLifecycle {
       } catch (error) {
         // An OnClosing failure is diagnostic and cleanup continues. It is
         // returned so host shutdown can classify its teardown outcome.
-        this.options.closeErrorSink?.reportRuntimeTaskException(
-          `spot ${String(activation.spotId)} onClosing`,
-          error
-        );
+        if (reason !== ZLinkSpotCloseReason.HostShutdown) {
+          this.options.closeErrorSink?.reportRuntimeTaskException(
+            `spot ${String(activation.spotId)} onClosing`,
+            error
+          );
+        }
         closingFailure = error;
       }
     }
@@ -1088,7 +1105,12 @@ export class ZLinkSpotActivationLifecycle {
     }
     if (!state.nativeDisposed) {
       await cleanup(
-        () => activation.nativeSpot?.dispose(),
+        async () => {
+          if (reason === ZLinkSpotCloseReason.HostShutdown) {
+            await this.options.releaseActorMembers?.(locationMeshName, activation.spotId);
+          }
+          await activation.nativeSpot?.dispose();
+        },
         () => {
           state.nativeDisposed = true;
         }
@@ -1116,8 +1138,9 @@ export class ZLinkSpotActivationLifecycle {
         }
       );
     }
-    if (errors.length === 1) throw errors[0];
-    if (errors.length > 1) {
+    if (errors.length > 0) {
+      if (closingFailure !== undefined) errors.unshift(closingFailure);
+      if (errors.length === 1) throw errors[0];
       throw new AggregateError(errors, `Spot '${activation.spotId}' cleanup failed.`);
     }
     return closingFailure;

package/src/runtime/spots/spot-actor-admission-coordinator.ts

@@ -1,3 +1,5 @@
+import { currentApplicationJobOrigin } from '../application-jobs/application-job-queue-scope';
+import type { ApplicationJobOrigin } from '../application-jobs/contracts';
 import type { ActorRef, ZLinkActor } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
 import type { ZLinkMessageFollowOrigin } from '../foundation/service-runtime-contracts';
@@ -39,6 +41,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
   constructor(private readonly options: AdmissionOptions) {}
 
   async dispatchActorPacket(
+    origin: ApplicationJobOrigin,
     activation: ZLinkSpotActivation,
     actorId: string,
     parts: readonly Message[],
@@ -49,6 +52,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
     messageFollowOrigin?: ZLinkMessageFollowOrigin
   ): Promise<unknown> {
     const handoff = this.options.actorHandoffRuntime?.capture(
+      origin,
       actorId,
       parts,
       returnResponse,
@@ -63,6 +67,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
         replayFallbackActorRef
       ) =>
         this.dispatchActorPacketDirect(
+          origin,
           activation,
           actorId,
           replayedParts,
@@ -73,6 +78,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
     );
     if (handoff !== undefined) return await handoff;
     return await this.dispatchActorPacketDirect(
+      origin,
       activation,
       actorId,
       parts,
@@ -116,6 +122,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
       packets: {
         handle: (delivery) =>
           this.dispatchActorPacket(
+            'remote',
             activation,
             delivery.actorId,
             delivery.parts,
@@ -149,6 +156,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
 
   /** @internal Dispatches a coordinator-owned replay without recapturing it. */
   dispatchActorPacketDirect(
+    origin: ApplicationJobOrigin,
     activation: ZLinkSpotActivation,
     actorId: string,
     parts: readonly Message[],
@@ -159,6 +167,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
   ): Promise<unknown> {
     return activation.executeActor(actorId, (actorSerial) =>
       this.dispatchActorPacketInActorTurn(
+        origin,
         activation,
         actorSerial,
         actorId,
@@ -190,6 +199,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
           record.drain((parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef) =>
             executeChild((actorSerial) =>
               this.dispatchActorPacketInActorTurn(
+                currentApplicationJobOrigin(),
                 activation,
                 actorSerial,
                 actorId,
@@ -217,6 +227,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
   }
 
   private dispatchActorPacketInActorTurn(
+    origin: ApplicationJobOrigin,
     activation: ZLinkSpotActivation,
     actorSerial: ZLinkSpotSerialTurnExecutor,
     actorId: string,
@@ -250,6 +261,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
       dispatchErrors: this.options.dispatchErrors,
       routeToActorJoinPrewarm: this.options.routeToActorJoinPrewarm
     }).dispatch(
+      origin,
       actorId,
       parts,
       returnResponse,
@@ -305,6 +317,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
       backlog,
       (parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef) =>
         this.dispatchActorPacketDirect(
+          'remote',
           activation,
           actor.context.actorId,
           parts,

package/src/runtime/spots/spot-actor-packet-dispatch.ts

@@ -1,3 +1,4 @@
+import type { ApplicationJobOrigin } from '../application-jobs/contracts';
 import {
   ZLinkFrameworkInternalErrorKind,
   createInternalFrameworkException,
@@ -57,6 +58,7 @@ export interface ZLinkActorRequestTerminal {
 
 /** One admitted Actor packet and the routing context that must move with it. */
 export interface ZLinkActorPacketDelivery {
+  readonly origin: ApplicationJobOrigin;
   readonly actorId: string;
   readonly parts: readonly Message[];
   readonly returnResponse: boolean;
@@ -79,6 +81,7 @@ export type ZLinkRouteToActorJoinPrewarm = (
   actorId: string,
   objectGeneration: bigint,
   arrival: {
+    readonly origin: ApplicationJobOrigin;
     readonly header: Buffer;
     readonly payload: Buffer;
     readonly returnResponse: boolean;
@@ -133,6 +136,7 @@ export class ZLinkSpotActorPacketDispatch {
   constructor(private readonly options: ZLinkSpotActorPacketDispatchOptions) {}
 
   dispatch(
+    origin: ApplicationJobOrigin,
     actorId: string,
     parts: readonly Message[],
     returnResponse = false,
@@ -141,6 +145,7 @@ export class ZLinkSpotActorPacketDispatch {
     requestTerminal?: ZLinkActorRequestTerminal
   ): Promise<unknown> {
     return this.dispatchDelivery({
+      origin,
       actorId,
       parts,
       returnResponse,
@@ -212,6 +217,7 @@ export class ZLinkSpotActorPacketDispatch {
         const actor = this.options.resolveActor(actorId);
         if (actor === undefined) {
           return this.handleMissingActor(
+            delivery.origin,
             actorId,
             parts,
             header,
@@ -250,6 +256,7 @@ export class ZLinkSpotActorPacketDispatch {
   }
 
   private async handleMissingActor(
+    origin: ApplicationJobOrigin,
     actorId: string,
     parts: readonly Message[],
     header: ReturnType<typeof decodeStreamHeader>,
@@ -271,6 +278,7 @@ export class ZLinkSpotActorPacketDispatch {
       (messageKind !== ZLinkDispatchMessageKind.ActorRequest || requestTerminal !== undefined)
     ) {
       const parked = this.parkForActorJoinPrewarm(
+        origin,
         actorId,
         parts,
         messageKind,
@@ -328,6 +336,7 @@ export class ZLinkSpotActorPacketDispatch {
    * lifetime.
    */
   private parkForActorJoinPrewarm(
+    origin: ApplicationJobOrigin,
     actorId: string,
     parts: readonly Message[],
     messageKind: ZLinkDispatchMessageKind,
@@ -369,6 +378,7 @@ export class ZLinkSpotActorPacketDispatch {
       actorId,
       fallbackActorRef.objectGeneration,
       {
+        origin,
         header: Buffer.from(parts[0].data()),
         payload: Buffer.from(parts[1].data()),
         returnResponse,