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

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://eidetic-engine/schemas/ee.cursor.v1.json",
  "title": "ee.cursor.v1",
  "description": "Continuation-cursor payload for output-token-governed list surfaces (ADR 0063 ยง3, payload amended by bd-7lvbg.3). The wire form is opaque: base64url(payload).base64url(blake3_mac), where the MAC is a keyed BLAKE3 over the canonical payload bytes using a deterministic per-workspace key (BLAKE3 derive_key with context 'ee.cursor.v1 workspace mac key v1' over the workspace scope string). This document describes the decoded payload object. Cursors never embed secrets or raw query text; paramsHash is a BLAKE3 of the normalized invocation parameters. Resuming with a MAC or paramsHash mismatch yields the cursor_invalid degraded code; resuming after the workspace DB generation advanced yields cursor_stale (repair for both: re-run without --cursor). A rejected cursor always yields an empty page plus the degraded entry, never a restarted page, so a page sequence can never duplicate items.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema",
    "targetSchema",
    "dbGeneration",
    "positionKey",
    "droppedCount",
    "paramsHash"
  ],
  "properties": {
    "schema": {
      "const": "ee.cursor.v1"
    },
    "targetSchema": {
      "type": "string",
      "minLength": 1,
      "description": "Schema id of the governed response the cursor continues (e.g. ee.search.v1). Surfaces identified only by data.command use the ee.command:<command> form."
    },
    "dbGeneration": {
      "type": "integer",
      "minimum": 0,
      "description": "Workspace DB generation the page sequence was issued at. Pages must partition exactly one generation's result set (no duplicates, no gaps); a lower value than the current generation is rejected as cursor_stale, a higher value as cursor_invalid."
    },
    "positionKey": {
      "type": "string",
      "description": "Honesty cross-check on resume (the element's registered key field, falling back to its original array index). Flat truncation points name the last emitted element; per-section points (sections[].items[]) name the last withheld element in the engine's deterministic round-robin drop order, which is the form that stays coordinate-stable across pages. A recomputation mismatch on resume rejects the cursor as cursor_invalid."
    },
    "droppedCount": {
      "type": "integer",
      "minimum": 1,
      "description": "Count of elements still unemitted when the cursor was issued. This is what reconstructs the emitted set on resume: per-section round-robin shapes map many drop counts onto the same last-kept element, so a position key alone is ambiguous. Pre-amendment payloads without this field are rejected as cursor_invalid (legacy format)."
    },
    "paramsHash": {
      "type": "string",
      "pattern": "^blake3:[0-9a-f]{64}$",
      "description": "BLAKE3 of the length-prefixed normalized query/filter parameters, excluding the governor's own flags (--max-output-tokens and the --cursor token itself) so the same query at a different ceiling stays resumable."
    }
  },
  "x-ee-status": {
    "shipped": true,
    "available_in_build": true,
    "tracking_bead": "bd-7lvbg.3"
  }
}