@ibgib/web-gib 0.0.1

package/dist/witness/agent/agents-service-v1.mjs

@@ -0,0 +1,453 @@
+import { extractErrorMsg, pretty } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { getIbAndGib } from "@ibgib/ts-gib/dist/helper.mjs";
+import { Factory_V1 } from "@ibgib/ts-gib/dist/V1/factory.mjs";
+import { rel8ToTag } from "@ibgib/core-gib/dist/common/tag/tag-helper.mjs";
+import { toDto } from "@ibgib/core-gib/dist/common/other/ibgib-helper.mjs";
+import { updateSpecialIndex } from "@ibgib/core-gib/dist/timeline/timeline-api.mjs";
+import { GLOBAL_LOG_A_LOT, HARDCODED_PROMPT_TAG_TEXT } from "../../constants.mjs";
+import { getGlobalMetaspace_waitIfNeeded } from "../../helpers.web.mjs";
+import { getAgents, getConcreteAgentFactory, getTag_Agents } from "./agent-helpers.mjs";
+import { getAgentIb, parseAgentIb, taggifyForPrompt } from "./agent-one-file.mjs";
+import { AGENT_ATOM, AGENT_REL8N_NAME } from "./agent-constants.mjs";
+const logalot = GLOBAL_LOG_A_LOT;
+/**
+ * I'm having an issue with agents being out of date. I don't want to have to
+ * update the agent to the latest which would require calling getLatest
+ * (relatively expensive).
+ *
+ * but I am having an issue where I update an agent, but before I can update the
+ * spcial ibgib index, it is being loaded again. So I am trying a hack to have a
+ * simple in-memory latest hack.
+ *
+ * So the idea is that we will consider agents to be singleton-like, i.e., only
+ * one local timeline allowed.
+ */
+export class AgentsService_V1 {
+    lc = `[${AgentsService_V1.name}]`;
+    /**
+     * dtos of latest agents
+     */
+    latestAgents = new Map();
+    factoryFns = {};
+    constructor() {
+    }
+    async getAgentById(opts) {
+        const lc = `${this.lc}[${this.getAgentById.name}]`;
+        try {
+            const { agentId, agentType, spaceId, } = opts;
+            if (logalot) {
+                console.log(`${lc} starting... (I: 0c4214b4614a43bd2825978e54aee325)`);
+            }
+            let agent = this.latestAgents.get(agentId);
+            if (!agent) {
+                const metaspace = await getGlobalMetaspace_waitIfNeeded();
+                const agents = await getAgents({ metaspace, type: agentType, spaceId });
+                agent = agents.find(x => x.data.uuid === agentId);
+            }
+            if (!agent) {
+                console.warn(`${lc} couldn't find any agent by id. opts: ${pretty(opts)} (W: 70cf51ecbe68dfdcfe1e9995a7468f25)`);
+            }
+            return agent;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * SHOULD NOT NEED THIS... USE A GD PROXY.
+     *
+     * if the incoming {@link agent} is the most recent, then this will save
+     * this agent as the latest.
+     *
+     * if the incoming {@link agent} is equal, then nothing happens.
+     *
+     * if the incoming {@link agent} is older than the known latest agent, then
+     * the incoming {@link agent} will load the most recent agent's dto unless {@link throwIfNewerFound} is true.
+     */
+    async updateOrSetLatestAgent({ agent, throwIfNewerFound, }) {
+        const lc = `${this.lc}[${this.updateOrSetLatestAgent.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 9bb74f19b989fc0ee969cb4c2c2aa525)`);
+            }
+            if (!agent.data) {
+                throw new Error(`invalid agent. data falsy. agent.ib: ${agent.ib} (E: 7356db7395cb0c5664d13437dd62c425)`);
+            }
+            if (!agent.data.uuid) {
+                throw new Error(`invalid agent. data.uuid falsy. agent.ib: ${agent.ib} (E: 48afcd6658154bee1138fca31cbfbf25)`);
+            }
+            const existing = await this.getLatestAgent({ id: agent.data.uuid });
+            if (existing) {
+                // check existing against the one we're trying to set.
+                if (!existing.data) {
+                    throw new Error(`(UNEXPECTED) existing.data falsy? should have thrown on previous set function call? (E: f3cbae9922ea9849ada25db2eea40825)`);
+                }
+                if (existing.data.n === agent.data.n) {
+                    if (existing.gib === agent.gib) {
+                        // already have this version
+                        return; /* <<<< returns early */
+                    }
+                    else {
+                        console.warn(`existing.data.n === agent.data.n but gibs are different. We have a branched timeline. just logging this error, need to figure out wth is going on here. we should not have this with the timeline being locked. The only thing I can think of is if the ibgib is updated very quickly, but even then, the n should be incremented. still the approach is valid. anyway, we're going ahead and taking the newer agent.\nexisting: ${pretty(toDto({ ibGib: existing }))}\nnew: ${pretty(toDto({ ibGib: agent }))} (E: 5e079b566ff3533acdb2d01359f08625)`);
+                        await existing.loadIbGibDto(agent.toIbGibDto());
+                        this.latestAgents.set(agent.data.uuid, agent);
+                        return; /* <<<< returns early */
+                    }
+                }
+                else if (existing.data.n > agent.data.n) {
+                    const msg = `existing.data.n > agent.data.n, i.e., the one we already have is newer. So why was the caller trying to set to the older agent thinking it was the most recent? Probably have a branched timeline.`;
+                    if (throwIfNewerFound) {
+                        throw new Error(`${lc} ${msg} (E: bb2cc3ce8cfa88b80fb62149b0e70225)`);
+                    }
+                    else {
+                        console.warn(`${lc} ${msg} (W: caaf66deb4e6fd8e2eb9261685dc0325)`);
+                    }
+                    return; /* <<<< returns early */
+                }
+                else {
+                    // happy path, the new one is newer than the existing one
+                    await existing.loadIbGibDto(agent.toIbGibDto());
+                    this.latestAgents.set(agent.data.uuid, agent);
+                    return; /* <<<< returns early */
+                }
+            }
+            else {
+                this.latestAgents.set(agent.data.uuid, agent);
+                return; /* <<<< returns early */
+            }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * gets the most recent agent witness corresponding to the given {@link id},
+     * if found. If not found, then returns undefined.
+     *
+     * ## atow 04/2025 - implementation note
+     *
+     * right now this executes sync but is promise-based, because in the future
+     * this has a decent chance of becoming truly promise-based.
+     */
+    getLatestAgent({ id, }) {
+        const lc = `${this.lc}[${this.getLatestAgent.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 8e85b55057760b712a913a92e88ead25)`);
+            }
+            return Promise.resolve(this.latestAgents.get(id));
+            // const agents = this.latestAgents.filter(x => x.data!.uuid === id);
+            // if (agents.length === 1) {
+            //     return agents.at(0)!;
+            // } else if (agents.length === 0) {
+            //     return undefined;
+            // } else {
+            //     throw new Error(`(UNEXPECTED) more than one agent with the same agent.data.uuid (${id})? (E: a4e3bc9053523e0eb4ec5514e1825825)`);
+            // }
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    registerFactory({ classname, fnDtoToAgentWitness, }) {
+        this.factoryFns[classname] = fnDtoToAgentWitness;
+    }
+    async getAgentWitnessFromDto({ dto, classname, }) {
+        const lc = `${this.lc}[${this.getAgentWitnessFromDto.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 718837d4ee3d590177f3425b99106225)`);
+            }
+            if (!dto.data) {
+                throw new Error(`dto.data falsy (E: fad89dd4c787b687a657c13968946925)`);
+            }
+            let agent = undefined;
+            classname ??= dto.data.classname;
+            if (classname) {
+                const fn = this.factoryFns[classname];
+                const res = await fn(dto);
+                if (res.applies) {
+                    if (!res.agent) {
+                        throw new Error(`(UNEXPECTED) factory function for agent dto applies: true, but the resulting agent is undefined? (E: b13cdf0f3d9c50f1fa419f2c409ebf25)`);
+                    }
+                    agent = res.agent;
+                }
+                else {
+                    throw new Error(`classname (${classname}) factory function found and attempted, but result says applied: false. (E: 751a2502c9a7e2d61c76c8ae2f7fb125)`);
+                }
+            }
+            else {
+                // not found, try to brute force
+                const fnClassnames = Object.keys(this.factoryFns);
+                for (const fnClassname of fnClassnames) {
+                    const fn = this.factoryFns[fnClassname];
+                    const res = await fn(dto);
+                    if (res.applies) {
+                        if (!res.agent) {
+                            throw new Error(`(UNEXPECTED) factory function for agent dto applies: true, but the resulting agent is undefined? (E: 60e97c083a668baf11efcd6adf6a3525)`);
+                        }
+                        agent = res.agent;
+                        break;
+                    }
+                }
+            }
+            return agent;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * Retrieves an agent instance by its ibGib address.
+     * Checks the in-memory cache first. If not found, retrieves the agent ibGib
+     * from the specified space, converts the DTO to a witness, and caches it.
+     */
+    async getAgentByAddr({ agentAddr, spaceId, metaspace, // Assuming metaspace might be needed here
+     }) {
+        const lc = `${this.lc}[${this.getAgentByAddr.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 42dfecbe6d6b5a3a7d392af5a66cc625)`);
+            }
+            if (!agentAddr) {
+                throw new Error(`${lc} agentAddr is required. (E: 389351659a2e08fa179ceede16925a25)`);
+            }
+            // first check to see if we have it in the agents service already
+            const { ib: agentIb } = getIbAndGib({ ibGibAddr: agentAddr });
+            let { uuid: agentId, type: agentType } = parseAgentIb({ ib: agentIb });
+            if (!agentId) {
+                debugger; // error agent ib didn't have uuid?
+                throw new Error(`(UNEXPECTED) agentAddr doesn't have uuid in the ib? agentAddr: ${agentAddr} (E: fedcacffed98fdc78b1e80e45c413925)`);
+            }
+            let resAgent = await this.getAgentById({
+                agentId,
+                agentType,
+            });
+            if (resAgent) {
+                if (logalot) {
+                    console.log(`${lc} agent found already in agents svc so didn't need to go get it from the space. (I: ec6abaf3badd8e301d79a7476845bc25)`);
+                }
+                return resAgent; /* <<<< returns early */
+            }
+            // we do NOT yet have it in the agents svc. so get the ibgib,
+            // convert it to a witness, add it to this service's cache,
+            // and return it
+            // Let's try to get the ibGib from the space first to get the UUID.
+            // We'll need the metaspace and space instance.
+            metaspace ??= await getGlobalMetaspace_waitIfNeeded();
+            const space = await metaspace.getLocalUserSpace({
+                localSpaceId: spaceId,
+                lock: false
+            });
+            if (!space) {
+                if (spaceId) {
+                    throw new Error(`couldn't get space with spaceId (${spaceId}) (E: 26b3f1414a93cc339e704d0162cb8b25)`);
+                }
+                else {
+                    throw new Error(`(UNEXPECTED) couldn't get default local user space? (E: 2e19a1fae8b3f00595257f51426ac225)`);
+                }
+            }
+            const resGet = await metaspace.get({ addrs: [agentAddr], space, });
+            if (!resGet.success || !resGet.ibGibs || resGet.ibGibs.length === 0) {
+                if (logalot) {
+                    console.log(`${lc} Agent ibGib not found in space (${spaceId}) at address ${agentAddr}. (I: 29c5c7994fb3ed388b28a81a9ed68325)`);
+                }
+                return undefined; // Agent not found in the space
+            }
+            const agentIbGib = resGet.ibGibs[0];
+            // 3. Convert DTO to Witness
+            const agentWitness = await this.getAgentWitnessFromDto({ dto: agentIbGib });
+            if (!agentWitness) {
+                debugger; // error couldn't get agent from dto?
+                throw new Error(`${lc} Couldn't get actual agent witness from agent dto (${agentAddr}). Have we registered classname (${agentIbGib.data?.classname}) and factory fn with agents service? (E: e6e9da6c91d14bd7acb5c571c8de1a25)`);
+            }
+            // 4. Cache the witness
+            await this.updateOrSetLatestAgent({
+                agent: agentWitness,
+                throwIfNewerFound: true, // we just checked, it would be weird if already exists
+            });
+            if (logalot) {
+                console.log(`${lc} Cached agent witness with id ${agentId}. (I: b862f63147a3fac3c6e6210d5ab87c25)`);
+            }
+            if (logalot) {
+                console.log(`${lc} complete. Retrieved and cached agent witness for address ${agentAddr}.`);
+            }
+            return agentWitness;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * factory function that creates a new agent ibgib and witness. this **DOES**
+     * save all created ibgibs (including dependency and intermediate ibgibs) in the
+     * given {@link space} if provided, else the default local space according to
+     * the given {@link metaspace}.
+     */
+    async createNewAgent(arg) {
+        const lc = `[${this.createNewAgent.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: a3e07b54bb7bf45f7739eff2d738c825)`);
+            }
+            let { metaspace, superSpace, name, 
+            // api, // extracted and used in getConcreteAgentFactory
+            // model, // extracted and used in getConcreteAgentFactory
+            availableFunctions, initialSystemText, initialChatText, fnGetAPIKey, addToAgentsTag, type, } = arg;
+            superSpace ??= await metaspace.getLocalUserSpace({});
+            if (!superSpace) {
+                throw new Error(`(UNEXPECTED) superSpace falsy? (E: ceb60d96ff25b6d6aaa5aa69a7a51d25)`);
+            }
+            if (!superSpace.data) {
+                throw new Error(`(UNEXPECTED) superSpace.data falsy? (E: 56b4ec127f8559da96e6f70c7cb13825)`);
+            }
+            /**
+             * this sets the factory to the given {@link arg}
+             */
+            const agentFactory = getConcreteAgentFactory(arg);
+            // do the data (should be in concrete api function, pass in superSpaceId)
+            const data = await agentFactory.createInitialData(superSpace);
+            if (!data.uuid) {
+                throw new Error(`(UNEXPECTED) data.uuid falsy? (E: 4e4f6fcf89d1e3775971ad843a083725)`);
+            }
+            const newSubSpace = await metaspace.createLocalSpaceAndUpdateBootstrap({
+                allowCancel: false,
+                zeroSpace: metaspace.zeroSpace,
+                spaceName: name + data.uuid.substring(0, 5),
+                createBootstrap: false,
+            });
+            // let debugerrors = await validateIbGibIntrinsically({ ibGib: newSubSpace! }) ?? []; // debugging
+            // console.log(`${lc}\n${debugerrors?.join('\n')}`)
+            if (!newSubSpace) {
+                throw new Error(`(UNEXPECTED) newSubSpace falsy after creating locally? (E: af8b5503c15d4292e2f591b316e7d825)`);
+            }
+            data.subSpaceId = newSubSpace.data.uuid;
+            // do the rel8ns (should be in concrete api function, pass in superSpaceId)
+            // const rel8ns = !!DEFAULT_AGENT_REL8NS_V1 ?
+            //     clone(DEFAULT_AGENT_REL8NS_V1) as AgentWitnessRel8ns_V1 :
+            //     undefined;
+            const rel8ns = await agentFactory.createInitialRel8ns();
+            const resFirstGen = await Factory_V1.firstGen({
+                ib: getAgentIb({ data }),
+                parentIbGib: Factory_V1.primitive({ ib: AGENT_ATOM }),
+                data, rel8ns,
+                nCounter: true, dna: true,
+                tjp: { timestamp: true, },
+            });
+            await metaspace.persistTransformResult({ resTransform: resFirstGen });
+            // await metaspace.registerNewIbGib
+            // skipping registering new ibgib with metaspace for now. maybe should
+            // do this, I don't remember.
+            const agentIbGib = resFirstGen.newIbGib;
+            const agentWitness = await agentFactory.createWitness();
+            // agentWitness.setMetaspace(metaspace); // must set metaspace 1st
+            agentWitness.fnGetAPIKey = fnGetAPIKey;
+            await agentWitness.loadIbGibDto(agentIbGib);
+            if (addToAgentsTag) {
+                const agentsTagIbGib = await getTag_Agents({ metaspace, space: superSpace, });
+                // this will persist the new agents tag and register it with the
+                // given superSpace
+                let _newAgentsTagIbGib = await rel8ToTag({
+                    ibGib: agentIbGib,
+                    metaspace,
+                    space: superSpace,
+                    tagIbGib: agentsTagIbGib,
+                });
+            }
+            // always add to agent index
+            await updateSpecialIndex({
+                type,
+                rel8nInfos: [{ rel8nName: AGENT_REL8N_NAME, ibGibs: [agentIbGib], }],
+                metaspace,
+                space: superSpace,
+            });
+            // at this point, we should have a witness that is able to build itself
+            // up with its own functions.
+            if (availableFunctions.length > 0) {
+                await agentWitness.addAvailableFunctions(availableFunctions);
+            }
+            const textsToAdd = [];
+            // always tell the agent their id, superSpaceId and subSpaceId
+            textsToAdd.push({
+                textSrc: 'hardcoded',
+                text: taggifyForPrompt({
+                    tagText: HARDCODED_PROMPT_TAG_TEXT,
+                    contentText: `Your id (agent id) is: ${data.uuid}. Your superSpaceId is: ${data.superSpaceId}. Your subSpaceId is: ${data.subSpaceId}. These may be useful/required in some functions, though you should refer to those functions' instructions/descriptions for applicability.`,
+                }),
+                isSystem: true,
+            });
+            if (initialSystemText) {
+                textsToAdd.push({ textSrc: 'hardcoded', text: initialSystemText, isSystem: true, });
+            }
+            if (initialChatText) {
+                textsToAdd.push({ textSrc: 'hardcoded', text: initialChatText, });
+            }
+            await agentWitness.addTexts({ infos: textsToAdd, });
+            this.latestAgents.set(agentWitness.data.uuid, agentWitness);
+            return agentWitness;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    getAgents(opts) {
+        const lc = `${this.lc}[${this.getAgents.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 4663f125c3a21fa3ecccc2c5a38d1225)`);
+            }
+            return getAgents(opts);
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+}
+/**
+ * Singleton {@link AgentsService_V1} instance.
+ */
+let _agentsSvcInstance = undefined;
+export function getAgentsSvc() {
+    if (!_agentsSvcInstance) {
+        _agentsSvcInstance = new AgentsService_V1();
+    }
+    return _agentsSvcInstance;
+}
+//# sourceMappingURL=agents-service-v1.mjs.map

package/dist/witness/agent/agents-service-v1.mjs.map

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

package/dist/witness/agent/function-info/function-info-one-file.d.mts

@@ -0,0 +1,192 @@
+import { Ib, TransformResult } from '@ibgib/ts-gib/dist/types.mjs';
+import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
+import { MetaspaceService } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs';
+import { AgentAPI } from '../agent-types.mjs';
+/**
+ * used as a rel8nName to link a Function Call Request (FCR) comment ibgib to
+ * the actual function call info ibgibs that represent each FCR.
+ */
+export declare const FUNCTION_INFO_REL8N_NAME = "function_info";
+export declare const FUNCTION_INFO_ATOM = "function_info";
+/**
+ * @interface FunctionInfoIbInfo - Type for parsed function info ib.
+ * Used by parseFunctionInfoIb
+ */
+export interface FunctionInfoIbInfo {
+    atom: string;
+    timestampInTicks: string;
+    model: string;
+    api: AgentAPI;
+    agentId: string;
+}
+/**
+ * builds the function info ibgib's ib based on given {@link data}
+ * @see {@link parseFunctionInfoIb}
+ */
+export declare function getFunctionInfoIb({ data, }: {
+    /** function info data, should be valid */
+    data: FunctionInfoData_V1;
+}): string;
+/**
+ * @returns parsed info from an ib
+ * @see {@link getFunctionInfoIb}
+ */
+export declare function parseFunctionInfoIb({ ib, }: {
+    ib: Ib;
+}): FunctionInfoIbInfo;
+/**
+ * Validates a `FunctionInfoIb` and returns a list of any errors.
+ *
+ * @param {object} arg - Options for validating the `ib`.
+ * @param {string} arg.ib - `ib` to validate.
+ * @returns {string[]} - list of validation errors or an empty array if valid.
+ */
+export declare function validateFunctionInfoIb({ ib, }: {
+    ib: Ib;
+}): string[];
+/**
+ * Information required when creating an info ibgib.
+ *
+ * ATOW (01/2025) Note that this does NOT save the ibgib in any spaces.
+ */
+export interface CreateFunctionInfoIbGibArgs {
+    /**
+     * raw string of the function call requested by the model.
+     */
+    fnRawRequest: string;
+    /**
+     * which api (e.g. 'gemini') was used when generating the function call
+     * request.
+     * @see {@link model}
+     * @see {@link FunctionInfoData_V1.api}
+     */
+    api: AgentAPI;
+    /**
+     * model that generated the request
+     * @see {@link api}
+     * @see {@link FunctionInfoData_V1.model}
+     */
+    model: string;
+    /**
+     * id of the agent that this will be associated with
+     */
+    agentId: string;
+    /**
+     * name of the function.
+     *
+     * in gemini, this should be provided easily and we shouldn't need a regex for it.
+     */
+    fnName: string;
+    /**
+     * parsed args from the raw request string
+     */
+    fnArgs: any;
+    /**
+     * the result of a successful functionImpl, otherwise undefined.
+     * @see {@link FunctionInfoData_V1.fnResult}
+     */
+    fnResult?: any;
+    /**
+     * flag that indicates if the function completed successfully.
+     * @see {@link FunctionInfoData_V1.fnComplete}
+     */
+    fnComplete?: boolean;
+    /**
+     * This is the error msg if there was an error actually parsing the raw
+     * function info.
+     * @see {@link execErrorMsg}
+     */
+    parseErrorMsg?: string;
+    /**
+     * This is the error msg if there was an error actually executing the
+     * function.
+     * @see {@link parseErrorMsg}
+     */
+    execErrorMsg?: string;
+    /**
+     * corresponds to whether or not the model wanted to be notified upon function completion/error.
+     * @see {@link FunctionInfoData_V1.repromptWithResult}
+     */
+    repromptWithResult?: boolean;
+    /**
+     * should we save the newly created ibgib and its dependency graph?
+     * @see {@link metaspace}
+     */
+    saveInSpace?: boolean;
+    /**
+     * if {@link saveInSpace}, this is the required metaspace to handle saving.
+     * @see {@link space}
+     */
+    metaspace?: MetaspaceService;
+    /**
+     * if {@link saveInSpace}, this is the required space in which to save.
+     * @see {@link metaspace}
+     */
+    space?: IbGibSpaceAny;
+}
+/**
+ * Creates a new FunctionInfoIbGib_V1 object.
+ *
+ * @param {object} arg - Arguments for creating the new ibgib
+ * @returns {Promise<FunctionInfoIbGib_V1>} A promise that resolves to the new FunctionInfoIbGib_V1 object.
+ * @throws {Error} If there is an error during ibgib creation.
+ */
+export declare function createFunctionInfoIbGib(arg: CreateFunctionInfoIbGibArgs): Promise<TransformResult<FunctionInfoIbGib_V1>>;
+/**
+ * @interface FunctionInfoData_V1
+ * Data interface for a function call.
+ */
+export interface FunctionInfoData_V1 extends IbGibData_V1 {
+    /**
+     * which model generated this function request.
+     */
+    model: string;
+    /**
+     * Which api was used to generate this function request.
+     */
+    api: AgentAPI;
+    /**
+     *  This is the raw JSON string that was returned from the LLM function call
+     */
+    fnRawRequest: string;
+    /**
+     * name of the function.
+     *
+     * in gemini, this should be provided easily and we shouldn't need a regex for it.
+     */
+    fnName: string;
+    /**
+     * parsed args from the raw request string
+     */
+    fnArgs: any;
+    /**
+     * The results of the called function. If the function implementation called
+     * returns void/Promise<void> then this should remain undefined.
+     */
+    fnResult?: any;
+    /**
+     * Was the functionImpl completed without issue? If it returned void, this
+     * should be set to true, but this may be used for other workflows in the
+     * future.
+     */
+    fnComplete?: boolean;
+    /**
+     * Is the function call request intended to have its result reprompted to the model
+     * upon function completion or error?
+     */
+    repromptWithResult?: boolean;
+}
+/**
+ * @interface FunctionInfoRel8ns_V1 - Rel8ns interface for function info ibgibs.
+ * Extends {@link IbGibRel8ns_V1}
+ */
+export interface FunctionInfoRel8ns_V1 extends IbGibRel8ns_V1 {
+}
+/**
+ * @interface FunctionInfoIbGib_V1 - Interface for ibgibs of individual function calls.
+ * Extends {@link IbGib_V1} with {@link FunctionInfoData_V1} and {@link FunctionInfoRel8ns_V1}
+ */
+export interface FunctionInfoIbGib_V1 extends IbGib_V1<FunctionInfoData_V1, FunctionInfoRel8ns_V1> {
+}
+//# sourceMappingURL=function-info-one-file.d.mts.map

package/dist/witness/agent/function-info/function-info-one-file.d.mts.map

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