@meshagent/meshagent 0.33.3 → 0.35.0

package/dist/node/memory-client.d.ts

@@ -1,4 +1,103 @@
 import { RoomClient } from "./room-client";
+export type MemoryIngestStrategy = "heuristic" | "llm";
+export interface MemoryEntityRecord {
+    entityId?: string | null;
+    name: string;
+    entityType?: string | null;
+    context?: string | null;
+    confidence?: number | null;
+    createdAt?: string | null;
+    validAt?: string | null;
+    metadata?: Record<string, string> | null;
+}
+export interface MemoryRelationshipRecord {
+    sourceEntityId: string;
+    targetEntityId: string;
+    relationshipType?: string;
+    description?: string | null;
+    confidence?: number | null;
+    createdAt?: string | null;
+    validAt?: string | null;
+    expiredAt?: string | null;
+    invalidAt?: string | null;
+    sourceEntityName?: string | null;
+    targetEntityName?: string | null;
+    metadata?: Record<string, string> | null;
+}
+export interface MemoryDatasetSummary {
+    name: string;
+    rows: number;
+    columns: string[];
+}
+export interface MemoryDetails {
+    name: string;
+    namespace?: string[] | null;
+    path: string;
+    datasets: MemoryDatasetSummary[];
+}
+export interface MemoryIngestStats {
+    entities: number;
+    relationships: number;
+    sources: number;
+}
+export interface MemoryIngestResult {
+    name: string;
+    stats: MemoryIngestStats;
+    entityIds: string[];
+}
+export interface MemoryRecallRelationship {
+    sourceEntityId: string;
+    targetEntityId: string;
+    relationshipType: string;
+    description?: string | null;
+    createdAt?: string | null;
+    validAt?: string | null;
+    expiredAt?: string | null;
+    invalidAt?: string | null;
+}
+export interface MemoryRecallItem {
+    entityId: string;
+    name: string;
+    entityType: string;
+    context?: string | null;
+    confidence?: number | null;
+    createdAt?: string | null;
+    validAt?: string | null;
+    score: number;
+    relationships: MemoryRecallRelationship[];
+}
+export interface MemoryRecallResult {
+    name: string;
+    query: string;
+    items: MemoryRecallItem[];
+}
+export interface MemoryDeleteEntitiesResult {
+    name: string;
+    deletedEntities: number;
+    deletedRelationships: number;
+}
+export interface MemoryRelationshipSelector {
+    sourceEntityId: string;
+    targetEntityId: string;
+    relationshipType?: string | null;
+}
+export interface MemoryDeleteRelationshipsResult {
+    name: string;
+    deletedRelationships: number;
+}
+export interface MemoryOptimizeDatasetStats {
+    dataset: string;
+    fragmentsAdded: number;
+    fragmentsRemoved: number;
+    filesAdded: number;
+    filesRemoved: number;
+    oldVersionsRemoved: number;
+    bytesRemoved: number;
+}
+export interface MemoryOptimizeResult {
+    name: string;
+    datasets: MemoryOptimizeDatasetStats[];
+}
 export declare class MemoryClient {
     private readonly room;
     constructor({ room }: {
@@ -6,6 +105,7 @@ export declare class MemoryClient {
     });
     private unexpectedResponse;
     private invoke;
+    private expectJsonResponse;
     list(params?: {
         namespace?: string[] | null;
     }): Promise<string[]>;
@@ -20,4 +120,104 @@ export declare class MemoryClient {
         namespace?: string[] | null;
         ignoreMissing?: boolean;
     }): Promise<void>;
+    inspect(params: {
+        name: string;
+        namespace?: string[] | null;
+    }): Promise<MemoryDetails>;
+    query(params: {
+        name: string;
+        statement: string;
+        namespace?: string[] | null;
+    }): Promise<Array<Record<string, unknown>>>;
+    upsertTable(params: {
+        name: string;
+        table: string;
+        records: Array<Record<string, unknown>>;
+        namespace?: string[] | null;
+        merge?: boolean;
+    }): Promise<void>;
+    upsertNodes(params: {
+        name: string;
+        records: MemoryEntityRecord[];
+        namespace?: string[] | null;
+        merge?: boolean;
+    }): Promise<void>;
+    upsertRelationships(params: {
+        name: string;
+        records: MemoryRelationshipRecord[];
+        namespace?: string[] | null;
+        merge?: boolean;
+    }): Promise<void>;
+    ingestText(params: {
+        name: string;
+        text: string;
+        namespace?: string[] | null;
+        strategy?: MemoryIngestStrategy;
+        llmModel?: string | null;
+        llmTemperature?: number | null;
+    }): Promise<MemoryIngestResult>;
+    ingestImage(params: {
+        name: string;
+        caption?: string | null;
+        data?: Uint8Array | null;
+        mimeType?: string | null;
+        source?: string | null;
+        annotations?: Record<string, string> | null;
+        namespace?: string[] | null;
+        strategy?: MemoryIngestStrategy;
+        llmModel?: string | null;
+        llmTemperature?: number | null;
+    }): Promise<MemoryIngestResult>;
+    ingestFile(params: {
+        name: string;
+        path?: string | null;
+        text?: string | null;
+        mimeType?: string | null;
+        namespace?: string[] | null;
+        strategy?: MemoryIngestStrategy;
+        llmModel?: string | null;
+        llmTemperature?: number | null;
+    }): Promise<MemoryIngestResult>;
+    ingestFromTable(params: {
+        name: string;
+        table: string;
+        textColumns?: string[] | null;
+        tableNamespace?: string[] | null;
+        limit?: number | null;
+        namespace?: string[] | null;
+        strategy?: MemoryIngestStrategy;
+        llmModel?: string | null;
+        llmTemperature?: number | null;
+    }): Promise<MemoryIngestResult>;
+    ingestFromStorage(params: {
+        name: string;
+        paths: string[];
+        namespace?: string[] | null;
+        strategy?: MemoryIngestStrategy;
+        llmModel?: string | null;
+        llmTemperature?: number | null;
+    }): Promise<MemoryIngestResult>;
+    recall(params: {
+        name: string;
+        query: string;
+        namespace?: string[] | null;
+        limit?: number;
+        includeRelationships?: boolean;
+    }): Promise<MemoryRecallResult>;
+    deleteEntities(params: {
+        name: string;
+        entityIds: string[];
+        namespace?: string[] | null;
+    }): Promise<MemoryDeleteEntitiesResult>;
+    deleteRelationships(params: {
+        name: string;
+        relationships: MemoryRelationshipSelector[];
+        namespace?: string[] | null;
+    }): Promise<MemoryDeleteRelationshipsResult>;
+    optimize(params: {
+        name: string;
+        namespace?: string[] | null;
+        compact?: boolean;
+        cleanup?: boolean;
+    }): Promise<MemoryOptimizeResult>;
 }