snipara_remember_if_novel
Idempotent
Store a memory only when it is novel compared to existing reviewed memories, with automatic deduplication and optional supersede of similar records.
Instructions
Store one durable Memory V2 record only when it is sufficiently different from existing reviewed memory. This EDITOR operation may write project, team, user, or agent state; duplicate calls normally skip the write, while auto_safe reconciliation may supersede high-confidence same-owner matches without deleting them. Use snipara_end_of_task_commit for multi-outcome workflow capture and context tools for source documents. Returns whether storage occurred, duplicate evidence, the memory ID, and reconciliation actions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The memory text to store | |
| type | No | Durable knowledge type used for authority, retention, and later recall filtering. | fact |
| scope | No | Memory owner boundary. scope=agent requires agent_id; scope=user is personal to the authenticated user or integrator external_user_id. | project |
| source | No | Optional source label for the memory write | |
| agent_id | No | Required when scope=agent; identifies the agent-owned memory namespace | |
| category | No | Optional stable category used to group and deduplicate related memories. | |
| ttl_days | No | Optional retention period in days; omit only for knowledge that should not expire automatically. | |
| related_to | No | Existing memory IDs that provide an explicit relationship, not duplicate candidates. | |
| dedupe_limit | No | Maximum nearest existing memories examined before deciding whether this write is novel. | |
| document_refs | No | Project-relative source document paths supporting this memory; never place secrets here. | |
| allow_supersede | No | Reserved for future conflict handling | |
| external_user_id | No | Integrator client keys only: stable end-user ID for scope=user memory. Snipara hashes and namespaces it per integrator client. | |
| novelty_threshold | No | Similarity threshold above which a memory is treated as duplicate | |
| memory_reconciliation_mode | No | After storing, find older similar memories. recommend returns supersede candidates only; auto_safe supersedes only high-confidence same-scope/type/category matches. No physical deletion. | recommend |