@ibgib/web-gib 0.0.1

package/dist/api/commands/text/text-edit.mjs

@@ -0,0 +1,170 @@
+/**
+ * @module text-edit.mts Provides the API Function Info to edit an ibgib's `data.text`. This is commonly found on a CommentIbGib_V1.
+ *
+ * ## notes
+ *
+ * ### ordering imports
+ *
+ * import sections always go:
+ * 1. non-ibgib deps first
+ * 2. @ibgib/helper-gib, @ibgib/encrypt-gib, @ibgib/ts-gib, @ibgib/core-gib packages (in that order)
+ * 3. import GLOBAL_LOG_A_LOT then remaining project imports
+ * 4. code proper starts with the definition of `const logalot` (if applicable)
+ *
+ * Each section is separated by a blank line.
+ */
+import { extractErrorMsg, getTimestamp, getTimestampInTicks, pretty } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { getCommentIb } from '@ibgib/core-gib/dist/common/comment/comment-helper.mjs';
+import { mut8Timeline } from '@ibgib/core-gib/dist/timeline/timeline-api.mjs';
+import { GLOBAL_LOG_A_LOT } from '../../../constants.mjs';
+import { COMMAND_BASE_SCHEMA_PROPERTIES } from "../command-constants.mjs";
+import { getCommandService } from "../command-service-v1.mjs";
+import { getGlobalMetaspace_waitIfNeeded } from '../../../helpers.web.mjs';
+import { FUNCTION_CALL_EXAMPLES_HEADER } from '../../api-constants.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+// #region constants
+/**
+ * camelCased name of the command itself.
+ */
+const FUNCTION_NAME = 'editText';
+/**
+ * agent is the broad command which basically acts like a category of commands at this point.
+ */
+const CMD_CATEGORY = 'ibgib';
+/**
+ *
+ */
+const CMD_MODIFIERS = [FUNCTION_NAME];
+const EXAMPLE_INPUT_EDIT_TEXT = {
+    ibGibAddr: 'comment HelloThereImBob 1748386170000^A2D75E05B14E264619D2ACCCCABF234128E183B4524CC26029E54B84BF7BFD73.61985691826359867236266716461787826378AFFF23984723987FDA2013C8CB',
+    newText: `This is the newly edited text`,
+    notesToSelf: `Example of an ibgib's data.text property.`,
+    repromptWithResult: false,
+};
+const EXAMPLES = [
+    FUNCTION_CALL_EXAMPLES_HEADER,
+    pretty(EXAMPLE_INPUT_EDIT_TEXT),
+].join('\n');
+const FUNCTION_DESCRIPTION = [
+    `Edits an ibGib's data.text property and performs additional business logic on other fields within the ibGib record, like timestamps, updating the ib, etc.`,
+    ``,
+    EXAMPLES,
+].join('\n');
+const FUNCTION_SCHEMA = {
+    name: FUNCTION_NAME,
+    description: FUNCTION_DESCRIPTION,
+    parameters: {
+        type: 'object',
+        properties: {
+            ...COMMAND_BASE_SCHEMA_PROPERTIES,
+            spaceId: {
+                type: 'string',
+                description: `The id of the local user space. If not provided, will use the default local space. Only provide this if you don't want to use the default space. Agents should either leave this unset, or if they are trying to mut8 an ibGib that is inside *their* subspace, then they should provide this. Otherwise, it will look in the default space which will be incorrect. In the future, agents will have a different API for interacting with their subspaces, but for now this may be used (if the agent even has access to their subspace id. it's so early in dev, I'm not sure if this is true.)`,
+            },
+            ibGibAddr: {
+                type: 'string',
+                description: 'The content address of the ibGib to edit.',
+            },
+            newText: {
+                type: 'string',
+                description: 'The new text to set for the ibGib\'s data.text property.',
+            },
+        },
+        required: [
+            'ibGibAddr',
+        ],
+    },
+};
+/**
+ * Wrapper function to enqueue the mut8IbGib command.
+ * @param {EditIbGibTextOpts} opts - @see {@link EditIbGibTextOpts}
+ * @returns {Promise<void>} A promise that resolves when the command finishes execution.
+ */
+function viaCmd(opts) {
+    const commandService = getCommandService();
+    const command = {
+        ...opts,
+        cmd: CMD_CATEGORY,
+        cmdModifiers: CMD_MODIFIERS,
+    };
+    return new Promise((resolve, reject) => {
+        commandService.enqueueCommand({ command, resolve, reject });
+    });
+}
+/**
+ * Implementation function for the mut8IbGib command.
+ *
+ * @param {EditIbGibTextOpts} opts - @see {@link EditIbGibTextOpts}
+ * @returns {Promise<IbGib_V1>} the new timeline ibgib
+ */
+async function fnImpl(opts) {
+    const lc = `[${fnImpl.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: genuuid)`);
+        }
+        console.log(`${lc} ${CMD_CATEGORY} ${CMD_MODIFIERS} opts: ${pretty(opts)}`);
+        let { spaceId, ibGibAddr, newText, } = opts;
+        const metaspace = await getGlobalMetaspace_waitIfNeeded();
+        if (!metaspace) {
+            throw new Error(`${lc} metaspace falsy (E: 1a3f5e6c8d9a7b01f2e3d4c5b6a708d9)`);
+        }
+        const space = await metaspace.getLocalUserSpace({ localSpaceId: spaceId });
+        if (!space) {
+            if (!spaceId) {
+                throw new Error(`(UNEXPECTED) couldn't get default local user space? (E: 593028fc4038c1cb713a8b1d757da825)`);
+            }
+            else {
+                throw new Error(`could not get local user space for spaceId (${spaceId}) (E: 61fc28fbdf3fd69ae7c9214fe74c2825)`);
+            }
+        }
+        newText ??= '';
+        if (!ibGibAddr) {
+            throw new Error(`${lc} ibGibAddr is required. (E: genuuid)`);
+        }
+        const newIb = getCommentIb({ commentText: newText, addlMetadataText: getTimestampInTicks() });
+        // 3. Perform the mut8 transform
+        if (logalot) {
+            console.log(`${lc} Mutating timeline ibGib... (I: genuuid)`);
+        }
+        const newTimelineIbGib = await mut8Timeline({
+            timelineAddr: ibGibAddr,
+            mut8Opts: {
+                dataToAddOrPatch: {
+                    text: newText,
+                    textTimestamp: getTimestamp(),
+                },
+                mut8Ib: newIb,
+            },
+            metaspace,
+            space,
+        });
+        if (!newTimelineIbGib) {
+            throw new Error(`${lc} Mutate timeline transform failed: No new timeline ibGib returned. (E: genuuid)`);
+        }
+        console.log(`${lc} Mutated timeline ibGib processed.`);
+        return newTimelineIbGib;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error; // Re-throw the error to be caught by the command service
+    }
+    finally {
+        // This finally block will execute regardless of whether the try block succeeds or fails.
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * API function info for the mut8IbGib command.
+ */
+export const editTextFunctionInfo = {
+    nameOrId: FUNCTION_NAME,
+    fnViaCmd: viaCmd,
+    functionImpl: fnImpl,
+    cmd: CMD_CATEGORY,
+    cmdModifiers: CMD_MODIFIERS,
+    schema: FUNCTION_SCHEMA,
+};
+//# sourceMappingURL=text-edit.mjs.map

package/dist/api/commands/text/text-edit.mjs.map

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

package/dist/api/commands/text/text-index.d.mts

@@ -0,0 +1,3 @@
+import { APIFunctionInfo } from "../../api-types.mjs";
+export declare const TextAPIFunctionInfos: APIFunctionInfo<any>[];
+//# sourceMappingURL=text-index.d.mts.map

package/dist/api/commands/text/text-index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-index.d.mts","sourceRoot":"","sources":["../../../../src/api/commands/text/text-index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,eAAO,MAAM,oBAAoB,EAAE,eAAe,CAAC,GAAG,CAAC,EAEtD,CAAC"}

package/dist/api/commands/text/text-index.mjs

@@ -0,0 +1,5 @@
+import { editTextFunctionInfo } from "./text-edit.mjs";
+export const TextAPIFunctionInfos = [
+    editTextFunctionInfo,
+];
+//# sourceMappingURL=text-index.mjs.map

package/dist/api/commands/text/text-index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-index.mjs","sourceRoot":"","sources":["../../../../src/api/commands/text/text-index.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IACxD,oBAAoB;CACvB,CAAC"}

package/dist/api/commands/ui/ui-index.d.mts

@@ -0,0 +1,3 @@
+import { APIFunctionInfo } from "../../api-types.mjs";
+export declare const UIAgentFunctionInfos: APIFunctionInfo<any>[];
+//# sourceMappingURL=ui-index.d.mts.map

package/dist/api/commands/ui/ui-index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-index.d.mts","sourceRoot":"","sources":["../../../../src/api/commands/ui/ui-index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,eAAO,MAAM,oBAAoB,EAAE,eAAe,CAAC,GAAG,CAAC,EAEtD,CAAC"}

package/dist/api/commands/ui/ui-index.mjs

@@ -0,0 +1,5 @@
+import { updateCSSVariablesFunctionInfo } from './update-css-variables.mjs';
+export const UIAgentFunctionInfos = [
+    updateCSSVariablesFunctionInfo,
+];
+//# sourceMappingURL=ui-index.mjs.map

package/dist/api/commands/ui/ui-index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-index.mjs","sourceRoot":"","sources":["../../../../src/api/commands/ui/ui-index.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAE5E,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IACxD,8BAA8B;CACjC,CAAC"}

package/dist/api/commands/ui/update-css-variables.d.mts

@@ -0,0 +1,48 @@
+import { APIFunctionInfo } from "../../api-types.mjs";
+import { CommandDataBase } from "../command-types.mjs";
+/**
+ * 'ui' is the broad command which basically acts like a category of commands at this point.
+ */
+declare const CMD_CATEGORY = "ui";
+/**
+ * This should be camelCased actual name of the function.
+ */
+declare const CMD_MODIFIERS: string[];
+/**
+ * @interface UpdateCSSVariablesOpts - Options for the updateCSSVariables command.
+ * @extends CommandDataBase
+ */
+export interface UpdateCSSVariablesOpts extends CommandDataBase<typeof CMD_CATEGORY, typeof CMD_MODIFIERS> {
+    /**
+     * @property cssVariables - An object where keys are CSS variable names
+     * (e.g., '--text-color-base') and values are their new values (e.g., 'blue').
+     */
+    cssVariables: {
+        [key: string]: string;
+    };
+}
+/**
+ * @interface UpdateCSSVariablesCommandData - Command data for the updateCSSVariables command.
+ * @extends CommandDataBase
+ *
+ */
+export interface UpdateCSSVariablesCommandData extends CommandDataBase<typeof CMD_CATEGORY, typeof CMD_MODIFIERS> {
+    /**
+     * @see {@link UpdateCSSVariablesOpts.cssVariables}
+     */
+    cssVariables: {
+        [key: string]: string;
+    };
+}
+/**
+ * Wrapper function to enqueue the updateCSSVariables command.
+ * @param {UpdateCSSVariablesOpts} opts - Options for updating CSS variables.
+ * @returns {Promise<void>} A promise that resolves when the command is enqueued.
+ */
+declare function updateCSSVariablesViaCmd(opts: UpdateCSSVariablesOpts): Promise<void>;
+/**
+ * API function info for the updateCSSVariables command.
+ */
+export declare const updateCSSVariablesFunctionInfo: APIFunctionInfo<typeof updateCSSVariablesViaCmd>;
+export {};
+//# sourceMappingURL=update-css-variables.d.mts.map

package/dist/api/commands/ui/update-css-variables.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-css-variables.d.mts","sourceRoot":"","sources":["../../../../src/api/commands/ui/update-css-variables.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAgBvD;;GAEG;AACH,QAAA,MAAM,YAAY,OAAO,CAAC;AAE1B;;GAEG;AACH,QAAA,MAAM,aAAa,EAAE,MAAM,EAAoB,CAAC;AAiChD;;;GAGG;AACH,MAAM,WAAW,sBACb,SAAQ,eAAe,CAAC,OAAO,YAAY,EAAE,OAAO,aAAa,CAAC;IAClE;;;OAGG;IACH,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC3C;AAGD;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,eAAe,CAAC,OAAO,YAAY,EAAE,OAAO,aAAa,CAAC;IAC7G;;OAEG;IACH,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,iBAAS,wBAAwB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E;AA8CD;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,eAAe,CAAC,OAAO,wBAAwB,CA8B3F,CAAC"}

package/dist/api/commands/ui/update-css-variables.mjs

@@ -0,0 +1,145 @@
+import { extractErrorMsg, pretty } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../../constants.mjs";
+import { COMMAND_BASE_SCHEMA_PROPERTIES } from "../command-constants.mjs";
+import { getCommandService } from "../command-service-v1.mjs";
+import { FUNCTION_CALL_EXAMPLES_HEADER } from "../../api-constants.mjs";
+import { UI_THEME_INFO_KEY, VALID_CSS_VARIABLES } from "../../../ui/ui-constants.mjs";
+import { storagePut } from "../../../storage/storage-helpers.web.mjs";
+import { getExistingUIInfo } from "../../../ui/ui-helpers.mjs";
+import { getGlobalDbName, getGlobalStoreName } from "../../../helpers.web.mjs";
+const logalot = GLOBAL_LOG_A_LOT;
+// #region constants
+/**
+ * camelCased name of the command itself.
+ */
+const FUNCTION_NAME = 'updateCSSVariables';
+/**
+ * 'ui' is the broad command which basically acts like a category of commands at this point.
+ */
+const CMD_CATEGORY = 'ui';
+/**
+ * This should be camelCased actual name of the function.
+ */
+const CMD_MODIFIERS = [FUNCTION_NAME];
+const EXAMPLE_INPUT_UPDATECSS = {
+    cssVariables: {
+        '--button-background-color-base': '#4CAF50',
+        '--button-text-color-base': 'white',
+        '--button-border-color-base': '#4CAF50',
+        '--button-border-width-base': '1px',
+        '--button-border-style-base': 'solid',
+        '--button-border-radius-base': '4px',
+        '--button-padding-base': '10px 20px',
+        '--button-hover-background-color': '#45a049',
+        '--button-hover-text-color': 'white',
+        '--button-hover-border-color': '#45a049',
+    },
+    notesToSelf: 'Example of an updateCSSVariables function call that is updating a theme section that corresponds to the buttons. I still will do the other sections.',
+    repromptWithResult: true,
+};
+const EXAMPLES = [
+    FUNCTION_CALL_EXAMPLES_HEADER,
+    pretty(EXAMPLE_INPUT_UPDATECSS),
+].join('\n');
+const FUNCTION_DESCRIPTION = [
+    `Use this to update global CSS variables, effectively changing the visual theme of the application. Provide an object where keys are CSS variable names (e.g., '--text-color-base') and values are their new values (e.g., 'blue'). REMEMBER! When you are asked to change an entire theme, BE SURE TO CHANGE ALL PARTS TO MATCH THE THEME! BUT...apply the changes to related sections of variables together (e.g., all tab-related variables, all button-related variables, etc.) instead of individual properties, otherwise you'll hit the reprompt limit if you try to do each one by itself. To help do this, _first_ categorize ALL the properties into smaller sections, and then tell the user your plan for each section: primary bases (fonts, main text, main background), buttons, tabs, scrollbars, fonts, and any others I might have forgotten. THEN do each group with a single function call but be sure to prompt yourself until you have gone through all of them.`,
+    '',
+    EXAMPLES,
+].join('\n');
+/**
+ * Wrapper function to enqueue the updateCSSVariables command.
+ * @param {UpdateCSSVariablesOpts} opts - Options for updating CSS variables.
+ * @returns {Promise<void>} A promise that resolves when the command is enqueued.
+ */
+function updateCSSVariablesViaCmd(opts) {
+    const commandService = getCommandService();
+    const command = {
+        ...opts,
+        cmd: CMD_CATEGORY,
+        cmdModifiers: [FUNCTION_NAME],
+        // cssVariables: opts.cssVariables,
+        // repromptWithResult: opts?.repromptWithResult,
+        // notesToSelf: opts?.notesToSelf,
+    };
+    return new Promise((resolve, reject) => {
+        commandService.enqueueCommand({ command, resolve, reject });
+    });
+}
+/**
+ * Implementation function for the updateCSSVariables command (atow, does nothing other than resolve).
+ * @param {UpdateCSSVariablesOpts} opts - Options for updating CSS variables.
+ * @returns {Promise<void>} A promise that resolves when the command is executed (immediately).
+ */
+async function updateCSSVariablesImpl(opts) {
+    const lc = `[${updateCSSVariablesImpl.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: badce195ed1817dd686c7098511e1f25)`);
+        }
+        // In the actual implementation, this function would update the CSS variables.
+        console.log(`${lc} Updating CSS variables: ${JSON.stringify(opts.cssVariables)}`);
+        // Actual implementation to be added here:
+        for (const [variableName, value] of Object.entries(opts.cssVariables)) {
+            document.documentElement.style.setProperty(variableName, value);
+        }
+        // update the theme in the options
+        const dbName = getGlobalDbName();
+        const storeName = await getGlobalStoreName();
+        const existingUIInfo = await getExistingUIInfo({ dbName, storeName }) ?? { cssVariableOverrides: {}, };
+        const newUIInfo = {
+            ...existingUIInfo,
+            cssVariableOverrides: {
+                ...existingUIInfo.cssVariableOverrides,
+                ...opts.cssVariables,
+            },
+        };
+        await storagePut({
+            dbName,
+            storeName: await getGlobalStoreName(),
+            key: UI_THEME_INFO_KEY,
+            value: JSON.stringify(newUIInfo),
+        });
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+/**
+ * API function info for the updateCSSVariables command.
+ */
+export const updateCSSVariablesFunctionInfo = {
+    nameOrId: FUNCTION_NAME,
+    fnViaCmd: updateCSSVariablesViaCmd,
+    functionImpl: updateCSSVariablesImpl,
+    cmd: CMD_CATEGORY,
+    cmdModifiers: CMD_MODIFIERS,
+    schema: {
+        name: FUNCTION_NAME,
+        description: FUNCTION_DESCRIPTION,
+        parameters: {
+            type: 'object',
+            properties: {
+                ...COMMAND_BASE_SCHEMA_PROPERTIES,
+                cssVariables: {
+                    type: 'object',
+                    description: 'CSS variables to update when theming or otherwise changing these visual aspects of the web app per user preferences or the user directly asking for it. (atow there are no preferences saved or anything, so this is just user-driven if they ask for it.)',
+                    properties: Object.fromEntries(VALID_CSS_VARIABLES.map(varName => [
+                        varName,
+                        {
+                            type: 'string',
+                            description: `configurable css variable`,
+                        },
+                    ])),
+                }
+            },
+            required: ['cssVariables'],
+        },
+    },
+};
+//# sourceMappingURL=update-css-variables.mjs.map

package/dist/api/commands/ui/update-css-variables.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-css-variables.mjs","sourceRoot":"","sources":["../../../../src/api/commands/ui/update-css-variables.mts"],"names":[],"mappings":"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"}

package/dist/api/function-infos.web.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @module function-infos.web.mts
+ *
+ * Web app-specific function infos, as opposed to extension or other function
+ * infos.
+ *
+ * funky structure because AllFunctionInfos started as just a global constant,
+ * but when broke out extension, we needed to separate web extension function
+ * infos from web app function infos.
+ */
+/**
+ * This should be called early on when initializing the web app.
+ */
+export declare function registerDeprecatedFunctionNamesAndFunctionInfos_Web(): void;
+//# sourceMappingURL=function-infos.web.d.mts.map

package/dist/api/function-infos.web.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-infos.web.d.mts","sourceRoot":"","sources":["../../src/api/function-infos.web.mts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqCH;;GAEG;AACH,wBAAgB,mDAAmD,IAAI,IAAI,CAgB1E"}

package/dist/api/function-infos.web.mjs

@@ -0,0 +1,63 @@
+/**
+ * @module function-infos.web.mts
+ *
+ * Web app-specific function infos, as opposed to extension or other function
+ * infos.
+ *
+ * funky structure because AllFunctionInfos started as just a global constant,
+ * but when broke out extension, we needed to separate web extension function
+ * infos from web app function infos.
+ */
+import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { GLOBAL_LOG_A_LOT } from "../constants.mjs";
+import { UIAgentFunctionInfos } from "./commands/ui/ui-index.mjs";
+import { ProjectFunctionInfos } from "../common/project/project-constants.mjs";
+import { IbGibAPIFunctionInfos } from "./commands/ibgib/ibgib-index.mjs";
+import { ChatAPIFunctionInfos } from "./commands/chat/chat-index.mjs";
+import { TextAPIFunctionInfos } from "./commands/text/text-index.mjs";
+import { registerDeprecatedFunctionInfoName, registerFunctionInfos } from "./api-index.mjs";
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * Map of all available API functions for agents.
+ *
+ * NOTE: Any and all functions should be added to this.
+ */
+// export const AllFunctionInfos: { [nameOrId: string]: APIFunctionInfo<any> } = {
+//     ...RenderAgentFunctionInfos.reduce((acc, info) => ({ ...acc, [info.nameOrId]: info }), {}),
+// }
+const AllFunctionInfos_Web = new Map([
+    ...ChatAPIFunctionInfos,
+    ...TextAPIFunctionInfos,
+    ...ProjectFunctionInfos,
+    ...UIAgentFunctionInfos,
+    ...IbGibAPIFunctionInfos,
+].map(x => [x.nameOrId, x]));
+const DeprecatedFunctionInfoNames_Web = [
+// 'minigameBuilderAddStimuli',
+// 'minigameBuilderEditStimuli', // debug only...this is a valid function and this needs to be removed from this list. i'm just trying to cause the prune action to happen for debugging.
+];
+/**
+ * This should be called early on when initializing the web app.
+ */
+export function registerDeprecatedFunctionNamesAndFunctionInfos_Web() {
+    const lc = `[${registerDeprecatedFunctionNamesAndFunctionInfos_Web.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 31efff44c2be8ac45dac33d8824c4c25)`);
+        }
+        for (const nameOrId of DeprecatedFunctionInfoNames_Web) {
+            registerDeprecatedFunctionInfoName({ nameOrId });
+        }
+        registerFunctionInfos({ functionInfos: AllFunctionInfos_Web });
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=function-infos.web.mjs.map

package/dist/api/function-infos.web.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-infos.web.mjs","sourceRoot":"","sources":["../../src/api/function-infos.web.mts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,kCAAkC,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE5F,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC;;;;GAIG;AACH,kFAAkF;AAClF,kGAAkG;AAClG,IAAI;AAEJ,MAAM,oBAAoB,GAAsC,IAAI,GAAG,CAAC;IACpE,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,GAAG,qBAAqB;CAC3B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7B,MAAM,+BAA+B,GAAa;AAC9C,+BAA+B;AAC/B,yLAAyL;CAC5L,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mDAAmD;IAC/D,MAAM,EAAE,GAAG,IAAI,mDAAmD,CAAC,IAAI,GAAG,CAAC;IAC3E,IAAI;QACA,IAAI,OAAO,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;SAAE;QAExF,KAAK,MAAM,QAAQ,IAAI,+BAA+B,EAAE;YACpD,kCAAkC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;SACpD;QAED,qBAAqB,CAAC,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC,CAAC;KAClE;IAAC,OAAO,KAAK,EAAE;QACZ,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjD,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/assumptions.respec.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assumptions.respec.d.mts.map

package/dist/assumptions.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assumptions.respec.d.mts","sourceRoot":"","sources":["../src/assumptions.respec.mts"],"names":[],"mappings":""}

package/dist/assumptions.respec.mjs

@@ -0,0 +1,41 @@
+import { ifWe, iReckon, respecfully } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+const maam = `[${import.meta.url}]`, sir = maam;
+/**
+ * wrapper that uses crypto.subtle under the hood (i.e. doesn't hash using ts-gib)
+ *
+ * notes:
+ *
+ * * i did in fact copy this from ts-gib though, but we're testing simply that the
+ *   context (node/browser/whatever) has this since it's integral to all things ibgib.
+ */
+async function cryptoSubtleHash({ s, algorithm = 'SHA-256', }) {
+    let { subtle } = globalThis.crypto;
+    if (!s) {
+        throw new Error(`[${cryptoSubtleHash.name}] s is required`);
+    }
+    if (!algorithm) {
+        throw new Error(`[${cryptoSubtleHash.name}] algorithm is required`);
+    }
+    try {
+        const msgUint8 = new TextEncoder().encode(s);
+        const buffer = await subtle.digest(algorithm, msgUint8);
+        const asArray = Array.from(new Uint8Array(buffer));
+        return asArray.map(b => b.toString(16).padStart(2, '0')).join('');
+    }
+    catch (e) {
+        console.error(e.message ?? e);
+        throw e;
+    }
+}
+await respecfully(sir, `non-ts-gib isomorphic crypto hashing`, async () => {
+    await ifWe(sir, `should digest simple string consistently using crypto.subtle directly `, async () => {
+        let h = await cryptoSubtleHash({ s: '42' });
+        iReckon(sir, h).asTo('42').isGonnaBe('73475cb40a568e8da8a045ced110137e159f890ac4da883b6b17dc651b3a8049');
+    });
+    await ifWe(sir, `should digest simple stringified ibgib consistently using crypto.subtle directly `, async () => {
+        let ibgib = { ib: 'ib', gib: 'gib' };
+        let h = await cryptoSubtleHash({ s: JSON.stringify(ibgib) }); // doesn't use ts-gib but consistent stringifying json is important
+        iReckon(sir, h).asTo('ib^gib').isGonnaBe('cbad0694a257358c044611ea1fa88ace71a01a9b8409d2354d0387d8043f7671');
+    });
+});
+//# sourceMappingURL=assumptions.respec.mjs.map

package/dist/assumptions.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assumptions.respec.mjs","sourceRoot":"","sources":["../src/assumptions.respec.mts"],"names":[],"mappings":"AAAA,OAAO,EACsB,IAAI,EAElB,OAAO,EAAE,WAAW,EAClC,MAAM,kDAAkD,CAAC;AAC1D,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;AAGhD;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAAC,EAC5B,CAAC,EACD,SAAS,GAAG,SAAS,GAIxB;IACG,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;IACnC,IAAI,CAAC,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,iBAAiB,CAAC,CAAA;KAAE;IACvE,IAAI,CAAC,SAAS,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,yBAAyB,CAAC,CAAA;KAAE;IACvF,IAAI;QACA,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KACrE;IAAC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC;KACX;AACL,CAAC;AAED,MAAM,WAAW,CAAC,GAAG,EAAE,sCAAsC,EAAE,KAAK,IAAI,EAAE;IAEtE,MAAM,IAAI,CAAC,GAAG,EAAE,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACjG,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,kEAAkE,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,GAAG,EAAE,mFAAmF,EAAE,KAAK,IAAI,EAAE;QAC5G,IAAI,KAAK,GAAa,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,mEAAmE;QACjI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,kEAAkE,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;AAEP,CAAC,CAAC,CAAC"}

package/dist/common/project/project-constants.d.mts

@@ -0,0 +1,38 @@
+import { APIFunctionInfo } from "../../api/api-types.mjs";
+export declare const PROJECT_ATOM = "project";
+/**
+ * must match {@link PROJECT_MAX_NAME_LENGTH}
+ */
+export declare const PROJECT_NAME_REGEXP: RegExp;
+export declare const PROJECT_DESC_REGEXP: RegExp;
+/**
+ * must match {@link PROJECT_NAME_REGEXP}
+ */
+export declare const PROJECT_MAX_NAME_LENGTH = 128;
+export declare const PROJECT_SETTINGS_SCOPE = "settings_project";
+export declare const DEFAULT_PROJECT_SAFE_NAME_LENGTH = 32;
+/**
+ * change this in the future if we add more fields
+ */
+export declare const DEFAULT_PROJECT_ADDL_METADATA_LENGTH = 32;
+export declare const PROJECT_REL8N_NAME = "project";
+/**
+ * project children are ibgibs that are expected to be shown in a project tab.
+ * These are _kinda_ like contained files/folders when viewing the project as a
+ * folder.
+ */
+export declare const PROJECT_CHILD_DEFAULT_REL8N_NAME = "child";
+/**
+ * all over the place, but the idea is here that barring a few key rel8nNames
+ * (e.g. dna, ancestor, past, etc.), all other rel8nNames are considered
+ * "children".
+ */
+export declare const PROJECT_CHILD_TEXT_REL8N_NAME = "text";
+/**
+ * @constant ProjectAgentFunctionInfos - An array of all available API functions for project agents.
+ */
+export declare const ProjectFunctionInfos: APIFunctionInfo<any>[];
+export declare const ProjectChildTextFunctionInfos: APIFunctionInfo<any>[];
+export declare const AGENT_AVAILABLE_FUNCTIONS_PROJECTAGENT: APIFunctionInfo<any>[];
+export declare const AGENT_AVAILABLE_FUNCTIONS_PROJECTCHILDTEXTAGENT: APIFunctionInfo<any>[];
+//# sourceMappingURL=project-constants.d.mts.map

package/dist/common/project/project-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-constants.d.mts","sourceRoot":"","sources":["../../../src/common/project/project-constants.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAS1D,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAA8B,CAAC;AAC/D,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C;;GAEG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,eAAO,MAAM,sBAAsB,qBAAqC,CAAC;AAEzE,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD;;GAEG;AACH,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAKvD,eAAO,MAAM,kBAAkB,YAAe,CAAC;AAC/C;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,UAAU,CAAC;AACxD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,SAAS,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAAe,CAAC,GAAG,CAAC,EAEtD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,eAAe,CAAC,GAAG,CAAC,EAE/D,CAAC;AAEF,eAAO,MAAM,sCAAsC,EAAE,eAAe,CAAC,GAAG,CAAC,EAMxE,CAAC;AAEF,eAAO,MAAM,+CAA+C,EAAE,eAAe,CAAC,GAAG,CAAC,EAIjF,CAAC"}