@ibgib/web-gib 0.0.1

package/dist/witness/agent/agent-constants.mjs

@@ -0,0 +1,98 @@
+/**
+ * beginning of agent.ib
+ */
+export const AGENT_ATOM = 'witness_agent';
+export const AGENT_NAME_REGEXP = /^[a-zA-Z0-9_\-.]{1,32}$/;
+export const AGENT_DESC_REGEXP = /.{1,255}/;
+export const DEFAULT_UUID_AGENT = '';
+export const DEFAULT_NAME_AGENT = 'Manco';
+export const DEFAULT_DESCRIPTION_AGENT = 'This is a generic, unspecified agent.';
+/**
+ * demarcates a block of entries loaded from ibgibs requested by the model on a
+ * one-time basis.
+ */
+export const CONTEXT_DECOMPRESSION_TAG = 'CONTEXT_DECOMPRESSION_REFERENCE';
+/**
+ * demarcates a block of function info ibgib addresses
+ */
+export const FUNCTION_CALL_REQUEST_COMMENT_TAG = 'List of function info ibgib addresses. These contain info on both the requests you made and the resultant values.';
+// export const PRIMARY_AGENT_SPECIAL_IBGIB_TYPE = 'primaryagent';
+// export const PRIMARY_AGENT_SPECIAL_IBGIB_NAME = 'Robbie';
+/**
+ * this is the rel8nName ON the special ibgib index that points to its agents.
+ *
+ * So `agentIndex.rel8ns[AGENT_REL8N_NAME]` is a list of the agents (addrs)
+ * registered in the space.
+ *
+ * @see {@link MetaspaceService.getSpecialIbGib}
+ * @see {@link MetaspaceService.getSpecialRel8dIbGibs}
+ */
+export const AGENT_REL8N_NAME = 'agent';
+export const GEMINI_SCHEMA_AGENT_ID = {
+    type: 'string',
+    description: 'unique identifier for the agent. Should be provided to the agent in system instructions upon creation.',
+};
+export const GEMINI_SCHEMA_AGENT_TYPE = {
+    type: 'string',
+    description: 'type of the agent that governs basic responsibilities. Should be provided to the agent in system instructions upon creation.',
+};
+export const GEMINI_SCHEMA_SPACE_ID_FORAGENTS = {
+    type: 'string',
+    description: 'the id of a space, usually local user space. Each agent, atow (04/2025), has two spaces: a superSpace and a subSpace. The superSpace right now is just the default local user space for all agents, though this may change. The subSpace is particular only to the agent and corresponds to where internal ibgib notes/memories should be stored. So use the subSpace for internal notes, and superSpace for any user/interagent communications/notes.',
+};
+// #region TextSource enum
+/**
+ * @see {@link TextSource.HARDCODED}
+ */
+const TEXT_SOURCE_HARDCODED = 'hardcoded';
+/**
+ * @see {@link TextSource.HUMAN}
+ */
+const TEXT_SOURCE_HUMAN = 'human';
+/**
+ * @see {@link TextSource.AI}
+ */
+const TEXT_SOURCE_AI = 'ai';
+/**
+ * @see {@link TextSource.FUNCTION}
+ */
+const TEXT_SOURCE_FUNCTION = 'function';
+/**
+ * @see {@link TextSource.UNKNOWN}
+ */
+const TEXT_SOURCE_UNKNOWN = 'unknown';
+/**
+ * The source of the text, which helps the LLM differentiate
+ */
+export const TextSource = {
+    /**
+     * The text was hardcoded in the system.
+     */
+    HARDCODED: TEXT_SOURCE_HARDCODED,
+    /**
+     * The text originated from a human.
+     */
+    HUMAN: TEXT_SOURCE_HUMAN,
+    /**
+     * The text originated from an AI.
+     */
+    AI: TEXT_SOURCE_AI,
+    /**
+     * The text originated from a function, e.g. a function response/result.
+     */
+    FUNCTION: TEXT_SOURCE_FUNCTION,
+    /**
+     * The origin is unknown.
+     */
+    UNKNOWN: TEXT_SOURCE_UNKNOWN,
+};
+export const TEXT_SOURCE_VALUES = Object.freeze(Object.values(TextSource));
+export function isTextSource(str) {
+    return !!str && TEXT_SOURCE_VALUES.includes(str);
+}
+// #endregion TextSource enum
+export const GEMINI_SCHEMA_AGENTS_SELF_IDENTIFIED_NAME = {
+    type: 'string',
+    description: `The agent should pick a name with which to represent him/her/itself to the user. This should not be "Gemini" or something bland like that, rather, it should be a name that the agent likes. Should contain no spaces, only alphanumerics. Note that the example given has a name, but really it should be up to the agent's own preference. Please be consistent with this with yourself, i.e., don't change it once established. Must pass regex: ${AGENT_NAME_REGEXP.source}`,
+};
+//# sourceMappingURL=agent-constants.mjs.map

package/dist/witness/agent/agent-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-constants.mjs","sourceRoot":"","sources":["../../../src/witness/agent/agent-constants.mts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,uCAAuC,CAAC;AAGjF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AAC3E;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,mHAAmH,CAAC;AAErK,kEAAkE;AAClE,4DAA4D;AAE5D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,wGAAwG;CACxH,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,8HAA8H;CAC9I,CAAA;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC5C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,wbAAwb;CACxc,CAAA;AAED,0BAA0B;AAC1B;;GAEG;AACH,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAC1C;;GAEG;AACH,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC;;GAEG;AACH,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B;;GAEG;AACH,MAAM,oBAAoB,GAAG,UAAU,CAAC;AACxC;;GAEG;AACH,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAatC;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB;;OAEG;IACH,SAAS,EAAE,qBAAmC;IAC9C;;OAEG;IACH,KAAK,EAAE,iBAA+B;IACtC;;OAEG;IACH,EAAE,EAAE,cAA4B;IAChC;;OAEG;IACH,QAAQ,EAAE,oBAAkC;IAC5C;;OAEG;IACH,OAAO,EAAE,mBAAiC;CACL,CAAC;AAE1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAC3E,MAAM,UAAU,YAAY,CAAC,GAAW;IACpC,OAAO,CAAC,CAAC,GAAG,IAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAiB,CAAC,CAAC;AACnE,CAAC;AAED,6BAA6B;AAE7B,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACrD,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,ubAAub,iBAAiB,CAAC,MAAM,EAAE;CACje,CAAC"}

package/dist/witness/agent/agent-helpers.d.mts

@@ -0,0 +1,106 @@
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+import { MetaspaceService } from "@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs";
+import { SpaceId } from "@ibgib/core-gib/dist/witness/space/space-types.mjs";
+import { SpecialIbGibType } from "@ibgib/core-gib/dist/common/other/other-types.mjs";
+import { IbGibSpaceAny } from "@ibgib/core-gib/dist/witness/space/space-base-v1.mjs";
+import { TagIbGib_V1 } from "@ibgib/core-gib/dist/common/tag/tag-types.mjs";
+import { AgentWitnessAny, AgentWitnessIbGib_V1 } from "./agent-one-file.mjs";
+import { CreateConcreteAgentWitnessFactory, CreateNewAgentArg } from "./agent-types.mjs";
+/**
+ * helper that gets/creates the agents tag in the given {@link space}, or in the
+ * default local user space if {@link space} is falsy.
+ * @returns agents tag ibgib
+ */
+export declare function getTag_Agents({ metaspace, space, createIfNone, }: {
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny | undefined;
+    createIfNone?: boolean;
+}): Promise<TagIbGib_V1>;
+/**
+ * gets agents of a certain {@link type} in the local space corresponding to
+ * {@link spaceId} (or default local user space if falsy) via the agents tag.
+ */
+export declare function getAgents({ metaspace, type, spaceId, space, }: {
+    metaspace: MetaspaceService;
+    type: SpecialIbGibType;
+    spaceId?: SpaceId;
+    space?: IbGibSpaceAny;
+}): Promise<AgentWitnessAny[]>;
+/**
+ * i'm updating the index proactively so we don't need to rely on jit getLatest
+ * any time we want to get the agent.
+ */
+export declare function updateAgentIndex({ metaspace, type, space, newAgentIbGib, }: {
+    metaspace: MetaspaceService;
+    type: SpecialIbGibType;
+    space: IbGibSpaceAny;
+    newAgentIbGib: AgentWitnessIbGib_V1;
+}): Promise<void>;
+/**
+ * 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 getAgentIndexNameFromIbGib({ ibGib, ibGibAddr, defaultNameIfError, }: {
+    ibGib?: IbGib_V1;
+    ibGibAddr?: IbGibAddr;
+    /**
+     * if truthy and an error is produced, then this will be returned.
+     */
+    defaultNameIfError?: string;
+}): string;
+/**
+ * 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.
+ */
+export declare function registerDomainIbGibWithAgentIndex({ domainIbGib, agentIbGib, metaspace, space, }: {
+    domainIbGib: IbGib_V1;
+    agentIbGib: AgentWitnessIbGib_V1;
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+}): Promise<void>;
+/**
+ * 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 getAgentForDomainIbGib({ ibGib, metaspace, space, }: {
+    ibGib: IbGib_V1;
+    metaspace: MetaspaceService;
+    space: IbGibSpaceAny;
+}): Promise<AgentWitnessAny | undefined>;
+/**
+ * @internal
+ * @returns factory to create concrete agent witnesses per given {@link arg}
+ */
+export declare function getConcreteAgentFactory(arg: CreateNewAgentArg): CreateConcreteAgentWitnessFactory;
+//# sourceMappingURL=agent-helpers.d.mts.map

package/dist/witness/agent/agent-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-helpers.d.mts","sourceRoot":"","sources":["../../../src/witness/agent/agent-helpers.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAG,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kEAAkE,CAAC;AACpG,OAAO,EAAE,OAAO,EAAE,MAAM,oDAAoD,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAGrF,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAO5E,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAO7E,OAAO,EAAE,iCAAiC,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUzF;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAChC,SAAS,EACT,KAAK,EACL,YAAY,GACf,EAAE;IACC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,WAAW,CAAC,CAwDvB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,EAC5B,SAAS,EACT,IAAI,EACJ,OAAO,EACP,KAAK,GACR,EAAE;IACC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAkE7B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACnC,SAAS,EACT,IAAI,EACJ,KAAK,EACL,aAAa,GAChB,EAAE;IACC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,oBAAoB,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,0BAA0B,CAAC,EACvC,KAAK,EACL,SAAS,EACT,kBAAkB,GACrB,EAAE;IACC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,MAAM,CAiGT;AAED;;;GAGG;AACH,wBAAsB,iCAAiC,CAAC,EACpD,WAAW,EACX,UAAU,EACV,SAAS,EACT,KAAK,GACR,EAAE;IACC,WAAW,EAAE,QAAQ,CAAC;IACtB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkHhB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,KAAK,EACL,SAAS,EACT,KAAK,GACR,EAAE;IACC,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAsEvC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,iCAAiC,CAiBjG"}