@ibgib/core-gib 0.0.8 → 0.0.11

package/src/witness/robbot/robbot-base-v1.mts

@@ -20,6 +20,8 @@ import {
     DEFAULT_ROBBOT_LEX_DATA,
     DEFAULT_HUMAN_LEX_DATA,
     SemanticHandlerResult,
+    ROBBOT_INTERACTION_ATOM,
+    ROBBOT_ATOM,
 } from './robbot-types.mjs';
 import { WitnessBase_V1, } from '../witness-base-v1.mjs';
 import { CommentIbGib_V1 } from '../../common/comment/comment-types.mjs';
@@ -35,9 +37,17 @@ import { createCommentIbGib, parseCommentIb } from '../../common/comment/comment
 import { getFromSpace, getLatestAddrs } from '../space/space-helper.mjs';
 import { getTjpAddr } from '../../common/other/ibgib-helper.mjs';
 import { IbGibTimelineUpdateInfo } from '../../common/other/other-types.mjs';
+import { WitnessWithContextBase_V1 } from '../witness-with-context/witness-with-context-base-v1.mjs';
+import { WitnessArgIbGib } from '../witness-types.mjs';
 
 const logalot = GLOBAL_LOG_A_LOT || true;
 
+export interface RobbotBaseParseMetadataResult {
+    robbotClassnameIsh?: string;
+    robbotNameIsh?: string;
+    robbotIdIsh?: string;
+}
+
 /**
  * ## distinguishing characteristics of robbots
  *
@@ -98,7 +108,7 @@ export abstract class RobbotBase_V1<
     TData extends RobbotData_V1 = RobbotData_V1,
     TRel8ns extends RobbotRel8ns_V1 = RobbotRel8ns_V1,
 >
-    extends WitnessBase_V1<
+    extends WitnessWithContextBase_V1<
         TOptionsData, TOptionsRel8ns, TOptionsIbGib,
         TResultData, TResultRel8ns, TResultIbGib,
         TData, TRel8ns>
@@ -111,34 +121,27 @@ export abstract class RobbotBase_V1<
      */
     protected lc: string = `[${RobbotBase_V1.name}]`;
 
-    /**
-     * Reference to the local ibgibs service, which is one way at getting at the
-     * local user space.
-     */
-    public ibgibsSvc: IbGibLocalSpaceService_AllPowerful | undefined;
-
     /**
      * 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.
      */
     protected _cacheIbGibs: { [addr: string]: IbGib_V1 } = {};
 
+    protected _semanticHandlers: { [semanticId: string]: SemanticHandler[] } = {};
 
-    protected _contextChangesSubscription: Subscription | undefined;
-    protected _currentWorkingContextIbGib: IbGib_V1 | undefined;
     /**
-     * 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.
+     * lex that the robbot uses to speak.
      */
-    protected _currentWorkingContextIbGib_PriorChildrenAddrs: IbGibAddr[] = [];
-
-    protected _updatingContext: boolean = false;
+    protected _robbotLex: Lex<TLexPropsData> | undefined;
+    /**
+     * lex that the robbot uses to interpret humans.
+     */
+    protected _userLex: Lex<TLexPropsData> | undefined;
 
-    protected _semanticHandlers: { [semanticId: string]: SemanticHandler[] } = {};
+    constructor(initialData?: TData, initialRel8ns?: TRel8ns) {
+        super(initialData, initialRel8ns);
+        this.initialized = this.initialize();
+    }
 
     protected async handleSemanticDefault(info: SemanticInfo): Promise<SemanticHandlerResult> {
         const lc = `${this.lc}[${this.handleSemanticDefault.name}]`;
@@ -166,42 +169,6 @@ export abstract class RobbotBase_V1<
         }
     }
 
-    /**
-     * lex that the robbot uses to speak.
-     */
-    protected _robbotLex: Lex<TLexPropsData> | undefined;
-    /**
-     * lex that the robbot uses to interpret humans.
-     */
-    protected _userLex: Lex<TLexPropsData> | undefined;
-
-    /**
-     * This should be awaited before dealing with the robbot.
-     *
-     * I'm keeping this named `ready` as a shout out to
-     * https://stackoverflow.com/a/45070748/3897838
-     * (https://stackoverflow.com/questions/35743426/async-constructor-functions-in-typescript).
-     *
-     * ## comments
-     *
-     * I've been considering going forward whether or not to have robbots'
-     * properties all be observables to allow for subscribing to events or
-     * similar in the future. But this may fight against the single `witness`
-     * point of contact, which of course itself is somewhat experimental. One
-     * grand experiment.
-     *
-     * I do have an observable as a property for the aws sync space saga
-     * updates.  This kind of observable can be passed around while still using
-     * the single `witness` access point, but of course these runtime aspects
-     * won't be memoized if storing the ibgib.
-     */
-    public initialized: Promise<void>;
-
-    constructor(initialData?: TData, initialRel8ns?: TRel8ns) {
-        super(initialData, initialRel8ns);
-        this.initialized = this.initialize();
-    }
-
     // #region initialize
 
     /**
@@ -211,6 +178,7 @@ export abstract class RobbotBase_V1<
         const lc = `${this.lc}[${this.initialize.name}]`;
         try {
             if (logalot) { console.log(`${lc} starting... (I: f0e65ab0f80046a59668ddfbf9f47a4a5)`); }
+            await super.initialize();
 
             await this.initialize_semanticHandlers();
             await this.initialize_lex();
@@ -287,35 +255,6 @@ export abstract class RobbotBase_V1<
 
     // #endregion initialize
 
-    protected async loadNewerSelfIfAvailable(): Promise<void> {
-        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] as IbGib_V1<TData, TRel8ns>);
-                    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
@@ -331,7 +270,10 @@ export abstract class RobbotBase_V1<
 
             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}`);
             throw error;
@@ -483,7 +425,10 @@ export abstract class RobbotBase_V1<
             if (!arg) { throw new Error(`arg required (E: 9cddabc6dc96ddb37846807feb093423)`); }
 
             if (arg.ibGibs?.length ?? 0 > 0) {
-                await this.initializeContext({ arg });
+                await this.initializeContext({
+                    arg: arg as WitnessArgIbGib<IbGib_V1, TData, TRel8ns>,
+                    rel8nName: ROBBOT_CONTEXT_REL8N_NAME,
+                });
             }
 
             const result = await this.resulty({
@@ -510,7 +455,9 @@ export abstract class RobbotBase_V1<
             if (logalot) { console.log(`${lc} starting... (I: d453593a295d4cdbae2acb71d9f6de35)`); }
             await this.initialized;
 
-            await this.finalizeContext({ arg });
+            await this.finalizeContext({
+                arg: arg as WitnessArgIbGib<IbGib_V1, TData, TRel8ns>,
+            });
 
             const result = await this.resulty({
                 resultData: {
@@ -595,148 +542,6 @@ export abstract class RobbotBase_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.
-     */
-    protected async rel8To({
-        ibGibs,
-        rel8nName,
-        linked,
-        ibgibsSvc,
-        // space,
-    }: {
-        /**
-         * The ibgib to which we are relating.
-         */
-        ibGibs: IbGib_V1[],
-        /**
-         * If given, will use this as the rel8n name when performing the `rel8`
-         * transform.
-         *
-         * If not given, will use the `robbot.data`'s {@link RobbotData_V1.defaultRel8nName} value.
-         */
-        rel8nName?: string,
-        /**
-         * If true, will include the `rel8nName` as a linked rel8n in the `rel8`
-         * transform.
-         */
-        linked?: boolean,
-        /**
-         * If provided, will register the newly created ibgib.
-         */
-        ibgibsSvc?: IbGibLocalSpaceService_AllPowerful,
-        // /**
-        //  * If given (which atow is most likely the case), then the {@link TransformResult} will
-        //  * be persisted in this `space`.
-        //  */
-        // space?: IbGibSpaceAny,
-    }): Promise<void> {
-        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 as any as IbGib_V1<TData, TRel8ns>;
-            const newRobbotValidationErrors =
-                await validateIbGibIntrinsically({ ibGib: newRobbotIbGib as any });
-            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.
      *
@@ -823,131 +628,11 @@ export abstract class RobbotBase_V1<
         return result;
     }
 
-    protected async rel8ToContextIbGib({
-        ibGibToRel8,
-        ibGibAddrToRel8,
-        contextIbGib,
-        rel8nNames,
-        // space,
-    }: {
-        ibGibToRel8?: IbGib_V1,
-        ibGibAddrToRel8?: IbGibAddr,
-        contextIbGib: IbGib_V1,
-        rel8nNames: string[],
-        // space?: IbGibSpaceAny,
-    }): Promise<void> {
-        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: IbGibRel8ns_V1 = {};
-            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;
-        }
-    }
-
-    protected async createCommentAndRel8ToContextIbGib({
-        text,
-        contextIbGib,
-    }: {
-        text: string,
-        contextIbGib: IbGib_V1,
-        ibgibsSvc?: IbGibLocalSpaceService_AllPowerful,
-    }): Promise<void> {
-        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 as CommentIbGib_V1;
-            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.`); }
-        }
+    protected getThisAtom(): string {
+        return ROBBOT_ATOM; // "robbot" atow
     }
 
-    /**
-     * 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
-     */
-    protected getAddlMetadata(): string {
-        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.`); }
-        }
-    }
-
-    protected parseAddlMetadataString({ ib }: { ib: Ib }): {
-        robbotClassnameIsh?: string;
-        robbotNameIsh?: string;
-        robbotIdIsh?: string;
-    } {
+    protected parseAddlMetadataString<RobbotBaseParseMetadataResult>({ ib }: { ib: Ib }): RobbotBaseParseMetadataResult {
         const lc = `${this.lc}[${this.parseAddlMetadataString.name}]`;
         try {
             if (logalot) { console.log(`${lc} starting... (I: d0cf162bc5f4cbf65bf1f7e29e3bd922)`); }
@@ -955,9 +640,9 @@ export abstract class RobbotBase_V1<
 
             if (safeIbCommentMetadataText) {
                 const [_, robbotClassnameIsh, robbotNameIsh, robbotIdIsh] = safeIbCommentMetadataText.split('__');
-                return { robbotClassnameIsh, robbotNameIsh, robbotIdIsh };
+                return { robbotClassnameIsh, robbotNameIsh, robbotIdIsh } as RobbotBaseParseMetadataResult;
             } else {
-                return { robbotClassnameIsh: undefined, robbotNameIsh: undefined, robbotIdIsh: undefined };
+                return { robbotClassnameIsh: undefined, robbotNameIsh: undefined, robbotIdIsh: undefined } as RobbotBaseParseMetadataResult;
             }
         } catch (error) {
             console.error(`${lc} ${error.message}`);
@@ -1103,342 +788,6 @@ export abstract class RobbotBase_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.
-     */
-    protected async getContextIbGibFromArgOrAddr({
-        arg,
-        addr,
-        latest,
-    }: {
-        arg?: RobbotCmdIbGib<IbGib_V1, RobbotCmdData, RobbotCmdRel8ns>,
-        addr?: IbGibAddr,
-        /**
-         * if true, after extracting the context from the arg, will get the
-         * latest ibgib (if there is a newer version).
-         */
-        latest?: boolean,
-    }): Promise<IbGib_V1> {
-        const lc = `${this.lc}[${this.getContextIbGibFromArgOrAddr.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} starting... (I: c13f7cb92133984048f606075efb8a22)`); }
-            let contextIbGib: IbGib_V1;
-            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.
-     */
-    protected async initializeContext({
-        arg,
-    }: {
-        arg: RobbotCmdIbGib<IbGib_V1, RobbotCmdData, RobbotCmdRel8ns>,
-    }): Promise<void> {
-        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: any) => {
-                    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.`); }
-        }
-    }
-
-    protected async finalizeContext({
-        arg,
-    }: {
-        arg: RobbotCmdIbGib<IbGib_V1, RobbotCmdData, RobbotCmdRel8ns>,
-    }): Promise<void> {
-        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.
-     */
-    private async handleContextUpdate({ update }: { update: IbGibTimelineUpdateInfo }): Promise<void> {
-        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: IbGib_V1;
-            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 }: { newContext: IbGib_V1 }): Promise<IbGib_V1[]> {
-        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 as IbGibAddr[] });
-            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.`); }
-        }
-    }
-
-    protected async handleNewContextChild({ newChild }: { newChild: IbGib_V1 }): Promise<void> {
-        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;
-        }
-    }
-
     protected async getRobbotInteractionData({
         type,
         commentText,