@gmickel/gno 1.17.0 → 1.19.0

package/spec/output-schemas/retrieval-trace-filters.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/retrieval-trace-filters@1.0",
+  "title": "GNO Retrieval Trace Filters",
+  "definitions": {
+    "queryMode": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "text"],
+      "properties": {
+        "mode": { "enum": ["term", "intent", "hyde"] },
+        "text": { "type": "string", "maxLength": 8192 }
+      }
+    },
+    "filters": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": { "type": "integer", "minimum": 1 },
+        "minScore": { "type": "number", "minimum": 0, "maximum": 1 },
+        "collection": { "type": "string", "maxLength": 256 },
+        "collections": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        },
+        "lang": { "type": "string", "maxLength": 64 },
+        "full": { "type": "boolean" },
+        "lineNumbers": { "type": "boolean" },
+        "tagsAll": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": { "type": "string", "maxLength": 512 }
+        },
+        "tagsAny": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": { "type": "string", "maxLength": 512 }
+        },
+        "since": { "type": "string", "maxLength": 128 },
+        "until": { "type": "string", "maxLength": 128 },
+        "categories": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": { "type": "string", "maxLength": 512 }
+        },
+        "author": { "type": "string", "maxLength": 1024 },
+        "intent": { "type": "string", "maxLength": 8192 },
+        "exclude": {
+          "type": "array",
+          "maxItems": 1000,
+          "items": { "type": "string", "maxLength": 1024 }
+        },
+        "noExpand": { "type": "boolean" },
+        "noRerank": { "type": "boolean" },
+        "candidateLimit": { "type": "integer", "minimum": 1 },
+        "explain": { "type": "boolean" },
+        "graph": { "type": "boolean" },
+        "noGraph": { "type": "boolean" },
+        "queryLanguageHint": { "type": "string", "maxLength": 64 },
+        "queryModes": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/definitions/queryMode" }
+        },
+        "uriPrefix": { "type": "string", "maxLength": 4096 }
+      }
+    },
+    "metadataShape": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "enum": ["null", "array", "object", "string", "number", "boolean"]
+        },
+        "count": { "type": "integer", "minimum": 0 },
+        "itemTypes": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": ["null", "array", "object", "string", "number", "boolean"]
+          }
+        },
+        "fields": { "$ref": "#/definitions/metadataFilterFields" }
+      }
+    },
+    "metadataFilterFields": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": { "$ref": "#/definitions/metadataShape" },
+        "minScore": { "$ref": "#/definitions/metadataShape" },
+        "collection": { "$ref": "#/definitions/metadataShape" },
+        "collections": { "$ref": "#/definitions/metadataShape" },
+        "lang": { "$ref": "#/definitions/metadataShape" },
+        "full": { "$ref": "#/definitions/metadataShape" },
+        "lineNumbers": { "$ref": "#/definitions/metadataShape" },
+        "tagsAll": { "$ref": "#/definitions/metadataShape" },
+        "tagsAny": { "$ref": "#/definitions/metadataShape" },
+        "since": { "$ref": "#/definitions/metadataShape" },
+        "until": { "$ref": "#/definitions/metadataShape" },
+        "categories": { "$ref": "#/definitions/metadataShape" },
+        "author": { "$ref": "#/definitions/metadataShape" },
+        "intent": { "$ref": "#/definitions/metadataShape" },
+        "exclude": { "$ref": "#/definitions/metadataShape" },
+        "noExpand": { "$ref": "#/definitions/metadataShape" },
+        "noRerank": { "$ref": "#/definitions/metadataShape" },
+        "candidateLimit": { "$ref": "#/definitions/metadataShape" },
+        "explain": { "$ref": "#/definitions/metadataShape" },
+        "graph": { "$ref": "#/definitions/metadataShape" },
+        "noGraph": { "$ref": "#/definitions/metadataShape" },
+        "queryLanguageHint": { "$ref": "#/definitions/metadataShape" },
+        "queryModes": { "$ref": "#/definitions/metadataShape" },
+        "uriPrefix": { "$ref": "#/definitions/metadataShape" }
+      }
+    },
+    "metadataFilters": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["shape"],
+      "properties": {
+        "shape": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "fields"],
+          "properties": {
+            "type": { "const": "object" },
+            "fields": { "$ref": "#/definitions/metadataFilterFields" }
+          }
+        }
+      }
+    }
+  },
+  "oneOf": [
+    { "$ref": "#/definitions/filters" },
+    { "$ref": "#/definitions/metadataFilters" }
+  ]
+}

package/spec/output-schemas/retrieval-trace-judgment.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/retrieval-trace-judgment@1.0",
+  "title": "GNO Retrieval Trace Judgment",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "result", "judgment"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "result": { "enum": ["inserted", "duplicate"] },
+    "judgment": {
+      "$ref": "gno://schemas/retrieval-trace-common@1.0#/definitions/judgment"
+    }
+  }
+}

package/spec/output-schemas/retrieval-trace-list.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/retrieval-trace-list@1.0",
+  "title": "GNO Retrieval Trace List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "traces", "nextCursor"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "traces": {
+      "type": "array",
+      "items": {
+        "$ref": "gno://schemas/retrieval-trace-common@1.0#/definitions/summary"
+      }
+    },
+    "nextCursor": { "type": ["string", "null"] }
+  }
+}

package/spec/output-schemas/retrieval-trace-payloads.schema.json

@@ -0,0 +1,178 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/retrieval-trace-payloads@1.0",
+  "title": "GNO Retrieval Trace Payloads",
+  "definitions": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "identity": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": { "docid": {} },
+          "required": ["docid"]
+        },
+        {
+          "type": "object",
+          "properties": { "sourceHash": {} },
+          "required": ["sourceHash"]
+        },
+        {
+          "type": "object",
+          "properties": { "mirrorHash": {} },
+          "required": ["mirrorHash"]
+        },
+        {
+          "type": "object",
+          "properties": { "uri": {} },
+          "required": ["uri"]
+        }
+      ]
+    },
+    "evidenceRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "allOf": [{ "$ref": "#/definitions/identity" }],
+      "dependencies": {
+        "startLine": ["endLine"],
+        "endLine": ["startLine"]
+      },
+      "properties": {
+        "docid": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": { "$ref": "#/definitions/sha256" },
+        "uri": { "type": "string", "pattern": "^gno://", "maxLength": 4096 },
+        "seq": { "type": "integer", "minimum": 0 },
+        "startLine": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 },
+        "score": { "type": "number" },
+        "rank": { "type": "integer", "minimum": 1 },
+        "plannerRank": { "type": "integer", "minimum": 1 },
+        "passageHash": { "$ref": "#/definitions/sha256" },
+        "sources": {
+          "type": "array",
+          "maxItems": 16,
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "graphExpanded": { "type": "boolean" }
+      }
+    },
+    "evidencePayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["evidence"],
+      "properties": {
+        "evidence": {
+          "type": "array",
+          "maxItems": 10000,
+          "items": { "$ref": "#/definitions/evidenceRef" }
+        },
+        "latencyMs": { "type": "number", "minimum": 0 }
+      }
+    },
+    "retrievalPayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ranked"],
+      "properties": {
+        "ranked": {
+          "type": "array",
+          "maxItems": 10000,
+          "items": { "$ref": "#/definitions/evidenceRef" }
+        },
+        "latencyMs": { "type": "number", "minimum": 0 },
+        "capabilities": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "fallbackCodes": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        }
+      }
+    },
+    "contextPayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["evidence", "capsuleId"],
+      "properties": {
+        "evidence": {
+          "type": "array",
+          "maxItems": 10000,
+          "items": { "$ref": "#/definitions/evidenceRef" }
+        },
+        "capsuleId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "latencyMs": { "type": "number", "minimum": 0 }
+      }
+    },
+    "queryPayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "filterFingerprint": { "$ref": "#/definitions/sha256" }
+      }
+    },
+    "capabilityPayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["capability", "status"],
+      "properties": {
+        "capability": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "status": {
+          "enum": ["attempted", "used", "unavailable", "failed"]
+        },
+        "reasonCode": { "type": "string", "minLength": 1, "maxLength": 128 }
+      }
+    },
+    "completePayload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["outcome"],
+      "properties": {
+        "outcome": { "enum": ["completed", "partial", "failed", "cancelled"] },
+        "latencyMs": { "type": "number", "minimum": 0 }
+      }
+    },
+    "judgmentTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "allOf": [{ "$ref": "#/definitions/identity" }],
+      "dependencies": {
+        "startLine": ["endLine"],
+        "endLine": ["startLine"]
+      },
+      "properties": {
+        "docid": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": { "$ref": "#/definitions/sha256" },
+        "uri": { "type": "string", "pattern": "^gno://", "maxLength": 4096 },
+        "seq": { "type": "integer", "minimum": 0 },
+        "startLine": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 },
+        "plannerRank": { "type": "integer", "minimum": 1 },
+        "passageHash": { "$ref": "#/definitions/sha256" },
+        "sources": {
+          "type": "array",
+          "maxItems": 16,
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "graphExpanded": { "type": "boolean" }
+      }
+    },
+    "documentTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "allOf": [{ "$ref": "#/definitions/identity" }],
+      "properties": {
+        "docid": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": { "$ref": "#/definitions/sha256" },
+        "uri": { "type": "string", "pattern": "^gno://", "maxLength": 4096 }
+      }
+    }
+  }
+}

package/spec/output-schemas/retrieval-trace-purge.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/retrieval-trace-purge@1.0",
+  "title": "GNO Retrieval Trace Purge",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "traces",
+    "runs",
+    "events",
+    "judgments",
+    "exports",
+    "exportLinks",
+    "physicalCleanup",
+    "checkpointedFrames",
+    "remainingWalFrames"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "traces": { "type": "integer", "minimum": 0 },
+    "runs": { "type": "integer", "minimum": 0 },
+    "events": { "type": "integer", "minimum": 0 },
+    "judgments": { "type": "integer", "minimum": 0 },
+    "exports": { "type": "integer", "minimum": 0 },
+    "exportLinks": { "type": "integer", "minimum": 0 },
+    "physicalCleanup": { "enum": ["completed", "wal_busy", "failed"] },
+    "checkpointedFrames": { "type": "integer", "minimum": 0 },
+    "remainingWalFrames": { "type": "integer", "minimum": 0 }
+  }
+}