Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 | 2x 2x 2x 2x 2x 2x 2x 2x 2x 2x 2x 2x 1x 13x 13x 13x 13x 13x 13x 13x 13x 2x 2x 2x 2x 2x 2x 13x 13x 48x 48x 48x 48x 48x 48x 13x 6x 6x 2x 2x 6x 1x 1x 6x 6x 6x 13x 1x 1x 13x 1x 1x 1x 13x 13x 13x 2x 1x 2x 13x 13x 13x 2x 2x 13x 1x 1x 13x 1x 1x 1x 1x 13x 13x | /**
* AgentKits — Agent Memory Module
*
* Conversation memory management for agent loops.
* Short-term buffer, long-term key-value store, auto-summarization.
*
* Usage:
* import { createMemory } from 'agentkits/agent-memory';
* const memory = createMemory({ maxMessages: 20 });
* memory.addMessage({ role: 'user', content: 'Hello' });
* const context = memory.getMessages();
*/
// ── Types ──────────────────────────────────────────────────────────
export interface MemoryMessage {
role: 'system' | 'user' | 'assistant';
content: string;
timestamp?: number;
}
export interface MemoryConfig {
/** Max messages in short-term buffer before summarization (default: 50) */
maxMessages?: number;
/** Enable auto-summarization when buffer exceeds maxMessages (default: false) */
autoSummarize?: boolean;
/** Summary function — called when buffer overflows */
summarizer?: (messages: MemoryMessage[]) => Promise<string>;
/** System prompt to always prepend */
systemPrompt?: string;
}
export interface MemoryClient {
/** Add a message to conversation buffer */
addMessage(msg: MemoryMessage): void;
/** Get current conversation messages (with system prompt if set) */
getMessages(): MemoryMessage[];
/** Get a subset of recent messages */
getRecent(n: number): MemoryMessage[];
/** Clear conversation buffer */
clear(): void;
/** Get/set long-term key-value memory */
get(key: string): string | undefined;
set(key: string, value: string): void;
delete(key: string): boolean;
keys(): string[];
/** Get summary of older conversations */
getSummary(): string | undefined;
/** Force summarization of current buffer */
summarize(): Promise<string>;
/** Export full state */
export(): MemoryState;
/** Import state */
import(state: MemoryState): void;
}
export interface MemoryState {
messages: MemoryMessage[];
kvStore: Record<string, string>;
summary?: string;
}
// ── Default summarizer ─────────────────────────────────────────────
function defaultSummarizer(messages: MemoryMessage[]): Promise<string> {
// Simple extractive summary — take first line of each assistant message
const points = messages
.filter(m => m.role === 'assistant')
.map(m => m.content.split('\n')[0])
.slice(-5);
const userTopics = messages
.filter(m => m.role === 'user')
.map(m => m.content.slice(0, 100))
.slice(-5);
const summary = `Previous conversation summary:\nTopics discussed: ${userTopics.join('; ')}\nKey points: ${points.join('; ')}`;
return Promise.resolve(summary);
}
// ── Factory ────────────────────────────────────────────────────────
export function createMemory(config: MemoryConfig = {}): MemoryClient {
const maxMessages = config.maxMessages ?? 50;
const autoSummarize = config.autoSummarize ?? false;
const summarizer = config.summarizer ?? defaultSummarizer;
const systemPrompt = config.systemPrompt;
let messages: MemoryMessage[] = [];
let kvStore: Record<string, string> = {};
let summary: string | undefined;
async function doSummarize(): Promise<string> {
// Summarize oldest half of messages
const half = Math.floor(messages.length / 2);
const toSummarize = messages.slice(0, half);
summary = await summarizer(toSummarize);
messages = messages.slice(half);
return summary;
}
return {
addMessage(msg) {
messages.push({
...msg,
timestamp: msg.timestamp ?? Date.now(),
});
if (autoSummarize && messages.length > maxMessages) {
// Fire and forget summarization
doSummarize().catch(() => {});
}
},
getMessages() {
const result: MemoryMessage[] = [];
if (systemPrompt) {
result.push({ role: 'system', content: systemPrompt });
}
if (summary) {
result.push({ role: 'system', content: summary });
}
result.push(...messages);
return result;
},
getRecent(n) {
return messages.slice(-n);
},
clear() {
messages = [];
summary = undefined;
},
get(key) { return kvStore[key]; },
set(key, value) { kvStore[key] = value; },
delete(key) {
if (key in kvStore) { delete kvStore[key]; return true; }
return false;
},
keys() { return Object.keys(kvStore); },
getSummary() { return summary; },
async summarize() {
return doSummarize();
},
export() {
return { messages: [...messages], kvStore: { ...kvStore }, summary };
},
import(state) {
messages = [...state.messages];
kvStore = { ...state.kvStore };
summary = state.summary;
},
};
}
|