SD-M3: the node-engine seat's read-only verb pull-waits (design 51, A7's ENG-9)

Optional until every engine serves it; answers each failed pull waiting on a store's holder. Claude-Session: https://claude.ai/code/session_01JG73KJNrH5EgFXMKKYSrig
2026-11-04 12:19:52 +01:00
parent 7f0b0f3b42
commit 5b4239e6d9
3 changed files with 138 additions and 3 deletions
@@ -6581,6 +6581,72 @@ export const list: readonly Seat[] = [
        },
        "name": "compose-candidate",
        "optional": true
+      },
+      {
+        "description": "The failed pulls this machine's engine waits on a store's holder for (design 51 *What a pull meets in the swap*): per module, the image, the seat it came through and that seat's holder, when the pull began, how many settled events of that holder it heard and the last, and its last retry and what started it. Read-only. Answered by this machine's engine alone.",
+        "input": {
+          "properties": {},
+          "type": "object"
+        },
+        "name": "pull-waits",
+        "optional": true,
+        "output": {
+          "properties": {
+            "waits": {
+              "description": "every failed pull waiting on a holder",
+              "items": {
+                "properties": {
+                  "holder": {
+                    "description": "that seat's holder, whose settled the retry waits on",
+                    "type": "string"
+                  },
+                  "image": {
+                    "description": "the image whose pull failed",
+                    "type": "string"
+                  },
+                  "module": {
+                    "description": "the module whose apply failed",
+                    "type": "string"
+                  },
+                  "pull-began": {
+                    "description": "when the failed pull began, RFC 3339",
+                    "type": "string"
+                  },
+                  "retry-last": {
+                    "description": "when it was last tried again, RFC 3339",
+                    "type": "string"
+                  },
+                  "retry-trigger": {
+                    "description": "what started that retry: settled, or the engine's start",
+                    "type": "string"
+                  },
+                  "seat": {
+                    "description": "the seat the image came through",
+                    "type": "string"
+                  },
+                  "settled-count": {
+                    "description": "the settled events of the holder heard since the engine started",
+                    "type": "integer"
+                  },
+                  "settled-last": {
+                    "description": "when the last was heard, RFC 3339",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "module",
+                  "image"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "waits"
+          ],
+          "type": "object"
+        }
      }
    ]
  },