@mastra/memory 0.12.0-alpha.3 → 0.12.1-alpha.0

package/dist/_tsup-dts-rollup.d.cts

@@ -1,212 +0,0 @@
-import type { CoreMessage } from 'ai';
-import type { CoreMessage as CoreMessage_2 } from '@mastra/core';
-import type { CoreTool } from '@mastra/core';
-import { embedMany } from 'ai';
-import { MastraMemory } from '@mastra/core/memory';
-import type { MastraMessageV1 } from '@mastra/core';
-import type { MastraMessageV2 } from '@mastra/core/agent';
-import type { MemoryConfig } from '@mastra/core/memory';
-import type { MemoryConfig as MemoryConfig_2 } from '@mastra/core';
-import { MemoryProcessor } from '@mastra/core/memory';
-import { MemoryProcessor as MemoryProcessor_2 } from '@mastra/core';
-import type { MemoryProcessorOpts } from '@mastra/core';
-import type { SharedMemoryConfig } from '@mastra/core/memory';
-import type { StorageGetMessagesArg } from '@mastra/core/storage';
-import type { StorageThreadType } from '@mastra/core/memory';
-import type { ThreadSortOptions } from '@mastra/core/storage';
-import type { TiktokenBPE } from 'js-tiktoken/lite';
-import type { UIMessageWithMetadata } from '@mastra/core/agent';
-import type { WorkingMemoryTemplate } from '@mastra/core/memory';
-
-export declare const __experimental_updateWorkingMemoryToolVNext: (config: MemoryConfig_2) => CoreTool;
-
-/**
- * Concrete implementation of MastraMemory that adds support for thread configuration
- * and message injection.
- */
-export declare class Memory extends MastraMemory {
-    constructor(config?: SharedMemoryConfig);
-    protected validateThreadIsOwnedByResource(threadId: string, resourceId: string): Promise<void>;
-    protected checkStorageFeatureSupport(config: MemoryConfig): void;
-    query({ threadId, resourceId, selectBy, threadConfig, }: StorageGetMessagesArg & {
-        threadConfig?: MemoryConfig;
-    }): Promise<{
-        messages: CoreMessage[];
-        uiMessages: UIMessageWithMetadata[];
-        messagesV2: MastraMessageV2[];
-    }>;
-    rememberMessages({ threadId, resourceId, vectorMessageSearch, config, }: {
-        threadId: string;
-        resourceId?: string;
-        vectorMessageSearch?: string;
-        config?: MemoryConfig;
-    }): Promise<{
-        messages: MastraMessageV1[];
-        messagesV2: MastraMessageV2[];
-    }>;
-    getThreadById({ threadId }: {
-        threadId: string;
-    }): Promise<StorageThreadType | null>;
-    getThreadsByResourceId({ resourceId, orderBy, sortDirection, }: {
-        resourceId: string;
-    } & ThreadSortOptions): Promise<StorageThreadType[]>;
-    saveThread({ thread }: {
-        thread: StorageThreadType;
-        memoryConfig?: MemoryConfig;
-    }): Promise<StorageThreadType>;
-    updateThread({ id, title, metadata, }: {
-        id: string;
-        title: string;
-        metadata: Record<string, unknown>;
-    }): Promise<StorageThreadType>;
-    deleteThread(threadId: string): Promise<void>;
-    updateWorkingMemory({ threadId, resourceId, workingMemory, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        workingMemory: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<void>;
-    private updateWorkingMemoryMutexes;
-    /**
-     * @warning experimental! can be removed or changed at any time
-     */
-    __experimental_updateWorkingMemoryVNext({ threadId, resourceId, workingMemory, searchString, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        workingMemory: string;
-        searchString?: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<{
-        success: boolean;
-        reason: string;
-    }>;
-    protected chunkText(text: string, tokenSize?: number): string[];
-    private hasher;
-    private embeddingCache;
-    private firstEmbed;
-    protected embedMessageContent(content: string): Promise<{
-        chunks: string[];
-        embeddings: Awaited<ReturnType<typeof embedMany>>["embeddings"];
-        dimension: number | undefined;
-    }>;
-    saveMessages(args: {
-        messages: (MastraMessageV1 | MastraMessageV2)[] | MastraMessageV1[] | MastraMessageV2[];
-        memoryConfig?: MemoryConfig | undefined;
-        format?: 'v1';
-    }): Promise<MastraMessageV1[]>;
-    saveMessages(args: {
-        messages: (MastraMessageV1 | MastraMessageV2)[] | MastraMessageV1[] | MastraMessageV2[];
-        memoryConfig?: MemoryConfig | undefined;
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    protected updateMessageToHideWorkingMemory(message: MastraMessageV1): MastraMessageV1 | null;
-    protected updateMessageToHideWorkingMemoryV2(message: MastraMessageV2): MastraMessageV2 | null;
-    protected parseWorkingMemory(text: string): string | null;
-    getWorkingMemory({ threadId, resourceId, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<string | null>;
-    /**
-     * Gets the working memory template for the current memory configuration.
-     * Supports both ZodObject and JSONSchema7 schemas.
-     *
-     * @param memoryConfig - The memory configuration containing the working memory settings
-     * @returns The working memory template with format and content, or null if working memory is disabled
-     */
-    getWorkingMemoryTemplate({ memoryConfig, }: {
-        memoryConfig?: MemoryConfig;
-    }): Promise<WorkingMemoryTemplate | null>;
-    getSystemMessage({ threadId, resourceId, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<string | null>;
-    defaultWorkingMemoryTemplate: string;
-    protected getWorkingMemoryToolInstruction({ template, data, }: {
-        template: WorkingMemoryTemplate;
-        data: string | null;
-    }): string;
-    protected __experimental_getWorkingMemoryToolInstructionVNext({ template, data, }: {
-        template: WorkingMemoryTemplate;
-        data: string | null;
-    }): string;
-    private isVNextWorkingMemoryConfig;
-    getTools(config?: MemoryConfig): Record<string, CoreTool>;
-    /**
-     * Updates the metadata of a list of messages
-     * @param messages - The list of messages to update
-     * @returns The list of updated messages
-     */
-    updateMessages({ messages, }: {
-        messages: Partial<MastraMessageV2> & {
-            id: string;
-        }[];
-    }): Promise<MastraMessageV2[]>;
-    /**
-     * Deletes one or more messages
-     * @param input - Must be an array containing either:
-     *   - Message ID strings
-     *   - Message objects with 'id' properties
-     * @returns Promise that resolves when all messages are deleted
-     */
-    deleteMessages(input: MessageDeleteInput): Promise<void>;
-}
-
-export declare type MessageDeleteInput = string[] | {
-    id: string;
-}[];
-
-/**
- * Limits the total number of tokens in the messages.
- * Uses js-tiktoken with o200k_base encoding by default for accurate token counting with modern models.
- */
-declare class TokenLimiter extends MemoryProcessor {
-    private encoder;
-    private maxTokens;
-    TOKENS_PER_MESSAGE: number;
-    TOKENS_PER_CONVERSATION: number;
-    /**
-     * Create a token limiter for messages.
-     * @param options Either a number (token limit) or a configuration object
-     */
-    constructor(options: number | TokenLimiterOptions);
-    process(messages: CoreMessage_2[], { systemMessage, memorySystemMessage, newMessages }?: MemoryProcessorOpts): CoreMessage_2[];
-    countTokens(message: string | CoreMessage_2): number;
-}
-export { TokenLimiter }
-export { TokenLimiter as TokenLimiter_alias_1 }
-
-/**
- * Configuration options for TokenLimiter
- */
-declare interface TokenLimiterOptions {
-    /** Maximum number of tokens to allow */
-    limit: number;
-    /** Optional encoding to use (defaults to o200k_base which is used by gpt-4o) */
-    encoding?: TiktokenBPE;
-}
-
-/**
- * Filters out tool calls and results from messages.
- * By default (with no arguments), excludes all tool calls and their results.
- * Can be configured to exclude only specific tools by name.
- */
-declare class ToolCallFilter extends MemoryProcessor_2 {
-    private exclude;
-    /**
-     * Create a filter for tool calls and results.
-     * @param options Configuration options
-     * @param options.exclude List of specific tool names to exclude. If not provided, all tool calls are excluded.
-     */
-    constructor(options?: {
-        exclude?: string[];
-    });
-    process(messages: CoreMessage_2[]): CoreMessage_2[];
-}
-export { ToolCallFilter }
-export { ToolCallFilter as ToolCallFilter_alias_1 }
-
-export declare const updateWorkingMemoryTool: (memoryConfig?: MemoryConfig_2) => CoreTool;
-
-export { }

package/dist/_tsup-dts-rollup.d.ts

@@ -1,212 +0,0 @@
-import type { CoreMessage } from 'ai';
-import type { CoreMessage as CoreMessage_2 } from '@mastra/core';
-import type { CoreTool } from '@mastra/core';
-import { embedMany } from 'ai';
-import { MastraMemory } from '@mastra/core/memory';
-import type { MastraMessageV1 } from '@mastra/core';
-import type { MastraMessageV2 } from '@mastra/core/agent';
-import type { MemoryConfig } from '@mastra/core/memory';
-import type { MemoryConfig as MemoryConfig_2 } from '@mastra/core';
-import { MemoryProcessor } from '@mastra/core/memory';
-import { MemoryProcessor as MemoryProcessor_2 } from '@mastra/core';
-import type { MemoryProcessorOpts } from '@mastra/core';
-import type { SharedMemoryConfig } from '@mastra/core/memory';
-import type { StorageGetMessagesArg } from '@mastra/core/storage';
-import type { StorageThreadType } from '@mastra/core/memory';
-import type { ThreadSortOptions } from '@mastra/core/storage';
-import type { TiktokenBPE } from 'js-tiktoken/lite';
-import type { UIMessageWithMetadata } from '@mastra/core/agent';
-import type { WorkingMemoryTemplate } from '@mastra/core/memory';
-
-export declare const __experimental_updateWorkingMemoryToolVNext: (config: MemoryConfig_2) => CoreTool;
-
-/**
- * Concrete implementation of MastraMemory that adds support for thread configuration
- * and message injection.
- */
-export declare class Memory extends MastraMemory {
-    constructor(config?: SharedMemoryConfig);
-    protected validateThreadIsOwnedByResource(threadId: string, resourceId: string): Promise<void>;
-    protected checkStorageFeatureSupport(config: MemoryConfig): void;
-    query({ threadId, resourceId, selectBy, threadConfig, }: StorageGetMessagesArg & {
-        threadConfig?: MemoryConfig;
-    }): Promise<{
-        messages: CoreMessage[];
-        uiMessages: UIMessageWithMetadata[];
-        messagesV2: MastraMessageV2[];
-    }>;
-    rememberMessages({ threadId, resourceId, vectorMessageSearch, config, }: {
-        threadId: string;
-        resourceId?: string;
-        vectorMessageSearch?: string;
-        config?: MemoryConfig;
-    }): Promise<{
-        messages: MastraMessageV1[];
-        messagesV2: MastraMessageV2[];
-    }>;
-    getThreadById({ threadId }: {
-        threadId: string;
-    }): Promise<StorageThreadType | null>;
-    getThreadsByResourceId({ resourceId, orderBy, sortDirection, }: {
-        resourceId: string;
-    } & ThreadSortOptions): Promise<StorageThreadType[]>;
-    saveThread({ thread }: {
-        thread: StorageThreadType;
-        memoryConfig?: MemoryConfig;
-    }): Promise<StorageThreadType>;
-    updateThread({ id, title, metadata, }: {
-        id: string;
-        title: string;
-        metadata: Record<string, unknown>;
-    }): Promise<StorageThreadType>;
-    deleteThread(threadId: string): Promise<void>;
-    updateWorkingMemory({ threadId, resourceId, workingMemory, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        workingMemory: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<void>;
-    private updateWorkingMemoryMutexes;
-    /**
-     * @warning experimental! can be removed or changed at any time
-     */
-    __experimental_updateWorkingMemoryVNext({ threadId, resourceId, workingMemory, searchString, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        workingMemory: string;
-        searchString?: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<{
-        success: boolean;
-        reason: string;
-    }>;
-    protected chunkText(text: string, tokenSize?: number): string[];
-    private hasher;
-    private embeddingCache;
-    private firstEmbed;
-    protected embedMessageContent(content: string): Promise<{
-        chunks: string[];
-        embeddings: Awaited<ReturnType<typeof embedMany>>["embeddings"];
-        dimension: number | undefined;
-    }>;
-    saveMessages(args: {
-        messages: (MastraMessageV1 | MastraMessageV2)[] | MastraMessageV1[] | MastraMessageV2[];
-        memoryConfig?: MemoryConfig | undefined;
-        format?: 'v1';
-    }): Promise<MastraMessageV1[]>;
-    saveMessages(args: {
-        messages: (MastraMessageV1 | MastraMessageV2)[] | MastraMessageV1[] | MastraMessageV2[];
-        memoryConfig?: MemoryConfig | undefined;
-        format: 'v2';
-    }): Promise<MastraMessageV2[]>;
-    protected updateMessageToHideWorkingMemory(message: MastraMessageV1): MastraMessageV1 | null;
-    protected updateMessageToHideWorkingMemoryV2(message: MastraMessageV2): MastraMessageV2 | null;
-    protected parseWorkingMemory(text: string): string | null;
-    getWorkingMemory({ threadId, resourceId, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<string | null>;
-    /**
-     * Gets the working memory template for the current memory configuration.
-     * Supports both ZodObject and JSONSchema7 schemas.
-     *
-     * @param memoryConfig - The memory configuration containing the working memory settings
-     * @returns The working memory template with format and content, or null if working memory is disabled
-     */
-    getWorkingMemoryTemplate({ memoryConfig, }: {
-        memoryConfig?: MemoryConfig;
-    }): Promise<WorkingMemoryTemplate | null>;
-    getSystemMessage({ threadId, resourceId, memoryConfig, }: {
-        threadId: string;
-        resourceId?: string;
-        memoryConfig?: MemoryConfig;
-    }): Promise<string | null>;
-    defaultWorkingMemoryTemplate: string;
-    protected getWorkingMemoryToolInstruction({ template, data, }: {
-        template: WorkingMemoryTemplate;
-        data: string | null;
-    }): string;
-    protected __experimental_getWorkingMemoryToolInstructionVNext({ template, data, }: {
-        template: WorkingMemoryTemplate;
-        data: string | null;
-    }): string;
-    private isVNextWorkingMemoryConfig;
-    getTools(config?: MemoryConfig): Record<string, CoreTool>;
-    /**
-     * Updates the metadata of a list of messages
-     * @param messages - The list of messages to update
-     * @returns The list of updated messages
-     */
-    updateMessages({ messages, }: {
-        messages: Partial<MastraMessageV2> & {
-            id: string;
-        }[];
-    }): Promise<MastraMessageV2[]>;
-    /**
-     * Deletes one or more messages
-     * @param input - Must be an array containing either:
-     *   - Message ID strings
-     *   - Message objects with 'id' properties
-     * @returns Promise that resolves when all messages are deleted
-     */
-    deleteMessages(input: MessageDeleteInput): Promise<void>;
-}
-
-export declare type MessageDeleteInput = string[] | {
-    id: string;
-}[];
-
-/**
- * Limits the total number of tokens in the messages.
- * Uses js-tiktoken with o200k_base encoding by default for accurate token counting with modern models.
- */
-declare class TokenLimiter extends MemoryProcessor {
-    private encoder;
-    private maxTokens;
-    TOKENS_PER_MESSAGE: number;
-    TOKENS_PER_CONVERSATION: number;
-    /**
-     * Create a token limiter for messages.
-     * @param options Either a number (token limit) or a configuration object
-     */
-    constructor(options: number | TokenLimiterOptions);
-    process(messages: CoreMessage_2[], { systemMessage, memorySystemMessage, newMessages }?: MemoryProcessorOpts): CoreMessage_2[];
-    countTokens(message: string | CoreMessage_2): number;
-}
-export { TokenLimiter }
-export { TokenLimiter as TokenLimiter_alias_1 }
-
-/**
- * Configuration options for TokenLimiter
- */
-declare interface TokenLimiterOptions {
-    /** Maximum number of tokens to allow */
-    limit: number;
-    /** Optional encoding to use (defaults to o200k_base which is used by gpt-4o) */
-    encoding?: TiktokenBPE;
-}
-
-/**
- * Filters out tool calls and results from messages.
- * By default (with no arguments), excludes all tool calls and their results.
- * Can be configured to exclude only specific tools by name.
- */
-declare class ToolCallFilter extends MemoryProcessor_2 {
-    private exclude;
-    /**
-     * Create a filter for tool calls and results.
-     * @param options Configuration options
-     * @param options.exclude List of specific tool names to exclude. If not provided, all tool calls are excluded.
-     */
-    constructor(options?: {
-        exclude?: string[];
-    });
-    process(messages: CoreMessage_2[]): CoreMessage_2[];
-}
-export { ToolCallFilter }
-export { ToolCallFilter as ToolCallFilter_alias_1 }
-
-export declare const updateWorkingMemoryTool: (memoryConfig?: MemoryConfig_2) => CoreTool;
-
-export { }

package/dist/index.d.cts

@@ -1,2 +0,0 @@
-export { MessageDeleteInput } from './_tsup-dts-rollup.cjs';
-export { Memory } from './_tsup-dts-rollup.cjs';

package/dist/processors/index.d.cts

@@ -1,2 +0,0 @@
-export { TokenLimiter } from '../_tsup-dts-rollup.cjs';
-export { ToolCallFilter } from '../_tsup-dts-rollup.cjs';