indusagi 0.12.13 → 0.12.15

package/dist/memory/types.d.ts

@@ -0,0 +1,386 @@
+/**
+ * Memory System Type Definitions
+ * Based on Mastra memory types
+ */
+import type { JSONSchema7 } from "json-schema";
+import type { ZodObject } from "zod";
+/**
+ * Message content types for V2 format
+ */
+export interface MessageContentV2 {
+    format: 2;
+    content: string;
+    parts: MessagePart[];
+    metadata?: Record<string, unknown>;
+}
+export type MessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    image: string;
+    mimeType?: string;
+} | {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+} | {
+    type: "tool-result";
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+};
+/**
+ * Core message type used throughout the memory system
+ */
+export interface CoreMessage {
+    id: string;
+    role: "user" | "assistant" | "system" | "tool";
+    content: string | MessageContentV2;
+    createdAt: Date;
+    threadId?: string;
+    resourceId?: string;
+}
+/**
+ * Storage message format (for persistence)
+ */
+export interface StorageMessageType {
+    id: string;
+    thread_id: string;
+    content: string;
+    role: string;
+    type: "text" | "tool-call" | "tool-result";
+    createdAt: Date;
+    updatedAt?: Date;
+    resourceId: string | null;
+}
+/**
+ * Thread (conversation) record
+ */
+export interface StorageThreadType {
+    id: string;
+    title?: string;
+    resourceId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Resource (user/session) record
+ */
+export interface StorageResourceType {
+    id: string;
+    workingMemory?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Vector index configuration for optimizing semantic recall performance
+ */
+export interface VectorIndexConfig {
+    type?: "ivfflat" | "hnsw" | "flat";
+    metric?: "cosine" | "euclidean" | "dotproduct";
+    ivf?: {
+        lists?: number;
+    };
+    hnsw?: {
+        m?: number;
+        efConstruction?: number;
+    };
+}
+/**
+ * Semantic recall configuration
+ */
+export interface SemanticRecallConfig {
+    /** Number of similar messages to retrieve */
+    topK: number;
+    /** Messages to include before/after each match */
+    messageRange: number | {
+        before: number;
+        after: number;
+    };
+    /** Scope: thread (per conversation) or resource (cross-conversation) */
+    scope?: "thread" | "resource";
+    /** Vector index configuration */
+    indexConfig?: VectorIndexConfig;
+    /** Minimum similarity threshold (0-1) */
+    threshold?: number;
+    /** Index name for the vector store */
+    indexName?: string;
+}
+/**
+ * Base working memory configuration
+ */
+export interface BaseWorkingMemory {
+    enabled: boolean;
+    /** Scope for working memory storage */
+    scope?: "thread" | "resource";
+}
+/**
+ * Template-based working memory
+ */
+export interface TemplateWorkingMemory extends BaseWorkingMemory {
+    template: string;
+    schema?: never;
+}
+/**
+ * Schema-based working memory
+ */
+export interface SchemaWorkingMemory extends BaseWorkingMemory {
+    schema: ZodObject<any> | JSONSchema7;
+    template?: never;
+}
+/**
+ * Working memory configuration union type
+ */
+export type WorkingMemoryConfig = TemplateWorkingMemory | SchemaWorkingMemory | (BaseWorkingMemory & {
+    template?: never;
+    schema?: never;
+});
+/**
+ * Model settings for Observer/Reflector agents
+ */
+export interface ObservationalMemoryModelSettings {
+    temperature?: number;
+    maxOutputTokens?: number;
+    topP?: number;
+    [key: string]: unknown;
+}
+/**
+ * Observation step configuration
+ */
+export interface ObservationConfig {
+    model?: string;
+    messageTokens?: number;
+    modelSettings?: ObservationalMemoryModelSettings;
+    providerOptions?: Record<string, Record<string, unknown>>;
+    maxTokensPerBatch?: number;
+    bufferTokens?: number | false;
+    bufferActivation?: number;
+    blockAfter?: number;
+    instruction?: string;
+}
+/**
+ * Reflection step configuration
+ */
+export interface ReflectionConfig {
+    model?: string;
+    observationTokens?: number;
+    modelSettings?: ObservationalMemoryModelSettings;
+    providerOptions?: Record<string, Record<string, unknown>>;
+    blockAfter?: number;
+    bufferActivation?: number;
+    instruction?: string;
+}
+/**
+ * Observational memory configuration
+ */
+export interface ObservationalMemoryOptions {
+    enabled?: boolean;
+    model?: string;
+    observation?: ObservationConfig;
+    reflection?: ReflectionConfig;
+    scope?: "resource" | "thread";
+    shareTokenBudget?: boolean;
+}
+/**
+ * Main memory configuration
+ */
+export interface MemoryConfig {
+    /** Read-only mode (no learning) */
+    readOnly?: boolean;
+    /** Number of recent messages to include (or false to disable) */
+    lastMessages?: number | false;
+    /** Semantic recall configuration */
+    semanticRecall?: boolean | SemanticRecallConfig;
+    /** Working memory configuration */
+    workingMemory?: WorkingMemoryConfig;
+    /** Observational memory configuration */
+    observationalMemory?: boolean | ObservationalMemoryOptions;
+    /** Auto-generate thread titles */
+    generateTitle?: boolean | {
+        model: string;
+        instructions?: string;
+    };
+}
+/**
+ * Shared memory configuration (for Memory class constructor)
+ */
+export interface SharedMemoryConfig {
+    storage?: import("./storage/base.js").MemoryStorage;
+    vector?: import("./vector/base.js").VectorStore;
+    embedder?: import("./embedder/base.js").Embedder;
+    embedderOptions?: EmbedderOptions;
+    options?: MemoryConfig;
+}
+/**
+ * Embedding result
+ */
+export interface EmbeddingResult {
+    vector: number[];
+    model: string;
+    dimensions: number;
+    usage?: {
+        inputTokens: number;
+    };
+}
+/**
+ * Embedder options
+ */
+export interface EmbedderOptions {
+    dimensions?: number;
+    providerOptions?: Record<string, unknown>;
+}
+/**
+ * Vector query result
+ */
+export interface VectorQueryResult {
+    id: string;
+    score: number;
+    vector?: number[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Index statistics
+ */
+export interface IndexStats {
+    dimension: number;
+    metric?: string;
+    count: number;
+}
+/**
+ * Pagination input for list operations
+ */
+export interface PaginationInput {
+    page?: number;
+    perPage?: number | false;
+}
+/**
+ * Pagination output for list operations
+ */
+export interface PaginationOutput {
+    page: number;
+    perPage: number | false;
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Order by configuration
+ */
+export interface OrderByInput {
+    field: "createdAt" | "updatedAt";
+    direction: "ASC" | "DESC";
+}
+/**
+ * Storage list messages input
+ */
+export interface StorageListMessagesInput extends PaginationInput {
+    threadId: string | string[];
+    resourceId?: string;
+    include?: Array<{
+        id: string;
+        threadId?: string;
+        withPreviousMessages?: number;
+        withNextMessages?: number;
+    }>;
+    filter?: {
+        dateRange?: {
+            start?: Date;
+            end?: Date;
+        };
+    };
+    orderBy?: OrderByInput;
+}
+/**
+ * Storage list messages output
+ */
+export interface StorageListMessagesOutput extends PaginationOutput {
+    messages: CoreMessage[];
+}
+/**
+ * Storage list threads input
+ */
+export interface StorageListThreadsInput extends PaginationInput {
+    filter?: {
+        resourceId?: string;
+        metadata?: Record<string, unknown>;
+    };
+    orderBy?: OrderByInput;
+}
+/**
+ * Storage list threads output
+ */
+export interface StorageListThreadsOutput extends PaginationOutput {
+    threads: StorageThreadType[];
+}
+/**
+ * Buffered observation chunk
+ */
+export interface BufferedObservationChunk {
+    id: string;
+    cycleId?: string;
+    observations: string;
+    tokenCount: number;
+    messageIds: string[];
+    messageTokens?: number;
+    lastObservedAt?: Date;
+    createdAt: Date;
+    suggestedContinuation?: string;
+    currentTask?: string;
+}
+/**
+ * Observational memory record
+ */
+export interface ObservationalMemoryRecord {
+    id: string;
+    scope: "thread" | "resource";
+    threadId: string | null;
+    resourceId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    lastObservedAt?: Date;
+    lastReflectedAt?: Date;
+    originType: "initial" | "reflection";
+    generationCount: number;
+    activeObservations: string;
+    observationTokenCount: number;
+    totalTokensObserved: number;
+    bufferedObservationChunks?: BufferedObservationChunk[];
+    bufferedReflection?: string;
+    bufferedReflectionTokens?: number;
+    bufferedReflectionInputTokens?: number;
+    observedMessageIds?: string[];
+    pendingMessageTokens: number;
+    isReflecting: boolean;
+    isObserving: boolean;
+    isBufferingObservation: boolean;
+    isBufferingReflection: boolean;
+    lastBufferedAtTokens: number;
+    lastBufferedAtTime: Date | null;
+    config?: ObservationalMemoryOptions;
+    observedTimezone?: string;
+    reflectedObservationLineCount?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Working memory template format
+ */
+export interface WorkingMemoryTemplate {
+    format: "json" | "markdown";
+    content: string;
+}
+/**
+ * Default memory options
+ */
+export declare const memoryDefaultOptions: MemoryConfig;
+/**
+ * Default semantic recall configuration
+ */
+export declare const DEFAULT_SEMANTIC_RECALL: SemanticRecallConfig;
+/**
+ * Default observational memory configuration
+ */
+export declare const DEFAULT_OBSERVATIONAL_MEMORY: ObservationalMemoryOptions;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,58 @@
+/**
+ * Memory System Type Definitions
+ * Based on Mastra memory types
+ */
+// ============================================================================
+// Default Configuration
+// ============================================================================
+/**
+ * Default memory options
+ */
+export const memoryDefaultOptions = {
+    lastMessages: 10,
+    semanticRecall: false,
+    generateTitle: false,
+    workingMemory: {
+        enabled: false,
+        template: `
+# User Information
+- **First Name**: 
+- **Last Name**: 
+- **Location**: 
+- **Occupation**: 
+- **Interests**: 
+- **Goals**: 
+- **Events**: 
+- **Facts**: 
+- **Projects**: 
+`,
+    },
+};
+/**
+ * Default semantic recall configuration
+ */
+export const DEFAULT_SEMANTIC_RECALL = {
+    topK: 4,
+    messageRange: { before: 1, after: 1 },
+    scope: "resource",
+    threshold: 0.7,
+};
+/**
+ * Default observational memory configuration
+ */
+export const DEFAULT_OBSERVATIONAL_MEMORY = {
+    enabled: true,
+    scope: "thread",
+    observation: {
+        messageTokens: 30_000,
+        modelSettings: { temperature: 0.3, maxOutputTokens: 100_000 },
+        bufferTokens: 0.2,
+        bufferActivation: 0.8,
+    },
+    reflection: {
+        observationTokens: 40_000,
+        modelSettings: { temperature: 0, maxOutputTokens: 100_000 },
+        bufferActivation: 0.5,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4bH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE;QACb,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE;;;;;;;;;;;CAWb;KACE;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC3D,IAAI,EAAE,CAAC;IACP,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;IACrC,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,GAAG;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA+B;IACtE,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE;QACX,aAAa,EAAE,MAAM;QACrB,aAAa,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE;QAC7D,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE,GAAG;KACtB;IACD,UAAU,EAAE;QACV,iBAAiB,EAAE,MAAM;QACzB,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE;QAC3D,gBAAgB,EAAE,GAAG;KACtB;CACF,CAAC"}

package/dist/memory/vector/base.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Vector Store Abstract Base Class
+ * Based on Mastra MastraVector
+ */
+import type { IndexStats, VectorQueryResult } from "../types.js";
+/**
+ * Create index parameters
+ */
+export interface CreateIndexParams {
+    indexName: string;
+    dimension: number;
+    metric?: "cosine" | "euclidean" | "dotproduct";
+    indexConfig?: {
+        type?: "ivfflat" | "hnsw" | "flat";
+        ivf?: {
+            lists?: number;
+        };
+        hnsw?: {
+            m?: number;
+            efConstruction?: number;
+        };
+    };
+}
+/**
+ * Upsert vector parameters
+ */
+export interface UpsertVectorParams {
+    indexName: string;
+    vectors: number[][];
+    metadata?: Record<string, unknown>[];
+    ids?: string[];
+}
+/**
+ * Query vector parameters
+ */
+export interface QueryVectorParams {
+    indexName: string;
+    queryVector: number[];
+    topK?: number;
+    filter?: Record<string, unknown>;
+    includeVector?: boolean;
+    minScore?: number;
+}
+/**
+ * Update vector parameters
+ */
+export interface UpdateVectorParams {
+    indexName: string;
+    id: string;
+    vector?: number[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Delete vector parameters
+ */
+export interface DeleteVectorParams {
+    indexName: string;
+    id: string;
+}
+/**
+ * Delete vectors parameters
+ */
+export interface DeleteVectorsParams {
+    indexName: string;
+    ids?: string[];
+    filter?: Record<string, unknown>;
+}
+/**
+ * Describe index parameters
+ */
+export interface DescribeIndexParams {
+    indexName: string;
+}
+/**
+ * Delete index parameters
+ */
+export interface DeleteIndexParams {
+    indexName: string;
+}
+/**
+ * Abstract base class for vector store implementations
+ */
+export declare abstract class VectorStore {
+    /**
+     * Unique identifier for this vector store
+     */
+    abstract readonly id: string;
+    /**
+     * Index separator used for generating index names
+     */
+    readonly indexSeparator: string;
+    /**
+     * Create a new vector index
+     */
+    abstract createIndex(params: CreateIndexParams): Promise<void>;
+    /**
+     * Upsert vectors into an index
+     */
+    abstract upsert(params: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Query vectors from an index
+     */
+    abstract query(params: QueryVectorParams): Promise<VectorQueryResult[]>;
+    /**
+     * Update a vector in an index
+     */
+    abstract updateVector(params: UpdateVectorParams): Promise<void>;
+    /**
+     * Delete a single vector from an index
+     */
+    abstract deleteVector(params: DeleteVectorParams): Promise<void>;
+    /**
+     * Delete multiple vectors from an index
+     */
+    abstract deleteVectors(params: DeleteVectorsParams): Promise<void>;
+    /**
+     * List all indexes
+     */
+    abstract listIndexes(): Promise<string[]>;
+    /**
+     * Describe an index
+     */
+    abstract describeIndex(params: DescribeIndexParams): Promise<IndexStats>;
+    /**
+     * Delete an index
+     */
+    abstract deleteIndex(params: DeleteIndexParams): Promise<void>;
+    /**
+     * Validate existing index dimensions
+     */
+    protected validateExistingIndex(indexName: string, dimension: number, metric: string): Promise<void>;
+}
+/**
+ * Validate upsert input
+ */
+export declare function validateUpsertInput(storeName: string, vectors: number[][], metadata?: Record<string, unknown>[], ids?: string[]): void;
+/**
+ * Validate topK value
+ */
+export declare function validateTopK(storeName: string, topK?: number): void;
+/**
+ * Validate vector values
+ */
+export declare function validateVectorValues(storeName: string, vectors: number[][]): void;
+//# sourceMappingURL=base.d.ts.map

package/dist/memory/vector/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/memory/vector/base.ts"],"names":[],"mappings":"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"}

package/dist/memory/vector/base.js

@@ -0,0 +1,83 @@
+/**
+ * Vector Store Abstract Base Class
+ * Based on Mastra MastraVector
+ */
+/**
+ * Abstract base class for vector store implementations
+ */
+export class VectorStore {
+    constructor() {
+        /**
+         * Index separator used for generating index names
+         */
+        this.indexSeparator = "_";
+    }
+    // ========================================================================
+    // Protected Helpers
+    // ========================================================================
+    /**
+     * Validate existing index dimensions
+     */
+    async validateExistingIndex(indexName, dimension, metric) {
+        try {
+            const stats = await this.describeIndex({ indexName });
+            if (stats.dimension !== dimension) {
+                throw new Error(`Index "${indexName}" already exists with dimension ${stats.dimension}, but ${dimension} was requested. ` +
+                    `Use a different index name or delete the existing index first.`);
+            }
+            if (stats.metric && stats.metric !== metric) {
+                throw new Error(`Index "${indexName}" already exists with metric ${stats.metric}, but ${metric} was requested. ` +
+                    `Use a different index name or delete the existing index first.`);
+            }
+        }
+        catch (error) {
+            // Index doesn't exist, which is fine
+            if (error.message?.includes("does not exist")) {
+                return;
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * Validate upsert input
+ */
+export function validateUpsertInput(storeName, vectors, metadata, ids) {
+    if (!vectors || vectors.length === 0) {
+        throw new Error(`${storeName}: No vectors provided for upsert`);
+    }
+    if (metadata && metadata.length !== vectors.length) {
+        throw new Error(`${storeName}: Metadata array length (${metadata.length}) must match vectors length (${vectors.length})`);
+    }
+    if (ids && ids.length !== vectors.length) {
+        throw new Error(`${storeName}: IDs array length (${ids.length}) must match vectors length (${vectors.length})`);
+    }
+}
+/**
+ * Validate topK value
+ */
+export function validateTopK(storeName, topK) {
+    if (topK !== undefined && (!Number.isInteger(topK) || topK <= 0)) {
+        throw new Error(`${storeName}: topK must be a positive integer`);
+    }
+}
+/**
+ * Validate vector values
+ */
+export function validateVectorValues(storeName, vectors) {
+    for (let i = 0; i < vectors.length; i++) {
+        const vector = vectors[i];
+        if (!Array.isArray(vector)) {
+            throw new Error(`${storeName}: Vector at index ${i} is not an array`);
+        }
+        if (vector.length === 0) {
+            throw new Error(`${storeName}: Vector at index ${i} is empty`);
+        }
+        for (let j = 0; j < vector.length; j++) {
+            if (typeof vector[j] !== "number" || !Number.isFinite(vector[j])) {
+                throw new Error(`${storeName}: Invalid vector value at index [${i}][${j}]: ${vector[j]}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=base.js.map