edge-memory/spec/v1.0/schema.json at master · theianmay/edge-memory · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://edgememory.org/schemas/v1.0/entry.json",
  "title": "Edge Memory Entry",
  "description": "A single memory entry in the Edge Memory Protocol v1.0",
  "type": "object",
  "required": ["v", "id", "ts", "src", "content"],
  "properties": {
    "v": {
      "type": "string",
      "description": "Protocol version number",
      "pattern": "^\\d+\\.\\d+$",
      "examples": ["1.0"]
    },
    "id": {
      "type": "string",
      "description": "Unique identifier (UUID v4)",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
      "examples": ["550e8400-e29b-41d4-a716-446655440000"]
    },
    "ts": {
      "type": "number",
      "description": "Unix timestamp in milliseconds",
      "minimum": 0,
      "examples": [1701234567890]
    },
    "src": {
      "type": "string",
      "description": "Source application in reverse domain notation",
      "pattern": "^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)+$",
      "examples": ["com.example.app", "org.company.product"]
    },
    "content": {
      "type": "string",
      "description": "The memory content",
      "minLength": 1,
      "examples": ["User prefers dark mode"]
    },
    "type": {
      "type": "string",
      "description": "Memory type for categorization",
      "examples": ["preference", "fact", "event", "conversation", "note"]
    },
    "tags": {
      "type": "array",
      "description": "Tags for filtering and search",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9:_-]+$"
      },
      "uniqueItems": true,
      "examples": [["ui", "theme"], ["person:john", "calendar"]]
    },
    "meta": {
      "type": "object",
      "description": "App-specific metadata",
      "additionalProperties": true,
      "examples": [
        {"priority": "high"},
        {"location": "home", "confidence": 0.95}
      ]
    },
    "emb": {
      "type": "array",
      "description": "Embedding vector for semantic search",
      "items": {
        "type": "number"
      },
      "minItems": 1,
      "examples": [[0.123, 0.456, 0.789]]
    }
  },
  "additionalProperties": false
}