@ainetwork/adk 0.0.1

package/dist/esm/services/a2a.service.js

@@ -0,0 +1,89 @@
+import { randomUUID } from "node:crypto";
+import { loggers } from "../utils/logger.js";
+/**
+ * Implements the AgentExecutor interface from the a2a-js-sdk.
+ * This service is responsible for the core business logic of executing an A2A task.
+ */
+export class A2AService {
+    constructor(queryService) {
+        this.canceledTasks = new Set();
+        this.cancelTask = async (taskId, _eventBus) => {
+            this.canceledTasks.add(taskId);
+        };
+        this.createTaskStatusUpdateEvent = (taskId, contextId, state, message) => {
+            return {
+                kind: "status-update",
+                taskId: taskId,
+                contextId: contextId,
+                status: {
+                    state: state,
+                    message: message
+                        ? {
+                            kind: "message",
+                            role: "agent",
+                            messageId: randomUUID(),
+                            parts: [{ kind: "text", text: message }],
+                            taskId: taskId,
+                            contextId: contextId,
+                        }
+                        : undefined,
+                    timestamp: new Date().toISOString(),
+                },
+                final: state !== "working",
+            };
+        };
+        this.queryService = queryService;
+    }
+    async execute(requestContext, eventBus) {
+        const userMessage = requestContext.userMessage;
+        const { sessionId } = userMessage.metadata;
+        const existingTask = requestContext.task;
+        const taskId = existingTask?.id || randomUUID();
+        const contextId = userMessage.contextId || existingTask?.contextId || randomUUID();
+        if (!existingTask) {
+            const initialTask = {
+                kind: "task",
+                id: taskId,
+                contextId: contextId,
+                status: {
+                    state: "submitted",
+                    timestamp: new Date().toISOString(),
+                },
+                history: [userMessage],
+                metadata: userMessage.metadata,
+                artifacts: [],
+            };
+            eventBus.publish(initialTask);
+        }
+        const workingStatusUpdate = this.createTaskStatusUpdateEvent(taskId, contextId, "working");
+        eventBus.publish(workingStatusUpdate);
+        const message = userMessage.parts
+            .filter((part) => part.kind === "text")
+            .map((part) => part.text)
+            .join("\n");
+        if (message.length === 0) {
+            loggers.server.warn(`Empty message received for task ${taskId}.`);
+            const failureUpdate = this.createTaskStatusUpdateEvent(taskId, contextId, "failed", "No message found to process.");
+            eventBus.publish(failureUpdate);
+            return;
+        }
+        try {
+            const response = await this.queryService.handleQuery(message, sessionId);
+            if (this.canceledTasks.has(taskId)) {
+                loggers.server.info(`Task ${taskId} was canceled.`);
+                const canceledUpdate = this.createTaskStatusUpdateEvent(taskId, contextId, "canceled");
+                eventBus.publish(canceledUpdate);
+                return;
+            }
+            const finalUpdate = this.createTaskStatusUpdateEvent(taskId, contextId, "completed", response.content);
+            eventBus.publish(finalUpdate);
+            loggers.server.info(`Task ${taskId} completed successfully.`);
+        }
+        catch (error) {
+            loggers.server.error(`Error processing task ${taskId}:`, error);
+            const errorUpdate = this.createTaskStatusUpdateEvent(taskId, contextId, "failed", `Agent error: ${error.message}`);
+            eventBus.publish(errorUpdate);
+        }
+    }
+}
+//# sourceMappingURL=a2a.service.js.map

package/dist/esm/services/a2a.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.service.js","sourceRoot":"","sources":["../../../src/services/a2a.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/services/query.service.d.ts

@@ -0,0 +1,57 @@
+import type { A2AModule, MCPModule, MemoryModule, ModelModule } from "../modules/index.js";
+import type { AinAgentPrompts } from "../types/index.js";
+/**
+ * Service for processing user queries through the agent's AI pipeline.
+ *
+ * Orchestrates the query processing workflow including intent detection,
+ * model inference, tool execution, and response generation. Manages
+ * conversation context and coordinates between different modules.
+ */
+export declare class QueryService {
+    private modelModule;
+    private a2aModule?;
+    private mcpModule?;
+    private memoryModule?;
+    private prompts?;
+    constructor(modelModule: ModelModule, a2aModule?: A2AModule, mcpModule?: MCPModule, memoryModule?: MemoryModule, prompts?: AinAgentPrompts);
+    /**
+     * Detects the intent from a user query.
+     *
+     * @param query - The user's input query
+     * @returns The detected intent (currently returns the query as-is)
+     * @todo Implement actual intent detection logic
+     */
+    private intentTriggering;
+    /**
+     * Fulfills the detected intent by generating a response.
+     *
+     * Manages the complete inference loop including:
+     * - Loading prompts and conversation history
+     * - Collecting available tools from modules
+     * - Executing model inference with tool support
+     * - Processing tool calls iteratively until completion
+     *
+     * @param query - The user's input query
+     * @param sessionId - Session identifier for context
+     * @param sessionHistory - Previous conversation history
+     * @returns Object containing process steps and final response
+     */
+    private intentFulfilling;
+    /**
+     * Main entry point for processing user queries.
+     *
+     * Handles the complete query lifecycle:
+     * 1. Loads session history from memory
+     * 2. Detects intent from the query
+     * 3. Fulfills the intent with AI response
+     * 4. Updates conversation history
+     *
+     * @param query - The user's input query
+     * @param sessionId - Unique session identifier
+     * @returns Object containing the AI-generated response
+     */
+    handleQuery(query: string, sessionId: string): Promise<{
+        content: string;
+    }>;
+}
+//# sourceMappingURL=query.service.d.ts.map

package/dist/esm/services/query.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.service.d.ts","sourceRoot":"","sources":["../../../src/services/query.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUxD;;;;;;GAMG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,OAAO,CAAC,CAAkB;gBAGjC,WAAW,EAAE,WAAW,EACxB,SAAS,CAAC,EAAE,SAAS,EACrB,SAAS,CAAC,EAAE,SAAS,EACrB,YAAY,CAAC,EAAE,YAAY,EAC3B,OAAO,CAAC,EAAE,eAAe;IAS1B;;;;;;OAMG;YACW,gBAAgB;IAK9B;;;;;;;;;;;;;OAaG;YACW,gBAAgB;IAkH9B;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;CAgCzD"}

package/dist/esm/services/query.service.js

@@ -0,0 +1,154 @@
+import { ChatRole } from "../types/memory.js";
+import { TOOL_PROTOCOL_TYPE, } from "../types/tool.js";
+import { loggers } from "../utils/logger.js";
+/**
+ * Service for processing user queries through the agent's AI pipeline.
+ *
+ * Orchestrates the query processing workflow including intent detection,
+ * model inference, tool execution, and response generation. Manages
+ * conversation context and coordinates between different modules.
+ */
+export class QueryService {
+    constructor(modelModule, a2aModule, mcpModule, memoryModule, prompts) {
+        this.modelModule = modelModule;
+        this.a2aModule = a2aModule;
+        this.mcpModule = mcpModule;
+        this.memoryModule = memoryModule;
+        this.prompts = prompts;
+    }
+    /**
+     * Detects the intent from a user query.
+     *
+     * @param query - The user's input query
+     * @returns The detected intent (currently returns the query as-is)
+     * @todo Implement actual intent detection logic
+     */
+    async intentTriggering(query) {
+        /* TODO */
+        return query;
+    }
+    /**
+     * Fulfills the detected intent by generating a response.
+     *
+     * Manages the complete inference loop including:
+     * - Loading prompts and conversation history
+     * - Collecting available tools from modules
+     * - Executing model inference with tool support
+     * - Processing tool calls iteratively until completion
+     *
+     * @param query - The user's input query
+     * @param sessionId - Session identifier for context
+     * @param sessionHistory - Previous conversation history
+     * @returns Object containing process steps and final response
+     */
+    async intentFulfilling(query, sessionId, sessionHistory) {
+        // 1. Load agent / system prompt from memory
+        const systemPrompt = `
+Today is ${new Date().toLocaleDateString()}.
+
+${this.prompts?.agent || ""}
+
+${this.prompts?.system || ""}
+    `;
+        const modelInstance = this.modelModule.getModel();
+        const messages = modelInstance.generateMessages(sessionHistory, query, systemPrompt.trim());
+        const tools = [];
+        if (this.mcpModule) {
+            tools.push(...this.mcpModule.getTools());
+        }
+        if (this.a2aModule) {
+            tools.push(...(await this.a2aModule.getTools()));
+        }
+        const functions = modelInstance.convertToolsToFunctions(tools);
+        const processList = [];
+        let finalMessage = "";
+        let didCallTool = false;
+        while (true) {
+            const response = await modelInstance.fetchWithContextMessage(messages, functions);
+            didCallTool = false;
+            loggers.intent.debug("messages", { messages });
+            const { content, toolCalls } = response;
+            loggers.intent.debug("content", { content });
+            loggers.intent.debug("tool_calls", { ...toolCalls });
+            if (toolCalls) {
+                const messagePayload = this.a2aModule?.getMessagePayload(query, sessionId);
+                for (const toolCall of toolCalls) {
+                    const toolName = toolCall.name;
+                    didCallTool = true;
+                    const selectedTool = tools.filter((tool) => tool.id === toolName)[0];
+                    let toolResult = "";
+                    if (this.mcpModule &&
+                        selectedTool.protocol === TOOL_PROTOCOL_TYPE.MCP) {
+                        const toolArgs = toolCall.arguments;
+                        loggers.intent.debug("MCP tool call", { toolName, toolArgs });
+                        const result = await this.mcpModule.useTool(selectedTool, toolArgs);
+                        toolResult =
+                            `[Bot Called MCP Tool ${toolName} with args ${JSON.stringify(toolArgs)}]\n` +
+                                JSON.stringify(result.content, null, 2);
+                    }
+                    else if (this.a2aModule &&
+                        selectedTool.protocol === TOOL_PROTOCOL_TYPE.A2A) {
+                        const result = await this.a2aModule.useTool(selectedTool, messagePayload, sessionId);
+                        toolResult = `[Bot Called A2A Tool ${toolName}]\n${result.join("\n")}`;
+                    }
+                    else {
+                        // Unrecognized tool type. It cannot be happened...
+                        loggers.intent.warn(`Unrecognized tool type: ${selectedTool.protocol}`);
+                        continue;
+                    }
+                    loggers.intent.debug("toolResult", { toolResult });
+                    processList.push(toolResult);
+                    modelInstance.appendMessages(messages, toolResult);
+                }
+            }
+            else if (content) {
+                processList.push(content);
+                finalMessage = content;
+            }
+            if (!didCallTool)
+                break;
+        }
+        const botResponse = {
+            process: processList.join("\n"),
+            response: finalMessage,
+        };
+        return botResponse;
+    }
+    /**
+     * Main entry point for processing user queries.
+     *
+     * Handles the complete query lifecycle:
+     * 1. Loads session history from memory
+     * 2. Detects intent from the query
+     * 3. Fulfills the intent with AI response
+     * 4. Updates conversation history
+     *
+     * @param query - The user's input query
+     * @param sessionId - Unique session identifier
+     * @returns Object containing the AI-generated response
+     */
+    async handleQuery(query, sessionId) {
+        // 1. Load session history with sessionId
+        const queryStartAt = Date.now();
+        const memoryInstance = this.memoryModule?.getMemory();
+        const sessionHistory = (await memoryInstance?.getSessionHistory(sessionId)) || { chats: {} } /* FIXME */;
+        // 2. intent triggering
+        const intent = this.intentTriggering(query);
+        // 3. intent fulfillment
+        const result = await this.intentFulfilling(query, sessionId, sessionHistory);
+        if (sessionId) {
+            await memoryInstance?.updateSessionHistory(sessionId, {
+                role: ChatRole.USER,
+                timestamp: queryStartAt,
+                content: { type: "text", parts: [query] },
+            });
+            await memoryInstance?.updateSessionHistory(sessionId, {
+                role: ChatRole.MODEL,
+                timestamp: Date.now(),
+                content: { type: "text", parts: [result.response] },
+            });
+        }
+        return { content: result.response };
+    }
+}
+//# sourceMappingURL=query.service.js.map

package/dist/esm/services/query.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.service.js","sourceRoot":"","sources":["../../../src/services/query.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/session/BaseSession.d.ts

@@ -0,0 +1,21 @@
+export declare enum ChatRole {
+    USER = "USER",
+    SYSTEM = "SYSTEM",
+    MODEL = "MODEL"
+}
+export type ContentObject = {
+    type: string;
+    parts: any[];
+};
+export type MessageObject = {
+    role: ChatRole;
+    content: ContentObject;
+    metadata?: any;
+};
+export type SessionObject = {
+    [messageId: string]: MessageObject;
+};
+export declare abstract class BaseSession {
+    abstract getSessionHistory(sessionId: string): SessionObject;
+}
+//# sourceMappingURL=BaseSession.d.ts.map

package/dist/esm/session/BaseSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSession.d.ts","sourceRoot":"","sources":["../../../src/session/BaseSession.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;CACf;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,EAAE,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,GAAG,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;CACnC,CAAC;AAEF,8BAAsB,WAAW;IAChC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;CAC5D"}

package/dist/esm/session/BaseSession.js

@@ -0,0 +1,9 @@
+export var ChatRole;
+(function (ChatRole) {
+    ChatRole["USER"] = "USER";
+    ChatRole["SYSTEM"] = "SYSTEM";
+    ChatRole["MODEL"] = "MODEL";
+})(ChatRole || (ChatRole = {}));
+export class BaseSession {
+}
+//# sourceMappingURL=BaseSession.js.map

package/dist/esm/session/BaseSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSession.js","sourceRoot":"","sources":["../../../src/session/BaseSession.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IACnB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB,2BAAe,CAAA;AAChB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAiBD,MAAM,OAAgB,WAAW;CAEhC"}

package/dist/esm/types/fol.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Represents a First-Order Logic (FOL) knowledge base structure.
+ *
+ * FOL is used for representing and reasoning about knowledge in the agent.
+ * This interface defines the structure for storing constants, predicates,
+ * and facts that make up the agent's knowledge representation.
+ *
+ * @example
+ * ```typescript
+ * const knowledge: Facts = {
+ *   constants: [
+ *     { name: "John", description: "A person named John" },
+ *     { name: "Mary", description: "A person named Mary" }
+ *   ],
+ *   predicates: [
+ *     { name: "likes", description: "Represents liking relationship" },
+ *     { name: "knows", description: "Represents knowing relationship" }
+ *   ],
+ *   facts: [
+ *     { name: "likes(John, Mary)", description: "John likes Mary" },
+ *     { name: "knows(Mary, John)", description: "Mary knows John" }
+ *   ]
+ * };
+ * ```
+ */
+export type FactElement = {
+    name: string;
+    description: string;
+};
+export type Facts = {
+    /** Constants represent individual objects or entities in the domain */
+    constants: FactElement[];
+    /** Predicates represent properties or relationships between constants */
+    predicates: FactElement[];
+    /** Facts are specific instances of predicates applied to constants */
+    facts: FactElement[];
+};
+//# sourceMappingURL=fol.d.ts.map

package/dist/esm/types/fol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fol.d.ts","sourceRoot":"","sources":["../../../src/types/fol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IACnB,uEAAuE;IACvE,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,yEAAyE;IACzE,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,sEAAsE;IACtE,KAAK,EAAE,WAAW,EAAE,CAAC;CACrB,CAAC"}

package/dist/esm/types/fol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fol.js.map

package/dist/esm/types/fol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fol.js","sourceRoot":"","sources":["../../../src/types/fol.ts"],"names":[],"mappings":""}

package/dist/esm/types/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Custom prompts configuration for the agent.
+ *
+ * Allows customization of agent behavior through system and agent-level prompts.
+ */
+export type AinAgentPrompts = {
+    /** Agent-level prompt that defines the agent's personality and behavior */
+    agent?: string;
+    /** System-level prompt that provides context and instructions */
+    system?: string;
+};
+/**
+ * Agent manifest containing essential metadata and configuration.
+ *
+ * The manifest defines the agent's identity, version, and optional configuration
+ * such as the public URL for A2A protocol support and custom prompts.
+ *
+ * @example
+ * ```typescript
+ * const manifest: AinAgentManifest = {
+ *   name: "CustomerSupportAgent",
+ *   description: "AI agent for handling customer support queries",
+ *   version: "1.0.0",
+ *   url: "https://api.example.com/agent",
+ *   prompts: {
+ *     system: "You are a helpful customer support assistant.",
+ *     agent: "Always be polite and provide detailed solutions."
+ *   }
+ * };
+ * ```
+ */
+export type AinAgentManifest = {
+    /** Unique name identifier for the agent */
+    name: string;
+    /** Human-readable description of the agent's purpose and capabilities */
+    description: string;
+    /** Semantic version of the agent (e.g., "1.0.0") */
+    version: string;
+    /** Optional public URL for A2A protocol discovery and communication */
+    url?: string;
+    /** Optional custom prompts to configure agent behavior */
+    prompts?: AinAgentPrompts;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC"}

package/dist/esm/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/esm/types/mcp.d.ts

@@ -0,0 +1,5 @@
+import type { StdioServerParameters } from "@modelcontextprotocol/sdk/client/stdio.js";
+export type MCPConfig = {
+    [name: string]: StdioServerParameters;
+};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/esm/types/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/types/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAEvF,MAAM,MAAM,SAAS,GAAG;IACvB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAC;CACtC,CAAC"}

package/dist/esm/types/mcp.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/esm/types/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/types/mcp.ts"],"names":[],"mappings":""}

package/dist/esm/types/memory.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Roles for participants in a chat conversation.
+ */
+export declare enum ChatRole {
+    /** User/human participant */
+    USER = "USER",
+    /** System-generated messages or instructions */
+    SYSTEM = "SYSTEM",
+    /** AI model responses */
+    MODEL = "MODEL"
+}
+/**
+ * Content structure for chat messages.
+ *
+ * Supports multi-part content with different types (text, images, etc.).
+ */
+export type ChatContentObject = {
+    /** Content type (e.g., "text", "image", "tool_use") */
+    type: string;
+    /** Array of content parts, structure depends on content type */
+    parts: any[];
+};
+/**
+ * Represents a single message in a chat conversation.
+ *
+ * @example
+ * ```typescript
+ * const message: ChatObject = {
+ *   role: ChatRole.USER,
+ *   content: {
+ *     type: "text",
+ *     parts: ["Hello, how can you help me?"]
+ *   },
+ *   timestamp: Date.now(),
+ *   metadata: { source: "web-ui" }
+ * };
+ * ```
+ */
+export type ChatObject = {
+    /** Role of the message sender */
+    role: ChatRole;
+    /** Message content with type and parts */
+    content: ChatContentObject;
+    /** Unix timestamp when the message was created */
+    timestamp: number;
+    /** Optional metadata for additional context */
+    metadata?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Represents a conversation session containing multiple chat messages.
+ *
+ * Messages are stored in a key-value structure where keys are unique chat IDs
+ * and values are the corresponding chat objects.
+ *
+ * @example
+ * ```typescript
+ * const session: SessionObject = {
+ *   chats: {
+ *     "<UUID_1>": { role: ChatRole.USER, content: {...}, timestamp: 1234567890 },
+ *     "<UUID_2>": { role: ChatRole.MODEL, content: {...}, timestamp: 1234567891 }
+ *   }
+ * };
+ * ```
+ */
+export type SessionObject = {
+    /** Collection of chat messages indexed by unique chat ID */
+    chats: {
+        [chatId: string]: ChatObject;
+    };
+};
+//# sourceMappingURL=memory.d.ts.map

package/dist/esm/types/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IACnB,6BAA6B;IAC7B,IAAI,SAAS;IACb,gDAAgD;IAChD,MAAM,WAAW;IACjB,yBAAyB;IACzB,KAAK,UAAU;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,GAAG,EAAE,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,iCAAiC;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,4DAA4D;IAC5D,KAAK,EAAE;QACN,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;KAC7B,CAAC;CACF,CAAC"}

package/dist/esm/types/memory.js

@@ -0,0 +1,13 @@
+/**
+ * Roles for participants in a chat conversation.
+ */
+export var ChatRole;
+(function (ChatRole) {
+    /** User/human participant */
+    ChatRole["USER"] = "USER";
+    /** System-generated messages or instructions */
+    ChatRole["SYSTEM"] = "SYSTEM";
+    /** AI model responses */
+    ChatRole["MODEL"] = "MODEL";
+})(ChatRole || (ChatRole = {}));
+//# sourceMappingURL=memory.js.map

package/dist/esm/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IACnB,6BAA6B;IAC7B,yBAAa,CAAA;IACb,gDAAgD;IAChD,6BAAiB,CAAA;IACjB,yBAAyB;IACzB,2BAAe,CAAA;AAChB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB"}