@gmickel/gno 1.20.0 → 1.22.0

package/spec/output-schemas/publish-artifact.schema.json

@@ -0,0 +1,284 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/publish-artifact@1.0",
+  "title": "GNO publish artifact",
+  "oneOf": [
+    { "$ref": "#/definitions/artifactV1" },
+    { "$ref": "#/definitions/artifactV2" }
+  ],
+  "definitions": {
+    "artifactV1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "source", "exportedAt", "spaces"],
+      "properties": {
+        "version": { "const": 1 },
+        "source": { "$ref": "#/definitions/slug" },
+        "exportedAt": { "type": "string", "format": "date-time" },
+        "spaces": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "oneOf": [
+              { "$ref": "#/definitions/publicSpace" },
+              { "$ref": "#/definitions/restrictedSpace" }
+            ]
+          }
+        }
+      }
+    },
+    "artifactV2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "source", "exportedAt", "spaces"],
+      "properties": {
+        "version": { "const": 2 },
+        "source": { "$ref": "#/definitions/slug" },
+        "exportedAt": { "type": "string", "format": "date-time" },
+        "spaces": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/encryptedSpace" }
+        }
+      }
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9](?:[a-z0-9-]{0,78}[a-z0-9])?$",
+      "maxLength": 80
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "docid": {
+      "type": "string",
+      "pattern": "^#[a-f0-9]{8}$"
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        ]
+      }
+    },
+    "note": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["markdown", "slug", "summary", "title"],
+      "properties": {
+        "markdown": { "type": "string" },
+        "metadata": { "$ref": "#/definitions/metadata" },
+        "slug": { "$ref": "#/definitions/slug" },
+        "summary": { "type": "string" },
+        "title": { "type": "string", "minLength": 1 }
+      }
+    },
+    "publicSpace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "notes",
+        "routeSlug",
+        "sourceType",
+        "summary",
+        "title",
+        "visibility",
+        "manifest"
+      ],
+      "properties": {
+        "homeNoteSlug": { "$ref": "#/definitions/slug" },
+        "notes": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/note" }
+        },
+        "routeSlug": { "$ref": "#/definitions/slug" },
+        "sourceType": { "enum": ["note", "collection"] },
+        "summary": { "type": "string" },
+        "title": { "type": "string", "minLength": 1 },
+        "visibility": { "const": "public" },
+        "manifest": { "$ref": "#/definitions/publicManifest" }
+      }
+    },
+    "restrictedSpace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "notes",
+        "routeSlug",
+        "sourceType",
+        "summary",
+        "title",
+        "visibility"
+      ],
+      "properties": {
+        "homeNoteSlug": { "$ref": "#/definitions/slug" },
+        "notes": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/note" }
+        },
+        "routeSlug": { "$ref": "#/definitions/slug" },
+        "sourceType": { "enum": ["note", "collection"] },
+        "summary": { "type": "string" },
+        "title": { "type": "string", "minLength": 1 },
+        "visibility": { "enum": ["secret-link", "invite-only"] }
+      }
+    },
+    "publicManifest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "projectionRevision",
+        "generatedAt",
+        "visibility",
+        "capabilities",
+        "documents"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "projectionRevision": { "$ref": "#/definitions/hash" },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "visibility": { "const": "public" },
+        "capabilities": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "capsuleEvidence",
+            "exactLineCitations",
+            "llmsTxt",
+            "markdownDocuments"
+          ],
+          "properties": {
+            "capsuleEvidence": { "const": true },
+            "exactLineCitations": { "const": true },
+            "llmsTxt": { "const": true },
+            "markdownDocuments": { "const": true }
+          }
+        },
+        "documents": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/publicDocument" }
+        }
+      }
+    },
+    "publicDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "slug",
+        "title",
+        "summary",
+        "markdownPath",
+        "contentHash",
+        "byteLength",
+        "lineCount",
+        "evidence"
+      ],
+      "properties": {
+        "slug": { "$ref": "#/definitions/slug" },
+        "title": { "type": "string", "minLength": 1 },
+        "summary": { "type": "string" },
+        "markdownPath": {
+          "type": "string",
+          "pattern": "^\\./[a-z0-9](?:[a-z0-9-]{0,78}[a-z0-9])?\\.md$"
+        },
+        "contentHash": { "$ref": "#/definitions/hash" },
+        "byteLength": { "type": "integer", "minimum": 0 },
+        "lineCount": { "type": "integer", "minimum": 1 },
+        "evidence": { "$ref": "#/definitions/publicEvidence" }
+      }
+    },
+    "publicEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "evidenceId",
+        "uri",
+        "docid",
+        "startLine",
+        "endLine",
+        "sourceHash",
+        "mirrorHash",
+        "passageHash",
+        "locator"
+      ],
+      "properties": {
+        "evidenceId": { "$ref": "#/definitions/hash" },
+        "uri": {
+          "type": "string",
+          "pattern": "^gno://public/[a-z0-9][a-z0-9-]{0,79}/[a-z0-9][a-z0-9-]{0,79}\\.md$"
+        },
+        "docid": { "$ref": "#/definitions/docid" },
+        "startLine": { "const": 1 },
+        "endLine": { "type": "integer", "minimum": 1 },
+        "sourceHash": { "$ref": "#/definitions/hash" },
+        "mirrorHash": { "$ref": "#/definitions/hash" },
+        "passageHash": { "$ref": "#/definitions/hash" },
+        "locator": {
+          "type": "string",
+          "pattern": "^\\./[a-z0-9][a-z0-9-]{0,79}\\.md#L1-L[1-9][0-9]*$"
+        }
+      }
+    },
+    "encryptedSpace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "encryptedPayload",
+        "routeSlug",
+        "secretToken",
+        "sourceType",
+        "visibility"
+      ],
+      "properties": {
+        "encryptedPayload": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ciphertext", "iterations", "iv", "salt"],
+          "properties": {
+            "ciphertext": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 67108864,
+              "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+            },
+            "iterations": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "iv": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+            },
+            "salt": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+            }
+          }
+        },
+        "routeSlug": { "$ref": "#/definitions/slug" },
+        "secretToken": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "sourceType": { "enum": ["note", "collection"] },
+        "visibility": { "const": "encrypted" }
+      }
+    }
+  }
+}

package/spec/output-schemas/saved-capsule-list.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-list@1.0",
+  "title": "GNO Saved Context Capsule List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "registrations"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "registrations": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": { "$ref": "gno://schemas/saved-capsule-registration@1.0" }
+    }
+  }
+}

package/spec/output-schemas/saved-capsule-registration.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-registration@1.0",
+  "title": "GNO Saved Context Capsule Registration",
+  "description": "Metadata-only registration for one caller-owned Context Capsule file. Capsule and passage bytes are never embedded in this payload.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "registrationId",
+    "filePath",
+    "fileHash",
+    "capsuleId",
+    "indexName",
+    "question",
+    "label",
+    "notificationPreference",
+    "registeredAtMs",
+    "updatedAtMs",
+    "lastAttemptedSequence",
+    "evidence",
+    "verification"
+  ],
+  "properties": {
+    "registrationId": {
+      "type": "string",
+      "pattern": "^capsule-[a-f0-9]{40}$"
+    },
+    "filePath": { "type": "string", "minLength": 1, "maxLength": 8192 },
+    "fileHash": { "$ref": "#/definitions/sha256" },
+    "capsuleId": { "$ref": "#/definitions/sha256" },
+    "indexName": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "question": {
+      "type": ["string", "null"],
+      "minLength": 1,
+      "maxLength": 8192
+    },
+    "label": {
+      "type": ["string", "null"],
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "notificationPreference": { "enum": ["none", "local"] },
+    "registeredAtMs": { "type": "integer", "minimum": 0 },
+    "updatedAtMs": { "type": "integer", "minimum": 0 },
+    "lastAttemptedSequence": { "type": "integer", "minimum": 0 },
+    "evidence": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": { "$ref": "#/definitions/evidenceReference" }
+    },
+    "verification": {
+      "anyOf": [{ "$ref": "#/definitions/verification" }, { "type": "null" }]
+    }
+  },
+  "definitions": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "evidenceReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "evidenceId",
+        "canonicalUri",
+        "collection",
+        "sourceHash",
+        "mirrorHash",
+        "passageHash"
+      ],
+      "properties": {
+        "evidenceId": { "$ref": "#/definitions/sha256" },
+        "canonicalUri": { "type": "string", "pattern": "^gno://.+" },
+        "collection": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": { "$ref": "#/definitions/sha256" },
+        "passageHash": { "$ref": "#/definitions/sha256" }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "registrationId",
+        "triggerKind",
+        "fromSequence",
+        "throughSequence",
+        "operationStatus",
+        "affectedQuestionState",
+        "affectedReasons",
+        "receiptJson",
+        "receiptHash",
+        "errorCode",
+        "errorMessage",
+        "verifiedAtMs"
+      ],
+      "properties": {
+        "registrationId": {
+          "type": "string",
+          "pattern": "^capsule-[a-f0-9]{40}$"
+        },
+        "triggerKind": { "enum": ["manual", "journal"] },
+        "fromSequence": { "type": "integer", "minimum": 0 },
+        "throughSequence": { "type": "integer", "minimum": 0 },
+        "operationStatus": { "enum": ["completed", "failed"] },
+        "affectedQuestionState": {
+          "enum": ["unaffected", "affected", "unknown"]
+        },
+        "affectedReasons": {
+          "type": "array",
+          "maxItems": 4,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "content_stale",
+              "content_missing",
+              "ranking_changed",
+              "fingerprint_changed"
+            ]
+          }
+        },
+        "receiptJson": {
+          "type": ["string", "null"],
+          "maxLength": 16777216
+        },
+        "receiptHash": {
+          "anyOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+        },
+        "errorCode": {
+          "type": ["string", "null"],
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "errorMessage": {
+          "type": ["string", "null"],
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "verifiedAtMs": { "type": "integer", "minimum": 0 }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "operationStatus": { "const": "completed" } },
+            "required": ["operationStatus"]
+          },
+          "then": {
+            "properties": {
+              "affectedQuestionState": {
+                "enum": ["unaffected", "affected"]
+              },
+              "receiptJson": { "type": "string", "minLength": 1 },
+              "receiptHash": { "$ref": "#/definitions/sha256" },
+              "errorCode": { "type": "null" },
+              "errorMessage": { "type": "null" }
+            }
+          },
+          "else": {
+            "properties": {
+              "affectedQuestionState": { "const": "unknown" },
+              "affectedReasons": { "type": "array", "maxItems": 0 },
+              "receiptJson": { "type": "null" },
+              "receiptHash": { "type": "null" },
+              "errorCode": { "type": "string", "minLength": 1 },
+              "errorMessage": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/spec/output-schemas/saved-capsule-reverification.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-reverification@1.0",
+  "title": "GNO Saved Context Capsule Reverification Result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "registration", "verification", "receipt"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "registration": {
+      "$ref": "gno://schemas/saved-capsule-registration@1.0"
+    },
+    "verification": {
+      "$ref": "gno://schemas/saved-capsule-registration@1.0#/definitions/verification"
+    },
+    "receipt": {
+      "anyOf": [
+        { "$ref": "gno://schemas/context-capsule-verification@1.0" },
+        { "type": "null" }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": { "operationStatus": { "const": "completed" } },
+            "required": ["operationStatus"]
+          }
+        },
+        "required": ["verification"]
+      },
+      "then": {
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": { "triggerKind": { "const": "manual" } },
+            "required": ["triggerKind"]
+          },
+          "receipt": {
+            "$ref": "gno://schemas/context-capsule-verification@1.0"
+          }
+        }
+      },
+      "else": {
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": { "triggerKind": { "const": "manual" } },
+            "required": ["triggerKind"]
+          },
+          "receipt": { "type": "null" }
+        }
+      }
+    }
+  ]
+}

package/spec/output-schemas/saved-capsule-unwatch.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-unwatch@1.0",
+  "title": "GNO Saved Context Capsule Unwatch Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "registrationId", "removed"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "registrationId": {
+      "type": "string",
+      "pattern": "^capsule-[a-f0-9]{40}$"
+    },
+    "removed": { "const": true }
+  }
+}

package/spec/output-schemas/saved-capsule-watch.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-watch@1.0",
+  "title": "GNO Saved Context Capsule Watch Result",
+  "allOf": [
+    {
+      "$ref": "gno://schemas/saved-capsule-registration@1.0"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "verification": { "type": "null" }
+      },
+      "required": ["verification"]
+    }
+  ]
+}