recall_by_time
Retrieve memories from any time period using natural language phrases like 'yesterday' or 'last week'.
Instructions
Query memories using natural language time expressions like "yesterday", "last week", "this morning", "before 3pm".
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sessionId | Yes | Session identifier | |
| expression | Yes | Natural language time expression like "yesterday", "last week", "before Monday" | |
| limit | No | Max results (default 10) |
Implementation Reference
- src/index.ts:196-208 (registration)Tool 'recall_by_time' is registered in the ListToolsRequestSchema handler with name, description, and inputSchema requiring sessionId, expression, and optional limit.
{ name: 'recall_by_time', description: 'Query memories using natural language time expressions like "yesterday", "last week", "this morning", "before 3pm".', inputSchema: { type: 'object', properties: { sessionId: { type: 'string', description: 'Session identifier' }, expression: { type: 'string', description: 'Natural language time expression like "yesterday", "last week", "before Monday"' }, limit: { type: 'number', description: 'Max results (default 10)', default: 10 }, }, required: ['sessionId', 'expression'], }, }, - src/index.ts:199-207 (schema)Input schema for recall_by_time defines properties: sessionId (string), expression (string - natural language time expression), limit (number, default 10). Required: sessionId and expression.
inputSchema: { type: 'object', properties: { sessionId: { type: 'string', description: 'Session identifier' }, expression: { type: 'string', description: 'Natural language time expression like "yesterday", "last week", "before Monday"' }, limit: { type: 'number', description: 'Max results (default 10)', default: 10 }, }, required: ['sessionId', 'expression'], }, - src/index.ts:376-383 (handler)The handler for 'recall_by_time' in the CallToolRequestSchema switch statement. It calls (memory as any).recallByTime(sessionId, expression, limit) and returns results as JSON.
case 'recall_by_time': { const entries = await (memory as any).recallByTime( args.sessionId as string, args.expression as string, (args.limit as number) || 10 ); return { content: [{ type: 'text', text: JSON.stringify(entries, null, 2) }] }; }