@ibgib/core-gib 0.1.27 → 0.1.28

package/dist/sync/sync-saga-coordinator.mjs

@@ -6,7 +6,7 @@ import { putInSpace, getLatestAddrs, getFromSpace } from "../witness/space/space
 import { SyncStage, SYNC_ATOM, SYNC_MSG_REL8N_NAME, SYNC_SAGA_PAYLOAD_ADDRS_DOMAIN, } from "./sync-constants.mjs";
 import { appendToTimeline, createTimeline } from "../timeline/timeline-api.mjs";
 import { SyncConflictStrategy, SyncMode, SYNC_CONFLICT_STRATEGY_VALID_VALUES, } from "./sync-types.mjs";
-import { getSyncIb, getTempSpaceName, isPastFrame } from "./sync-helpers.mjs";
+import { getFullSyncSagaHistory, getSyncIb, getTempSpaceName, isPastFrame, putInSpace_dnasThenNonDnas, validateFullSyncSagaHistory } from "./sync-helpers.mjs";
 import { getDeltaDependencyGraph, getDependencyGraph, toFlatGraph } from "../common/other/graph-helper.mjs";
 import { getSyncSagaMessageIb } from "./sync-saga-message/sync-saga-message-helpers.mjs";
 import { SYNC_SAGA_MSG_ATOM } from "./sync-saga-message/sync-saga-message-constants.mjs";
@@ -171,7 +171,12 @@ export class SyncSagaCoordinator {
                 if (logalot) {
                     console.log(`${lc} Handler returned null (Saga End). (I: 43da8bb6c846b1fe7766332643be0e26)`);
                 }
-                return null;
+                // does this ever hit now?
+                return null; /* <<<< returns early */
+            }
+            else if (contextResult.nextFrameInfo?.sagaComplete) {
+                // this is the current proper workflow I believe as of 01/22/2026
+                return null; /* <<<< returns early */
             }
             // #region error conditions throw
             if (contextResult.errorMsg) {
@@ -180,9 +185,6 @@ export class SyncSagaCoordinator {
             else if (!contextResult.nextFrameInfo) {
                 throw new Error(`(UNEXPECTED) contextResult.nextFrameInfo falsy? (E: 5740542f5eb8ccb41dfec188d87c1e26)`);
             }
-            else if (contextResult.nextFrameInfo?.responseWasNull) {
-                throw new Error(`(UNEXPECTED) contextResult.nextFrameInfo.responseWasNull? logic flow should not have gotten here. (E: ae06748d8c0c5e70c92322c8fb0cb426)`);
-            }
             // #endregion error conditions throw
             // create the return context
             const { frame, payloadIbGibsDomain } = contextResult.nextFrameInfo;
@@ -417,8 +419,8 @@ export class SyncSagaCoordinator {
             else if (!contextResult.nextFrameInfo) {
                 throw new Error(`(UNEXPECTED) contextResult.nextFrameInfo falsy? (E: c287a82e823e662a77923278e2418826)`);
             }
-            else if (contextResult.nextFrameInfo?.responseWasNull) {
-                throw new Error(`(UNEXPECTED) contextResult.nextFrameInfo.responseWasNull? logic flow should not have gotten here. (E: 104a32381db816b7183435e805b3d626)`);
+            else if (contextResult.nextFrameInfo?.sagaComplete) {
+                throw new Error(`(UNEXPECTED) contextResult.nextFrameInfo.sagaComplete? logic flow should not have gotten here. (E: 104a32381db816b7183435e805b3d626)`);
             }
             // #endregion error conditions throw
             // we have another frame to process and send out, with possibly
@@ -1333,69 +1335,6 @@ export class SyncSagaCoordinator {
             }
         }
     }
-    async getPayloadsForRequestedInfos({ deltaRequestAddrInfos, mySpace, }) {
-        const lc = `${this.lc}[${this.getPayloadsForRequestedInfos.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: 4fe13d0d80050f20a8b74ba80cee5826)`);
-            }
-            /**
-             * graph of ibgibs we will send to the receiver. addr-based, so will
-             * already be unique (no need to call `unique` on the domains
-             * ibgibs)
-             */
-            const outgoingPayloadIbGibsDomainGraph = {};
-            for (const { addr, latestAddrAlreadyHave } of deltaRequestAddrInfos) {
-                let deltaDepGraph;
-                if (latestAddrAlreadyHave) {
-                    // already has some, so only get the delta
-                    // remember: if we didn't have the other's latest addr, then
-                    // this would be in the conflicts not requested addrs
-                    deltaDepGraph = await getDeltaDependencyGraph({
-                        ibGibAddr: addr,
-                        latestCommonFrameAddr: latestAddrAlreadyHave,
-                        space: mySpace,
-                        live: true,
-                    });
-                }
-                else {
-                    // doesn't have anything, so get the entire dependency graph
-                    // INEFFICIENT: we've already gotten all of the domain
-                    // dependencies in initDomainGraph, but getDependencyGraph
-                    // only works against a space so we are going to rerun this.
-                    // an optimization would be to adapt/create a new
-                    // getDependencyGraph to work against an existing flat ibgib
-                    // map.
-                    deltaDepGraph = await getDependencyGraph({
-                        ibGibAddr: addr,
-                        space: mySpace,
-                        live: true,
-                    });
-                }
-                const depGraphSize = Object.keys(deltaDepGraph).length;
-                if (depGraphSize === 0) {
-                    throw new Error(`(UNEXPECTED) couldn't get requested addrs in mySpace (${mySpace.ib})? How did the receiver know to ask for these addrs if they weren't in our original graph? (E: 281eaebcdf77dd73e8245b2872100826)`);
-                }
-                else {
-                    // we have dependencies!
-                    Object.values(deltaDepGraph).forEach(x => {
-                        outgoingPayloadIbGibsDomainGraph[getIbGibAddr({ ibGib: x })] = x;
-                    });
-                }
-            }
-            const result = Object.values(outgoingPayloadIbGibsDomainGraph);
-            return result;
-        }
-        catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
     /**
      * Handles the `Delta` frame.
      *
@@ -1451,25 +1390,33 @@ export class SyncSagaCoordinator {
                 // V1 timelines carry full history in `past`.
                 const pastAddrs = sagaIbGib.rel8ns?.past || [];
                 console.log(`${lc} [TEST DEBUG] pastAddrs count: ${pastAddrs.length}`);
-                let ackData;
-                if (pastAddrs.length > 0) {
-                    // Batch fetch all past frames
-                    const resPast = await getFromSpace({ addrs: pastAddrs, space: myTempSpace });
-                    if (resPast.success && resPast.ibGibs) {
-                        // Iterate backwards (most recent first) to find the latest Ack
-                        for (let i = resPast.ibGibs.length - 1; i >= 0; i--) {
-                            const pastFrame = resPast.ibGibs[i];
-                            const messageStone = await getSyncSagaMessageFromFrame({
-                                frameIbGib: pastFrame,
-                                space: myTempSpace
-                            });
-                            if (messageStone?.data?.stage === SyncStage.ack) {
-                                ackData = messageStone.data;
-                                console.log(`${lc} [TEST DEBUG] Found Ack Frame. Conflicts: ${ackData.conflicts?.length || 0}`);
-                                break;
-                            }
-                        }
-                    }
+                const sagaHistory = await getFullSyncSagaHistory({
+                    sagaIbGib,
+                    space: mySpace,
+                });
+                // #region validate/sanity sagaHistory
+                if (sagaHistory.length === 0) {
+                    throw new Error(`(UNEXPECTED) sagaHistory.length is 0? We're in handleDeltaFrame. So we should have at least init and ack. (E: 815735c9cf756b275719bf434f180826)`);
+                }
+                if (sagaHistory.length === 1) {
+                    throw new Error(`(UNEXPECTED) sagaHistory.length is 1? We're in handleDeltaFrame. So we should have at least init and ack. (E: 0e4ef8e3ed088e83b2cdcd18ecea9826)`);
+                }
+                // #endregion validate/sanity sagaHistory
+                const ackGraphs = sagaHistory.filter(x => x.msgStones.at(0).data.stage === SyncStage.ack);
+                // #region validate/sanity ackGraphs
+                if (ackGraphs.length > 1) {
+                    throw new Error(`(UNEXPECTED) more than one ack stage found in sagaHistory? we're expecting exactly one. (E: 7150983bb3a841caf8acd60826ba4f26)`);
+                }
+                else if (ackGraphs.length === 0) {
+                    throw new Error(`(UNEXPECTED) couldn't find ack stage in sagaHistory? (E: 7d2da859196b86de28e7c8183af1e826)`);
+                }
+                if (ackGraphs[0].msgStones.length !== 1) {
+                    throw new Error(`(UNEXPECTED) ackGraph has more than one msg stone? only one expected right now. (E: f07d388abff8d26f98cbf6e8d3932826)`);
+                }
+                // #endregion validate/sanity ackGraphs
+                const ackData = ackGraphs[0].msgStones[0].data;
+                if (!ackData) {
+                    throw new Error(`(UNEXPECTED) ackData falsy? (E: f9af88427f66a8db1ba868b810e8b826)`);
                 }
                 if (ackData && ackData.conflicts) {
                     const optimisticConflicts = ackData.conflicts.filter(c => !c.terminal);
@@ -1529,17 +1476,7 @@ export class SyncSagaCoordinator {
                     stage: SyncStage.delta,
                     payloadAddrs: outgoingPayload.map(p => getIbGibAddr({ ibGib: p })),
                     requests: hasMyRequests ? myRequests : undefined,
-                    proposeCommit: !hasMyRequests // If we are sending data but have no requests, we VALIDATE PROPOSAL?
-                    // Wait. If we send data, we are NOT committing yet.
-                    // We are sending data. The OTHER side must ingest it.
-                    // So proposeCommit = true?
-                    // "Here is the data. I'm done. If you are good, let's commit."
-                    // Yes.
                 };
-                // BUT if `peerProposesCommit` was true, and we are sending data, we are effectively rejecting/delaying it.
-                // We just send the Delta. Peer receives it, ingests, sees ProposeCommit=True (from us), and then Commits.
-                // So yes, proposeCommit = true.
-                responseDeltaData.proposeCommit = true;
                 const deltaStone = await this.createSyncMsgStone({
                     data: responseDeltaData,
                     localSpace: mySpace,
@@ -1552,41 +1489,43 @@ export class SyncSagaCoordinator {
                     localSpace: mySpace,
                     metaspace,
                 });
-                // Build control payloads: frame + its dependencies (msg stone, identity)
-                const payloadIbGibsControl = [deltaFrame, deltaStone];
-                if (identity) {
-                    payloadIbGibsControl.push(identity);
-                }
-                // return { frame: deltaFrame, payloadIbGibsControl, payloadIbGibsDomain: outgoingPayload };
                 return { frame: deltaFrame, payloadIbGibsDomain: outgoingPayload };
-                // throw new Error(`not implemented (E: 2b38a8afb6d84efcee5ab51673387826)`);
             }
             else {
                 // We have nothing to send.
                 if (peerProposesCommit) {
                     // Peer is done. We are done. -> Commit.
-                    const commitData = {
-                        sagaId: deltaData.sagaId,
-                        stage: SyncStage.commit,
-                        success: true,
-                    };
-                    const commitStone = await this.createSyncMsgStone({
-                        data: commitData,
-                        localSpace: mySpace,
-                        metaspace
+                    // one last validate entire history?
+                    const history = await getFullSyncSagaHistory({
+                        sagaIbGib,
+                        space: mySpace,
                     });
-                    const commitFrame = await this.evolveSyncSagaIbGib({
-                        prevSagaIbGib: sagaIbGib,
-                        msgStones: [commitStone],
-                        sessionIdentity: identity,
-                        localSpace: mySpace,
-                        metaspace
+                    const validationErrors = await validateFullSyncSagaHistory({
+                        history,
                     });
-                    // Build control payloads for commit
-                    const commitCtrlPayloads = [commitFrame, commitStone];
-                    if (identity) {
-                        commitCtrlPayloads.push(identity);
+                    if (validationErrors.length > 0) {
+                        const errorCommitFrame = await this.createCommitFrame({
+                            sagaIbGib,
+                            errors: validationErrors,
+                            metaspace, mySpace,
+                            identity,
+                        });
+                        return { frame: errorCommitFrame, }; /* <<<< returns early */
                     }
+                    await this.executeLocalCommit({
+                        sagaHistory: history,
+                        deltaFrame: sagaIbGib,
+                        localTempSpace: myTempSpace,
+                        localSpace: mySpace,
+                        metaspace,
+                    });
+                    const commitFrame = await this.createCommitFrame({
+                        sagaIbGib,
+                        errors: undefined,
+                        metaspace,
+                        mySpace,
+                        identity,
+                    });
                     return { frame: commitFrame, };
                 }
                 else {
@@ -1660,28 +1599,219 @@ export class SyncSagaCoordinator {
             }
         }
     }
+    /**
+     * should throw if fails
+     */
+    async executeLocalCommit({ deltaFrame, sagaHistory, metaspace, localSpace, localTempSpace, identity, }) {
+        const lc = `${this.lc}[${this.executeLocalCommit.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 6734980446b86a63c1af6e2e206de826)`);
+            }
+            // #region validate/sanity
+            if (!deltaFrame.data) {
+                throw new Error(`(UNEXPECTED) deltaFrame.data falsy? (E: a8be68d48668d93d992d793834823826)`);
+            }
+            // #endregion validate/sanity
+            // * move all payload addrs from temp space to local space
+            // * register each and every iteration of each timeline (including
+            //   stones, which are like their own sealed timeline of length 1)
+            const allPayloadAddrsDomainTransferred = [];
+            const fnAddPayloadAddr = (addr) => {
+                if (!allPayloadAddrsDomainTransferred.includes(addr)) {
+                    allPayloadAddrsDomainTransferred.push(addr);
+                }
+            };
+            sagaHistory.forEach(x => {
+                if (!x.sagaIbGib.data) {
+                    throw new Error(`(UNEXPECTED) sagaIbGib.data falsy? (E: 34d7f8cdee14717ce828878d98f89826)`);
+                }
+                x.msgStones.forEach(msgStone => {
+                    if (!msgStone.data) {
+                        throw new Error(`(UNEXPECTED) msgStone.data falsy? (E: 21406101f91847514cc759c8a7382f26)`);
+                    }
+                    if (msgStone.data.stage === SyncStage.ack) {
+                        const ackData = msgStone.data;
+                        if (ackData.pushOfferInfos && ackData.pushOfferInfos.length > 0) {
+                            ackData.pushOfferInfos.forEach(info => {
+                                info.addrs.forEach(addr => fnAddPayloadAddr(addr));
+                            });
+                        }
+                    }
+                    else if (msgStone.data.stage === SyncStage.delta) {
+                        const deltaData = msgStone.data;
+                        if (deltaData.payloadAddrsDomain && deltaData.payloadAddrsDomain.length > 0) {
+                            deltaData.payloadAddrsDomain.forEach(addr => fnAddPayloadAddr(addr));
+                        }
+                    }
+                });
+            });
+            // at this point, we have a list of ALL payload addrs retrieved.
+            let allPayloadIbGibsDomainTransferred = [];
+            const resGetAllTransferred = await getFromSpace({ addrs: allPayloadAddrsDomainTransferred, space: localTempSpace });
+            if (resGetAllTransferred.success && resGetAllTransferred.ibGibs && resGetAllTransferred.ibGibs.length === allPayloadAddrsDomainTransferred.length) {
+                allPayloadIbGibsDomainTransferred = resGetAllTransferred.ibGibs.concat();
+            }
+            else {
+                // errored out, gather info
+                if (!resGetAllTransferred.rawResultIbGib) {
+                    throw new Error(`(UNEXPECTED) !resGetAllTransferred.rawResultIbGib falsy? (E: dc6cf8729668f4fbe8c024f887d97a26)`);
+                }
+                const { addrsNotFound, addrsErrored, errors } = resGetAllTransferred.rawResultIbGib.data;
+                throw new Error(`(UNEXPECTED) we couldn't get all addrs transferred throughout the saga from the tempspace (${localTempSpace.ib})? addrsNotFound: ${addrsNotFound ?? []}. addrsErrored: ${addrsErrored ?? []}. errors: ${errors ?? []}(E: 222e341e634862b4d88ae7282584d826)`);
+            }
+            // now we have all ibgibs transferred, first put them all the local space
+            const { payload_Dnas, payload_NonDnas } = await putInSpace_dnasThenNonDnas({
+                ibGibs: allPayloadIbGibsDomainTransferred,
+                space: localSpace
+            });
+            const { mapWithTjp_NoDna, mapWithTjp_YesDna, mapWithoutTjps } = splitPerTjpAndOrDna({ ibGibs: payload_NonDnas, filterPrimitives: true });
+            // first register all non-tjp stones
+            const nontjps = Object.values(mapWithoutTjps);
+            for (const nontjp of nontjps) {
+                await metaspace.registerNewIbGib({
+                    ibGib: nontjp,
+                    space: localSpace,
+                });
+            }
+            // next register each timeline in order...
+            // ...first the ones without dna...
+            const timelinesByTjpAddr_NoDna = getTimelinesGroupedByTjp({ ibGibs: Object.values(mapWithTjp_NoDna) });
+            const tjpAddrs_NoDna = Object.keys(timelinesByTjpAddr_NoDna);
+            for (const tjpAddr_NoDna of tjpAddrs_NoDna) {
+                const timelineIbGibs = timelinesByTjpAddr_NoDna[tjpAddr_NoDna];
+                for (const ibGib of timelineIbGibs) {
+                    await metaspace.registerNewIbGib({
+                        ibGib,
+                        space: localSpace,
+                    });
+                }
+            }
+            // ...then the ones WITH dna.
+            const timelinesByTjpAddr_YesDna = getTimelinesGroupedByTjp({ ibGibs: Object.values(mapWithTjp_YesDna) });
+            const tjpAddrs_YesDna = Object.keys(timelinesByTjpAddr_YesDna);
+            for (const tjpAddr_YesDna of tjpAddrs_YesDna) {
+                const timelineIbGibs = timelinesByTjpAddr_YesDna[tjpAddr_YesDna];
+                for (const ibGib of timelineIbGibs) {
+                    await metaspace.registerNewIbGib({
+                        ibGib,
+                        space: localSpace,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    async createCommitFrame({ sagaIbGib, errors, metaspace, mySpace, identity, }) {
+        const lc = `[${this.createCommitFrame.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 48fc57c023f80122135a284855757526)`);
+            }
+            const commitData = errors && errors.length > 0 ?
+                {
+                    // errored
+                    sagaId: sagaIbGib.data.uuid,
+                    stage: SyncStage.commit,
+                    success: false,
+                    errors,
+                } :
+                {
+                    // not errored
+                    sagaId: sagaIbGib.data.uuid,
+                    stage: SyncStage.commit,
+                    success: true,
+                };
+            const commitStone = await this.createSyncMsgStone({
+                data: commitData,
+                localSpace: mySpace,
+                metaspace
+            });
+            const commitFrame = await this.evolveSyncSagaIbGib({
+                prevSagaIbGib: sagaIbGib,
+                msgStones: [commitStone],
+                sessionIdentity: identity,
+                localSpace: mySpace,
+                metaspace,
+            });
+            return commitFrame;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
     async handleCommitFrame({ sagaIbGib, mySpace, myTempSpace, metaspace, identity, }) {
         const lc = `${this.lc}[${this.handleCommitFrame.name}]`;
         try {
             if (logalot) {
                 console.log(`${lc} starting... (I: e179573bdd881202f8ba3168da1c3826)`);
             }
+            let resNextSagaFrameInfo;
             // Sender Logic (Finalizing):
             // If we are here, we received a Commit frame from the Peer.
             // This implies the Peer has successfully committed.
             // We should now:
             // 1. Validate (implicitly done by receiving valid frame)
             // 2. Perform our own cleanup (Temp -> Dest, if applicable)
-            // 3. Return null to signal saga completion.
-            // Note: Currently we don't have explicit cleanup logic implemented here yet (TODO).
+            // 3. Return saga completion.
+            // one last validate entire history?
+            const history = await getFullSyncSagaHistory({
+                sagaIbGib,
+                space: mySpace,
+            });
+            const validationErrors = await validateFullSyncSagaHistory({
+                history,
+            });
+            if (validationErrors.length > 0) {
+                const errorCommitFrame = await this.createCommitFrame({
+                    sagaIbGib,
+                    metaspace,
+                    mySpace,
+                    identity,
+                    errors: validationErrors,
+                });
+                return { frame: errorCommitFrame, }; /* <<<< returns early */
+            }
+            await this.executeLocalCommit({
+                deltaFrame: sagaIbGib,
+                sagaHistory: history,
+                localSpace: mySpace,
+                localTempSpace: myTempSpace,
+                metaspace,
+            });
+            // todo: implement explicit cleanup logic here and in peer
+            console.error(`${lc} NAG ERROR (NOT THROWN): implement cleanup logic, including add a cleanup method to the peer (E: 3a9a24befb98a981a88fbdbf52920e26)`);
             if (logalot) {
                 console.log(`${lc} Peer committed. Finalizing saga locally. Saga Complete.`);
             }
-            return { responseWasNull: true };
+            // the holy grail!
+            return { sagaComplete: true };
         }
         catch (error) {
-            console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
+            const emsg = `${lc} ${extractErrorMsg(error)}`;
+            console.error(emsg);
+            const errorCommitFrame = await this.createCommitFrame({
+                sagaIbGib,
+                errors: [emsg],
+                metaspace,
+                mySpace,
+                identity,
+            });
+            return { frame: errorCommitFrame };
         }
         finally {
             if (logalot) {
@@ -1720,6 +1850,69 @@ export class SyncSagaCoordinator {
             }
         }
     }
+    async getPayloadsForRequestedInfos({ deltaRequestAddrInfos, mySpace, }) {
+        const lc = `${this.lc}[${this.getPayloadsForRequestedInfos.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 4fe13d0d80050f20a8b74ba80cee5826)`);
+            }
+            /**
+             * graph of ibgibs we will send to the receiver. addr-based, so will
+             * already be unique (no need to call `unique` on the domains
+             * ibgibs)
+             */
+            const outgoingPayloadIbGibsDomainGraph = {};
+            for (const { addr, latestAddrAlreadyHave } of deltaRequestAddrInfos) {
+                let deltaDepGraph;
+                if (latestAddrAlreadyHave) {
+                    // already has some, so only get the delta
+                    // remember: if we didn't have the other's latest addr, then
+                    // this would be in the conflicts not requested addrs
+                    deltaDepGraph = await getDeltaDependencyGraph({
+                        ibGibAddr: addr,
+                        latestCommonFrameAddr: latestAddrAlreadyHave,
+                        space: mySpace,
+                        live: true,
+                    });
+                }
+                else {
+                    // doesn't have anything, so get the entire dependency graph
+                    // INEFFICIENT: we've already gotten all of the domain
+                    // dependencies in initDomainGraph, but getDependencyGraph
+                    // only works against a space so we are going to rerun this.
+                    // an optimization would be to adapt/create a new
+                    // getDependencyGraph to work against an existing flat ibgib
+                    // map.
+                    deltaDepGraph = await getDependencyGraph({
+                        ibGibAddr: addr,
+                        space: mySpace,
+                        live: true,
+                    });
+                }
+                const depGraphSize = Object.keys(deltaDepGraph).length;
+                if (depGraphSize === 0) {
+                    throw new Error(`(UNEXPECTED) couldn't get requested addrs in mySpace (${mySpace.ib})? How did the receiver know to ask for these addrs if they weren't in our original graph? (E: 281eaebcdf77dd73e8245b2872100826)`);
+                }
+                else {
+                    // we have dependencies!
+                    Object.values(deltaDepGraph).forEach(x => {
+                        outgoingPayloadIbGibsDomainGraph[getIbGibAddr({ ibGib: x })] = x;
+                    });
+                }
+            }
+            const result = Object.values(outgoingPayloadIbGibsDomainGraph);
+            return result;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
     /**
      * Evolves the saga timeline with a new frame.
      */