---
title: Memory
description: "zoom_memory and message_date, for reading back further in an agent's own memory."
tools: [zoom_memory, message_date]
source: [packages/agents/src/tools/memory.ts, packages/agents/src/memory/memory.ts]
generated: true
---

> Roadstar docs for agents. Every page, as markdown: https://docs.roadstar.app/llms.txt

An agent's memory is its conversation, folded into lines as it grows: each line sums up the messages it covers. `zoom_memory` opens a line into the two it was made from, or reads one message whole. `message_date` gives when a message was sent.

A Mac program or outside app keeps its own conversation, so it doesn't have these. See [notes, About and memory](/how-it-works/notes-and-memory/).

## Where each is offered

| Tool | Roadstar's chat | An agent's chat | A thread | A Mac or outside app |
| --- | --- | --- | --- | --- |
| [zoom_memory](#zoom_memory) | Yes | Yes | Yes | — |
| [message_date](#message_date) | Yes | Yes | Yes | — |

## zoom_memory

What the agent reads, word for word:

> Open line id+n of your memory into the two lines it was made from (n a power of 2, id a multiple of n), or with n = 1 read message id whole; a long one a page at a time from at.

| Input | Type | Required | What it is | Limits |
| --- | --- | --- | --- | --- |
| `id` | whole number | yes | The line's first message |  |
| `n` | whole number | no | How many messages the line covers; 1 for a message |  |
| `at` | whole number | no | Where to go on in a long message |  |

## message_date

What the agent reads, word for word:

> The date and time of message id.

| Input | Type | Required | What it is | Limits |
| --- | --- | --- | --- | --- |
| `id` | whole number | yes | The message's id |  |