eidetic-engine 0.15.2

Durable, local-first, explainable memory for coding agents.
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://eidetic-engine/schemas/ee.pack.stream.v1.json",
  "title": "ee.pack.stream.v1",
  "description": "NDJSON frame contract for ee context --stream. Each line is exactly one frame object.",
  "oneOf": [
    {"$ref": "#/$defs/headerFrame"},
    {"$ref": "#/$defs/itemFrame"},
    {"$ref": "#/$defs/trailerFrame"},
    {"$ref": "#/$defs/errorFrame"}
  ],
  "$defs": {
    "headerFrame": {
      "type": "object",
      "required": [
        "schema",
        "kind",
        "packId",
        "query",
        "workspaceId",
        "requestId",
        "profile",
        "maxTokens",
        "candidatePool",
        "memoryScope",
        "strictScope",
        "startedAt"
      ],
      "additionalProperties": false,
      "properties": {
        "schema": {"type": "string", "const": "ee.pack.stream.v1"},
        "kind": {"type": "string", "const": "header"},
        "packId": {"type": "string"},
        "query": {"type": "string"},
        "workspaceId": {"type": "string"},
        "requestId": {"type": "string"},
        "profile": {"type": "string"},
        "maxTokens": {"type": "integer", "minimum": 1},
        "candidatePool": {"type": "integer", "minimum": 1},
        "memoryScope": {"type": "string"},
        "strictScope": {"type": "boolean"},
        "startedAt": {"type": "string", "format": "date-time"},
        "featureFlagsHash": {"type": ["string", "null"]},
        "canonicalKeyHash": {"type": ["string", "null"]},
        "degraded": {"type": "array", "items": {"$ref": "#/$defs/degradation"}}
      }
    },
    "itemFrame": {
      "type": "object",
      "required": [
        "schema",
        "kind",
        "packId",
        "seq",
        "rank",
        "memoryId",
        "section",
        "content",
        "estimatedTokens",
        "scores",
        "why",
        "provenance",
        "trust"
      ],
      "additionalProperties": false,
      "properties": {
        "schema": {"type": "string", "const": "ee.pack.stream.v1"},
        "kind": {"type": "string", "const": "item"},
        "packId": {"type": "string"},
        "seq": {"type": "integer", "minimum": 0},
        "rank": {"type": "integer", "minimum": 1},
        "memoryId": {"type": "string"},
        "section": {"type": "string"},
        "content": {"type": "string"},
        "estimatedTokens": {"type": "integer", "minimum": 0},
        "scores": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "why": {"type": "string"},
        "provenance": {
          "type": "array",
          "items": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}}
        },
        "trust": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "diversityKey": {"type": ["string", "null"]},
        "selectedIn": {"type": "string"},
        "lifecycle": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "redactions": {
          "type": "array",
          "items": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}}
        }
      }
    },
    "trailerFrame": {
      "type": "object",
      "required": [
        "schema",
        "kind",
        "packId",
        "packHash",
        "totalItems",
        "usedTokens",
        "selectionAudit",
        "quality",
        "degraded",
        "completedAt"
      ],
      "additionalProperties": false,
      "properties": {
        "schema": {"type": "string", "const": "ee.pack.stream.v1"},
        "kind": {"type": "string", "const": "trailer"},
        "packId": {"type": "string"},
        "packHash": {"type": "string"},
        "totalItems": {"type": "integer", "minimum": 0},
        "usedTokens": {"type": "integer", "minimum": 0},
        "selectionAudit": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "quality": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "skippedTotal": {"type": "integer", "minimum": 0},
        "provenanceFooter": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "coordination": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "packDna": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}},
        "degraded": {"type": "array", "items": {"$ref": "#/$defs/degradation"}},
        "completedAt": {"type": "string", "format": "date-time"}
      }
    },
    "errorFrame": {
      "type": "object",
      "required": ["schema", "kind", "packId", "error"],
      "additionalProperties": false,
      "properties": {
        "schema": {"type": "string", "const": "ee.pack.stream.v1"},
        "kind": {"type": "string", "enum": ["error", "cancelled"]},
        "packId": {"type": ["string", "null"]},
        "emittedItems": {"type": "integer", "minimum": 0},
        "error": {"$ref": "#/$defs/error"},
        "degraded": {"type": "array", "items": {"$ref": "#/$defs/degradation"}},
        "completedAt": {"type": "string", "format": "date-time"}
      }
    },
    "degradation": {
      "type": "object",
      "required": ["code", "severity", "message"],
      "additionalProperties": false,
      "properties": {
        "code": {"type": "string"},
        "severity": {
          "type": "string",
          "enum": ["info", "low", "warning", "medium", "high", "critical"]
        },
        "message": {"type": "string"},
        "repair": {"type": ["string", "null"]},
        "sources": {
          "type": "array",
          "items": {"type": "string"},
          "description": "Aggregated degradation source labels emitted when duplicate degraded entries are merged."
        },
        "details": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}}
      }
    },
    "error": {
      "type": "object",
      "required": ["code", "message", "severity"],
      "additionalProperties": false,
      "properties": {
        "code": {"type": "string"},
        "message": {"type": "string"},
        "severity": {
          "type": "string",
          "enum": ["info", "low", "warning", "medium", "high", "critical"]
        },
        "repair": {"type": ["string", "null"]},
        "details": {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}}
      }
    },
    "jsonValue": {
      "oneOf": [
        {"type": "null"},
        {"type": "boolean"},
        {"type": "number"},
        {"type": "string"},
        {"type": "array", "items": {"$ref": "#/$defs/jsonValue"}},
        {"type": "object", "additionalProperties": {"$ref": "#/$defs/jsonValue"}}
      ]
    }
  }
}