nexus.memory_create
Persist structured memories—episodic events, semantic facts, procedural how-tos—when users request to remember information. Supports metadata tags and temporal validity.
Instructions
Persist a new memory. Use when user explicitly asks to 'remember X' or when storing structured facts (preferences, decisions, code snippets with language tag). Set memory_type to 'episodic' for events, 'semantic' for facts, 'procedural' for how-tos.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | ||
| content | Yes | ||
| memory_type | No | semantic | |
| metadata | No | Free-form structured tags (e.g., {language: 'python', tags: ['snippet', 'react-hooks']}). Use ≤ 10 keys, value length ≤ 200 chars (proposal §ai R2 D-8 cap; over-cap → InvalidParams). | |
| valid_until | No | ||
| valid_until_source | No | v6 US-035 temporal validity (backend ValidUntilSource Literal, 5 values, locked in proposal §R2.1). MCP client typically passes 'sdk_provided' (user-declared) or omits to let backend worker auto-extract. Any value outside the 5-enum is rejected at args parse stage with InvalidParams. | |
| agent_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memory_id | Yes | ||
| created_at | Yes | ||
| conflict_resolution | No | If v6 US-036 ConflictResolver is enabled (per-tenant feature flag), resolution_status echoed here. NULL when feature flag disabled. status enum locked to 9 values (migration 020 CHECK). |