@ibgib/core-gib 0.0.8 → 0.0.11

package/dist/witness/robbot/robbot-base-v1.mjs

@@ -1,17 +1,14 @@
-import { filter } from 'rxjs/operators';
-import { V1, getIbGibAddr } from '@ibgib/ts-gib';
+import { getIbGibAddr } from '@ibgib/ts-gib';
 import { getGibInfo } from '@ibgib/ts-gib/dist/V1/index.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
-import { RobbotCmd, ROBBOT_MY_COMMENTS_REL8N_NAME, ROBBOT_CONTEXT_REL8N_NAME, SemanticId, RobbotInteractionType, DEFAULT_ROBBOT_LEX_DATA, DEFAULT_HUMAN_LEX_DATA, } from './robbot-types.mjs';
-import { WitnessBase_V1, } from '../witness-base-v1.mjs';
+import { RobbotCmd, ROBBOT_CONTEXT_REL8N_NAME, SemanticId, RobbotInteractionType, DEFAULT_ROBBOT_LEX_DATA, DEFAULT_HUMAN_LEX_DATA, ROBBOT_ATOM, } from './robbot-types.mjs';
 import { getInteractionIbGib_V1, validateCommonRobbotData } from './robbot-helper.mjs';
 import { argy_, isArg, resulty_ } from '../witness-helper.mjs';
-import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
-import { Lex, clone, delay, getTimestamp, getUUID, pretty } from '@ibgib/helper-gib';
+import { Lex, clone, getTimestamp, getUUID } from '@ibgib/helper-gib';
 import { errorIbGib } from '../../common/error/error-helper.mjs';
-import { createCommentIbGib, parseCommentIb } from '../../common/comment/comment-helper.mjs';
-import { getFromSpace, getLatestAddrs } from '../space/space-helper.mjs';
-import { getTjpAddr } from '../../common/other/ibgib-helper.mjs';
+import { parseCommentIb } from '../../common/comment/comment-helper.mjs';
+import { getFromSpace } from '../space/space-helper.mjs';
+import { WitnessWithContextBase_V1 } from '../witness-with-context/witness-with-context-base-v1.mjs';
 const logalot = GLOBAL_LOG_A_LOT || true;
 /**
  * ## distinguishing characteristics of robbots
@@ -60,7 +57,23 @@ const logalot = GLOBAL_LOG_A_LOT || true;
  * calls if they end up called for, effectively the equivalent of the
  * old-fashioned "ProcessMessages/DoEvents" hack.
  */
-export class RobbotBase_V1 extends WitnessBase_V1 {
+export class RobbotBase_V1 extends WitnessWithContextBase_V1 {
+    constructor(initialData, initialRel8ns) {
+        super(initialData, initialRel8ns);
+        /**
+         * Log context for convenience with logging. (Ignore if you don't want to use this.)
+         *
+         * Often used in conjunction with `logalot`.
+         */
+        this.lc = `[${RobbotBase_V1.name}]`;
+        /**
+         * When the robbot has to get some ibgibs, might as well store them here so
+         * we don't have to get them again from storage.
+         */
+        this._cacheIbGibs = {};
+        this._semanticHandlers = {};
+        this.initialized = this.initialize();
+    }
     async handleSemanticDefault(info) {
         const lc = `${this.lc}[${this.handleSemanticDefault.name}]`;
         try {
@@ -90,32 +103,6 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
             }
         }
     }
-    constructor(initialData, initialRel8ns) {
-        super(initialData, initialRel8ns);
-        /**
-         * Log context for convenience with logging. (Ignore if you don't want to use this.)
-         *
-         * Often used in conjunction with `logalot`.
-         */
-        this.lc = `[${RobbotBase_V1.name}]`;
-        /**
-         * When the robbot has to get some ibgibs, might as well store them here so
-         * we don't have to get them again from storage.
-         */
-        this._cacheIbGibs = {};
-        /**
-         * when we get an update to the context, we want to know what the _new_
-         * children are in order to interpret comments from the user that may be
-         * directed at us.
-         *
-         * So we will get an initial snapshot of children that we will diff against.
-         * We could go via the dna, but ultimately a diff is what is needed.
-         */
-        this._currentWorkingContextIbGib_PriorChildrenAddrs = [];
-        this._updatingContext = false;
-        this._semanticHandlers = {};
-        this.initialized = this.initialize();
-    }
     // #region initialize
     /**
      * Initializes to default space values.
@@ -126,6 +113,7 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
             if (logalot) {
                 console.log(`${lc} starting... (I: f0e65ab0f80046a59668ddfbf9f47a4a5)`);
             }
+            await super.initialize();
             await this.initialize_semanticHandlers();
             await this.initialize_lex();
         }
@@ -211,43 +199,6 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
         }
     }
     // #endregion initialize
-    async loadNewerSelfIfAvailable() {
-        const lc = `${this.lc}[${this.loadNewerSelfIfAvailable.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: 94755c3131f4dfa12d20fa38e2926522)`);
-            }
-            if (this.ibgibsSvc) {
-                // check for newer version of self locally before executing
-                const robbotAddr = getIbGibAddr({ ibGib: this });
-                const latestAddr = await this.ibgibsSvc.getLatestAddr({ ibGib: this });
-                if (latestAddr && latestAddr !== robbotAddr) {
-                    // robbot has a newer ibgib in its timeline
-                    let resGet = await this.ibgibsSvc.get({ addr: latestAddr });
-                    if (!resGet || !resGet?.success || (resGet?.ibGibs ?? []).length === 0) {
-                        throw new Error(`could not get newer robbot ibgib (E: 15fa346c8ac17edb96e4b0870104c122)`);
-                    }
-                    await this.loadIbGibDto(resGet.ibGibs[0]);
-                    const validationErrors = await this.validateThis();
-                    if (validationErrors?.length > 0) {
-                        throw new Error(`validationErrors when loading newer version: ${pretty(validationErrors)} (E: 0d9f0684a1ff6af44e20a57130e3ac22)`);
-                    }
-                }
-            }
-            else {
-                console.warn(`${lc} this.ibgibsSvc undefined (W: 44cc5bf1b14b4695b8de4c589787be06)`);
-            }
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
     /**
      * At this point in time, the arg has already been intrinsically validated,
      * as well as the internal state of this robbot. so whatever this robbot's
@@ -263,7 +214,14 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
                 console.log(`${lc} starting...`);
             }
             await this.loadNewerSelfIfAvailable();
-            return this.routeAndDoArg({ arg });
+            let result = await this.routeAndDoArg({ arg });
+            if (!result) {
+                result = await this.doDefault({ ibGib: arg });
+            }
+            if (!result) {
+                console.warn(`${lc} result falsy...Could not produce result? Was doDefault implemented in concrete class? (W: 67f5fc5e6e864a13b0053fb54cfba100)`);
+            }
+            return result;
         }
         catch (error) {
             console.error(`${lc} ${error.message}`);
@@ -432,7 +390,10 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
                 throw new Error(`arg required (E: 9cddabc6dc96ddb37846807feb093423)`);
             }
             if (arg.ibGibs?.length ?? 0 > 0) {
-                await this.initializeContext({ arg });
+                await this.initializeContext({
+                    arg: arg,
+                    rel8nName: ROBBOT_CONTEXT_REL8N_NAME,
+                });
             }
             const result = await this.resulty({
                 resultData: {
@@ -459,7 +420,9 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
                 console.log(`${lc} starting... (I: d453593a295d4cdbae2acb71d9f6de35)`);
             }
             await this.initialized;
-            await this.finalizeContext({ arg });
+            await this.finalizeContext({
+                arg: arg,
+            });
             const result = await this.resulty({
                 resultData: {
                     optsAddr: getIbGibAddr({ ibGib: arg }),
@@ -545,117 +508,6 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
         }
     }
     // #endregion other stubbed do functions (doPic, doComment, doDefault)
-    /**
-     * By default, this...
-     *
-     * * performs the raw {@link rel8} transform to the given `ibGib`.
-     * * persists the new ibgib's transform result in the given space.
-     * * registers the newer version of this robbot ibgib with the ibgibs svc.
-     *
-     * @see {@link ibGibs}
-     * @see {@link rel8nName}
-     * @see {@link ibgibsSvc}
-     * @see {@link space}
-     *
-     * ## notes
-     *
-     * * If there is no given `space`, then we will use the `ibgibsSvc` to get
-     *   the local user space. If none, then we skip persistence.
-     * * If there is no `ibgibsSvc`, we won't register the new ibgibs locally.
-     */
-    async rel8To({ ibGibs, rel8nName, linked, ibgibsSvc,
-    // space,
-     }) {
-        const lc = `${this.lc}[${this.rel8To.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting...`);
-            }
-            // #region initialize, validate args and this
-            if ((ibGibs ?? []).length === 0) {
-                throw new Error(`ibGibs required (E: 2fd13de0f025b170885bede4d7a50922)`);
-            }
-            rel8nName = rel8nName || this.data?.defaultRel8nName;
-            if (!rel8nName) {
-                throw new Error(`rel8nName required either as an arg or in this.data.defaultRel8nName (E: 43ab8ae63694a2a82cd8a70ed6b6b522)`);
-            }
-            const thisValidationErrors = await this.validateThis();
-            if (thisValidationErrors?.length > 0) {
-                throw new Error(`this is an invalid ibGib. thisValidationErrors: ${thisValidationErrors.join('|')} (E: 8f08716866cd13bf254222ee9e6a6722)`);
-            }
-            ibgibsSvc = ibgibsSvc ?? this.ibgibsSvc;
-            if (!ibgibsSvc) {
-                // if (this.ibgibsSvc) {
-                //     if (logalot) { console.log(`${lc} ibgibsSvc arg falsy, but we have a reference on this object, which we will use. (I: ee0d39a47ee8aee8ffd797721fea4322)`); }
-                //     ibgibsSvc = this.ibgibsSvc;
-                // }
-                throw new Error(`either ibgibsSvc or this.ibgibsSvc required (E: b5f9453ddb394a2b76dec74c7304df22)`);
-            }
-            // if (!space) {
-            //     if (ibgibsSvc) {
-            //         if (logalot) { console.log(`${lc} space arg falsy, but ibgibsSvc truthy, so we'll use ibgibsSvc's local user space for persistence. (I: 37a4b4c1406556cb23831671755b0d22)`); }
-            //         space = await ibgibsSvc.getLocalUserSpace({ lock: true });
-            //     }
-            // }
-            // if (!space) { throw new Error(`(UNEXPECTED) space required and ibgibsSvc couldn't get it? (E: a3b9f9b72f6f6f18883199a19d38c622)`); }
-            // #endregion initialize, validate args and this
-            // we want to rel8 only to the ibGibs whose timelines we're not
-            // already related to. So we look to see if we already have the tjpGib
-            // per our rel8nName.
-            // if (!this.rel8ns) { this.rel8ns = {} as any };
-            const alreadyRel8dAddrs = this.rel8ns ? this.rel8ns[rel8nName] ?? [] : [];
-            const alreadyRel8dTjpGibs = alreadyRel8dAddrs.map(x => getGibInfo({ ibGibAddr: x }).tjpGib);
-            const ibGibsNotYetRel8dByTjp = ibGibs.filter(x => {
-                const tjpGib = getGibInfo({ ibGibAddr: getIbGibAddr({ ibGib: x }) }).tjpGib;
-                return !alreadyRel8dTjpGibs.includes(tjpGib);
-            });
-            if (ibGibsNotYetRel8dByTjp.length === 0) {
-                if (logalot) {
-                    console.log(`${lc} already rel8d to all incoming ibGib(s) via tjp. (I: 5e9d94a98ba262f146c0c0b765157922)`);
-                }
-                return; /* <<<< returns early */
-            }
-            // perform the raw ibgib rel8 transform
-            const addrs = ibGibsNotYetRel8dByTjp.map(x => getIbGibAddr({ ibGib: x }));
-            const resNewRobbot = await V1.rel8({
-                src: this.toIbGibDto(),
-                rel8nsToAddByAddr: { [rel8nName]: addrs },
-                linkedRel8ns: linked ? ["past", "ancestor", rel8nName] : ["past", "ancestor"],
-                dna: true,
-                nCounter: true,
-            });
-            const newRobbotIbGib = resNewRobbot.newIbGib;
-            const newRobbotValidationErrors = await validateIbGibIntrinsically({ ibGib: newRobbotIbGib });
-            if (newRobbotValidationErrors?.length ?? 0 > 0) {
-                throw new Error(`new robbot would have validation errors. aborting. newRobbotValidationErrors: ${newRobbotValidationErrors.join('|')} (E: eb816a27156c246c121ef55e37d59322)`);
-            }
-            // if space is given, perform the persistence
-            // if (space) {
-            await ibgibsSvc.persistTransformResult({ resTransform: resNewRobbot });
-            // } else {
-            //     if (logalot) { console.log(`${lc} space falsy, skipping persistence (I: 90aa3553e92ad1d02bce61f83648ea22)`); }
-            // }
-            // if ibgibs svc is given, register the new ibgib
-            // (in the future, need to revisit the ibgibs service to the idea of locality/ies).
-            // if (ibgibsSvc) {
-            await ibgibsSvc.registerNewIbGib({ ibGib: newRobbotIbGib });
-            // } else {
-            //     if (logalot) { console.log(`${lc} ibgibsSvc falsy so skipping registerNewIbGib for new robbot (I: eda4f68fffaf2435eba25cd39d4f2922)`); }
-            // }
-            // update this witness' primary ibGib properties (ib, gib, data, rel8ns).
-            //   override `loadIbGibDto` to update secondary/derivative properties
-            await this.loadIbGibDto(newRobbotIbGib);
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
     /**
      * validates against common robbot qualities.
      *
@@ -721,121 +573,8 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
         }
         return result;
     }
-    async rel8ToContextIbGib({ ibGibToRel8, ibGibAddrToRel8, contextIbGib, rel8nNames,
-    // space,
-     }) {
-        const lc = `${this.lc}[${this.rel8ToContextIbGib.name}]`;
-        try {
-            if (!ibGibToRel8 && !ibGibAddrToRel8) {
-                throw new Error(`ibGibToRel8 or ibGibAddrToRel8 required (E: 3ee14659fd22355a5ba0e537a477be22)`);
-            }
-            if (!contextIbGib) {
-                throw new Error(`contextIbGib required (E: 85f27c7cbf713704c21084c141cd8822)`);
-            }
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc required (E: 6a38c4274bdefc8d44cafd2d6faaa222)`);
-            }
-            // space = space ?? await this.ibgibsSvc.getLocalUserSpace({ lock: true });
-            // if (!space) { throw new Error(`space required (E: 267ad87c148942cda641349df0bbbd22)`); }
-            if ((rel8nNames ?? []).length === 0) {
-                if (!this.data?.defaultRel8nName) {
-                    throw new Error(`either rel8nNames or this.data.defaultRel8nName required (E: a14ab4b3e479d9274c61bc5a30bc2222)`);
-                }
-                rel8nNames = [this.data.defaultRel8nName];
-            }
-            // set up the rel8ns to add
-            const rel8nsToAddByAddr = {};
-            ibGibAddrToRel8 = ibGibAddrToRel8 || getIbGibAddr({ ibGib: ibGibToRel8 });
-            rel8nNames.forEach((rel8nName) => { rel8nsToAddByAddr[rel8nName] = [ibGibAddrToRel8]; });
-            // perform the rel8 transform and...
-            const resRel8ToContext = await V1.rel8({
-                src: contextIbGib,
-                rel8nsToAddByAddr,
-                dna: true,
-                nCounter: true
-            });
-            // ...persist it...
-            await this.ibgibsSvc.persistTransformResult({ resTransform: resRel8ToContext });
-            // ...register the context.
-            const { newIbGib: newContext } = resRel8ToContext;
-            await this.ibgibsSvc.registerNewIbGib({ ibGib: newContext });
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-    }
-    async createCommentAndRel8ToContextIbGib({ text, contextIbGib, }) {
-        const lc = `${this.lc}[${this.createCommentAndRel8ToContextIbGib.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: c3a005f7d323468a5b4e1b2710901d22)`);
-            }
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc required (E: 5dbb1a7f0ff5469b8ce3cb1be175e521)`);
-            }
-            // space = space ?? await this.ibgibsSvc.getLocalUserSpace({ lock: true });
-            // if (!space) { throw new Error(`(UNEXPECTED) space required and wasn't able to get it from ibgibsSvc? (E: 7159f9893a66c28a7e09b61384545622)`); }
-            let space = await this.ibgibsSvc.getLocalUserSpace({ lock: true });
-            /** tag this comment with metadata to show it came from this robbot */
-            let resComment = await createCommentIbGib({ text, addlMetadataText: this.getAddlMetadata(), saveInSpace: true, space });
-            // get again to be sure it's the latest space.
-            space = await this.ibgibsSvc.getLocalUserSpace({ lock: true });
-            const commentIbGib = resComment.newIbGib;
-            if (!commentIbGib) {
-                throw new Error(`(UNEXPECTED) failed to create comment? (E: 6d668f4e55198e654324622eabaac922)`);
-            }
-            await this.ibgibsSvc.registerNewIbGib({ ibGib: commentIbGib });
-            await this.rel8ToContextIbGib({ ibGibToRel8: commentIbGib, contextIbGib, rel8nNames: ['comment'] });
-            await this.rel8To({
-                ibGibs: [commentIbGib],
-                rel8nName: ROBBOT_MY_COMMENTS_REL8N_NAME,
-            });
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * used to identify when comments are made by these robbots.
-     *
-     * atow this is `robbot_${this.data.classname}_${this.data.name}_${this.data.uuid.slice(0, 8)}`;
-     *
-     * @returns addlmetadata string to be used in comment ib's
-     */
-    getAddlMetadata() {
-        const lc = `${this.lc}[${this.getAddlMetadata.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: 7800732facf3783943fdf1b2423b0c22)`);
-            }
-            if (!this.data) {
-                throw new Error(`(UNEXPECTED) this.data falsy? (E: 7cb044b39b2b8e31f363f3b82f256323)`);
-            }
-            const classnameIsh = this.data.classname?.replace(/[_]/mg, '') || undefined;
-            const robbotNameIsh = this.data.name?.slice(0, 8).replace(/[__]/mg, '') || undefined;
-            const robbotIdIsh = this.data.uuid?.slice(0, 8) || undefined;
-            const addlMetadataText = `robbot_${classnameIsh}_${robbotNameIsh}_${robbotIdIsh}`;
-            if (logalot) {
-                console.log(`${lc} addlMetadataText: ${addlMetadataText} (I: 53c0044671dc99fb75635367d2e63c22)`);
-            }
-            return addlMetadataText;
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
+    getThisAtom() {
+        return ROBBOT_ATOM; // "robbot" atow
     }
     parseAddlMetadataString({ ib }) {
         const lc = `${this.lc}[${this.parseAddlMetadataString.name}]`;
@@ -1002,361 +741,6 @@ export class RobbotBase_V1 extends WitnessBase_V1 {
             }
         }
     }
-    /**
-     * I originally created this just to extract the context from the arg, but
-     * I'm reusing it to get the latest context from the addr alone.
-     */
-    async getContextIbGibFromArgOrAddr({ arg, addr, latest, }) {
-        const lc = `${this.lc}[${this.getContextIbGibFromArgOrAddr.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: c13f7cb92133984048f606075efb8a22)`);
-            }
-            let contextIbGib;
-            if (!arg && !addr) {
-                throw new Error(`either arg or addr required. (E: 3f647b65742242fd9ba878521acf7c22)`);
-            }
-            if (!this.ibgibsSvc) {
-                throw new Error(`(UNEXPECTED) this.ibgibsSvc required (E: f0046290b0d66d28c4bbbf83d9d9f523)`);
-            }
-            if (arg) {
-                if ((arg.ibGibs ?? []).length === 0) {
-                    throw new Error(`(UNEXPECTED) invalid arg? no context ibgib on arg (E: 89997eb4bdeb3885bee9de5d33ee0f22)`);
-                }
-                if ((arg.ibGibs ?? []).length !== 1) {
-                    throw new Error(`(UNEXPECTED) invalid arg? only expected one ibgib on arg.ibGibs (E: 1a1498af668740fe9439f4953a74ea8a)`);
-                }
-                contextIbGib = arg.ibGibs[0];
-            }
-            else {
-                // addr provided
-                const resGet = await this.ibgibsSvc.get({ addr });
-                if (!resGet.success || resGet.ibGibs?.length !== 1) {
-                    throw new Error(`could not get context addr (${addr}) (E: 834492313512a45b23a7bebacdc48122)`);
-                }
-                contextIbGib = resGet.ibGibs[0];
-            }
-            if (latest) {
-                const resLatestAddr = await this.ibgibsSvc.getLatestAddr({ ibGib: contextIbGib });
-                if (resLatestAddr !== getIbGibAddr({ ibGib: contextIbGib })) {
-                    const resGet = await this.ibgibsSvc.get({ addr: resLatestAddr });
-                    if (resGet.success && resGet.ibGibs?.length === 1) {
-                        contextIbGib = resGet.ibGibs[0];
-                    }
-                    else {
-                        throw new Error(`unable to get resLatestAddr (${resLatestAddr}) (E: ce1e1297743e9a16c8f082321e52a122)`);
-                    }
-                }
-            }
-            return contextIbGib;
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * The context is the ibgib where we are interacting with the user(s) (only
-     * singlular atow).
-     *
-     * When we initialize, we are setting state on this robbot as well as subscribing
-     * to the context ibgib's updates in `this.ibgibsSvc`.
-     *
-     * if we already have a context, then this will check the new incoming
-     * context against it.  If it's the same timeline, then this won't do
-     * anything. Otherwise, it will finalize the previous context.
-     */
-    async initializeContext({ arg, }) {
-        const lc = `${this.lc}[${this.initializeContext.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: d93429c85b0a494388f66fba3eece922)`);
-            }
-            // get context from arg just to compare the tjp's so we don't need
-            // the latest at this point
-            const incomingContext_NotLatest = await this.getContextIbGibFromArgOrAddr({ arg, latest: false });
-            if (this._currentWorkingContextIbGib) {
-                let currentTjpAddr = getTjpAddr({ ibGib: this._currentWorkingContextIbGib });
-                const incomingTjpAddr = getTjpAddr({ ibGib: incomingContext_NotLatest });
-                if (currentTjpAddr === incomingTjpAddr) {
-                    console.warn(`${lc} initializing context but it's the same timeline (${currentTjpAddr}). (W: 7609f8f51172443183e0c93ad52bfe56)`);
-                    return;
-                }
-                else {
-                    await this.finalizeContext({ arg });
-                }
-            }
-            /** used both now and when context ibgib is updated via observable */
-            const updatePriorChildren = () => {
-                this._currentWorkingContextIbGib_PriorChildrenAddrs = [
-                    ...this._currentWorkingContextIbGib?.rel8ns?.comment ?? [],
-                    ...this._currentWorkingContextIbGib?.rel8ns?.pic ?? [],
-                    ...this._currentWorkingContextIbGib?.rel8ns?.link ?? [],
-                ];
-            };
-            // set the props
-            this._currentWorkingContextIbGib = await this.getContextIbGibFromArgOrAddr({ arg, latest: true });
-            updatePriorChildren();
-            // subscribe to context ibgib updates
-            const contextTjpAddr = getTjpAddr({ ibGib: this._currentWorkingContextIbGib });
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc falsy...not initialized? (E: 6e38bfdc5c2eb5fef884f0183889e823)`);
-            }
-            this._contextChangesSubscription =
-                this.ibgibsSvc.latestObs.pipe(filter(x => x.tjpAddr === contextTjpAddr)).subscribe(async (update) => {
-                    const currentAddr = getIbGibAddr({ ibGib: this._currentWorkingContextIbGib });
-                    if (update.latestAddr !== currentAddr) {
-                        if (logalot) {
-                            console.warn(`${lc} checking if new context is actually new...damn getLatestAddr maybe not working in ionic space... argh (W: 3d1a12154dfafb9c96d07e6f75f7a322)`);
-                        }
-                        if (update.latestIbGib) {
-                            let latestN_Supposedly = update.latestIbGib.data?.n ?? -1;
-                            let currentN = this._currentWorkingContextIbGib?.data?.n ?? -2;
-                            if (latestN_Supposedly <= currentN) {
-                                console.warn(`${lc} latestN is not really the latest. latestN_Supposedly: ${latestN_Supposedly}, currentN: ${currentN} (W: 6792c9a596c44c03b262614ae79a715e)`);
-                                return; /* <<<< returns early */
-                            }
-                        }
-                        if (logalot) {
-                            console.log(`${lc} update to context.\ncurrentAddr: ${currentAddr}\nlatestAddr: ${update.latestAddr} (I: d0adcc392e6e974c9917730ebad51322)`);
-                        }
-                        this._currentWorkingContextIbGib =
-                            update.latestIbGib ??
-                                await this.getContextIbGibFromArgOrAddr({ addr: update.latestAddr, latest: false }); // already latest
-                        if (!this._updatingContext) {
-                            await this.handleContextUpdate({ update });
-                            updatePriorChildren();
-                        }
-                        else {
-                            if (logalot) {
-                                console.log(`${lc} already updating context (I: f856f9414627ab00418dccd285b55822)`);
-                            }
-                        }
-                    }
-                });
-            // rel8 to the context (conversation)
-            await this.rel8To({
-                ibGibs: [this._currentWorkingContextIbGib],
-                rel8nName: ROBBOT_CONTEXT_REL8N_NAME,
-            });
-            // subscribe to receive updates to the context so we can participate
-            // in the conversation (i.e. interpret incoming ibgibs like commands
-            // if needed)
-            // let gibInfo = getGibInfo({ gib: this._currentWorkingContextIbGib.gib });
-            // if (gibInfo.tjpGib) {
-            //     this.ibgibsSvc.latestObs
-            //         .subscribe(update => {
-            //             if (!update.tjpAddr) { return; /* <<<< returns early */ }
-            //             if (getIbAndGib({ ibGibAddr: update.tjpAddr }).gib !== gibInfo.tjpGib) { return; /* <<<< returns early */ }
-            //             if (update.latestAddr === getIbGibAddr({ ibGib: this._currentWorkingContextIbGib })) {
-            //                 if (logalot) { console.log(`${lc} already have that context... (I: a6e17ec40d620f0bd5b231db39eaa522)`); }
-            //                 return; /* <<<< returns early */
-            //             }
-            //             if (this._updatingContext) {
-            //                 if (logalot) { console.log(`${lc} already updating context (I: f856f9414627ab00418dccd285b55822)`); }
-            //                 return; /* <<<< returns early */
-            //             }
-            //             this.handleContextUpdate({ update });
-            //         });
-            // }
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    async finalizeContext({ arg, }) {
-        const lc = `${this.lc}[${this.finalizeContext.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: dd53dfc745864dd19fde5f209ceb82c8)`);
-            }
-            let tries = 0;
-            const maxTries = 100;
-            while (this._updatingContext && tries < maxTries) {
-                await delay(100);
-                tries++;
-                if (tries % 10 === 0) {
-                    console.log(`${lc} already updating context and taking a litle while... waiting still. tries: ${tries}/${maxTries} (I: d45ab59af9ea43518432e34ddad95c19)`);
-                }
-            }
-            if (this._updatingContext) {
-                console.error(`${lc} previous call to updatingContext took too long. Ignoring flag and finalizing context. (E: 9a2dc4e1923442fa90fbeae72f358acd)`);
-            }
-            this._updatingContext = true;
-            if (this._contextChangesSubscription) {
-                debugger;
-                this._contextChangesSubscription.unsubscribe();
-                delete this._contextChangesSubscription;
-            }
-            delete this._currentWorkingContextIbGib;
-            if (this._currentWorkingContextIbGib) {
-                await this.createCommentAndRel8ToContextIbGib({
-                    text: await this.getOutputText({ text: 'end of line' }),
-                    contextIbGib: this._currentWorkingContextIbGib,
-                });
-                delete this._currentWorkingContextIbGib;
-            }
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            this._updatingContext = false;
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    /**
-     * Handles a new ibgib in the current working context.
-     *
-     * If it originated from the robbot him/herself, then we will ignore it.
-     * Otherwise this is interpreted either as a "command" or something to remember.
-     *
-     * ## notes
-     *
-     * If the user says something and we're listening (this is triggered), then
-     * it should be either interpreted as a "command" or ignored. I put
-     * "command" in quotes because the word is a very short-sighted
-     * understanding of the conversational aspect. Or perhaps I speak to the
-     * connotations to current belief's regarding robbots and commands.
-     *
-     * This is complicated by the possibility in the future of multiple robbots
-     * being engaged in a conversation within the same context.
-     */
-    async handleContextUpdate({ update }) {
-        const lc = `${this.lc}[${this.handleContextUpdate.name}]`;
-        // I don't see this as really being very likely in the near future,
-        // but putting in a wait delay in case there are multiple updates
-        while (this._updatingContext) {
-            console.warn(`${lc} already updating context? delaying... (W: 19d2ebeaaf2340fb91a7d6c717e9cb41)`);
-            await delay(1000);
-        }
-        this._updatingContext = true;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: 3eeaa40cad49094f125f9f5cd6ff6e22)`);
-            }
-            // if it's caused by this robbot speaking, then we don't really need
-            // it. but if it's from the user, then we want to respond.
-            if (logalot) {
-                console.log(`${lc} update: (I: ad0abae7de472e3b4d3891ea0b937322)`);
-                console.table(update);
-            }
-            if (!update.latestIbGib) {
-                debugger;
-                throw new Error(`(UNEXPECTED) update.latestIbGib falsy? (E: e18a048d7e95757238396ddd84748f22)`);
-            }
-            const newContext = update.latestIbGib;
-            const newChildrenIbGibs = await this.getNewChildrenIbGibs({ newContext });
-            // should normally be just one (would be very edge casey if not atow)
-            let newChild;
-            if (newChildrenIbGibs.length === 1) {
-                newChild = newChildrenIbGibs[0];
-            }
-            else if (newChildrenIbGibs.length > 1) {
-                console.warn(`${lc} (UNEXPECTED) found multiple new children in conversation? Using only the last. (W: 02d82a8f755f418d95fa30f0f52ad58e)`);
-                newChild = newChildrenIbGibs[newChildrenIbGibs.length - 1];
-            }
-            else {
-                // no new children, so maybe the user deleted something or who knows.
-                if (logalot) {
-                    console.log(`${lc} no new children in context update. returning early... (I: 31397b04965351ab29bb3f78cb709122)`);
-                }
-                return; /* <<<< returns early */
-            }
-            // we have a new chidl inthe context.
-            await this.handleNewContextChild({ newChild });
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            this._updatingContext = false;
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    async getNewChildrenIbGibs({ newContext }) {
-        const lc = `${this.lc}[${this.getNewChildrenIbGibs.name}]`;
-        try {
-            if (logalot) {
-                console.log(`${lc} starting... (I: 1b3d1cf908489087fa3b281f55b9a522)`);
-            }
-            // get a diff of the new addrs vs. the old addrs.
-            /** all of the children addrs of the new context */
-            const newContextChildrenAddrs = [
-                ...newContext.rel8ns?.comment ?? [],
-                ...newContext.rel8ns?.pic ?? [],
-                ...newContext.rel8ns?.link ?? [],
-            ];
-            /** just the new addrs from the context  */
-            const newChildrenAddrs = newContextChildrenAddrs.filter(x => !this._currentWorkingContextIbGib_PriorChildrenAddrs.includes(x));
-            if (newChildrenAddrs.length === 0) {
-                // no new children
-                if (logalot) {
-                    console.log(`${lc} no new children addrs in newContext. returning early... (I: 8f9c3658c194c472cb1e2bc19d847b22)`);
-                }
-                return []; /* <<<< returns early */
-            }
-            // get the latest addrs for those children
-            if (!this.ibgibsSvc) {
-                throw new Error(`this.ibgibsSvc falsy. not initialized? (E: 1cc26ca7de7fadcdbaecbd6613350e23)`);
-            }
-            const space = await this.ibgibsSvc.getLocalUserSpace({});
-            if (!space) {
-                throw new Error(`couldn't get local user space? (E: f118f75e5852fc22bba3a6495beec723)`);
-            }
-            const resLatestAddrs = await getLatestAddrs({ addrs: newChildrenAddrs, space, });
-            const latestAddrs = Object.values(resLatestAddrs?.data?.latestAddrsMap ?? {});
-            if (!resLatestAddrs?.data?.success || latestAddrs.length !== newChildrenAddrs.length) {
-                throw new Error(`could not get latest addrs. (E: 2e1619e7e2e166696fe8ff78cb02cc22)`);
-            }
-            // get the addrs' corresponding ibgibs
-            if (latestAddrs.some(x => x === null)) {
-                // some of the addrs were not found in the space
-                throw new Error(`some addrs were not found in the space. (E: 2216d8e5ad7fb600ceb025ed7c90f323)`);
-            }
-            const resGet = await this.ibgibsSvc.get({ addrs: latestAddrs });
-            if (!resGet.success || resGet.ibGibs?.length !== newChildrenAddrs.length) {
-                throw new Error(`failed to get newChildren with addrs: ${newChildrenAddrs.join('|')}. Error: ${resGet.errorMsg ?? 'unknown error 5737bd0996d5445b8bd80975bedc0d57'} (E: 05722e11350ec6ffffdb5c7d0caa2922)`);
-            }
-            return resGet.ibGibs;
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-        finally {
-            if (logalot) {
-                console.log(`${lc} complete.`);
-            }
-        }
-    }
-    async handleNewContextChild({ newChild }) {
-        const lc = `${this.lc}[${this.handleNewContextChild.name}]`;
-        try {
-            throw new Error(`not implemented in base class (E: 833038a17d04e38b9b97be19ed010922)`);
-        }
-        catch (error) {
-            console.error(`${lc} ${error.message}`);
-            throw error;
-        }
-    }
     async getRobbotInteractionData({ type, commentText, subjectTjpGibs, details, expectingResponse, uuid, timestamp, }) {
         const lc = `${this.lc}[${this.getRobbotInteractionData.name}]`;
         try {