@gmickel/gno 2.4.0 → 2.6.0

package/spec/output-schemas/compiled-context-preview.schema.json

@@ -0,0 +1,142 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "rendererVersion": {
+      "type": "string",
+      "const": "1"
+    },
+    "capsuleId": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "markdown": {
+      "type": "string"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "verificationDigest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "lineageDigest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "budget": {
+      "type": "object",
+      "properties": {
+        "requestedTokens": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 1000000
+        },
+        "requestedBytes": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 4194304
+        },
+        "usedTokens": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "usedBytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "estimator": {
+          "type": "string",
+          "enum": ["unicode_conservative", "active_tokenizer"]
+        },
+        "tokenizerFingerprint": {
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^[a-f0-9]{64}$"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "requestedTokens",
+        "requestedBytes",
+        "usedTokens",
+        "usedBytes",
+        "estimator",
+        "tokenizerFingerprint"
+      ],
+      "additionalProperties": false
+    },
+    "coverage": {
+      "type": "object",
+      "properties": {
+        "complete": {
+          "type": "boolean"
+        },
+        "coveredFacets": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "unresolvedFacets": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": ["complete", "coveredFacets", "unresolvedFacets"],
+      "additionalProperties": false
+    },
+    "evidenceIds": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      }
+    },
+    "omissions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "evidenceId": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": ["evidenceId", "reason"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "rendererVersion",
+    "capsuleId",
+    "markdown",
+    "digest",
+    "verificationDigest",
+    "lineageDigest",
+    "budget",
+    "coverage",
+    "evidenceIds",
+    "omissions"
+  ],
+  "additionalProperties": false
+}

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" } }
+      }
+    }
+  }
+}