@ibgib/web-gib 0.0.1

package/dist/common/settings/settings-helpers.mjs

@@ -0,0 +1,253 @@
+import { clone, extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { Factory_V1 } from "@ibgib/ts-gib/dist/V1/factory.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../constants.mjs";
+import { isSettingsType, DEFAULT_SETTINGS_GENERAL, SETTINGS_TYPE_VALID_VALUES, SettingsType, DEFAULT_SETTINGS_TEXTEDITOR, DEFAULT_SETTINGS_DATA_V1, SETTINGS_ATOM, DEFAULT_SETTINGS_PROJECT, DEFAULT_SETTINGS_MINIGAME, DEFAULT_SETTINGS_CHRONOLOGYS } from "./settings-constants.mjs";
+import { getIbAndGib } from "@ibgib/ts-gib/dist/helper.mjs";
+const logalot = GLOBAL_LOG_A_LOT; // change this when you want to turn off verbose logging
+export async function getSettingsScope({ ibGib }) {
+    const lc = `[${getSettingsScope.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 57ac4c0a3448bc5e98ecf5bfb02ce825)`);
+        }
+        const { ib } = getIbAndGib({ ibGib });
+        const atom = ib.split(' ').at(0);
+        if (!atom) {
+            throw new Error(`(UNEXPECTED) atom falsy? we split the ib by spaces (space-delimiter). this makes no sense. (E: 6a9ea640ae38823aeefc6ec82a05d625)`);
+        }
+        return `${SETTINGS_ATOM}_${atom}`;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export async function getSectionName({ settingsType, useCase, }) {
+    const lc = `[${getSectionName.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: f13dff111048421cad5453f821487825)`);
+        }
+        if (useCase.includes('_')) {
+            throw new Error(`(UNEXPECTED) settingsType.includes('_')? should be kebab-cased or camelCased (E: 8f75e89b9378819ab882cc1870f1e825)`);
+        }
+        if (settingsType.includes('_')) {
+            throw new Error(`(UNEXPECTED) settingsType.includes('_')? should be kebab-cased or camelCased (E: 1d316b0808287c12689d1e882648b825)`);
+        }
+        return [
+            settingsType,
+            useCase
+        ].join('_');
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export function parseSectionName({ sectionName, }) {
+    const lc = `[${parseSectionName.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: f5867c51505a3c32f20d5489f2919f25)`);
+        }
+        if (!sectionName.includes('_')) {
+            throw new Error(`invalid sectionName (${sectionName}). Should be a underscore-delimited value in form of "settingsType_useCase" (E: ec0208c6513878f028b68756a818b825)`);
+        }
+        const [settingsType, useCase] = sectionName.split('_');
+        if (!isSettingsType(settingsType)) {
+            throw new Error(`invalid settingsType (${settingsType}) found in sectionName (${sectionName}). Must be one of ${SETTINGS_TYPE_VALID_VALUES} (E: 0e1078f6aaa871154182f239a639f825)`);
+        }
+        return { settingsType, useCase, };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export async function getDefaultSettings({ settingsType, }) {
+    const lc = `[${getDefaultSettings.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: f8a03b1bb6d1ecbf52552358f9ea0825)`);
+        }
+        switch (settingsType) {
+            case SettingsType.general:
+                return clone(DEFAULT_SETTINGS_GENERAL);
+            case SettingsType.textEditor:
+                return clone(DEFAULT_SETTINGS_TEXTEDITOR);
+            case SettingsType.project:
+                return clone(DEFAULT_SETTINGS_PROJECT);
+            case SettingsType.minigame:
+                return clone(DEFAULT_SETTINGS_MINIGAME);
+            case SettingsType.chronologys:
+                return clone(DEFAULT_SETTINGS_CHRONOLOGYS);
+            default:
+                throw new Error(`(UNEXPECTED) unknown settingsType (${settingsType})? right now, we're whitelisting only. SettingsTypes: ${SETTINGS_TYPE_VALID_VALUES} (E: 801a7ade4c0849b308d5c8f8f0318d25)`);
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export async function getSettingsSection({ sectionName, settingsIbGib, }) {
+    const lc = `[${getSettingsSection.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 266554b13f6ce6daa85c882f04805825)`);
+        }
+        if (!settingsIbGib.data) {
+            throw new Error(`(UNEXPECTED) settingsIbGib.data falsy? (E: dd3708f0515fb0b4d4024f4d336a3625)`);
+        }
+        if (!settingsIbGib.data.sections) {
+            throw new Error(`(UNEXPECTED) settingsIbGib.data.sections falsy? what was the settingsIbGib even created for? (E: 31f85898a1c854e13440e278a79ceb25)`);
+        }
+        const sections = settingsIbGib.data.sections ?? {};
+        const section = sections[sectionName];
+        return section;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+export function getSettingsIb({ scope, }) {
+    const lc = `[${getSettingsIb.name}]`;
+    try {
+        if (scope.includes(' ')) {
+            console.warn(`${lc} scope includes one or more spaces. These will be converted to double underscores. (W: 75a53c623d3110b5e874e5789b414325)`);
+            scope = scope.replace(/ /g, '__');
+        }
+        return `${SETTINGS_ATOM} ${scope}`;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+export function parseSettingsIb({ ib, }) {
+    const lc = `[${parseSettingsIb.name}]`;
+    try {
+        const pieces = ib.split(' ');
+        if (pieces.length !== 2) {
+            throw new Error(`invalid settings ib (${ib}). should be in the form of "atom scope" (a single space, scope should not have spaces, atom should be ${SETTINGS_ATOM}) (E: 7b3fd82f4b68a29b9890dc164d52dc25)`);
+        }
+        const [atom, scope] = pieces;
+        if (atom !== SETTINGS_ATOM) {
+            throw new Error(`invalid atom (${atom}) found in ib (${ib}). should be ${SETTINGS_ATOM} (E: b8a5ac4b940816ff6887a64dec05bf25)`);
+        }
+        return {
+            atom,
+            scope,
+        };
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+/**
+ * creates a new settings ibgib with default values set (and atow 05/2025 also
+ * assigns "current" Settings as well).
+ *
+ * if {@link saveInSpace} is true, then will save the transform result AND
+ * register the ibgib with the metaspace's latest index. This requires also
+ * {@link metaspace} to be truthy, and throws if it is not. If {@link space} is
+ * falsy, then will use the metaspace's default local user space.
+ */
+export async function createSettings({ scope, metaspace, space, saveInSpace, }) {
+    const lc = `[${createSettings.name}]`;
+    try {
+        let ib = getSettingsIb({ scope });
+        let data = await getDefaultSettingsData();
+        let rel8ns = undefined;
+        const resSettings = await Factory_V1.firstGen({
+            parentIbGib: Factory_V1.primitive({ ib: SETTINGS_ATOM }),
+            ib, data, rel8ns,
+            dna: true,
+            nCounter: true,
+            tjp: { timestamp: true, uuid: true },
+        });
+        if (saveInSpace) {
+            if (!metaspace) {
+                throw new Error(`metaspace falsy but saveInSpace is true (E: f91adfe38d78e6e4f8bca278fce37925)`);
+            }
+            await metaspace.persistTransformResult({ resTransform: resSettings, space });
+            await metaspace.registerNewIbGib({ ibGib: resSettings.newIbGib, space });
+        }
+        return resSettings;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+}
+/**
+ * hacky function that atow (05/2025) populates default/current
+ * general/texteditor sections
+ */
+export async function getDefaultSettingsData() {
+    const lc = `[${getDefaultSettingsData.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 3d7cc3f242cc88ad28dafaf85d646a25)`);
+        }
+        const data = clone(DEFAULT_SETTINGS_DATA_V1);
+        const sectionName_generalDefault = await getSectionName({
+            settingsType: 'general',
+            useCase: 'default',
+        });
+        const sectionName_generalCurrent = await getSectionName({
+            settingsType: 'general',
+            useCase: 'current',
+        });
+        data.sections[sectionName_generalDefault] = clone(DEFAULT_SETTINGS_GENERAL);
+        data.sections[sectionName_generalCurrent] = clone(DEFAULT_SETTINGS_GENERAL);
+        const sectionName_textEditorDefault = await getSectionName({
+            settingsType: 'text-editor',
+            useCase: 'default',
+        });
+        const sectionName_textEditorCurrent = await getSectionName({
+            settingsType: 'text-editor',
+            useCase: 'current',
+        });
+        data.sections[sectionName_textEditorDefault] = clone(DEFAULT_SETTINGS_TEXTEDITOR);
+        data.sections[sectionName_textEditorCurrent] = clone(DEFAULT_SETTINGS_TEXTEDITOR);
+        return data;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=settings-helpers.mjs.map

package/dist/common/settings/settings-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-helpers.mjs","sourceRoot":"","sources":["../../../src/common/settings/settings-helpers.mts"],"names":[],"mappings":"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"}

package/dist/common/settings/settings-types.d.mts

@@ -0,0 +1,118 @@
+/**
+ * @module settings-types
+ *
+ * The idea is that some settings we want to rel8 to the ibgib itself, and some
+ * settings we will relate to the local user space (similar to the user). In the
+ * future, when we get identity going hopefully with keystones, then we may
+ * relate these to keystones.
+ *
+ * This is similar to how agents are associated with ibgibs. There is an agent
+ * special ibgib index that has a map of domainTjpAddr -> agentAddr
+ */
+import { IbGib_V1, IbGibData_V1, IbGibRel8ns_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { SETTINGS_ATOM, SETTINGS_TYPE_CHRONOLOGYS, SETTINGS_TYPE_MINIGAME, SETTINGS_TYPE_PROJECT, SETTINGS_TYPE_TEXTEDITOR, SettingsType } from "./settings-constants.mjs";
+import { LensMode } from "../project/project-types.mjs";
+export interface SettingsBase {
+    /**
+     * Discriminator for Settings info
+     */
+    type: SettingsType;
+    /**
+     * to help determine competing settings. fudge factor basically.
+     */
+    priority?: number;
+    /**
+     * ibgib has been marked as readonly.
+     */
+    readonly?: boolean;
+}
+export interface SettingsWithTabs extends SettingsBase {
+    openChildTjpAddrs: IbGibAddr[];
+    activeChildTjpAddr: IbGibAddr | undefined;
+}
+/**
+ * general settings for any ibgib. This can be
+ */
+export interface Settings_General extends SettingsBase {
+    type: 'general';
+    /**
+     * type of viewing component to use when just viewing the ibgib.
+     */
+    viewer?: string;
+    /**
+     * type of editor component to use when editing ibgib.
+     */
+    editor?: string;
+}
+/**
+ * settings specifically when interfacing with an ibgib via a text-editor
+ * component.
+ */
+export interface Settings_TextEditor extends SettingsBase {
+    type: typeof SETTINGS_TYPE_TEXTEDITOR;
+    wrap?: boolean | 'normal' | 'break-word' | 'wrap' | 'nowrap';
+}
+export interface Settings_Project extends SettingsBase, SettingsWithTabs {
+    type: typeof SETTINGS_TYPE_PROJECT;
+    lensMode: LensMode;
+}
+export interface Settings_Minigame extends SettingsBase {
+    type: typeof SETTINGS_TYPE_MINIGAME;
+}
+export interface Settings_Chronologys extends SettingsBase, SettingsWithTabs {
+    type: typeof SETTINGS_TYPE_CHRONOLOGYS;
+}
+/**
+ * union type of known Settings interfaces for various use cases.
+ *
+ * ## notes
+ *
+ * This is more a union type of shapes that this app knows, not necessarily what
+ * settings must have. IOW, there might be other shapes in settings...
+ *
+ * @see {@link SettingsBase.type}
+ */
+export type IbGibSettings = Settings_General | Settings_TextEditor | Settings_Project | Settings_Minigame | Settings_Chronologys;
+export interface SettingsData_V1 extends IbGibData_V1 {
+    /**
+     * map of a use-case key to a Settings instance.
+     *
+     * I am thinking this will be 'general_default', 'text-editor_default',
+     * 'general_current', 'text-editor_current', etc., so the key will be in the
+     * form of:
+     *   `${type}_${useCase}`
+     */
+    sections: {
+        [key: string]: IbGibSettings;
+    };
+    /**
+     * composite pattern for settings.
+     *
+     * ## intent
+     *
+     * Does the ibgib have any children, i.e., if this ibgib has child tabs,
+     * which tabs are open? Which details pages are open? What are their
+     * rel8nNames? (I don't know which things I'll keep here or what).
+     *
+     * ## NOTE
+     *
+     * This is not a composite pattern of other *settings ibgibs*, but just the
+     * settings themselves.
+     *
+     * Also, I don't know which one wins as far as an ibgib's child's settings
+     * vs. that child ibgib's registered settings with the local space.
+     */
+    children: {
+        [tjpAddr: IbGibAddr]: IbGibSettings;
+    };
+}
+export interface SettingsRel8ns_V1 extends IbGibRel8ns_V1 {
+}
+export interface SettingsIbGib_V1 extends IbGib_V1<SettingsData_V1, SettingsRel8ns_V1> {
+}
+export interface SettingsIbInfo {
+    atom: typeof SETTINGS_ATOM;
+    scope: string;
+}
+//# sourceMappingURL=settings-types.d.mts.map

package/dist/common/settings/settings-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-types.d.mts","sourceRoot":"","sources":["../../../src/common/settings/settings-types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EACH,aAAa,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,qBAAqB,EACvF,wBAAwB,EAAE,YAAY,EACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IAClD,iBAAiB,EAAE,SAAS,EAAE,CAAC;IAC/B,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACrD,IAAI,EAAE,OAAO,wBAAwB,CAAC;IACtC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;CAChE;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY,EAAE,gBAAgB;IACpE,IAAI,EAAE,OAAO,qBAAqB,CAAC;IAGnC,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACnD,IAAI,EAAE,OAAO,sBAAsB,CAAC;CACvC;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY,EAAE,gBAAgB;IACxE,IAAI,EAAE,OAAO,yBAAyB,CAAC;CAG1C;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,CAAC;AAE3B,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD;;;;;;;OAOG;IACH,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;KAAE,CAAA;IAC3C;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,EAAE;QAAE,CAAC,OAAO,EAAE,SAAS,GAAG,aAAa,CAAC;KAAE,CAAA;CACrD;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;CAAI;AAE7D,MAAM,WAAW,gBAAiB,SAAQ,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;CAAI;AAE1F,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,OAAO,aAAa,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACjB"}

package/dist/common/settings/settings-types.mjs

@@ -0,0 +1,13 @@
+/**
+ * @module settings-types
+ *
+ * The idea is that some settings we want to rel8 to the ibgib itself, and some
+ * settings we will relate to the local user space (similar to the user). In the
+ * future, when we get identity going hopefully with keystones, then we may
+ * relate these to keystones.
+ *
+ * This is similar to how agents are associated with ibgibs. There is an agent
+ * special ibgib index that has a map of domainTjpAddr -> agentAddr
+ */
+export {};
+//# sourceMappingURL=settings-types.mjs.map

package/dist/common/settings/settings-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-types.mjs","sourceRoot":"","sources":["../../../src/common/settings/settings-types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/constants.d.mts

@@ -0,0 +1,34 @@
+export declare const GLOBAL_LOG_A_LOT = false;
+export declare const GLOBAL_TIMER_NAME = "[web^gib timer]";
+/**
+ * regex for what we think of as a gemini api key.
+ */
+export declare const GEMINI_API_KEY_REGEXP: RegExp;
+export declare const CONFIG_OPTION_GEMINI_API_KEY_LOCATION_HELP = "Gemini API Key Config option (\u2699\uFE0F icon in the top right)";
+/**
+ * used for the agent tag, in ibgib.data.text
+ */
+export declare const TAG_AGENT_TEXT = "agent";
+/**
+ * used for the agent tag, in ibgib.data.icon
+ */
+export declare const TAG_AGENT_ICON = "body-outline";
+/**
+ * used for the agent tag, in ibgib.data.description
+ */
+export declare const TAG_AGENT_DESCRIPTION = "This tag tracks the active agents for the current local user space.";
+/**
+ * the ib value of the tag ibgib for the agents.
+ */
+export declare const TAG_AGENT_IB: string;
+export declare const DEFAULT_IBGIB_COLOR = "#78f87e88";
+export declare const DEFAULT_IBGIB_TRANSLUCENT = "#78f87e10";
+export declare const DEFAULT_IBGIB_COLOR_CONTRAST = "#ffffff";
+export declare const DEFAULT_TJP_COLOR = "#78f87e88";
+export declare const DEFAULT_TJP_COLOR_TRANSLUCENT = "#78f87e10";
+export declare const DEFAULT_TJP_COLOR_CONTRAST = "#ffffff";
+/**
+ * I am toying with tagging hardcoded prompts at the moment (atow 05/2025)
+ */
+export declare const HARDCODED_PROMPT_TAG_TEXT = "AUTOMATED_TEXT";
+//# sourceMappingURL=constants.d.mts.map

package/dist/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../src/constants.mts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAA4B,CAAC;AAC/D,eAAO,MAAM,0CAA0C,sEAA4D,CAAC;AAEpH;;GAEG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC;;GAEG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C;;GAEG;AACH,eAAO,MAAM,qBAAqB,wEAAwE,CAAC;AAC3G;;GAEG;AACH,eAAO,MAAM,YAAY,QAA8B,CAAC;AAExD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,4BAA4B,YAAY,CAAC;AACtD,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAC7C,eAAO,MAAM,6BAA6B,cAAc,CAAC;AACzD,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAC"}

package/dist/constants.mjs

@@ -0,0 +1,35 @@
+import { tagTextToIb } from "@ibgib/core-gib/dist/common/other/ibgib-helper.mjs";
+export const GLOBAL_LOG_A_LOT = false;
+export const GLOBAL_TIMER_NAME = '[web^gib timer]';
+/**
+ * regex for what we think of as a gemini api key.
+ */
+export const GEMINI_API_KEY_REGEXP = /^[a-zA-Z0-9\-_]{32,64}$/;
+export const CONFIG_OPTION_GEMINI_API_KEY_LOCATION_HELP = `Gemini API Key Config option (⚙️ icon in the top right)`;
+/**
+ * used for the agent tag, in ibgib.data.text
+ */
+export const TAG_AGENT_TEXT = "agent";
+/**
+ * used for the agent tag, in ibgib.data.icon
+ */
+export const TAG_AGENT_ICON = "body-outline";
+/**
+ * used for the agent tag, in ibgib.data.description
+ */
+export const TAG_AGENT_DESCRIPTION = "This tag tracks the active agents for the current local user space.";
+/**
+ * the ib value of the tag ibgib for the agents.
+ */
+export const TAG_AGENT_IB = tagTextToIb(TAG_AGENT_TEXT);
+export const DEFAULT_IBGIB_COLOR = '#78f87e88';
+export const DEFAULT_IBGIB_TRANSLUCENT = '#78f87e10';
+export const DEFAULT_IBGIB_COLOR_CONTRAST = '#ffffff';
+export const DEFAULT_TJP_COLOR = '#78f87e88';
+export const DEFAULT_TJP_COLOR_TRANSLUCENT = '#78f87e10';
+export const DEFAULT_TJP_COLOR_CONTRAST = '#ffffff';
+/**
+ * I am toying with tagging hardcoded prompts at the moment (atow 05/2025)
+ */
+export const HARDCODED_PROMPT_TAG_TEXT = 'AUTOMATED_TEXT';
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../src/constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAEjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAC/D,MAAM,CAAC,MAAM,0CAA0C,GAAG,yDAAyD,CAAC;AAEpH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAC7C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,qEAAqE,CAAC;AAC3G;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CAAC;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC"}

package/dist/foo.d.mts

@@ -0,0 +1,2 @@
+export declare function fooFn(): Promise<void>;
+//# sourceMappingURL=foo.d.mts.map

package/dist/foo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foo.d.mts","sourceRoot":"","sources":["../src/foo.mts"],"names":[],"mappings":"AAEA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3C"}

package/dist/foo.mjs

@@ -0,0 +1,19 @@
+const logalot = true;
+export async function fooFn() {
+    const lc = `[${fooFn.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: dfb1e864e0a8d029abab9418f249ed25)`);
+        }
+    }
+    catch (error) {
+        console.error(`${lc} ${error.message}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=foo.mjs.map

package/dist/foo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"foo.mjs","sourceRoot":"","sources":["../src/foo.mts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,KAAK;IACvB,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;IAC7B,IAAI;QACA,IAAI,OAAO,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;SAAE;KAC3F;IAAC,OAAO,KAAK,EAAE;QACZ,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC;KACf;YAAS;QACN,IAAI,OAAO,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;SAAE;KACnD;AACL,CAAC"}

package/dist/helpers.d.mts

@@ -0,0 +1,137 @@
+import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { MetaspaceService } from "@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs";
+import { IbGibSpaceAny } from "@ibgib/core-gib/dist/witness/space/space-base-v1.mjs";
+export declare function getTagsIbGib({ metaspace, space, }: {
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny | undefined;
+}): Promise<IbGib_V1>;
+/**
+ * NOTE: This was originally written only for agents and I'm generalizing it to
+ * any "coupled" ibgib. The idea is that for local-space-specific ibgibs that
+ * are related to domain ibgibs, but where we don't want to modify the domain
+ * ibgib directly, we create this "coupled" ibgib. We then index it in a local
+ * space special (index) ibgib and associate it by tjpAddr.
+ *
+ * Generates a consistent special name for the agent index ibGib based on the
+ * domain ibGib's primitive ancestor's ib or the ibGibAddr's ib atom.
+ *
+ * RIGHT NOW I"M PRIORITIZING THE ATOM. I THINK IT ALWAYS RETURNS THE ATOM, I.E., THE FIRST SPACE-DELIMITED PIECE OF THE `ib`.
+ *
+ * I am doing this because the project ibgib actually forks from a comment
+ * ibgib, so its primitive ancestor is "comment^gib".
+ *
+ * ## notes
+ *
+ * We are trying to get a special ibgib index that maps from ibgibs (the domain)
+ * to what local agent is registered to handle that ibgib's timeline.
+ *
+ * Concretely, we're working on the project ibgibs and we need a way to get at
+ * the agent that is assigned to that project. But we can't just mut8 the
+ * project itself because this would cause issues once the project is spread out
+ * among multiple execution contexts (similar to "remotes" in git).
+ *
+ * So we will have a special ibgib registered with the local space which will
+ * act as this index that maps ibgib -> handling agent. This function helps get
+ * the *name* of that special indexing ibgib.
+ *
+ * This can be driven either by the ibgib itself, via the last primitive ancestor
+ * ibgib's address, or via the ib's atom (the first space-delimited term in the
+ * `ib` metadata).
+ *
+ * So if an ancestor is [comment^gib, specialComment^gib, specialComment
+ * abc123^ABC123.DEF456] (where the abc123 things are representative of the full
+ * hashes 64 characters long atow since we're using sha256), then the *last*
+ * primitive address is specialComment^gib.
+ */
+export declare function getIndexNameFromIbGib({ scope, ibGib, ibGibAddr, defaultNameIfError, }: {
+    /**
+     * what kind of index are we talking in general?
+     */
+    scope: string;
+    ibGib?: IbGib_V1;
+    ibGibAddr?: IbGibAddr;
+    /**
+     * if truthy and an error is produced, then this will be returned.
+     */
+    defaultNameIfError?: string;
+}): string;
+/**
+ * NOTE: This was originally written only for agents and I'm generalizing it to
+ * any "coupled" ibgib. The idea is that for local-space-specific ibgibs that
+ * are related to domain ibgibs, but where we don't want to modify the domain
+ * ibgib directly, we create this "coupled" ibgib. We then index it in a local
+ * space special (index) ibgib and associate it by tjpAddr.
+ * Retrieves the agent ibGib associated with a domain ibGib from the special agent index ibGib.
+ *
+ * may have to change this to require the ibgib, not give an optional
+ * domainIbGibAddr
+ */
+export declare function getLocalCoupledIbGibForDomainIbGib<TIbGib extends IbGib_V1>({ scope, ibGib, metaspace, space, skipGetLatest, }: {
+    scope: string;
+    ibGib: IbGib_V1;
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+    /**
+     * if true, will not call getLatest on the coupled ibgib if found.
+     */
+    skipGetLatest?: boolean;
+}): Promise<TIbGib | undefined>;
+/**
+ * Registers a domain ibGib with its associated agent ibGib in the special agent
+ * index ibGib.  This creates or updates a mapping from the domain ibGib's TJP
+ * address to the agent's address.
+ *
+ * ## intent
+ *
+ * we want to rel8 ibgibs but not directly change the domain ibgib. Like if we
+ * have an ibgib that we want to collaborate on, we want a mechanism for the
+ * local space (later local user via keystone) to have settings, agents, etc.,
+ * for that domain ibgib. But each space has its own version, like a local/user
+ * settings vs. a workspace settings.
+ *
+ * So this gets/creates an index on the local space and associates the domain
+ * with the local.
+ *
+ * @example
+ * use this to couple a local agent to a domain ibgib or a local settings ibgib
+ * to a domain ibgib, that you do not want to share with others who will have
+ * their own versions.
+ */
+export declare function coupleDomainIbGibWithLocalIbGibViaIndex({ scope, domainIbGib, localIbGib, metaspace, space, }: {
+    scope: string;
+    domainIbGib: IbGib_V1;
+    localIbGib: IbGib_V1;
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+}): Promise<void>;
+/**
+ * Returns a function, that, as long as it continues to be invoked, will not
+ * be triggered. The function will be called after it stops being called for
+ * N milliseconds. If `immediate` is passed, trigger the function on the
+ * leading edge, instead of the trailing.
+ *
+ * @param func The function to debounce.
+ * @param wait The number of milliseconds to wait after the last call.
+ * @param immediate If true, trigger the function on the leading edge.
+ * @returns A debounced version of the function.
+ */
+export declare function debounce<T extends (...args: any[]) => void>(func: T, wait: number, immediate?: boolean): (...args: Parameters<T>) => void;
+export declare function getMaskedSecret({ secret, countToShow }: {
+    secret: string;
+    countToShow: number;
+}): string;
+export declare function insertAt<T>({ newItems, index, targetArray, }: {
+    newItems: T[];
+    index: number;
+    targetArray: T[];
+}): T[];
+export declare function deleteAt<T>({ targetArray, index, }: {
+    targetArray: T[];
+    index: number;
+}): T[];
+export declare function getShortenedStringWithEllipsis({ str, maxChars, }: {
+    str: string;
+    maxChars: number;
+}): string;
+//# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.mts","sourceRoot":"","sources":["../src/helpers.mts"],"names":[],"mappings":"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"}