@ibgib/web-gib 0.0.1

package/dist/api/commands/command-constants.mjs

@@ -0,0 +1,17 @@
+import { GEMINI_SCHEMA_AGENT_ID, GEMINI_SCHEMA_AGENTS_SELF_IDENTIFIED_NAME } from "../../witness/agent/agent-constants.mjs";
+/**
+ * common properties for available functions passed to models.
+ */
+export const COMMAND_BASE_SCHEMA_PROPERTIES = {
+    agentId: GEMINI_SCHEMA_AGENT_ID,
+    agentName: GEMINI_SCHEMA_AGENTS_SELF_IDENTIFIED_NAME,
+    repromptWithResult: {
+        type: 'boolean',
+        description: `Set this to true if you want to be reprompted with the function's result. Unless you really want a fire-and-forget style of function call, set this to true. NOTE: This is ignored with tellUser command, so you can't call tellUser and then repromptWithResult of true and then tellUser again.`,
+    },
+    notesToSelf: {
+        type: 'string',
+        description: 'Quick note scratchpad related to a requested function. For example, you could write your intent here.',
+    },
+};
+//# sourceMappingURL=command-constants.mjs.map

package/dist/api/commands/command-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-constants.mjs","sourceRoot":"","sources":["../../../src/api/commands/command-constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,yCAAyC,EAAE,MAAM,yCAAyC,CAAC;AAE5H;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC1C,OAAO,EAAE,sBAAsB;IAC/B,SAAS,EAAE,yCAAyC;IACpD,kBAAkB,EAAE;QAChB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,mSAAmS;KACnT;IACD,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uGAAuG;KACvH;CACK,CAAC"}

package/dist/api/commands/command-helpers.d.mts

@@ -0,0 +1,47 @@
+import { APIFunctionInfo } from "../api-types.mjs";
+/**
+ * customizing function to create the schema specific to some concrete schema
+ * description/instructions.
+ */
+export declare function tweakGeminiSchema({ baseSchema, addlDescription, }: {
+    /**
+     * starting schema which we will customize.
+     */
+    baseSchema: any;
+    /**
+     * additional description, to be used for concrete schema descriptions.
+     * If there is no description to begin with, this will simply set the
+     * description.
+     *
+     * For example, with destroy renderable, describe that this will recursively
+     * destroy children. With update renderable, this will apply the changes
+     * recursively to all children (like setting color).
+     */
+    addlDescription?: string;
+}): {
+    type: 'boolean';
+    description: string;
+};
+/**
+ * wraps the given {@link fn} inside of a {@link APIFunctionInfo} that can be
+ * executed on the api command service.
+ *
+ * ## intent
+ *
+ * I want to be able to execute certain functions serially similar to a barrier
+ * or critical section. This was the "easiest" way for me to do it, since each
+ * command is executed serially on the commanding service. And I didn't want to
+ * have to create APIFunctionInfo objects for things that will not be exposed to
+ * agents proper.
+ *
+ * ## NOT for agents' use
+ *
+ * because this is anon function, there is NO schema generated. So this can't be
+ * used with agents directly.
+ */
+export declare function commandifyAnonFn<TFunc extends (...args: any[]) => Promise<any> = (...args: any[]) => Promise<void>>({ fn, nameOrId, cmdCategory, }: {
+    fn: TFunc;
+    nameOrId?: string;
+    cmdCategory?: string;
+}): APIFunctionInfo<TFunc>;
+//# sourceMappingURL=command-helpers.d.mts.map

package/dist/api/commands/command-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.d.mts","sourceRoot":"","sources":["../../../src/api/commands/command-helpers.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,UAAU,EACV,eAAe,GAClB,EAAE;IACC;;OAEG;IACH,UAAU,EAAE,GAAG,CAAC;IAChB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAK3C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,EACjH,EAAE,EACF,QAAQ,EACR,WAAW,GACd,EAAE;IACC,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,eAAe,CAAC,KAAK,CAAC,CAyCzB"}

package/dist/api/commands/command-helpers.mjs

@@ -0,0 +1,76 @@
+import { clone, extractErrorMsg, pickRandom_Letters } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../constants.mjs";
+import { getCommandService } from "./command-service-v1.mjs";
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * customizing function to create the schema specific to some concrete schema
+ * description/instructions.
+ */
+export function tweakGeminiSchema({ baseSchema, addlDescription, }) {
+    if (!baseSchema) {
+        throw new Error(`(UNEXPECTED) baseSchema falsy? (E: 338a083d88ab9ae5286edc7d0c20c825)`);
+    }
+    const resSchema = clone(baseSchema);
+    resSchema.description = `${resSchema.description ?? ''}\n${addlDescription}`;
+    return resSchema;
+}
+/**
+ * wraps the given {@link fn} inside of a {@link APIFunctionInfo} that can be
+ * executed on the api command service.
+ *
+ * ## intent
+ *
+ * I want to be able to execute certain functions serially similar to a barrier
+ * or critical section. This was the "easiest" way for me to do it, since each
+ * command is executed serially on the commanding service. And I didn't want to
+ * have to create APIFunctionInfo objects for things that will not be exposed to
+ * agents proper.
+ *
+ * ## NOT for agents' use
+ *
+ * because this is anon function, there is NO schema generated. So this can't be
+ * used with agents directly.
+ */
+export function commandifyAnonFn({ fn, nameOrId, cmdCategory, }) {
+    const lc = `[${commandifyAnonFn.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: e302e6a0f13584968379c9149406f225)`);
+        }
+        const cmdName = (nameOrId ?? fn.name) + `_${pickRandom_Letters({ count: 8 })}`;
+        cmdCategory ??= 'anon';
+        const cmdModifiers = [cmdName];
+        const fnViaCmd = async (opts) => {
+            cmdCategory ??= 'anon';
+            const commandService = getCommandService();
+            const command = {
+                cmd: cmdCategory,
+                cmdModifiers,
+                ...opts,
+            };
+            return new Promise((resolve, reject) => {
+                commandService.enqueueCommand({ command, resolve, reject, anonApiFn });
+            });
+        };
+        const anonApiFn = {
+            nameOrId: cmdName,
+            cmd: cmdCategory,
+            cmdModifiers: [cmdName],
+            fnViaCmd,
+            functionImpl: fn,
+            schema: undefined,
+            isAnon: true,
+        };
+        return anonApiFn;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=command-helpers.mjs.map

package/dist/api/commands/command-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.mjs","sourceRoot":"","sources":["../../../src/api/commands/command-helpers.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAC9B,UAAU,EACV,eAAe,GAgBlB;IACG,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;KAAE;IAC7G,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,SAAS,CAAC,WAAW,GAAG,GAAG,SAAS,CAAC,WAAW,IAAI,EAAE,KAAK,eAAe,EAAE,CAAC;IAC7E,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAqF,EACjH,EAAE,EACF,QAAQ,EACR,WAAW,GAKd;IACG,MAAM,EAAE,GAAG,IAAI,gBAAgB,CAAC,IAAI,GAAG,CAAC;IACxC,IAAI;QACA,IAAI,OAAO,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;SAAE;QAExF,MAAM,OAAO,GACT,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACnE,WAAW,KAAK,MAAM,CAAC;QACvB,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,CAAC;QAE/B,MAAM,QAAQ,GAAQ,KAAK,EAAE,IAAS,EAAE,EAAE;YACtC,WAAW,KAAK,MAAM,CAAC;YACvB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAC3C,MAAM,OAAO,GAA6D;gBACtE,GAAG,EAAE,WAAW;gBAChB,YAAY;gBACZ,GAAG,IAAI;aACV,CAAC;YACF,OAAO,IAAI,OAAO,CAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACxC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3E,CAAC,CAAC,CAAC;QACP,CAAC,CAAA;QAED,MAAM,SAAS,GAA2B;YACtC,QAAQ,EAAE,OAAO;YACjB,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,QAAQ;YACR,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI;SACf,CAAA;QAED,OAAO,SAAS,CAAC;KAEpB;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/api/commands/command-service-v1.d.mts

@@ -0,0 +1,28 @@
+import { CommandDataBase, CommandService, EnqueuedCommand } from "./command-types.mjs";
+/**
+ * @class CommandService_V1 - Implementation of the command service.
+ * Implements the {@link CommandService} interface.
+ */
+export declare class CommandService_V1 implements CommandService {
+    protected lc: string;
+    private commandQueue;
+    private isProcessing;
+    constructor();
+    enqueueCommand<TCommand extends CommandDataBase<string, string[]>>(enqueuedCommand: EnqueuedCommand<TCommand>): void;
+    private startProcessing;
+    processQueue(): Promise<void>;
+    private executeCommand;
+    /**
+     * todo: change the structure so these explicit calls aren't necessary.
+     * @param cmdData about the cmd to invoke
+     * @param functionInfo full function info corresponding to cmd
+     * @returns args that the cmd expects depending on incoming {@link cmdData}
+     */
+    private getCommandArgs;
+}
+/**
+ * Gets the singleton instance of the CommandService.
+ * @returns {CommandService} The CommandService instance.
+ */
+export declare function getCommandService(): CommandService;
+//# sourceMappingURL=command-service-v1.d.mts.map

package/dist/api/commands/command-service-v1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-service-v1.d.mts","sourceRoot":"","sources":["../../../src/api/commands/command-service-v1.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGvF;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACpD,SAAS,CAAC,EAAE,EAAE,MAAM,CAAiC;IACrD,OAAO,CAAC,YAAY,CAA4D;IAChF,OAAO,CAAC,YAAY,CAAS;;IAc7B,cAAc,CAAC,QAAQ,SAAS,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,IAAI;IAOpH,OAAO,CAAC,eAAe;IAUjB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBrB,cAAc;IAgC5B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAoBzB;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}

package/dist/api/commands/command-service-v1.mjs

@@ -0,0 +1,122 @@
+import { extractErrorMsg, pretty } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { getAllFunctionInfos } from "../api-index.mjs";
+/**
+ * @class CommandService_V1 - Implementation of the command service.
+ * Implements the {@link CommandService} interface.
+ */
+export class CommandService_V1 {
+    lc = `[${CommandService_V1.name}]`;
+    commandQueue = [];
+    isProcessing = false;
+    // private anonFns: Map<string, APIFunctionInfo<any>> = new Map();
+    constructor() { }
+    // registerAnonFn({ apiFnInfo }: { apiFnInfo: APIFunctionInfo<any> }): void {
+    //     const lc = `${this.lc}[${this.registerAnonFn.name}]`;
+    //     if (this.anonFns.has(apiFnInfo.nameOrId)) {
+    //         console.warn(`${lc} anonFn already registered? (W: c6721a63affe97f5514d54bbe780f625)`)
+    //     }
+    //     this.anonFns.set(apiFnInfo.nameOrId, apiFnInfo);
+    // }
+    enqueueCommand(enqueuedCommand) {
+        this.commandQueue.push(enqueuedCommand);
+        if (!this.isProcessing) {
+            this.startProcessing();
+        }
+    }
+    startProcessing() {
+        this.isProcessing = true;
+        this.processQueue().finally(() => {
+            this.isProcessing = false;
+            if (this.commandQueue.length > 0) {
+                this.startProcessing(); // If more commands were added, process them
+            }
+        });
+    }
+    async processQueue() {
+        const lc = `${this.lc}[${this.processQueue.name}]`;
+        while (this.commandQueue.length > 0) {
+            const enqueuedCommand = this.commandQueue.shift();
+            if (enqueuedCommand) {
+                try {
+                    const result = await this.executeCommand(enqueuedCommand.command, enqueuedCommand.anonApiFn);
+                    enqueuedCommand.resolve(result);
+                }
+                catch (error) {
+                    console.error(`Error executing command ${enqueuedCommand.command.cmd} ${enqueuedCommand.command.cmdModifiers?.join(',') ?? ''}:`, error);
+                    enqueuedCommand.reject(error);
+                }
+            }
+        }
+    }
+    async executeCommand(cmdData, anonApiFn) {
+        const lc = `[${CommandService_V1.name}.${this.executeCommand.name}]`;
+        try {
+            const functionInfo = anonApiFn ??
+                Array.from(getAllFunctionInfos().entries())
+                    .map(x => x[1])
+                    .find((info) => {
+                    return info.cmd === cmdData.cmd &&
+                        info.cmdModifiers.every(modifier => !!cmdData.cmdModifiers?.includes(modifier));
+                });
+            if (functionInfo) {
+                console.log(`${lc} command executing. cmdData: ${pretty(cmdData)}`);
+                // Type checking and argument passing will need refinement based on schema
+                if (cmdData.notesToSelf) {
+                    console.log(`${lc} Notes to self: ${cmdData.notesToSelf}.  (I: ebcc5471b2b309ba186281c134f77e25)`);
+                }
+                const args = this.getCommandArgs(cmdData, functionInfo);
+                const result = await functionInfo.functionImpl(args);
+                return result;
+            }
+            else {
+                throw new Error(`${lc} Unknown command: ${cmdData.cmd} with modifiers ${cmdData.cmdModifiers?.join(', ')} (E: cc9cb829f118de05b762020213ef2825)`);
+            }
+        }
+        catch (error) {
+            debugger; // error in command svc exec
+            const errorMsg = `${lc} ${extractErrorMsg(error)}`;
+            console.error(errorMsg);
+            return { errorMsg };
+        }
+    }
+    /**
+     * todo: change the structure so these explicit calls aren't necessary.
+     * @param cmdData about the cmd to invoke
+     * @param functionInfo full function info corresponding to cmd
+     * @returns args that the cmd expects depending on incoming {@link cmdData}
+     */
+    getCommandArgs(cmdData, functionInfo) {
+        return cmdData;
+        // // This will need to be refined based on the actual function signature and schema
+        // if (functionInfo.nameOrId === 'renderableCreate') {
+        //     // return { initialStates: (cmdData as RenderableCreateCommandData).initialStates, };
+        //     return cmdData as RenderableCreateCommandData;
+        // } else if (functionInfo.nameOrId === 'renderableUpdate') {
+        //     // return { handle: (cmdData as RenderableUpdateCommandData).handle,
+        //     // updatedState: (cmdData as RenderableUpdateCommandData).updatedState
+        //     // };
+        //     return cmdData as RenderableUpdateCommandData;
+        // } else if (functionInfo.nameOrId === 'renderableDestroy') {
+        //     return cmdData as RenderableDestroyCommandData;
+        // } else if (functionInfo.nameOrId === 'tellUser') {
+        //     return { text: (cmdData as TellUserCommandData).text };
+        // } else {
+        //     throw new Error(`(UNEXPECTED) unknown command? functionInfo.nameOrId: ${functionInfo.nameOrId}, cmdData: ${pretty(cmdData)} (E: 376725f2024d48c5056a9f8989616125)`);
+        // }
+    }
+}
+/**
+ * @private
+ */
+let globalCommandService;
+/**
+ * Gets the singleton instance of the CommandService.
+ * @returns {CommandService} The CommandService instance.
+ */
+export function getCommandService() {
+    if (!globalCommandService) {
+        globalCommandService = new CommandService_V1();
+    }
+    return globalCommandService;
+}
+//# sourceMappingURL=command-service-v1.mjs.map

package/dist/api/commands/command-service-v1.mjs.map

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

package/dist/api/commands/command-service.respec.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @module command-service respec, not quite a real respec atow (01/2025).
+ * convert later when doing better testing. for now, just import the test function
+ * and run it to test.
+ */
+export {};
+//# sourceMappingURL=command-service.respec.d.mts.map

package/dist/api/commands/command-service.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-service.respec.d.mts","sourceRoot":"","sources":["../../../src/api/commands/command-service.respec.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/api/commands/command-service.respec.mjs

@@ -0,0 +1,66 @@
+/**
+ * @module command-service respec, not quite a real respec atow (01/2025).
+ * convert later when doing better testing. for now, just import the test function
+ * and run it to test.
+ */
+export {};
+// import { RenderableHandle } from '../../render/render-one-file.mjs';
+// import { renderableCreateFunctionInfo } from './renderable/create-renderables.mjs';
+// import { renderableDestroyFunctionInfo } from './renderable/destroy-renderable.mts';
+// import { renderableUpdateFunctionInfo } from './renderable/update-renderable.mts';
+// /**
+//  * @function testCommandService - A test function to demonstrate using the command service.
+//  * @returns {Promise<void>}
+//  */
+// export async function testCommandService(): Promise<void> {
+//     console.log('>>> Starting testCommandService...');
+//     // 1. Create a renderable
+//     let createHandle: RenderableHandle | undefined;
+//     try {
+//         const renderableCreateViaCmd = renderableCreateFunctionInfo.fnViaCmd;
+//         // createHandle = (await renderableCreateViaCmd({
+//         const resCreate = await renderableCreateViaCmd(
+//             {
+//                 cmd: 'Renderable',
+//                 initialStates: [{
+//                     isVisible: true,
+//                     color: { r: 1, g: 0, b: 0, a: 1 }, // Red
+//                     position: { x: 10, y: 10, z: 0 },
+//                     scale: { x: 1, y: 1 },
+//                     geometry: { type: 'rect', parameters: { type: 'rect', width: 50, height: 50 } },
+//                 }],
+//             });
+//         createHandle = resCreate.at(0);
+//         console.log(`testCommandService: Created renderable with handle ${createHandle.uuid}`);
+//     } catch (error) {
+//         console.error('testCommandService: Error creating renderable:', error);
+//         return;
+//     }
+//     if (!createHandle) {
+//         console.error('testCommandService: Error creating renderable - handle is undefined. (E: 6548f5560b07137bd683cb713a4fcc24)');
+//         return;
+//     }
+//     // 2. Update the renderable after a short delay
+//     await new Promise(resolve => setTimeout(resolve, 2000));
+//     try {
+//         const renderableUpdateViaCmd = renderableUpdateFunctionInfo.fnViaCmd;
+//         await renderableUpdateViaCmd({
+//             handle: createHandle,
+//             updatedState: { color: { r: 0, g: 1, b: 0, a: 1 }, position: { x: 100, y: 100, z: 0 } }, // Green, moved
+//         });
+//         console.log(`testCommandService: Updated renderable with handle ${createHandle.uuid}`);
+//     } catch (error) {
+//         console.error('testCommandService: Error updating renderable:', error);
+//     }
+//     // 3. Destroy the renderable after another short delay
+//     await new Promise(resolve => setTimeout(resolve, 2000));
+//     try {
+//         const renderableDestroyViaCmd = renderableDestroyFunctionInfo.fnViaCmd;
+//         await renderableDestroyViaCmd({ handle: createHandle });
+//         console.log(`testCommandService: Destroyed renderable with handle ${createHandle.uuid}`);
+//     } catch (error) {
+//         console.error('testCommandService: Error destroying renderable:', error);
+//     }
+//     console.log('>>> Finished testCommandService.');
+// }
+//# sourceMappingURL=command-service.respec.mjs.map

package/dist/api/commands/command-service.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-service.respec.mjs","sourceRoot":"","sources":["../../../src/api/commands/command-service.respec.mts"],"names":[],"mappings":"AAAA;;;;GAIG;;AAEH,uEAAuE;AACvE,sFAAsF;AACtF,uFAAuF;AACvF,qFAAqF;AAErF,MAAM;AACN,8FAA8F;AAC9F,8BAA8B;AAC9B,MAAM;AACN,8DAA8D;AAC9D,yDAAyD;AAEzD,gCAAgC;AAChC,sDAAsD;AACtD,YAAY;AACZ,gFAAgF;AAChF,4DAA4D;AAC5D,0DAA0D;AAC1D,gBAAgB;AAChB,qCAAqC;AACrC,oCAAoC;AACpC,uCAAuC;AACvC,gEAAgE;AAChE,wDAAwD;AACxD,6CAA6C;AAC7C,uGAAuG;AACvG,sBAAsB;AACtB,kBAAkB;AAElB,0CAA0C;AAC1C,kGAAkG;AAClG,wBAAwB;AACxB,kFAAkF;AAClF,kBAAkB;AAClB,QAAQ;AAER,2BAA2B;AAC3B,uIAAuI;AACvI,kBAAkB;AAClB,QAAQ;AAER,sDAAsD;AACtD,+DAA+D;AAC/D,YAAY;AACZ,gFAAgF;AAChF,yCAAyC;AACzC,oCAAoC;AACpC,uHAAuH;AACvH,cAAc;AACd,kGAAkG;AAClG,wBAAwB;AACxB,kFAAkF;AAClF,QAAQ;AAER,6DAA6D;AAC7D,+DAA+D;AAC/D,YAAY;AACZ,kFAAkF;AAClF,mEAAmE;AACnE,oGAAoG;AACpG,wBAAwB;AACxB,oFAAoF;AACpF,QAAQ;AAER,uDAAuD;AACvD,IAAI"}

package/dist/api/commands/command-types.d.mts

@@ -0,0 +1,48 @@
+import { WitnessCmdData } from "@ibgib/core-gib/dist/witness/witness-cmd/witness-cmd-types.mjs";
+import { APIFunctionInfo } from "../api-types.mjs";
+/**
+ * @interface CommandBase - Base interface for all commands.
+ * Extends the structure for witness commands.
+ */
+export interface CommandDataBase<TCmds extends string, TCmdModifiers extends string[]> extends WitnessCmdData<TCmds, TCmdModifiers> {
+    /**
+     * notes to self for use by the LLM to describe their use of the command.
+     */
+    notesToSelf?: string;
+    /**
+     * set to true if the model desires notification as soon as the command is completed.
+     * Note that this is not part of the intrinsic command, rather it is
+     * metadata regarding agent (internal LLM model) workflow.
+     */
+    repromptWithResult?: boolean;
+}
+/**
+ * @interface EnqueuedCommand - Represents a command enqueued with its resolve
+ * and reject functions.
+ */
+export interface EnqueuedCommand<TCommand extends CommandDataBase<string, string[]>> {
+    command: TCommand;
+    resolve: (result: any) => void;
+    reject: (error: Error) => void;
+    /**
+     * If the command is anonymous, then this will be set. Otherwise, the APIFunctionInfo
+     * that will be used will be whitelisted from {@link getAllFunctionInfos}.
+     */
+    anonApiFn?: APIFunctionInfo<any>;
+}
+/**
+ * @interface CommandService - Interface for the command service.
+ */
+export interface CommandService {
+    /**
+     * Enqueues a command to be executed.
+     * @param {EnqueuedCommand<TCommand>} enqueuedCommand - The command to enqueue with its resolve and reject functions.
+     */
+    enqueueCommand<TCommand extends CommandDataBase<string, string[]>>(enqueuedCommand: EnqueuedCommand<TCommand>): void;
+    /**
+     * Starts processing the command queue.
+     * @returns {Promise<void>} A promise that resolves when the queue is empty.
+     */
+    processQueue(): Promise<void>;
+}
+//# sourceMappingURL=command-types.d.mts.map

package/dist/api/commands/command-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-types.d.mts","sourceRoot":"","sources":["../../../src/api/commands/command-types.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gEAAgE,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,aAAa,SAAS,MAAM,EAAE,CAAE,SAAQ,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC;IAC/H;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC/E,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAS3B;;;OAGG;IACH,cAAc,CAAC,QAAQ,SAAS,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAErH;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC"}

package/dist/api/commands/command-types.mjs

@@ -0,0 +1,12 @@
+export {};
+// export const commandBaseSchemaProperties = {
+//     repromptWithResult: {
+//         type: 'boolean',
+//         description: `Set this to true if you want to be reprompted with the function's result.`,
+//     },
+//     notesToSelf: {
+//         type: 'string',
+//         description: `Use this as a note to yourself when looking at this function call and/or its result.`,
+//     },
+// } as const;
+//# sourceMappingURL=command-types.mjs.map

package/dist/api/commands/command-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-types.mjs","sourceRoot":"","sources":["../../../src/api/commands/command-types.mts"],"names":[],"mappings":";AA6DA,+CAA+C;AAC/C,4BAA4B;AAC5B,2BAA2B;AAC3B,oGAAoG;AACpG,SAAS;AACT,qBAAqB;AACrB,0BAA0B;AAC1B,+GAA+G;AAC/G,SAAS;AACT,cAAc"}

package/dist/api/commands/ibgib/get-ibgibs.d.mts

@@ -0,0 +1,94 @@
+/**
+ * @module get-ibgibs.mts
+ * Provides the API Function Info for the `getIbGibs` command, which allows
+ * editing an existing ibGib using the `mut8` transform.
+ *
+ * ## 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 { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
+import { SpaceId } from '@ibgib/core-gib/dist/witness/space/space-types.mjs';
+import { APIFunctionInfo } from "../../api-types.mjs";
+import { CommandDataBase } from "../command-types.mjs";
+type IbGibMap = Record<IbGibAddr, IbGib_V1 | undefined>;
+/**
+ * camelCased name of the command itself.
+ */
+declare const FUNCTION_NAME = "getIbGibs";
+/**
+ * agent is the broad command which basically acts like a category of commands at this point.
+ */
+declare const CMD_CATEGORY = "ibgib";
+/**
+ * getIbGibs here is the specific command modifier which narrows down to a command
+ * instance, similar to a fully curried function.
+ *
+ * This should be camelCased actual name of the function.
+ */
+declare const CMD_MODIFIERS: string[];
+export declare const GEMINI_SCHEMA_IBGIB_ADDRS: {
+    type: string;
+    description: string;
+    items: {
+        type: string;
+        description: string;
+    };
+};
+/**
+ * @interface GetIbGibsOpts - Options for the getIbGibs command.
+ *
+ * @extends CommandDataBase
+ */
+export interface GetIbGibsOpts extends CommandDataBase<typeof CMD_CATEGORY, typeof CMD_MODIFIERS> {
+    spaceId?: SpaceId;
+    /**
+     * @property ibGibAddr - The address (or tjp address) of the project ibGib to edit.
+     */
+    ibGibAddrs: IbGibAddr[];
+    /**
+     * @property getLatest - flag that if true will get the latest version of
+     * the ibGib registered with the space.
+     */
+    getLatest?: boolean;
+}
+/**
+ * @interface GetIbGibsCommandData - Command data for the getIbGibs command.
+ * @extends CommandDataBase
+ */
+export interface GetIbGibsCommandData extends CommandDataBase<typeof CMD_CATEGORY, [typeof FUNCTION_NAME]> {
+    /**
+     * @see {@link GetIbGibsOpts.spaceId}
+     */
+    spaceId?: string;
+    /**
+     * @see {@link GetIbGibsOpts.ibGibAddrs}
+     */
+    ibGibAddrs: IbGibAddr[];
+    /**
+     * @see {@link GetIbGibsOpts.getLatest}
+     */
+    getLatest?: boolean;
+}
+export type GetIbGibsResult = IbGibMap;
+/**
+ * Wrapper function to enqueue the getIbGibs command.
+ * @param {GetIbGibsOpts} opts - @see {@link GetIbGibsOpts}
+ * @returns {Promise<void>} A promise that resolves when the command finishes execution.
+ */
+declare function getIbGibsViaCmd(opts: GetIbGibsOpts): Promise<GetIbGibsResult>;
+/**
+ * API function info for the getIbGibs command.
+ */
+export declare const getIbGibsFunctionInfo: APIFunctionInfo<typeof getIbGibsViaCmd>;
+export {};
+//# sourceMappingURL=get-ibgibs.d.mts.map

package/dist/api/commands/ibgib/get-ibgibs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ibgibs.d.mts","sourceRoot":"","sources":["../../../../src/api/commands/ibgib/get-ibgibs.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,oDAAoD,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,KAAK,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;AAIxD;;GAEG;AACH,QAAA,MAAM,aAAa,cAAc,CAAC;AAElC;;GAEG;AACH,QAAA,MAAM,YAAY,UAAU,CAAC;AAC7B;;;;;GAKG;AACH,QAAA,MAAM,aAAa,EAAE,MAAM,EAAoB,CAAC;AA2BhD,eAAO,MAAM,yBAAyB;;;;;;;CAOrC,CAAC;AAyBF;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe,CAAC,OAAO,YAAY,EAAE,OAAO,aAAa,CAAC;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe,CAAC,OAAO,YAAY,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC;IACtG;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEvC;;;;GAIG;AACH,iBAAS,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAUtE;AA0FD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAAe,CAAC,OAAO,eAAe,CAOzE,CAAC"}