@gmickel/gno 1.24.0 → 1.26.0

package/spec/output-schemas/browser-clip.schema.json

@@ -0,0 +1,586 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/browser-clip@1.0",
+  "title": "GNO Browser Clip Payload",
+  "description": "Closed local browser-clip request. Reader extraction is a constrained semantic AST; raw HTML is not accepted.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "mode",
+    "sourceUrl",
+    "canonicalUrl",
+    "title",
+    "author",
+    "site",
+    "publishedAt",
+    "observedAt",
+    "browser",
+    "extraction",
+    "destination",
+    "tags",
+    "note"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "mode": { "enum": ["selection", "reader"] },
+    "sourceUrl": { "$ref": "#/definitions/httpUrl" },
+    "canonicalUrl": {
+      "oneOf": [{ "$ref": "#/definitions/httpUrl" }, { "type": "null" }]
+    },
+    "title": {
+      "allOf": [
+        { "$ref": "#/definitions/controlSafeString" },
+        { "type": "string", "minLength": 1, "maxLength": 2048 }
+      ]
+    },
+    "author": {
+      "oneOf": [
+        {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "maxLength": 1024 }
+          ]
+        },
+        { "type": "null" }
+      ]
+    },
+    "site": {
+      "oneOf": [
+        {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "maxLength": 1024 }
+          ]
+        },
+        { "type": "null" }
+      ]
+    },
+    "publishedAt": {
+      "oneOf": [
+        {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "format": "date" }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "format": "date-time" }
+          ]
+        },
+        { "type": "null" }
+      ]
+    },
+    "observedAt": {
+      "allOf": [
+        { "$ref": "#/definitions/controlSafeString" },
+        { "type": "string", "format": "date-time" }
+      ]
+    },
+    "browser": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version", "platform"],
+      "properties": {
+        "name": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "minLength": 1, "maxLength": 128 }
+          ]
+        },
+        "version": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 128 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "platform": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 128 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "extraction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "visibility",
+        "authenticated",
+        "extractorVersion",
+        "warnings"
+      ],
+      "properties": {
+        "visibility": { "const": "user_visible" },
+        "authenticated": { "type": "boolean" },
+        "extractorVersion": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "minLength": 1, "maxLength": 128 }
+          ]
+        },
+        "warnings": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "$ref": "#/definitions/warningCode" }
+        }
+      }
+    },
+    "destination": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["collection", "relPath", "folderPath", "collisionPolicy"],
+      "properties": {
+        "collection": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "minLength": 1, "maxLength": 128 }
+          ]
+        },
+        "relPath": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "minLength": 1, "maxLength": 2048 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "folderPath": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "minLength": 1, "maxLength": 2048 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "collisionPolicy": {
+          "enum": ["error", "open_existing", "create_with_suffix"]
+        }
+      },
+      "not": {
+        "properties": {
+          "relPath": { "type": "string" },
+          "folderPath": { "type": "string" }
+        },
+        "required": ["relPath", "folderPath"]
+      }
+    },
+    "tags": {
+      "type": "array",
+      "maxItems": 128,
+      "items": {
+        "allOf": [
+          { "$ref": "#/definitions/controlSafeString" },
+          { "type": "string", "minLength": 1, "maxLength": 256 }
+        ]
+      }
+    },
+    "note": {
+      "oneOf": [
+        {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "maxLength": 32768 }
+          ]
+        },
+        { "type": "null" }
+      ]
+    },
+    "selection": { "$ref": "#/definitions/selection" },
+    "reader": { "$ref": "#/definitions/reader" }
+  },
+  "oneOf": [
+    {
+      "properties": {
+        "mode": { "const": "selection" },
+        "selection": {}
+      },
+      "required": ["selection"],
+      "not": { "properties": { "reader": {} }, "required": ["reader"] }
+    },
+    {
+      "properties": {
+        "mode": { "const": "reader" },
+        "reader": {}
+      },
+      "required": ["reader"],
+      "not": {
+        "properties": { "selection": {} },
+        "required": ["selection"]
+      }
+    }
+  ],
+  "definitions": {
+    "controlSafeString": {
+      "type": "string",
+      "pattern": "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F-\\u009F]*$"
+    },
+    "httpUrl": {
+      "type": "string",
+      "maxLength": 4096,
+      "pattern": "^[Hh][Tt][Tt][Pp][Ss]?://(?:(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])|(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)*[A-Za-z](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)(?::(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?(?:(?:/(?:[A-Za-z0-9._~!$&'()*+,;=:@-]|%[0-9A-Fa-f]{2})*)*)(?:\\?(?:[A-Za-z0-9._~!$&'()*+,;=:@/?-]|%[0-9A-Fa-f]{2})*)?(?:#(?:[A-Za-z0-9._~!$&'()*+,;=:@/?-]|%[0-9A-Fa-f]{2})*)?$"
+    },
+    "warningCode": {
+      "enum": [
+        "authenticated_visible_content",
+        "canonical_url_differs",
+        "edited_content",
+        "line_endings_normalized",
+        "reader_partial",
+        "selection_truncated",
+        "spa_snapshot",
+        "unicode_normalized"
+      ]
+    },
+    "inline": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "text"],
+          "properties": {
+            "type": { "const": "text" },
+            "text": {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "minLength": 1, "maxLength": 32768 }
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "text", "href"],
+          "properties": {
+            "type": { "const": "link" },
+            "text": {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "minLength": 1, "maxLength": 32768 }
+              ]
+            },
+            "href": { "$ref": "#/definitions/httpUrl" }
+          }
+        }
+      ]
+    },
+    "inlineContent": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 256,
+      "items": { "$ref": "#/definitions/inline" }
+    },
+    "readerBlock": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "content"],
+          "properties": {
+            "type": { "const": "paragraph" },
+            "content": { "$ref": "#/definitions/inlineContent" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "level", "content"],
+          "properties": {
+            "type": { "const": "heading" },
+            "level": { "type": "integer", "minimum": 1, "maximum": 6 },
+            "content": { "$ref": "#/definitions/inlineContent" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "content"],
+          "properties": {
+            "type": { "const": "quote" },
+            "content": { "$ref": "#/definitions/inlineContent" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "ordered", "items"],
+          "properties": {
+            "type": { "const": "list" },
+            "ordered": { "type": "boolean" },
+            "items": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 256,
+              "items": { "$ref": "#/definitions/inlineContent" }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "language", "text"],
+          "properties": {
+            "type": { "const": "code" },
+            "language": {
+              "oneOf": [
+                {
+                  "allOf": [
+                    { "$ref": "#/definitions/controlSafeString" },
+                    {
+                      "type": "string",
+                      "pattern": "^[A-Za-z0-9_+-]{1,32}$"
+                    }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            },
+            "text": {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 131072 }
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type"],
+          "properties": { "type": { "const": "horizontal_rule" } }
+        }
+      ]
+    },
+    "selection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["exactText", "editedMarkdown"],
+      "properties": {
+        "exactText": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "minLength": 1, "maxLength": 524288 }
+          ]
+        },
+        "editedMarkdown": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 524288 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "reader": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["blocks", "editedMarkdown"],
+      "properties": {
+        "blocks": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 4096,
+          "items": { "$ref": "#/definitions/readerBlock" }
+        },
+        "editedMarkdown": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 524288 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "mode",
+        "sourceUrl",
+        "canonicalUrl",
+        "title",
+        "author",
+        "site",
+        "publishedAt",
+        "observedAt",
+        "capturedAt",
+        "extractionHash",
+        "finalBodyHash",
+        "clipIdentity",
+        "previewDigest",
+        "exactSelection",
+        "extractionWarnings",
+        "browser"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "mode": { "enum": ["selection", "reader"] },
+        "sourceUrl": { "$ref": "#/definitions/httpUrl" },
+        "canonicalUrl": {
+          "oneOf": [{ "$ref": "#/definitions/httpUrl" }, { "type": "null" }]
+        },
+        "title": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "minLength": 1, "maxLength": 2048 }
+          ]
+        },
+        "author": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 1024 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "site": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 1024 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "publishedAt": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "format": "date" }
+              ]
+            },
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "format": "date-time" }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "observedAt": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "format": "date-time" }
+          ]
+        },
+        "capturedAt": {
+          "allOf": [
+            { "$ref": "#/definitions/controlSafeString" },
+            { "type": "string", "format": "date-time" }
+          ]
+        },
+        "extractionHash": { "$ref": "#/definitions/sha256" },
+        "finalBodyHash": { "$ref": "#/definitions/sha256" },
+        "clipIdentity": { "$ref": "#/definitions/sha256" },
+        "previewDigest": { "$ref": "#/definitions/sha256" },
+        "exactSelection": {
+          "oneOf": [
+            {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "maxLength": 524288 }
+              ]
+            },
+            { "type": "null" }
+          ]
+        },
+        "extractionWarnings": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "$ref": "#/definitions/warningCode" }
+        },
+        "browser": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "version", "platform"],
+          "properties": {
+            "name": {
+              "allOf": [
+                { "$ref": "#/definitions/controlSafeString" },
+                { "type": "string", "minLength": 1, "maxLength": 128 }
+              ]
+            },
+            "version": {
+              "oneOf": [
+                {
+                  "allOf": [
+                    { "$ref": "#/definitions/controlSafeString" },
+                    { "type": "string", "maxLength": 128 }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            },
+            "platform": {
+              "oneOf": [
+                {
+                  "allOf": [
+                    { "$ref": "#/definitions/controlSafeString" },
+                    { "type": "string", "maxLength": 128 }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "mode": { "const": "selection" } } },
+          "then": {
+            "properties": {
+              "exactSelection": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "mode": { "const": "reader" } } },
+          "then": { "properties": { "exactSelection": { "type": "null" } } }
+        }
+      ]
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    }
+  }
+}

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

@@ -4,6 +4,7 @@
   "title": "GNO Capture Receipt",
   "description": "Shared receipt returned by capture surfaces after a write/open decision.",
   "type": "object",
+  "additionalProperties": false,
   "required": [
     "uri",
     "collection",
@@ -19,6 +20,10 @@
     "collisionPolicyResult"
   ],
   "properties": {
+    "schemaVersion": {
+      "const": "1.0",
+      "description": "Present on browser-clipper HTTP responses."
+    },
     "uri": {
       "type": "string",
       "description": "GNO URI for the captured note.",
@@ -40,6 +45,9 @@
       "type": "string",
       "description": "Absolute path when the local surface exposes it."
     },
+    "serverInstanceId": {
+      "type": "string"
+    },
     "created": {
       "type": "boolean",
       "description": "True when a new file was written."
@@ -63,6 +71,7 @@
     },
     "source": {
       "type": "object",
+      "additionalProperties": false,
       "required": ["kind", "capturedAt"],
       "properties": {
         "kind": {
@@ -85,9 +94,20 @@
         "mime": { "type": "string" },
         "ext": { "type": "string" },
         "author": { "type": "string" },
+        "canonicalUrl": { "type": "string", "format": "uri" },
+        "site": { "type": "string" },
+        "publishedAt": {
+          "oneOf": [
+            { "type": "string", "format": "date" },
+            { "type": "string", "format": "date-time" }
+          ]
+        },
         "observedAt": { "type": "string", "format": "date-time" },
         "capturedAt": { "type": "string", "format": "date-time" },
-        "externalId": { "type": "string" }
+        "externalId": { "type": "string" },
+        "browserClip": {
+          "$ref": "gno://schemas/browser-clip@1.0#/definitions/provenance"
+        }
       }
     },
     "tags": {
@@ -114,6 +134,7 @@
   "definitions": {
     "indexStatus": {
       "type": "object",
+      "additionalProperties": false,
       "required": ["status"],
       "properties": {
         "status": {

package/spec/output-schemas/clipper-csrf.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/clipper-csrf@1.0",
+  "title": "Browser Clipper Approval CSRF",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "csrfToken"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "csrfToken": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}