memoryrouter-codex 1.4.0 → 1.5.0

package/README.md

@@ -77,6 +77,7 @@ printf '%s' "$MEMORYROUTER_API_KEY" | \
 This uses a local stdio MCP server and the MemoryRouter API. It does not put the memory key in Codex config. The fallback tools are:
 
 - `memory_search`
+- `memory_date_search`
 - `memory_store`
 - `memory_status`
 - `memory_forget`
@@ -161,7 +162,7 @@ MemoryRouter's Reflection Hierarchy consolidates raw memories into higher-tier r
 - **CLI:** `memoryrouter-codex reflect [--tier 1|2] [--batches N|all] [--max-tokens N] [--dry-run]`. The loop checks out a batch of unconsolidated memories under a 15 minute server lease, runs Codex itself headlessly (`codex exec`, you pay your own inference) with server-authored instructions, and commits the resulting reflection entries. It keeps no local state: if anything dies mid-loop, the lease expires server-side and the memories return to the pool, so re-running always resumes from the oldest unconsolidated memory. `--dry-run` prints the checkout and prompt and deliberately lets the lease expire (this bills one checkout).
 - **Local stdio MCP:** `memory_consolidate` (checkout, returns memory texts plus the server's reflection instructions) and `memory_commit_reflections` (submit entries for the batch, idempotent on replay). The model never sees memory row IDs; it works with bare texts and one opaque `cb_` batch id.
 
-`memory_search` accepts optional `tiers` (subset of `[1, 2, 3]`: raw, reflections, high-level reflections) and `importance` (integer 1 to 10 minimum threshold; only reflections carry ratings). `memory_status` reports the current reflection debt. When the server reports that consolidation is suggested, hook-injected context appends a one-line suggestion on every injection until the debt is consolidated.
+`memory_search` accepts optional `tiers` (subset of `[1, 2, 3]`: raw, reflections, high-level reflections) and `importance` (integer 1 to 10 minimum threshold; only reflections carry ratings). `memory_date_search` retrieves memories from a specific time window (`from` required ISO 8601, optional `to`, `query`, `tiers`, `importance`, `max_tokens`): use it for questions like 'what happened last week' or 'most important things this month or lately', setting importance to 7 or higher with tiers `[2, 3]` for importance questions, omitting `query` for a chronological review. `memory_status` reports the current reflection debt. When the server reports that consolidation is suggested, hook-injected context appends a one-line suggestion on every injection until the debt is consolidated.
 
 Reflection prompts are always server-authored. This package never writes its own consolidation instructions and refuses to reflect if the server response carries none. See https://docs.memoryrouter.ai/reflections for endpoint semantics, lease rules, and billing.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memoryrouter-codex",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Automatic, project-scoped MemoryRouter memory for OpenAI Codex",
   "license": "MIT",
   "type": "commonjs",

package/runtime/api.cjs

@@ -129,10 +129,17 @@ function deleteIds(key, ids, options = {}) {
 }
 
 function dateSearch(key, params = {}, options = {}) {
+  const body = {};
+  if (params.from !== undefined) body.from = params.from;
+  if (params.to !== undefined) body.to = params.to;
+  if (params.query !== undefined) body.query = params.query;
+  if (params.max_tokens !== undefined) body.max_tokens = params.max_tokens;
+  if (Array.isArray(params.tiers) && params.tiers.length) body.tiers = params.tiers;
+  if (params.importance !== undefined) body.importance = params.importance;
   return request('POST', '/v1/memory/date-search', {
     ...options,
     key,
-    body: params,
+    body,
     timeoutMs: options.timeoutMs || 15000,
     retries: options.retries ?? 1,
   });

package/runtime/constants.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const INTEGRATION_VERSION = '1.4.0';
+const INTEGRATION_VERSION = '1.5.0';
 const RUNTIME_SCHEMA_VERSION = 1;
 const API_BASE = 'https://api.memoryrouter.ai';
 const MCP_ENDPOINT = 'https://mcp.memoryrouter.ai/mcp';

package/runtime/mcp-stdio.cjs

@@ -5,7 +5,7 @@ const readline = require('readline');
 const fs = require('fs');
 const { loadConfig, getApiKey, configPath, auditPath, recordAudit, healthPath } = require('./config.cjs');
 const { resolveProject } = require('./project.cjs');
-const { searchScoped, storeScoped, forgetLocally } = require('./memory.cjs');
+const { searchScoped, storeScoped, forgetLocally, parseEnvelope } = require('./memory.cjs');
 const api = require('./api.cjs');
 const { contractFrom, validateEntries } = require('./reflect.cjs');
 const { INTEGRATION_VERSION } = require('./constants.cjs');
@@ -15,19 +15,36 @@ const SERVER_INSTRUCTIONS = 'MemoryRouter provides durable cross-machine, cross-
 const TOOLS = [
   {
     name: 'memory_search',
-    description: 'Search durable MemoryRouter memories. Defaults to the current git project and filters other projects out.',
+    description: "Search durable MemoryRouter memories. Defaults to the current git project and filters other projects out. For questions like 'what are the most important things' set importance to 7 or higher with tiers [2, 3], since only reflections carry importance ratings. For time-window questions like 'what happened last week' or 'lately' use memory_date_search instead.",
     inputSchema: {
       type: 'object',
       properties: {
         query: { type: 'string', description: 'Semantic search query.' },
         limit: { type: 'integer', minimum: 1, maximum: 50, description: 'Candidate results before project filtering.' },
-        tiers: { type: 'array', items: { type: 'integer', enum: [1, 2, 3] }, minItems: 1, uniqueItems: true, description: 'Restrict results to these memory tiers. 1 raw memories, 2 reflections, 3 high-level reflections. Omit to search all tiers blended.' },
-        importance: { type: 'integer', minimum: 1, maximum: 10, description: 'Only return memories rated at least this important (1 to 10). Only reflections carry ratings, so this filters to tier 2 and 3 content.' },
+        tiers: { type: 'array', items: { type: 'integer', enum: [1, 2, 3] }, minItems: 1, uniqueItems: true, description: 'Restrict results to these memory tiers. 1 raw memories, 2 reflections, 3 high-level reflections. Only tiers 2 and 3 carry importance ratings. Omit to search all tiers blended.' },
+        importance: { type: 'integer', minimum: 1, maximum: 10, description: "Minimum importance threshold, 1 to 10. Only reflections (tiers 2 and 3) carry ratings, so raw memories are excluded whenever this is set. For 'most important' questions use 7 or higher with tiers [2, 3]." },
       },
       required: ['query'],
     },
     annotations: { title: 'Search MemoryRouter', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
   },
+  {
+    name: 'memory_date_search',
+    description: "Retrieve memories from a specific time window. Use for questions like 'what happened last week' or 'most important things this month or lately'. For importance questions set importance to 7 or higher with tiers [2, 3], since only reflections carry importance ratings. Omit query for a chronological review; include query to rank by relevance within the window. Resolve relative phrases like 'lately' to concrete ISO dates before calling.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        from: { type: 'string', description: 'Window start, ISO 8601 date or datetime (e.g. 2026-08-10 or 2026-08-10T00:00:00Z). Required. Must be a concrete date, not a relative phrase.' },
+        to: { type: 'string', description: 'Window end, ISO 8601 date or datetime. Optional, defaults to now.' },
+        query: { type: 'string', description: 'Optional relevance query. Omit for a pure chronological browse; include to rank results within the window.' },
+        tiers: { type: 'array', items: { type: 'integer', enum: [1, 2, 3] }, minItems: 1, uniqueItems: true, description: 'Restrict results to these memory tiers. 1 raw memories, 2 reflections, 3 high-level reflections. Only tiers 2 and 3 carry importance ratings. Omit to include all tiers.' },
+        importance: { type: 'integer', minimum: 1, maximum: 10, description: "Minimum importance threshold, 1 to 10. Only reflections (tiers 2 and 3) carry ratings, so raw memories are excluded whenever this is set. For 'most important' questions use 7 or higher with tiers [2, 3]." },
+        max_tokens: { type: 'integer', minimum: 1000, maximum: 200000, description: 'Token budget for returned results. Server default 50000; use a smaller value like 5000 for a quick look.' },
+      },
+      required: ['from'],
+    },
+    annotations: { title: 'Date search MemoryRouter', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+  },
   {
     name: 'memory_store',
     description: 'Store a concise durable project memory. Returns a stable content-derived handle and deduplicates exact repeats.',
@@ -139,6 +156,48 @@ async function callTool(name, args = {}, options = {}) {
     }
     return textResult(text);
   }
+  if (name === 'memory_date_search') {
+    if (!args.from || typeof args.from !== 'string') return textResult('from is required (ISO 8601 date or datetime)', true);
+    if (args.tiers !== undefined) {
+      if (!Array.isArray(args.tiers) || args.tiers.length < 1 || args.tiers.some(tier => ![1, 2, 3].includes(tier))) {
+        return textResult('tiers must be a non-empty array drawn from [1, 2, 3]', true);
+      }
+    }
+    if (args.importance !== undefined && (!Number.isInteger(args.importance) || args.importance < 1 || args.importance > 10)) {
+      return textResult('importance must be an integer 1 to 10', true);
+    }
+    if (args.max_tokens !== undefined && (!Number.isInteger(args.max_tokens) || args.max_tokens < 1000 || args.max_tokens > 200000)) {
+      return textResult('max_tokens must be an integer between 1000 and 200000', true);
+    }
+    const params = { from: args.from };
+    if (typeof args.to === 'string' && args.to) params.to = args.to;
+    if (typeof args.query === 'string' && args.query.trim()) params.query = args.query.trim();
+    if (args.tiers !== undefined) params.tiers = args.tiers;
+    if (args.importance !== undefined) params.importance = args.importance;
+    if (args.max_tokens !== undefined) params.max_tokens = args.max_tokens;
+    const response = await api.dateSearch(key, params, { apiBase: config.apiBase, timeoutMs: 15000 });
+    if (!response.ok) {
+      const detail = response.data && response.data.error ? ` ${response.data.error}` : '';
+      return textResult(`Date search failed (HTTP ${response.status}).${detail}`, true);
+    }
+    const data = response.data || {};
+    const rows = Array.isArray(data.results) ? data.results : [];
+    if (!rows.length) return textResult('No memories in that window matched the filters.');
+    const lines = rows.map(row => {
+      const parsed = parseEnvelope(row.content);
+      const body = parsed ? parsed.body : String(row.content || '');
+      const tierTag = row.tier != null ? ` | tier ${row.tier}` : '';
+      const importanceTag = row.importance != null ? ` | importance ${row.importance}` : '';
+      return `[${row.date || 'unknown date'}${tierTag}${importanceTag}]\n${body}`;
+    });
+    const header = data.window
+      ? `Window ${data.window.from || params.from} to ${data.window.to || 'now'} (${rows.length} memories${data.truncated ? ', truncated' : ''}).`
+      : `${rows.length} memories${data.truncated ? ' (truncated)' : ''}.`;
+    const footer = data.truncated
+      ? `\n\nTruncated. Continue with ${data.next_to ? `to = ${data.next_to}` : data.next_from ? `from = ${data.next_from}` : 'a narrower window'}.`
+      : '';
+    return textResult(`${header}\n\n${lines.join('\n\n')}${footer}`);
+  }
   if (name === 'memory_store') {
     if (!args.content) return textResult('content is required', true);
     const result = await storeScoped(args.content, {