Interface AiAgentMemoryOptions

Overrides the expiration for the whole chat history. If not provided, the expiration will not be changed.

Default: the last provided expiration by user or 1 day if the user didn't provide any expiration.

A unique ID to store the chat memory.

The full chat memory key is constructed as a combination of 'appId', 'agentId', and 'memoryId'. If not provided the Squid client instance ID used as a memoryId.

Important: the memory ID should be treated with the same security measures as Access Token because it unblocks direct access to the agent chat history. A good practice is to use a non-trivial and a unique value.

The memory mode for an AI agent.

Note: Squid persists chat history in its own store only for models whose provider does NOT manage memory itself. For provider-managed-memory models (e.g. Claude Code, which keeps its own CLI session), this mode still controls whether the conversation resumes, but Squid never reads or writes its own history DB.