Storage

The storage module provides utility functions for saving and retrieving document records between sessions. Records are scoped to the agent and persist across sessions.

Import

import { toolsLibrary } from '@minded-ai/mindedjs';

const { saveRecord, getRecords, deleteRecord } = toolsLibrary.storage;

Basic Operations

Save a record:

const recordId = await saveRecord(state.sessionId, {
  invoiceId: 'INV-12345',
  status: 'processed',
  amount: 1500.00,
}, 3600); // Optional: TTL in seconds

Retrieve records:

// Simple equality
const records = await getRecords({ status: 'processed' });

Delete a record:

await deleteRecord('record-id-123');

Record Structure

  • id: Unique identifier

  • agentId: Automatically set to the agent ID

  • sessionId: Session where the record was created

  • data: Your document data

  • createdAt: Creation timestamp

  • updatedAt: Last update timestamp

Notes

  • Records are agent-scoped (only accessible by the same agent)

  • Filters use MongoDB query syntax and apply to the data field (no data. prefix needed)

  • All operations require a valid sessionId

  • Records persist across sessions

PreviousClassifierNextZendesk

Last updated