Interface: IMessageQueryOptions

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:169

Options for querying conversation messages with filtering and pagination.

Interface

IMessageQueryOptions

Example

// Get last 50 assistant messages
const options: IMessageQueryOptions = {
  limit: 50,
  roles: ['assistant'],
  order: 'desc'
};

// Get messages from last hour
const recentOptions: IMessageQueryOptions = {
  since: Date.now() - (60 * 60 * 1000)
};

Properties

limit?

optional limit: number

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:170

Maximum number of messages to return

---

offset?

optional offset: number

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:171

Number of messages to skip (for pagination)

---

order?

optional order: "asc" | "desc"

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:175

Sort order by timestamp (default: 'asc')

---

roles?

optional roles: ("user" | "tool" | "system" | "assistant")[]

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:174

Filter by message roles

---

since?

optional since: number

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:172

Only return messages created after this timestamp

---

until?

optional until: number

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:173

Only return messages created before this timestamp