From eb0bcb840d73da76afd27b352c24802e916eb4d5 Mon Sep 17 00:00:00 2001 From: agumpandey Date: Wed, 13 May 2026 00:06:44 +0530 Subject: [PATCH] docs: add temporal reasoning llms coverage --- docs/llms.txt | 1 + docs/openapi.json | 93 +++++++++++++++-------------------------------- 2 files changed, 30 insertions(+), 64 deletions(-) diff --git a/docs/llms.txt b/docs/llms.txt index 1725f45ab..2fe77074c 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -185,6 +185,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or Platform `output_f ### Features - Advanced Retrieval - [Advanced Retrieval](https://docs.mem0.ai/platform/features/advanced-retrieval) [Platform]: Use when the user needs keyword search, reranking, or hybrid retrieval. - [Criteria-Based Retrieval](https://docs.mem0.ai/platform/features/criteria-retrieval) [Platform]: Use when targeting memories by custom criteria, not just semantic similarity. +- [Temporal Reasoning](https://docs.mem0.ai/platform/features/temporal-reasoning) [Platform]: Use when time-aware searches like last week, upcoming, or right now need better result ordering. - [Contextual Add](https://docs.mem0.ai/platform/features/contextual-add) [Platform]: Use when `add()` should consider the surrounding conversation, not just the latest turn. - [Custom Instructions](https://docs.mem0.ai/platform/features/custom-instructions) [Platform]: Use when tailoring what Mem0 extracts and stores on Platform. - [Advanced Memory Operations](https://docs.mem0.ai/platform/advanced-memory-operations) [Platform]: Use when basic CRUD is not enough - batch ops, complex filters, workflows. diff --git a/docs/openapi.json b/docs/openapi.json index cc7b1e0ea..8609e2d58 100644 --- a/docs/openapi.json +++ b/docs/openapi.json @@ -417,10 +417,10 @@ "nullable": true, "description": "Additional metadata associated with the event." }, - "results": { - "type": "array", - "description": "Array of results produced by the event. For add events, this confirms the write completed; temporal reasoning enrichment runs asynchronously by default." - }, + "results": { + "type": "array", + "description": "Array of results produced by the event. For add events, this confirms the write completed; temporal reasoning enrichment runs asynchronously by default." + }, "created_at": { "type": "string", "format": "date-time", @@ -1593,7 +1593,7 @@ }, { "lang": "JavaScript", - "source": "// To use the JavaScript SDK, install the package:\n// npm i mem0ai\n\nimport MemoryClient from 'mem0ai';\nconst client = new MemoryClient({ apiKey: \"your-api-key\" });\n\nconst query = \"Your search query here\";\n\nclient.search(query, { filters: { user_id: \"\" } })\n .then(result => console.log(result))\n .catch(error => console.error(error));" + "source": "// To use the JavaScript SDK, install the package:\n// npm i mem0ai\n\nimport MemoryClient from 'mem0ai';\nconst client = new MemoryClient({ apiKey: \"your-api-key\" });\n\nconst query = \"Your search query here\";\n\nclient.search(query, { user_id: \"\" })\n .then(result => console.log(result))\n .catch(error => console.error(error));" }, { "lang": "cURL", @@ -1828,30 +1828,17 @@ "type": "string", "description": "The extracted memory fact." }, - "user_id": { - "type": "string", - "nullable": true, - "description": "External user identifier scoping this memory, if any." + "score": { + "type": "number", + "format": "float", + "minimum": 0, + "maximum": 1, + "description": "Combined multi-signal relevance score in [0, 1] (search responses only)." }, - "agent_id": { - "type": "string", - "nullable": true, - "description": "External agent identifier scoping this memory, if any." - }, - "app_id": { - "type": "string", - "nullable": true, - "description": "External app identifier scoping this memory, if any." - }, - "run_id": { - "type": "string", - "nullable": true, - "description": "External run identifier scoping this memory, if any." - }, - "metadata": { - "type": "object", - "additionalProperties": true, - "description": "User-supplied metadata attached to the memory." + "metadata": { + "type": "object", + "additionalProperties": true, + "description": "User-supplied metadata attached to the memory." }, "categories": { "type": "array", @@ -1867,7 +1854,7 @@ "type": "string", "format": "date-time" } - }, + }, "required": [ "id", "memory", @@ -1888,19 +1875,18 @@ "next": "https://api.mem0.ai/v3/memories/?page=2&page_size=100", "previous": null, "results": [ - { - "id": "mem-uuid", - "memory": "User moved to San Francisco from New York in January 2026", - "user_id": "alice", - "metadata": {}, - "categories": [ - "location" - ], - "created_at": "2026-01-15T10:30:00Z", - "updated_at": "2026-01-15T10:30:00Z" - } - ] - } + { + "id": "mem-uuid", + "memory": "User moved to San Francisco from New York in January 2026", + "metadata": {}, + "categories": [ + "location" + ], + "created_at": "2026-01-15T10:30:00Z", + "updated_at": "2026-01-15T10:30:00Z" + } + ] + } } } }, @@ -1982,10 +1968,6 @@ "type": "string", "description": "Scope memories to this agent." }, - "app_id": { - "type": "string", - "description": "Scope memories to this app." - }, "run_id": { "type": "string", "description": "Scope memories to this session / run." @@ -1999,17 +1981,6 @@ "type": "string", "description": "Project-level instructions that guide extraction for this call." }, - "multilingual": { - "type": "boolean", - "nullable": true, - "description": "Extract memories in the same language as the input." - }, - "expiration_date": { - "type": "string", - "format": "date", - "nullable": true, - "description": "Optional expiration date for stored memories." - }, "infer": { "type": "boolean", "default": true, @@ -2235,13 +2206,7 @@ { "id": "mem-uuid", "memory": "User moved to San Francisco from New York in January 2026", - "user_id": "alice", "score": 0.82, - "score_breakdown": { - "semantic": 0.78, - "bm25": 0.0, - "entity": 0.0 - }, "metadata": {}, "categories": [ "location" @@ -6291,4 +6256,4 @@ } }, "x-original-swagger-version": "2.0" -} +} \ No newline at end of file