@gmickel/gno 1.18.0 → 1.19.0

package/spec/output-schemas/multi-get.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/multi-get@1.0",
+  "title": "GNO Multi-Get Response",
+  "description": "Response from gno multi-get command",
+  "type": "object",
+  "required": ["documents", "meta"],
+  "properties": {
+    "documents": {
+      "type": "array",
+      "description": "Retrieved documents",
+      "items": {
+        "type": "object",
+        "required": ["docid", "uri", "content", "source"],
+        "properties": {
+          "docid": {
+            "type": "string",
+            "pattern": "^#[a-f0-9]{6,8}$"
+          },
+          "uri": {
+            "type": "string",
+            "pattern": "^gno://[^/]+/.+"
+          },
+          "title": {
+            "type": "string"
+          },
+          "content": {
+            "type": "string",
+            "description": "Mirror content (possibly truncated)"
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "Whether content was truncated due to maxBytes"
+          },
+          "totalLines": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "source": {
+            "type": "object",
+            "required": ["relPath", "mime", "ext"],
+            "properties": {
+              "absPath": { "type": "string" },
+              "relPath": { "type": "string" },
+              "mime": { "type": "string" },
+              "ext": { "type": "string", "pattern": "^\\.[a-zA-Z0-9]+$" }
+            }
+          }
+        }
+      }
+    },
+    "skipped": {
+      "type": "array",
+      "description": "Documents that were skipped",
+      "items": {
+        "type": "object",
+        "required": ["ref", "reason"],
+        "properties": {
+          "ref": {
+            "type": "string",
+            "description": "Requested reference"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Reason for skipping",
+            "enum": [
+              "not_found",
+              "exceeds_maxBytes",
+              "permission_denied",
+              "conversion_error",
+              "invalid_ref"
+            ]
+          }
+        }
+      }
+    },
+    "meta": {
+      "type": "object",
+      "required": ["requested", "returned", "skipped"],
+      "properties": {
+        "requested": {
+          "type": "integer",
+          "description": "Number of documents requested",
+          "minimum": 0
+        },
+        "returned": {
+          "type": "integer",
+          "description": "Number of documents returned",
+          "minimum": 0
+        },
+        "skipped": {
+          "type": "integer",
+          "description": "Number of documents skipped",
+          "minimum": 0
+        },
+        "maxBytes": {
+          "type": "integer",
+          "description": "Max bytes limit used"
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/process-status.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/process-status@1.0",
+  "title": "GNO Process Status",
+  "description": "Status of a detached gno serve or daemon process, reported by --status --json",
+  "type": "object",
+  "required": [
+    "running",
+    "pid",
+    "port",
+    "cmd",
+    "version",
+    "started_at",
+    "uptime_seconds",
+    "resident",
+    "pid_file",
+    "log_file",
+    "log_size_bytes"
+  ],
+  "properties": {
+    "running": {
+      "type": "boolean",
+      "description": "Whether a live matching process was found via pid-file + liveness probe"
+    },
+    "pid": {
+      "type": ["integer", "null"],
+      "minimum": 1,
+      "description": "Process ID from the pid-file, or null when no pid-file exists"
+    },
+    "port": {
+      "type": ["integer", "null"],
+      "minimum": 1,
+      "maximum": 65535,
+      "description": "Resident HTTP listener port, or null when no usable live process was found."
+    },
+    "cmd": {
+      "type": "string",
+      "enum": ["serve", "daemon"],
+      "description": "Which command the status is reporting on"
+    },
+    "version": {
+      "type": ["string", "null"],
+      "description": "GNO version recorded when the process was started; null when no pid-file exists"
+    },
+    "started_at": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of when the detached process was started; null when no pid-file exists"
+    },
+    "uptime_seconds": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "description": "Seconds since started_at, computed at status-read time; null when not running"
+    },
+    "resident": {
+      "anyOf": [
+        { "$ref": "gno://schemas/resident-status@1.0" },
+        { "type": "null" }
+      ],
+      "description": "Best-effort live redacted resident lifecycle snapshot, or null when unavailable."
+    },
+    "pid_file": {
+      "type": "string",
+      "description": "Absolute path to the pid-file that was consulted"
+    },
+    "log_file": {
+      "type": "string",
+      "description": "Absolute path to the log-file the detached process writes to"
+    },
+    "log_size_bytes": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "description": "Current size of the log-file in bytes, or null when the file does not exist"
+    }
+  },
+  "allOf": [
+    {
+      "description": "when running, pid/version/started_at/uptime_seconds must all be populated",
+      "if": {
+        "properties": { "running": { "const": true } },
+        "required": ["running"]
+      },
+      "then": {
+        "properties": {
+          "pid": { "type": "integer", "minimum": 1 },
+          "version": { "type": "string" },
+          "started_at": { "type": "string", "format": "date-time" },
+          "uptime_seconds": { "type": "integer", "minimum": 0 }
+        },
+        "required": ["pid", "version", "started_at", "uptime_seconds"]
+      }
+    },
+    {
+      "description": "when not running, uptime_seconds must be null (the process has no live uptime to report)",
+      "if": {
+        "properties": { "running": { "const": false } },
+        "required": ["running"]
+      },
+      "then": {
+        "properties": { "uptime_seconds": { "type": "null" } }
+      }
+    },
+    {
+      "description": "a live resident process must report its HTTP listening port as an integer",
+      "if": {
+        "properties": {
+          "running": { "const": true }
+        },
+        "required": ["running"]
+      },
+      "then": {
+        "properties": {
+          "port": { "type": "integer", "minimum": 1, "maximum": 65535 }
+        },
+        "required": ["port"]
+      }
+    }
+  ]
+}

package/spec/output-schemas/query-diagnose.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/query-diagnose@1.0",
+  "title": "GNO Query Diagnose",
+  "type": "object",
+  "required": ["schemaVersion", "query", "target", "stages", "chunk", "meta"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0" },
+    "query": { "type": "string" },
+    "target": {
+      "type": "object",
+      "required": [
+        "ref",
+        "status",
+        "docid",
+        "uri",
+        "title",
+        "contentType",
+        "contentTypeSource",
+        "categories",
+        "graphHints",
+        "contentTypeRulesFingerprint",
+        "contentTypeFingerprintMatches",
+        "mirrorHash",
+        "chunkCount",
+        "filterReasons"
+      ],
+      "properties": {
+        "ref": { "type": "string" },
+        "status": {
+          "type": "string",
+          "enum": [
+            "not_found",
+            "inactive",
+            "no_indexed_content",
+            "filtered_out",
+            "diagnosed"
+          ]
+        },
+        "docid": { "type": ["string", "null"], "pattern": "^#[a-f0-9]{6,}$" },
+        "uri": { "type": ["string", "null"], "format": "uri" },
+        "title": { "type": ["string", "null"] },
+        "contentType": { "type": ["string", "null"] },
+        "contentTypeSource": { "type": ["string", "null"] },
+        "categories": { "type": "array", "items": { "type": "string" } },
+        "graphHints": { "type": "array", "items": { "type": "string" } },
+        "contentTypeRulesFingerprint": { "type": ["string", "null"] },
+        "contentTypeFingerprintMatches": { "type": ["boolean", "null"] },
+        "mirrorHash": { "type": ["string", "null"] },
+        "chunkCount": { "type": "integer", "minimum": 0 },
+        "filterReasons": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "stages": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "status",
+          "sourceCount",
+          "present",
+          "rank",
+          "score",
+          "survived",
+          "dropReason"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "enum": ["bm25", "vector", "fusion", "graph", "rerank"]
+          },
+          "status": { "type": "string", "enum": ["active", "skipped"] },
+          "sourceCount": { "type": "integer", "minimum": 0 },
+          "present": { "type": "boolean" },
+          "rank": { "type": ["integer", "null"], "minimum": 1 },
+          "score": { "type": ["number", "null"] },
+          "survived": { "type": "boolean" },
+          "dropReason": {
+            "type": ["string", "null"],
+            "enum": ["not_in_candidate_set", "below_cutoff", "skipped", null]
+          },
+          "reason": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "chunk": {
+      "type": "object",
+      "required": ["seq", "startLine", "endLine", "language"],
+      "properties": {
+        "seq": { "type": ["integer", "null"], "minimum": 0 },
+        "startLine": { "type": ["integer", "null"], "minimum": 1 },
+        "endLine": { "type": ["integer", "null"], "minimum": 1 },
+        "language": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    },
+    "meta": {
+      "type": "object",
+      "required": ["mode", "vectorsUsed", "reranked", "totalResults"],
+      "properties": {
+        "mode": { "type": "string", "enum": ["bm25_only", "hybrid"] },
+        "vectorsUsed": { "type": "boolean" },
+        "reranked": { "type": "boolean" },
+        "totalResults": { "type": "integer", "minimum": 0 },
+        "queryModes": {
+          "type": "object",
+          "required": ["term", "intent", "hyde"],
+          "properties": {
+            "term": { "type": "integer", "minimum": 0 },
+            "intent": { "type": "integer", "minimum": 0 },
+            "hyde": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/spec/output-schemas/resident-status.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/resident-status@1.0",
+  "title": "GNO Resident Status",
+  "description": "Redacted lifecycle projection shared by resident and standalone status surfaces; excludes paths, tokens, queries, content, and caller identity",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "mode",
+    "resident",
+    "uptimeSeconds",
+    "listenerPort",
+    "admission",
+    "shutdown",
+    "transport",
+    "readers",
+    "models",
+    "jobs",
+    "generations"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "mode": {
+      "type": "string",
+      "enum": ["serve", "daemon", "stdio", "direct-cli"]
+    },
+    "resident": { "type": "boolean" },
+    "uptimeSeconds": { "type": ["integer", "null"], "minimum": 0 },
+    "listenerPort": {
+      "type": ["integer", "null"],
+      "minimum": 1,
+      "maximum": 65535
+    },
+    "admission": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "activeRequests"],
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": ["accepting", "draining", "closed"]
+        },
+        "activeRequests": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "shutdown": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state"],
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": ["none", "graceful", "deadline"]
+        }
+      }
+    },
+    "transport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "activeRequests",
+        "activeSessions",
+        "queuedRequests",
+        "maxConcurrentRequests",
+        "maxQueuedRequests",
+        "maxSessions"
+      ],
+      "properties": {
+        "activeRequests": { "type": "integer", "minimum": 0 },
+        "activeSessions": { "type": "integer", "minimum": 0 },
+        "queuedRequests": { "type": "integer", "minimum": 0 },
+        "maxConcurrentRequests": { "type": "integer", "minimum": 0 },
+        "maxQueuedRequests": { "type": "integer", "minimum": 0 },
+        "maxSessions": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "readers": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["active", "queued", "limit", "maxQueued"],
+      "properties": {
+        "active": { "type": "integer", "minimum": 0 },
+        "queued": { "type": "integer", "minimum": 0 },
+        "limit": { "type": "integer", "minimum": 0 },
+        "maxQueued": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "models": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "activeLeases",
+        "leaseAcquisitions",
+        "leaseReleases",
+        "loadedModels",
+        "loadAttempts",
+        "loadSuccesses",
+        "loadFailures",
+        "inflightLoads"
+      ],
+      "properties": {
+        "activeLeases": { "type": "integer", "minimum": 0 },
+        "leaseAcquisitions": { "type": "integer", "minimum": 0 },
+        "leaseReleases": { "type": "integer", "minimum": 0 },
+        "loadedModels": { "type": "integer", "minimum": 0 },
+        "loadAttempts": { "type": "integer", "minimum": 0 },
+        "loadSuccesses": { "type": "integer", "minimum": 0 },
+        "loadFailures": { "type": "integer", "minimum": 0 },
+        "inflightLoads": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "jobs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["active", "recent", "failed"],
+      "properties": {
+        "active": { "type": "integer", "minimum": 0 },
+        "recent": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "generations": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["content", "index"],
+      "properties": {
+        "content": { "type": "integer", "minimum": 0 },
+        "index": { "type": "integer", "minimum": 0 }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "resident": { "const": true } },
+        "required": ["resident"]
+      },
+      "then": {
+        "properties": {
+          "mode": { "enum": ["serve", "daemon"] },
+          "uptimeSeconds": { "type": "integer", "minimum": 0 }
+        }
+      },
+      "else": {
+        "properties": {
+          "mode": { "enum": ["stdio", "direct-cli"] },
+          "uptimeSeconds": { "type": "null" },
+          "listenerPort": { "type": "null" }
+        }
+      }
+    }
+  ]
+}