@gmickel/gno 2.5.1 → 2.6.0

package/spec/mcp.md

@@ -153,7 +153,7 @@ the resident gateway applies one profile to every connected client.
 
 | Profile          | Without `--enable-write`                                                                              | With `--enable-write`                                   |
 | ---------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
-| `full` (default) | Every read tool below (34)                                                                            | Every read tool plus every write tool (53)              |
+| `full` (default) | Every read tool below (37)                                                                            | Every read tool plus every write tool (59)              |
 | `core`           | `gno_query`, `gno_search`, `gno_get`, `gno_multi_get`, `gno_context`, `gno_changes`, `gno_recall` (7) | The 7 read tools plus `gno_capture`, `gno_remember` (9) |
 
 Both lists are exact: `core` advertises nothing else, and `full` is byte-for-byte
@@ -232,6 +232,10 @@ the core memory service acquires the same `.mcp-write.lock` lease for every
 memory write, so an MCP remember and a CLI writer serialise on one lease. A
 lease that stays busy past the wait window returns `MEMORY_WRITE_LEASE_BUSY`.
 
+With a `requestId`, `gno_capture` and `gno_remember` admit the request under
+this same lease; there is no second lock. A request whose earlier attempt
+still holds the lease past the wait window returns `REQUEST_PENDING`.
+
 ### Resident Streamable HTTP boundary
 
 `gno serve` and `gno daemon` mount the same stateful MCP surface at `/mcp`.
@@ -1531,6 +1535,10 @@ Create a new document in a collection (write-enabled).
         "capturedAt": { "type": "string", "format": "date-time" },
         "externalId": { "type": "string" }
       }
+    },
+    "requestId": {
+      "type": "string",
+      "description": "Optional caller request ID (1-128 of A-Z a-z 0-9 . _ : -). Reuse the same ID when retrying the same write after a lost response; a new intent needs a new ID"
     }
   },
   "required": ["collection"]
@@ -1585,6 +1593,13 @@ Create a new document in a collection (write-enabled).
   writing
 - Writes run under the MCP write lock and are only registered when the server
   starts with `--enable-write` or `GNO_MCP_ENABLE_WRITE=1`
+- `requestId` (optional) makes a retry of the same call safe; look it up with
+  [`gno_request_status`](#gno_request_status). Semantics:
+  `docs/guides/retries-and-request-ids.md`
+- With a `requestId`, the result adds
+  `request: { requestId, status: "committed", replayed, committedAt }` and the
+  text output adds `Request: <id> committed` (`(replayed)` on a replay). The
+  field is absent when no `requestId` was sent
 
 **Output Schema:** `gno://schemas/mcp-capture-result@1.0`, compatible with the
 shared `gno://schemas/capture-receipt@1.0` contract.
@@ -1651,6 +1666,10 @@ file edits update existing notes, `gno_remember` upserts a fact.
     "source": {
       "type": "string",
       "description": "Free-text evidence for the fact"
+    },
+    "requestId": {
+      "type": "string",
+      "description": "Optional caller request ID (1-128 of A-Z a-z 0-9 . _ : -). Reuse the same ID when retrying the same write after a lost response; a new intent needs a new ID"
     }
   },
   "required": ["text", "collection", "scopes"]
@@ -1668,6 +1687,9 @@ file edits update existing notes, `gno_remember` upserts a fact.
   searchable)
 - `matching` — `mode` (`semantic` | `lexical`), `threshold`, and
   `semanticUnavailable` when lexical matching was used
+- `request` — present on `existing`, `added`, and `superseded` results when a
+  `requestId` was sent: `{ requestId, status: "committed", replayed,
+committedAt }`
 
 **Notes:**
 
@@ -1682,6 +1704,10 @@ file edits update existing notes, `gno_remember` upserts a fact.
 - The core service holds the shared write lease for the write and lexical
   sync; the MCP adapter takes no lock of its own
 - Identity mapping is the same as `gno_recall`
+- `requestId` requires `decision` (`add` or `supersede`); a candidates-only
+  call with a `requestId` returns `REQUEST_ID_INVALID`. `caller`, `session`,
+  and the MCP session are not part of the request identity. Semantics:
+  `docs/guides/retries-and-request-ids.md`
 - Annotations: `readOnlyHint: false`, `destructiveHint: false`,
   `idempotentHint: false`
 
@@ -1693,10 +1719,178 @@ file edits update existing notes, `gno_remember` upserts a fact.
 `MEMORY_PREDECESSOR_NOT_FOUND`, `MEMORY_PREDECESSOR_HASH_MISMATCH`,
 `MEMORY_SUPERSEDE_CONFLICT`, `MEMORY_FENCED_REPLAY`, `MEMORY_FENCED_DERIVED`,
 `MEMORY_WRITE_LEASE_BUSY`, `MEMORY_SYNC_FAILED`,
-`MEMORY_SUPERSEDE_PROJECTION_FAILED`, `MEMORY_QUERY_FAILED`.
+`MEMORY_SUPERSEDE_PROJECTION_FAILED`, `MEMORY_QUERY_FAILED`, and the
+`REQUEST_*` codes listed under [`gno_request_status`](#gno_request_status).
 
 ---
 
+### gno_request_status
+
+Look up a `requestId` sent with `gno_capture` or `gno_remember` before retrying
+the write (write-enabled server).
+
+The tool is read-only but registered only when the server starts with
+`--enable-write` (or `GNO_MCP_ENABLE_WRITE=1`), and only on the `full` tool
+profile; `core` does not advertise it.
+
+**Input Schema:**
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "requestId": {
+      "type": "string",
+      "description": "Request ID previously sent with gno_capture or gno_remember"
+    }
+  },
+  "required": ["requestId"]
+}
+```
+
+**Response (`structuredContent`):** `gno://schemas/request-status@1.0`
+
+```json
+{
+  "requestId": "0f8e5c1a-3c1e-4d0b-9a57-2f4f3b8f2c11",
+  "status": "committed",
+  "operation": "capture",
+  "createdAt": "2026-09-24T08:00:00.000Z",
+  "updatedAt": "2026-09-24T08:00:00.120Z",
+  "result": {
+    "uri": "gno://notes/inbox/2026-09-24/capture-3f9c.md",
+    "docid": "#a1b2c3",
+    "contentHash": "<sha256>"
+  }
+}
+```
+
+- `status`: `pending` | `committed` | `expired` | `not_found`.
+- `operation`: `capture` | `remember` | `document.update`. `result` appears
+  only for `committed` and carries `uri`, `docid`, and `contentHash` (or
+  `sourceHash` for a document update). Never note or fact content. A
+  `not_found` result has only `requestId` and `status`.
+- Text output: `Request:`, `Status:`, and, when present, `Operation:`,
+  `Updated:`, `URI:` lines.
+
+**Namespaces:** stdio uses the local-owner namespace shared with the CLI, SDK,
+and `gno serve` REST; resident Streamable HTTP uses the authorized identity
+(loopback, or the configured bearer token), not the MCP session. Visibility
+and token-rotation rules: `docs/guides/retries-and-request-ids.md`.
+
+**Annotations:** `readOnlyHint: true`, `destructiveHint: false`,
+`idempotentHint: true`, `openWorldHint: false`.
+
+**Request error codes** (on `gno_capture`, `gno_remember`, and this tool; tool
+error text `CODE: message`, `structuredContent.error` = `CODE`):
+`REQUEST_ID_INVALID`, `REQUEST_ID_CONFLICT`, `REQUEST_EXPIRED`,
+`REQUEST_PENDING`, `REQUEST_RECOVERY_CONFLICT`, `REQUEST_CAPACITY_EXHAUSTED`,
+`REQUEST_LEDGER_UNAVAILABLE`. Meanings:
+`docs/guides/retries-and-request-ids.md#errors`.
+
+---
+
+### gno_sessions_status
+
+Read-only status of a session-archive server (a server started with the
+dedicated archive `--config` and `--index`). Registered with the `full`
+profile only; not part of `core`.
+
+**Input Schema:** `{}` (no arguments).
+
+**Output:** the shared `sessions-status` schema
+(`spec/output-schemas/sessions-status.schema.json`): archive collections with
+thread counts and, per owner-registered source, its ID, harness, destination
+collection, availability, unit counts (complete, incomplete, failed,
+pending), `sourceUnavailable`, `staleParser` and last import time, and the
+`automation` block (daemon state, per-profile state, hook and schedule
+switches, pending and running work, last run, last success, next due time,
+recovery action). The result contains no host paths.
+
+**Errors:** `SESSIONS_NOT_CONFIGURED` when the server's config has no
+`sessions` block.
+
+### gno_sessions_import
+
+Manually import one owner-registered session source into the archive and sync
+the changed archive files (write-enabled; `full` profile only). There is no
+MCP discovery tool: remote clients never learn host directories.
+
+**Input Schema:**
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["sourceId"],
+  "properties": {
+    "sourceId": {
+      "type": "string",
+      "description": "ID of an owner-registered session source (see gno_sessions_status)"
+    },
+    "dryRun": {
+      "type": "boolean",
+      "description": "Parse and report without writing archive or index state"
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100000,
+      "description": "Maximum changed units processed this call; the rest are deferred"
+    }
+  }
+}
+```
+
+Unknown keys (for example `paths`) are rejected: MCP imports name a
+registered source ID only.
+
+**Output:** the shared `sessions-import-receipt` schema. Partial imports
+(`status: "partial"`) stay visible and are retried by the next call; the
+receipt carries no host paths or session content.
+
+Registered only with `--enable-write` (like `gno_capture` and
+`gno_remember`); without it the tool is not advertised. A dispatch while
+writes are disabled returns `WRITE_DISABLED`.
+
+### gno_sessions_automation_run
+
+Run one owner-configured automation profile now through the manual importer
+and record the outcome in automation status (write-enabled; `full` profile
+only). It cannot enable hooks or schedules, add sources, or change
+destinations; those stay local-owner operations.
+
+**Input Schema:**
+
+```json
+{
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["profileId"],
+  "properties": {
+    "profileId": {
+      "type": "string",
+      "description": "ID of an owner-configured automation profile (see gno_sessions_status)"
+    }
+  }
+}
+```
+
+**Output:** the shared `sessions-automation-run` schema
+(`spec/output-schemas/sessions-automation-run.schema.json`): `ran`,
+`outcome` (`complete`, `up_to_date`, `partial`, `failed`, or `not_started`),
+`reason`, `pending`, and one `sessions-import-receipt` per source. No host
+paths or session content.
+
+**Errors:** `SESSIONS_UNKNOWN_PROFILE`, `SESSIONS_NOT_CONFIGURED`,
+`WRITE_DISABLED`; unknown keys are rejected.
+
+**Errors:** `SESSIONS_UNKNOWN_SOURCE`, `SESSIONS_SOURCE_UNAVAILABLE`,
+`SESSIONS_UNKNOWN_COLLECTION`, `SESSIONS_INVALID_INPUT`,
+`SESSIONS_NOT_CONFIGURED`; `SESSIONS_BUSY` when another import holds the
+archive lock; `SESSIONS_RUNTIME_FAILURE` (fixed, path-free message) for filesystem or
+index failures.
+
 ### gno_list_tags
 
 List all tags with document counts.
@@ -2793,6 +2987,8 @@ Resource errors use standard MCP error responses.
 - `MEMORY_*` — Memory contract errors from `gno_recall` / `gno_remember`;
   the stable code set is `MemoryErrorCode` in `src/core/memory.ts` and each
   tool section above lists the codes it returns
+- `REQUEST_*` — Request ID errors from `gno_capture`, `gno_remember`, and
+  `gno_request_status`; see [`gno_request_status`](#gno_request_status)
 
 ---
 

package/spec/output-schemas/capture-receipt.schema.json

@@ -129,6 +129,9 @@
         "overwritten",
         "conflict"
       ]
+    },
+    "request": {
+      "$ref": "gno://schemas/request-status@1.0#/$defs/requestReceipt"
     }
   },
   "definitions": {

package/spec/output-schemas/mcp-capture-result.schema.json

@@ -129,6 +129,9 @@
       "type": "string",
       "description": "Server instance UUID",
       "format": "uuid"
+    },
+    "request": {
+      "$ref": "gno://schemas/request-status@1.0#/$defs/requestReceipt"
     }
   },
   "definitions": {

package/spec/output-schemas/memory-remember.schema.json

@@ -12,7 +12,10 @@
       "properties": {
         "outcome": { "const": "existing" },
         "record": { "$ref": "#/$defs/fact" },
-        "matching": { "$ref": "#/$defs/matching" }
+        "matching": { "$ref": "#/$defs/matching" },
+        "request": {
+          "$ref": "gno://schemas/request-status@1.0#/$defs/requestReceipt"
+        }
       }
     },
     {
@@ -40,7 +43,10 @@
           "description": "Absolute path of the fact file that was written."
         },
         "sync": { "$ref": "#/$defs/sync" },
-        "matching": { "$ref": "#/$defs/matching" }
+        "matching": { "$ref": "#/$defs/matching" },
+        "request": {
+          "$ref": "gno://schemas/request-status@1.0#/$defs/requestReceipt"
+        }
       }
     }
   ],

package/spec/output-schemas/request-status.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/request-status@1.0",
+  "title": "GNO Request Status",
+  "description": "Content-free lookup of a write request ID (CLI `gno request-status --json`, MCP gno_request_status, REST GET /api/requests/:requestId, SDK client.requestStatus()). Lookups are confined to the caller's namespace; another namespace's request reads as not_found.",
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestId",
+        "status",
+        "operation",
+        "createdAt",
+        "updatedAt",
+        "result"
+      ],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": { "const": "committed" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the request committed."
+        },
+        "result": { "$ref": "#/$defs/result" }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestId",
+        "status",
+        "operation",
+        "createdAt",
+        "updatedAt"
+      ],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": {
+          "enum": ["pending", "expired"],
+          "description": "pending: accepted but not finished; retry the same call with the same ID. expired: already ran; its outcome was compacted; it will not run again."
+        },
+        "operation": { "$ref": "#/$defs/operation" },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requestId", "status"],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": {
+          "const": "not_found",
+          "description": "Nothing was accepted under this ID in the caller's namespace (or it was rejected before any write)."
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "requestReceipt": {
+      "type": "object",
+      "description": "The `request` field a write result carries when the caller sent a requestId (capture, remember, document update). replayed is true when an identical retry returned the recorded outcome without executing again. Shared by capture-receipt, mcp-capture-result, and memory-remember.",
+      "additionalProperties": false,
+      "required": ["requestId", "status", "replayed", "committedAt"],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": { "const": "committed" },
+        "replayed": { "type": "boolean" },
+        "committedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "requestId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
+    },
+    "operation": {
+      "enum": ["capture", "remember", "document.update"]
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "result": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Pointer to what the committed request produced. Never note or fact content.",
+      "properties": {
+        "uri": {
+          "type": "string",
+          "pattern": "^gno://[^/]+/.+"
+        },
+        "docid": { "type": "string" },
+        "contentHash": {
+          "$ref": "#/$defs/sha256",
+          "description": "Capture and remember: content hash of the note or fact."
+        },
+        "sourceHash": {
+          "$ref": "#/$defs/sha256",
+          "description": "Document update: source hash after the save."
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/sessions-automation-run.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-automation-run@1.0",
+  "title": "GNO Session Automation Run Result",
+  "description": "Result of running one automation profile (CLI `gno sessions automation run --json`, MCP gno_sessions_automation_run, REST POST /api/sessions/automation/run, SDK client.runSessionsAutomation()). Derived from SessionAutomationRunResult in src/sessions/types.ts. Contains no host paths or session content.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "profileId",
+    "ran",
+    "outcome",
+    "reason",
+    "pending",
+    "receipts"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "1"
+    },
+    "profileId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "ran": {
+      "type": "boolean",
+      "description": "False when nothing could start (busy, backoff, nothing pending, trigger disabled)."
+    },
+    "outcome": {
+      "enum": ["complete", "up_to_date", "partial", "failed", "not_started"]
+    },
+    "reason": {
+      "type": ["string", "null"]
+    },
+    "pending": {
+      "type": "boolean",
+      "description": "Admitted work is still waiting (deferred units, failure, busy)."
+    },
+    "receipts": {
+      "type": "array",
+      "items": {
+        "$ref": "gno://schemas/sessions-import-receipt@1.0"
+      }
+    }
+  }
+}

package/spec/output-schemas/sessions-discovery.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-discovery@1.0",
+  "title": "GNO Session Source Discovery",
+  "description": "Preview of supported local session sources (CLI `gno sessions discover --json`, REST GET /api/sessions/discover for same-host browsers only, SDK client.discoverSessions()). Discovery never imports. It carries host paths and is therefore never exposed over MCP or to non-local HTTP clients.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "candidates", "warnings"],
+  "properties": {
+    "schemaVersion": { "const": "1" },
+    "candidates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "harness",
+          "path",
+          "units",
+          "bytes",
+          "truncated",
+          "formatVersions",
+          "registeredAs"
+        ],
+        "properties": {
+          "harness": { "enum": ["codex", "claude-code", "openclaw", "hermes"] },
+          "path": { "type": "string", "minLength": 1 },
+          "units": { "type": "integer", "minimum": 0 },
+          "bytes": { "type": "integer", "minimum": 0 },
+          "truncated": { "type": "boolean" },
+          "formatVersions": { "type": "array", "items": { "type": "string" } },
+          "registeredAs": { "type": ["string", "null"] }
+        }
+      }
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/spec/output-schemas/sessions-import-receipt.schema.json

@@ -0,0 +1,156 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-import-receipt@1.0",
+  "title": "GNO Session Import Receipt",
+  "description": "Shared receipt of a manual session import on every surface (CLI `gno sessions import --json`, MCP gno_sessions_import, REST POST /api/sessions/import, SDK client.importSessions()). Derived from SessionImportReceipt in src/sessions/types.ts. Receipts never contain host paths or session content.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "dryRun",
+    "index",
+    "sourceIds",
+    "status",
+    "counts",
+    "turns",
+    "units",
+    "unitsTruncated",
+    "deferredUnits",
+    "lexical",
+    "embedding",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1" },
+    "dryRun": {
+      "type": "boolean",
+      "description": "True when nothing was written to the archive, checkpoint state or index."
+    },
+    "index": { "type": "string", "minLength": 1 },
+    "sourceIds": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "status": {
+      "enum": ["complete", "partial", "failed", "nothing_to_do"],
+      "description": "partial whenever any unit is incomplete, failed, unsupported or deferred, or lexical sync failed; failed when nothing was archived or unchanged and nothing is incomplete; a partial import is never reported complete."
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "imported",
+        "updated",
+        "unchanged",
+        "skippedPolicy",
+        "unsupported",
+        "incomplete",
+        "failed"
+      ],
+      "properties": {
+        "imported": { "type": "integer", "minimum": 0 },
+        "updated": { "type": "integer", "minimum": 0 },
+        "unchanged": { "type": "integer", "minimum": 0 },
+        "skippedPolicy": { "type": "integer", "minimum": 0 },
+        "unsupported": { "type": "integer", "minimum": 0 },
+        "incomplete": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "turns": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "human",
+        "assistant",
+        "redactions",
+        "injectedSkipped",
+        "copiedHistorySkipped",
+        "overLimit"
+      ],
+      "properties": {
+        "human": { "type": "integer", "minimum": 0 },
+        "assistant": { "type": "integer", "minimum": 0 },
+        "redactions": { "type": "integer", "minimum": 0 },
+        "injectedSkipped": { "type": "integer", "minimum": 0 },
+        "copiedHistorySkipped": { "type": "integer", "minimum": 0 },
+        "overLimit": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "units": {
+      "type": "array",
+      "maxItems": 200,
+      "items": { "$ref": "#/$defs/unit" }
+    },
+    "unitsTruncated": { "type": "boolean" },
+    "deferredUnits": { "type": "integer", "minimum": 0 },
+    "lexical": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "collections"],
+      "properties": {
+        "status": { "enum": ["ready", "failed", "skipped"] },
+        "collections": { "type": "array", "items": { "type": "string" } },
+        "error": { "type": "string" }
+      }
+    },
+    "embedding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["backlog"],
+      "properties": {
+        "backlog": {
+          "type": ["integer", "null"],
+          "minimum": 0,
+          "description": "Chunks awaiting embeddings in the archive index; null on dry runs."
+        }
+      }
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "unit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sourceId",
+        "harness",
+        "locator",
+        "outcome",
+        "threads",
+        "turns",
+        "collections"
+      ],
+      "properties": {
+        "sourceId": { "type": "string" },
+        "harness": {
+          "enum": ["codex", "claude-code", "openclaw", "hermes", null]
+        },
+        "locator": {
+          "type": "string",
+          "description": "Safe locator inside the source root (file name or database path), never a host path."
+        },
+        "outcome": {
+          "enum": [
+            "imported",
+            "updated",
+            "unchanged",
+            "skipped_policy",
+            "unsupported",
+            "incomplete",
+            "failed"
+          ]
+        },
+        "reason": { "type": "string" },
+        "threads": { "type": "integer", "minimum": 0 },
+        "turns": { "type": "integer", "minimum": 0 },
+        "collections": { "type": "array", "items": { "type": "string" } },
+        "unknownKinds": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 1 }
+        },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}