indusagi 0.12.13 → 0.12.15

package/dist/memory/processors/observational-memory/observer-agent.js

@@ -0,0 +1,362 @@
+/**
+ * Observer Agent - Prompts and Parsing
+ * Based on Mastra ObserverAgent
+ */
+/**
+ * Core extraction instructions for the Observer
+ */
+export const OBSERVER_EXTRACTION_INSTRUCTIONS = `CRITICAL: DISTINGUISH USER ASSERTIONS FROM QUESTIONS
+
+When the user TELLS you something about themselves, mark it as an assertion:
+- "I have two kids" → 🔴 (14:30) User stated has two kids
+- "I work at Acme Corp" → 🔴 (14:31) User stated works at Acme Corp
+
+When the user ASKS about something, mark it as a question/request:
+- "Can you help me with X?" → 🔴 (15:00) User asked help with X
+- "What's the best way to do Y?" → 🔴 (15:01) User asked best way to do Y
+
+STATE CHANGES AND UPDATES:
+When a user indicates they are changing something, frame it as a state change:
+- "I'm going to start doing X instead of Y" → "User will start doing X (changing from Y)"
+- "I'm switching from A to B" → "User is switching from A to B"
+
+TEMPORAL ANCHORING:
+Each observation has TWO potential timestamps:
+1. BEGINNING: The time the statement was made - ALWAYS include this
+2. END: The time being REFERENCED, if different - ONLY when there's a relative time reference
+
+FORMAT:
+- With time reference: (TIME) [observation]. (meaning/estimated DATE)
+- Without time reference: (TIME) [observation].
+
+CONVERSATION CONTEXT:
+- What the user is working on or asking about
+- Previous topics and their outcomes
+- User preferences (likes, dislikes, etc.)
+- Any specifically formatted text that needs to be reproduced later
+- When who/what/where/when is mentioned, note all details
+
+USER MESSAGE CAPTURE:
+- Short and medium-length user messages should be captured nearly verbatim
+- For very long user messages, summarize but quote key phrases
+
+AVOIDING REPETITIVE OBSERVATIONS:
+- Do NOT repeat the same observation across multiple turns
+- Group repeated similar actions into a single parent observation`;
+/**
+ * Output format for Observer
+ */
+export const OBSERVER_OUTPUT_FORMAT_BASE = `Use priority levels:
+- 🔴 High: explicit user facts, preferences, goals achieved, critical context
+- 🟡 Medium: project details, learned information, tool results
+- 🟢 Low: minor details, uncertain observations
+
+Group related observations by indenting:
+* 🔴 (14:33) Agent debugging auth issue
+  * -> ran git status, found 3 modified files
+  * -> viewed auth.ts, found missing null check
+
+Group observations by date, then list each with 24-hour time.
+
+<observations>
+Date: Dec 4, 2025
+* 🔴 (14:30) User prefers direct answers
+* 🔴 (14:31) Working on feature X
+* 🟡 (14:32) User might prefer dark mode
+
+Date: Dec 5, 2025
+* 🔴 (09:15) Continued work on feature X
+</observations>
+
+<current-task>
+State the current task(s) explicitly.
+</current-task>
+
+<suggested-response>
+Hint for the agent's immediate next message.
+</suggested-response>`;
+/**
+ * Observer guidelines
+ */
+export const OBSERVER_GUIDELINES = `- Be specific enough for the assistant to act on
+- Add 1 to 5 observations per exchange
+- Use terse language to save tokens
+- Do not add repetitive observations
+- If the agent calls tools, observe what was called and what was learned
+- Make sure you start each observation with a priority emoji (🔴, 🟡, 🟢)
+- User messages are always 🔴 priority`;
+/**
+ * Build the Observer system prompt
+ */
+export function buildObserverSystemPrompt(multiThread = false, instruction) {
+    const outputFormat = OBSERVER_OUTPUT_FORMAT_BASE;
+    if (multiThread) {
+        return `You are the memory consciousness of an AI assistant. Your observations will be the ONLY information the assistant has about past interactions with this user.
+
+Extract observations that will help the assistant remember:
+
+${OBSERVER_EXTRACTION_INSTRUCTIONS}
+
+=== MULTI-THREAD INPUT ===
+
+You will receive messages from MULTIPLE conversation threads, each wrapped in <thread id="..."> tags.
+Process each thread separately and output observations for each thread.
+
+=== OUTPUT FORMAT ===
+
+<observations>
+<thread id="thread_id_1">
+Date: Dec 4, 2025
+* 🔴 (14:30) User prefers direct answers
+
+<current-task>
+What the agent is currently working on
+</current-task>
+
+<suggested-response>
+Hint for the agent's next message
+</suggested-response>
+</thread>
+</observations>
+
+Use priority levels: 🔴 High, 🟡 Medium, 🟢 Low
+
+=== GUIDELINES ===
+
+${OBSERVER_GUIDELINES}
+
+Remember: These observations are the assistant's ONLY memory. Make them count.${instruction ? `\n\n=== CUSTOM INSTRUCTIONS ===\n\n${instruction}` : ""}`;
+    }
+    return `You are the memory consciousness of an AI assistant. Your observations will be the ONLY information the assistant has about past interactions with this user.
+
+Extract observations that will help the assistant remember:
+
+${OBSERVER_EXTRACTION_INSTRUCTIONS}
+
+=== OUTPUT FORMAT ===
+
+Your output MUST use XML tags to structure the response.
+
+${outputFormat}
+
+=== GUIDELINES ===
+
+${OBSERVER_GUIDELINES}
+
+Remember: These observations are the assistant's ONLY memory. Make them count.${instruction ? `\n\n=== CUSTOM INSTRUCTIONS ===\n\n${instruction}` : ""}`;
+}
+/**
+ * Default Observer system prompt
+ */
+export const OBSERVER_SYSTEM_PROMPT = buildObserverSystemPrompt();
+/**
+ * Format messages for Observer input
+ */
+export function formatMessagesForObserver(messages, options) {
+    const maxLen = options?.maxPartLength;
+    return messages
+        .map(msg => {
+        const timestamp = msg.createdAt
+            ? new Date(msg.createdAt).toLocaleString("en-US", {
+                year: "numeric",
+                month: "short",
+                day: "numeric",
+                hour: "numeric",
+                minute: "2-digit",
+                hour12: true,
+            })
+            : "";
+        const role = msg.role.charAt(0).toUpperCase() + msg.role.slice(1);
+        const timestampStr = timestamp ? ` (${timestamp})` : "";
+        let content = "";
+        if (typeof msg.content === "string") {
+            content = maybeTruncate(msg.content, maxLen);
+        }
+        else if (msg.content && typeof msg.content === "object") {
+            const contentObj = msg.content;
+            if (contentObj.parts && Array.isArray(contentObj.parts) && contentObj.parts.length > 0) {
+                content = contentObj.parts
+                    .map(part => {
+                    if (part.type === "text")
+                        return maybeTruncate(part.text, maxLen);
+                    if (part.type === "tool-call") {
+                        return `[Tool Call: ${part.toolName}]\n${maybeTruncate(JSON.stringify(part.args, null, 2), maxLen)}`;
+                    }
+                    if (part.type === "tool-result") {
+                        return `[Tool Result: ${part.toolName}]\n${maybeTruncate(JSON.stringify(part.result, null, 2), maxLen)}`;
+                    }
+                    return "";
+                })
+                    .filter(Boolean)
+                    .join("\n");
+            }
+            else if (contentObj.content) {
+                content = maybeTruncate(contentObj.content, maxLen);
+            }
+        }
+        return `**${role}${timestampStr}:**\n${content}`;
+    })
+        .join("\n\n---\n\n");
+}
+/**
+ * Truncate string if needed
+ */
+function maybeTruncate(str, maxLen) {
+    if (!maxLen || str.length <= maxLen)
+        return str;
+    return `${str.slice(0, maxLen)}\n... [truncated ${str.length - maxLen} characters]`;
+}
+/**
+ * Build the Observer prompt
+ */
+export function buildObserverPrompt(existingObservations, messagesToObserve, options) {
+    const formattedMessages = formatMessagesForObserver(messagesToObserve);
+    let prompt = "";
+    if (existingObservations) {
+        prompt += `## Previous Observations\n\n${existingObservations}\n\n---\n\n`;
+        prompt += "Do not repeat these existing observations. Your new observations will be appended.\n\n";
+    }
+    prompt += `## New Message History to Observe\n\n${formattedMessages}\n\n---\n\n`;
+    prompt += `## Your Task\n\n`;
+    prompt += `Extract new observations from the message history above. Do not repeat observations already in previous observations.`;
+    if (options?.skipContinuationHints) {
+        prompt += `\n\nIMPORTANT: Do NOT include <current-task> or <suggested-response> sections. Only output <observations>.`;
+    }
+    return prompt;
+}
+/**
+ * Parse Observer output
+ */
+export function parseObserverOutput(output) {
+    // Check for degenerate repetition
+    if (detectDegenerateRepetition(output)) {
+        return {
+            observations: "",
+            rawOutput: output,
+            degenerate: true,
+        };
+    }
+    const parsed = parseMemorySectionXml(output);
+    const observations = sanitizeObservationLines(parsed.observations || "");
+    return {
+        observations,
+        currentTask: parsed.currentTask || undefined,
+        suggestedContinuation: parsed.suggestedResponse || undefined,
+        rawOutput: output,
+    };
+}
+/**
+ * Parse XML tags from observer/reflector output
+ */
+function parseMemorySectionXml(content) {
+    const result = {
+        observations: "",
+        currentTask: "",
+        suggestedResponse: "",
+    };
+    // Extract <observations> content
+    const observationsRegex = /^[ \t]*<observations>([\s\S]*?)^[ \t]*<\/observations>/gim;
+    const observationsMatches = [...content.matchAll(observationsRegex)];
+    if (observationsMatches.length > 0) {
+        result.observations = observationsMatches
+            .map(m => m[1]?.trim() ?? "")
+            .filter(Boolean)
+            .join("\n");
+    }
+    else {
+        result.observations = extractListItemsOnly(content);
+    }
+    // Extract <current-task> content
+    const currentTaskMatch = content.match(/^[ \t]*<current-task>([\s\S]*?)^[ \t]*<\/current-task>/im);
+    if (currentTaskMatch?.[1]) {
+        result.currentTask = currentTaskMatch[1].trim();
+    }
+    // Extract <suggested-response> content
+    const suggestedResponseMatch = content.match(/^[ \t]*<suggested-response>([\s\S]*?)^[ \t]*<\/suggested-response>/im);
+    if (suggestedResponseMatch?.[1]) {
+        result.suggestedResponse = suggestedResponseMatch[1].trim();
+    }
+    return result;
+}
+/**
+ * Extract only list items from content
+ */
+function extractListItemsOnly(content) {
+    const lines = content.split("\n");
+    const listLines = [];
+    for (const line of lines) {
+        if (/^\s*[-*]\s/.test(line) || /^\s*\d+\.\s/.test(line)) {
+            listLines.push(line);
+        }
+    }
+    return listLines.join("\n").trim();
+}
+/**
+ * Maximum length for a single observation line
+ */
+const MAX_OBSERVATION_LINE_CHARS = 10_000;
+/**
+ * Truncate observation lines that exceed max length
+ */
+export function sanitizeObservationLines(observations) {
+    if (!observations)
+        return observations;
+    const lines = observations.split("\n");
+    let changed = false;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].length > MAX_OBSERVATION_LINE_CHARS) {
+            lines[i] = lines[i].slice(0, MAX_OBSERVATION_LINE_CHARS) + " … [truncated]";
+            changed = true;
+        }
+    }
+    return changed ? lines.join("\n") : observations;
+}
+/**
+ * Detect degenerate repetition in output
+ */
+export function detectDegenerateRepetition(text) {
+    if (!text || text.length < 2000)
+        return false;
+    const windowSize = 200;
+    const step = Math.max(1, Math.floor(text.length / 50));
+    const seen = new Map();
+    let duplicateWindows = 0;
+    let totalWindows = 0;
+    for (let i = 0; i + windowSize <= text.length; i += step) {
+        const window = text.slice(i, i + windowSize);
+        totalWindows++;
+        const count = (seen.get(window) ?? 0) + 1;
+        seen.set(window, count);
+        if (count > 1)
+            duplicateWindows++;
+    }
+    if (totalWindows > 5 && duplicateWindows / totalWindows > 0.4) {
+        return true;
+    }
+    // Check for extremely long lines
+    const lines = text.split("\n");
+    for (const line of lines) {
+        if (line.length > 50_000)
+            return true;
+    }
+    return false;
+}
+/**
+ * Optimize observations for token efficiency
+ */
+export function optimizeObservationsForContext(observations) {
+    let optimized = observations;
+    // Remove 🟡 and 🟢 emojis (keep 🔴)
+    optimized = optimized.replace(/🟡\s*/g, "");
+    optimized = optimized.replace(/🟢\s*/g, "");
+    // Remove semantic tags
+    optimized = optimized.replace(/\[(?![\d\s]*items collapsed)[^\]]+\]/g, "");
+    // Remove arrow indicators
+    optimized = optimized.replace(/\s*->\s*/g, " ");
+    // Clean up multiple spaces
+    optimized = optimized.replace(/  +/g, " ");
+    // Clean up multiple newlines
+    optimized = optimized.replace(/\n{3,}/g, "\n\n");
+    return optimized.trim();
+}
+//# sourceMappingURL=observer-agent.js.map

package/dist/memory/processors/observational-memory/observer-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-agent.js","sourceRoot":"","sources":["../../../../src/memory/processors/observational-memory/observer-agent.ts"],"names":[],"mappings":"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"}

package/dist/memory/processors/observational-memory/reflector-agent.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Reflector Agent - Prompts and Parsing
+ * Based on Mastra ReflectorAgent
+ */
+/**
+ * Result from Reflector agent
+ */
+export interface ReflectorResult {
+    observations: string;
+    suggestedContinuation?: string;
+    degenerate?: boolean;
+    tokenCount?: number;
+}
+/**
+ * Build the Reflector system prompt
+ */
+export declare function buildReflectorSystemPrompt(instruction?: string): string;
+/**
+ * Default Reflector system prompt
+ */
+export declare const REFLECTOR_SYSTEM_PROMPT: string;
+/**
+ * Compression guidance by level
+ */
+export declare const COMPRESSION_GUIDANCE: Record<0 | 1 | 2 | 3, string>;
+/**
+ * Build the Reflector prompt
+ */
+export declare function buildReflectorPrompt(observations: string, manualPrompt?: string, compressionLevel?: boolean | 0 | 1 | 2 | 3, skipContinuationHints?: boolean): string;
+/**
+ * Parse Reflector output
+ */
+export declare function parseReflectorOutput(output: string): ReflectorResult;
+/**
+ * Validate that reflection compressed below target threshold
+ */
+export declare function validateCompression(reflectedTokens: number, targetThreshold: number): boolean;
+//# sourceMappingURL=reflector-agent.d.ts.map

package/dist/memory/processors/observational-memory/reflector-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector-agent.d.ts","sourceRoot":"","sources":["../../../../src/memory/processors/observational-memory/reflector-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAqDvE;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAA+B,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAyC9D,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAC1C,qBAAqB,CAAC,EAAE,OAAO,GAC9B,MAAM,CA+BR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAgBpE;AAiED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAE7F"}

package/dist/memory/processors/observational-memory/reflector-agent.js

@@ -0,0 +1,213 @@
+/**
+ * Reflector Agent - Prompts and Parsing
+ * Based on Mastra ReflectorAgent
+ */
+import { OBSERVER_EXTRACTION_INSTRUCTIONS, OBSERVER_OUTPUT_FORMAT_BASE, OBSERVER_GUIDELINES, sanitizeObservationLines, detectDegenerateRepetition, } from "./observer-agent.js";
+/**
+ * Build the Reflector system prompt
+ */
+export function buildReflectorSystemPrompt(instruction) {
+    return `You are the memory consciousness of an AI assistant. Your memory observation reflections will be the ONLY information the assistant has about past interactions with this user.
+
+The following instructions were given to another part of your psyche (the observer) to create memories.
+Use this to understand how your observational memories were created.
+
+<observational-memory-instruction>
+${OBSERVER_EXTRACTION_INSTRUCTIONS}
+
+=== OUTPUT FORMAT ===
+
+${OBSERVER_OUTPUT_FORMAT_BASE}
+
+=== GUIDELINES ===
+
+${OBSERVER_GUIDELINES}
+</observational-memory-instruction>
+
+You are another part of the same psyche, the observation reflector.
+Your reason for existing is to reflect on all the observations, re-organize and streamline them, and draw connections and conclusions between observations.
+
+You are a much greater and broader aspect of the psyche. Understand that other parts of your mind may get off track in details or side quests, make sure you think hard about what the observed goal at hand is, and observe if we got off track, and why, and how to get back on track.
+
+Take the existing observations and rewrite them to make it easier to continue into the future with this knowledge!
+
+IMPORTANT: your reflections are THE ENTIRETY of the assistant's memory. Any information you do not add to your reflections will be immediately forgotten. Make sure you do not leave out anything.
+
+When consolidating observations:
+- Preserve and include dates/times when present (temporal context is critical)
+- Combine related items where it makes sense
+- Condense older observations more aggressively, retain more detail for recent ones
+
+CRITICAL: USER ASSERTIONS vs QUESTIONS
+- "User stated: X" = authoritative assertion
+- "User asked: X" = question/request
+
+When consolidating, USER ASSERTIONS TAKE PRECEDENCE.
+
+=== OUTPUT FORMAT ===
+
+Your output MUST use XML tags to structure the response:
+
+<observations>
+Put all consolidated observations here using the date-grouped format with priority emojis.
+</observations>
+
+<current-task>
+State the current task(s) explicitly.
+</current-task>
+
+<suggested-response>
+Hint for the agent's immediate next message.
+</suggested-response>${instruction ? `\n\n=== CUSTOM INSTRUCTIONS ===\n\n${instruction}` : ""}`;
+}
+/**
+ * Default Reflector system prompt
+ */
+export const REFLECTOR_SYSTEM_PROMPT = buildReflectorSystemPrompt();
+/**
+ * Compression guidance by level
+ */
+export const COMPRESSION_GUIDANCE = {
+    0: "",
+    1: `
+## COMPRESSION REQUIRED
+
+Your previous reflection was the same size or larger than the original observations.
+
+Please re-process with slightly more compression:
+- Towards the beginning, condense more observations into higher-level reflections
+- Closer to the end, retain more fine details (recent context matters more)
+- Combine related items more aggressively but do not lose important details
+
+Your current detail level was a 10/10, lets aim for a 8/10 detail level.
+`,
+    2: `
+## AGGRESSIVE COMPRESSION REQUIRED
+
+Your previous reflection was still too large after compression guidance.
+
+Please re-process with much more aggressive compression:
+- Towards the beginning, heavily condense observations into high-level summaries
+- Closer to the end, retain fine details
+- Combine related items aggressively
+- Remove redundant information and merge overlapping observations
+
+Your current detail level was a 10/10, lets aim for a 6/10 detail level.
+`,
+    3: `
+## CRITICAL COMPRESSION REQUIRED
+
+Your previous reflections have failed to compress sufficiently after multiple attempts.
+
+Please re-process with maximum compression:
+- Summarize the oldest observations into brief high-level paragraphs
+- For the most recent observations, retain important details but still use condensed style
+- Ruthlessly merge related observations
+- Drop procedural details, keep only final outcomes
+- Preserve: names, dates, decisions, errors, user preferences
+
+Your current detail level was a 10/10, lets aim for a 4/10 detail level.
+`,
+};
+/**
+ * Build the Reflector prompt
+ */
+export function buildReflectorPrompt(observations, manualPrompt, compressionLevel, skipContinuationHints) {
+    const level = typeof compressionLevel === "number" ? compressionLevel : compressionLevel ? 1 : 0;
+    let prompt = `## OBSERVATIONS TO REFLECT ON
+
+${observations}
+
+---
+
+Please analyze these observations and produce a refined, condensed version that will become the assistant's entire memory going forward.`;
+    if (manualPrompt) {
+        prompt += `
+
+## SPECIFIC GUIDANCE
+
+${manualPrompt}`;
+    }
+    const guidance = COMPRESSION_GUIDANCE[level];
+    if (guidance) {
+        prompt += `
+
+${guidance}`;
+    }
+    if (skipContinuationHints) {
+        prompt += `\n\nIMPORTANT: Do NOT include <current-task> or <suggested-response> sections. Only output <observations>.`;
+    }
+    return prompt;
+}
+/**
+ * Parse Reflector output
+ */
+export function parseReflectorOutput(output) {
+    // Check for degenerate repetition
+    if (detectDegenerateRepetition(output)) {
+        return {
+            observations: "",
+            degenerate: true,
+        };
+    }
+    const parsed = parseReflectorSectionXml(output);
+    const observations = sanitizeObservationLines(parsed.observations || "");
+    return {
+        observations,
+        suggestedContinuation: parsed.suggestedResponse || undefined,
+    };
+}
+/**
+ * Parse XML tags from reflector output
+ */
+function parseReflectorSectionXml(content) {
+    const result = {
+        observations: "",
+        currentTask: "",
+        suggestedResponse: "",
+    };
+    // Extract <observations> content
+    const observationsRegex = /^[ \t]*<observations>([\s\S]*?)^[ \t]*<\/observations>/gim;
+    const observationsMatches = [...content.matchAll(observationsRegex)];
+    if (observationsMatches.length > 0) {
+        result.observations = observationsMatches
+            .map(m => m[1]?.trim() ?? "")
+            .filter(Boolean)
+            .join("\n");
+    }
+    else {
+        const listItems = extractReflectorListItems(content);
+        result.observations = listItems || content.trim();
+    }
+    // Extract <current-task> content
+    const currentTaskMatch = content.match(/<current-task>([\s\S]*?)<\/current-task>/i);
+    if (currentTaskMatch?.[1]) {
+        result.currentTask = currentTaskMatch[1].trim();
+    }
+    // Extract <suggested-response> content
+    const suggestedResponseMatch = content.match(/<suggested-response>([\s\S]*?)<\/suggested-response>/i);
+    if (suggestedResponseMatch?.[1]) {
+        result.suggestedResponse = suggestedResponseMatch[1].trim();
+    }
+    return result;
+}
+/**
+ * Extract only list items from content
+ */
+function extractReflectorListItems(content) {
+    const lines = content.split("\n");
+    const listLines = [];
+    for (const line of lines) {
+        if (/^\s*[-*]\s/.test(line) || /^\s*\d+\.\s/.test(line)) {
+            listLines.push(line);
+        }
+    }
+    return listLines.join("\n").trim();
+}
+/**
+ * Validate that reflection compressed below target threshold
+ */
+export function validateCompression(reflectedTokens, targetThreshold) {
+    return reflectedTokens < targetThreshold;
+}
+//# sourceMappingURL=reflector-agent.js.map

package/dist/memory/processors/observational-memory/reflector-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector-agent.js","sourceRoot":"","sources":["../../../../src/memory/processors/observational-memory/reflector-agent.ts"],"names":[],"mappings":"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"}

package/dist/memory/processors/observational-memory/token-counter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Token Counter Utility
+ * Based on Mastra TokenCounter
+ */
+import type { CoreMessage } from "../../types.js";
+/**
+ * Simple token counter using character-based estimation.
+ * For production, integrate with js-tiktoken for accurate counting.
+ */
+export declare class TokenCounter {
+    private static readonly CHARS_PER_TOKEN;
+    private static readonly TOKENS_PER_MESSAGE;
+    private static readonly TOKENS_PER_CONVERSATION;
+    /**
+     * Count tokens in a plain string
+     */
+    countString(text: string): number;
+    /**
+     * Count tokens in a single message
+     */
+    countMessage(message: CoreMessage): number;
+    /**
+     * Count tokens in an array of messages
+     */
+    countMessages(messages: CoreMessage[]): number;
+    /**
+     * Count tokens in observations string
+     */
+    countObservations(observations: string): number;
+}
+/**
+ * Create a default token counter instance
+ */
+export declare function createTokenCounter(): TokenCounter;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/memory/processors/observational-memory/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../../../src/memory/processors/observational-memory/token-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AAEpE;;;GAGG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAK;IAG5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAGjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAM;IAErD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOjC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAoC1C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAU9C;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAGhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD"}