Interface IMessageQueryOptions

Options for querying conversation messages with filtering and pagination.

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)
};
interface IMessageQueryOptions {
    limit?: number;
    offset?: number;
    since?: number;
    until?: number;
    roles?: ("tool" | "system" | "user" | "assistant")[];
    order?: "asc" | "desc";
}

Properties

limit?: number

Maximum number of messages to return

offset?: number

Number of messages to skip (for pagination)

since?: number

Only return messages created after this timestamp

until?: number

Only return messages created before this timestamp

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

Filter by message roles

order?: "asc" | "desc"

Sort order by timestamp (default: 'asc')