@gmickel/gno 1.24.0 → 1.25.1

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

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/clipper-error@1.0",
+  "title": "Browser Clipper Error",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["error"],
+  "properties": {
+    "error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "enum": [
+            "CLIPPER_ABORTED",
+            "CLIPPER_BODY_TOO_LARGE",
+            "CLIPPER_BUSY",
+            "CLIPPER_FORBIDDEN",
+            "CLIPPER_INVALID_JSON",
+            "CLIPPER_RATE_LIMITED",
+            "CLIPPER_UNAUTHORIZED",
+            "CLIPPER_PAIRING_UNAVAILABLE",
+            "CLIPPER_CSRF",
+            "CLIPPER_INVALID_REQUEST",
+            "CLIPPER_PAIR_NOT_FOUND",
+            "CLIPPER_PAIR_EXPIRED",
+            "CLIPPER_PAIR_INVALID_CODE",
+            "CLIPPER_PAIR_ALREADY_USED",
+            "CLIPPER_PREVIEW_MISMATCH",
+            "CLIPPER_PREVIEW_REQUIRED",
+            "CLIPPER_IDEMPOTENCY_PENDING",
+            "CLIPPER_IDEMPOTENCY_CONFLICT",
+            "CLIPPER_IDEMPOTENCY_RECOVERY_CONFLICT",
+            "CLIPPER_IDEMPOTENCY_GRANT_INACTIVE",
+            "CLIPPER_CAPTURE_FAILED",
+            "NOT_FOUND",
+            "RUNTIME",
+            "VALIDATION"
+          ]
+        },
+        "message": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/spec/output-schemas/clipper-pair-approval.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/clipper-pair-approval@1.0",
+  "title": "Browser Clipper Pair Approval",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "origin", "expiresAt"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "status": { "const": "approved" },
+    "origin": {
+      "type": "string",
+      "pattern": "^chrome-extension://[a-p]{32}$"
+    },
+    "expiresAt": { "type": "string", "format": "date-time" }
+  }
+}

package/spec/output-schemas/clipper-pair-start.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/clipper-pair-start@1.0",
+  "title": "Browser Clipper Pair Start",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "pairId",
+    "pairingCode",
+    "expiresAt",
+    "origin",
+    "approvalPath"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "pairId": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "pairingCode": { "type": "string", "pattern": "^[0-9]{8}$" },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "origin": {
+      "type": "string",
+      "pattern": "^chrome-extension://[a-p]{32}$"
+    },
+    "approvalPath": { "const": "/api/clipper/pair/approve" }
+  }
+}

package/spec/output-schemas/clipper-pair-status.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/clipper-pair-status@1.0",
+  "title": "Browser Clipper Pair Status",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "status", "expiresAt"],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "status": { "const": "pending" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "status",
+        "grantId",
+        "grantToken",
+        "expiresAt"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "status": { "const": "approved" },
+        "grantId": { "type": "string", "format": "uuid" },
+        "grantToken": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "status"],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "status": {
+          "enum": ["consumed", "expired", "not_found", "origin_mismatch"]
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/clipper-revoke@1.0",
+  "title": "Browser Clipper Grant Revocation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "grantId", "status"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "grantId": { "type": "string", "format": "uuid" },
+    "status": {
+      "enum": ["revoked", "already_revoked", "expired", "not_found"]
+    },
+    "revokedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "revoked" } } },
+      "then": {
+        "properties": {
+          "revokedAt": { "type": "string", "format": "date-time" }
+        },
+        "required": ["revokedAt"]
+      },
+      "else": { "not": { "required": ["revokedAt"] } }
+    }
+  ]
+}

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

@@ -89,9 +89,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": {

package/src/core/browser-clip-provenance.ts

@@ -0,0 +1,139 @@
+import { z } from "zod";
+
+export const BROWSER_CLIP_SCHEMA_VERSION = "1.0" as const;
+export const BROWSER_CLIP_MAX_BYTES = 512 * 1024;
+
+export const BROWSER_CLIP_WARNING_CODES = [
+  "authenticated_visible_content",
+  "canonical_url_differs",
+  "edited_content",
+  "line_endings_normalized",
+  "reader_partial",
+  "selection_truncated",
+  "spa_snapshot",
+  "unicode_normalized",
+] as const;
+
+export const BROWSER_CLIP_HTTP_URL_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})*)?$";
+
+const hasDisallowedControlCharacter = (value: string): boolean => {
+  for (const character of value) {
+    const codePoint = character.codePointAt(0);
+    if (
+      codePoint !== undefined &&
+      (codePoint <= 8 ||
+        codePoint === 11 ||
+        codePoint === 12 ||
+        (codePoint >= 14 && codePoint <= 31) ||
+        (codePoint >= 127 && codePoint <= 159))
+    ) {
+      return true;
+    }
+  }
+  return false;
+};
+
+export const findDisallowedBrowserClipControlPath = (
+  value: unknown,
+  path: Array<string | number> = []
+): Array<string | number> | null => {
+  if (typeof value === "string") {
+    return hasDisallowedControlCharacter(value) ? path : null;
+  }
+  if (Array.isArray(value)) {
+    for (const [index, child] of value.entries()) {
+      const match = findDisallowedBrowserClipControlPath(child, [
+        ...path,
+        index,
+      ]);
+      if (match !== null) return match;
+    }
+    return null;
+  }
+  if (value !== null && typeof value === "object") {
+    for (const [key, child] of Object.entries(value)) {
+      const match = findDisallowedBrowserClipControlPath(child, [...path, key]);
+      if (match !== null) return match;
+    }
+  }
+  return null;
+};
+
+export const browserClipHttpUrlSchema = z
+  .string()
+  .max(4096)
+  .regex(
+    new RegExp(BROWSER_CLIP_HTTP_URL_PATTERN, "u"),
+    "URL must use the browser clip HTTP(S) URL subset"
+  );
+
+const publishedAtSchema = z.union([
+  z.string().date(),
+  z.string().datetime({ offset: true }),
+]);
+
+const browserSchema = z
+  .object({
+    name: z.string().min(1).max(128),
+    version: z.string().max(128).nullable(),
+    platform: z.string().max(128).nullable(),
+  })
+  .strict();
+
+const sha256Schema = z.string().regex(/^[a-f0-9]{64}$/);
+
+export const browserClipProvenanceSchema = z
+  .object({
+    schemaVersion: z.literal(BROWSER_CLIP_SCHEMA_VERSION),
+    mode: z.enum(["selection", "reader"]),
+    sourceUrl: browserClipHttpUrlSchema,
+    canonicalUrl: browserClipHttpUrlSchema.nullable(),
+    title: z.string().min(1).max(2048),
+    author: z.string().max(1024).nullable(),
+    site: z.string().max(1024).nullable(),
+    publishedAt: publishedAtSchema.nullable(),
+    observedAt: z.string().datetime({ offset: true }),
+    capturedAt: z.string().datetime({ offset: true }),
+    extractionHash: sha256Schema,
+    finalBodyHash: sha256Schema,
+    clipIdentity: sha256Schema,
+    previewDigest: sha256Schema,
+    exactSelection: z.string().min(1).max(BROWSER_CLIP_MAX_BYTES).nullable(),
+    extractionWarnings: z.array(z.enum(BROWSER_CLIP_WARNING_CODES)).max(16),
+    browser: browserSchema,
+  })
+  .strict()
+  .superRefine((value, context) => {
+    const controlPath = findDisallowedBrowserClipControlPath(value);
+    if (controlPath !== null) {
+      context.addIssue({
+        code: "custom",
+        message: "Browser clip text cannot contain C0 or C1 control characters",
+        path: controlPath,
+      });
+    }
+    if (
+      new Set(value.extractionWarnings).size !== value.extractionWarnings.length
+    ) {
+      context.addIssue({
+        code: "custom",
+        message: "Warning codes must be unique",
+        path: ["extractionWarnings"],
+      });
+    }
+    if (
+      (value.mode === "selection" && value.exactSelection === null) ||
+      (value.mode === "reader" && value.exactSelection !== null)
+    ) {
+      context.addIssue({
+        code: "custom",
+        message: "Exact selection must match the extraction mode",
+        path: ["exactSelection"],
+      });
+    }
+  });
+
+export type BrowserClipProvenance = z.infer<typeof browserClipProvenanceSchema>;
+export type BrowserClipWarningCode =
+  (typeof BROWSER_CLIP_WARNING_CODES)[number];