@gmickel/gno 1.18.0 → 1.19.0

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

@@ -0,0 +1,152 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-capture-result@1.0",
+  "title": "GNO MCP Capture Result",
+  "description": "Result payload for gno_capture",
+  "type": "object",
+  "required": [
+    "docid",
+    "uri",
+    "absPath",
+    "collection",
+    "relPath",
+    "created",
+    "openedExisting",
+    "createdWithSuffix",
+    "overwritten",
+    "contentHash",
+    "source",
+    "tags",
+    "sync",
+    "embed",
+    "collisionPolicyResult",
+    "serverInstanceId"
+  ],
+  "properties": {
+    "docid": {
+      "type": "string",
+      "description": "Document ID"
+    },
+    "uri": {
+      "type": "string",
+      "description": "Document URI",
+      "pattern": "^gno://[^/]+/.+"
+    },
+    "absPath": {
+      "type": "string",
+      "description": "Absolute path to the created file"
+    },
+    "collection": {
+      "type": "string",
+      "description": "Normalized collection name"
+    },
+    "relPath": {
+      "type": "string",
+      "description": "Relative path within collection"
+    },
+    "created": {
+      "type": "boolean",
+      "description": "True if file was created"
+    },
+    "openedExisting": {
+      "type": "boolean",
+      "description": "True if an existing file was opened"
+    },
+    "createdWithSuffix": {
+      "type": "boolean",
+      "description": "True if a suffixed path was created"
+    },
+    "overwritten": {
+      "type": "boolean",
+      "description": "True if existing file was overwritten"
+    },
+    "contentHash": {
+      "type": "string",
+      "description": "SHA-256 hash of normalized capture body content",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "source": {
+      "type": "object",
+      "required": ["kind", "capturedAt"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "direct",
+            "web",
+            "email",
+            "meeting",
+            "chat",
+            "file",
+            "api",
+            "unknown"
+          ]
+        },
+        "title": { "type": "string" },
+        "url": { "type": "string", "format": "uri" },
+        "uri": { "type": "string" },
+        "docid": { "type": "string" },
+        "mime": { "type": "string" },
+        "ext": { "type": "string" },
+        "author": { "type": "string" },
+        "observedAt": { "type": "string", "format": "date-time" },
+        "capturedAt": { "type": "string", "format": "date-time" },
+        "externalId": { "type": "string" }
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "sync": {
+      "$ref": "#/definitions/indexStatus"
+    },
+    "embed": {
+      "$ref": "#/definitions/indexStatus"
+    },
+    "collisionPolicyResult": {
+      "type": "string",
+      "enum": [
+        "created",
+        "opened_existing",
+        "created_with_suffix",
+        "overwritten",
+        "conflict"
+      ]
+    },
+    "serverInstanceId": {
+      "type": "string",
+      "description": "Server instance UUID",
+      "format": "uuid"
+    }
+  },
+  "definitions": {
+    "indexStatus": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "not_requested",
+            "pending",
+            "running",
+            "completed",
+            "skipped",
+            "failed",
+            "unknown"
+          ]
+        },
+        "jobId": {
+          "type": ["string", "null"]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/mcp-http-error.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-http-error@1.0",
+  "title": "GNO HTTP MCP Boundary Error",
+  "description": "Redacted stable JSON-RPC error body emitted before SDK dispatch for HTTP MCP boundary failures",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["jsonrpc", "error", "id"],
+  "properties": {
+    "jsonrpc": { "const": "2.0" },
+    "error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": { "const": -32000 },
+        "message": {
+          "enum": [
+            "Unauthorized",
+            "Forbidden",
+            "Request body too large",
+            "Too many requests",
+            "Resident runtime unavailable"
+          ]
+        }
+      }
+    },
+    "id": { "type": "null" }
+  }
+}

package/spec/output-schemas/mcp-job-list.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-job-list@1.0",
+  "title": "GNO MCP Job List",
+  "description": "Result payload for gno_list_jobs",
+  "type": "object",
+  "required": ["active", "recent"],
+  "properties": {
+    "active": {
+      "type": "array",
+      "description": "Active jobs",
+      "items": {
+        "type": "object",
+        "required": ["jobId", "type", "startedAt"],
+        "properties": {
+          "jobId": {
+            "type": "string",
+            "description": "Job identifier"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["add", "sync", "embed", "index"]
+          },
+          "startedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    },
+    "recent": {
+      "type": "array",
+      "description": "Recent completed jobs",
+      "items": {
+        "type": "object",
+        "required": ["jobId", "type", "status", "completedAt"],
+        "properties": {
+          "jobId": {
+            "type": "string",
+            "description": "Job identifier"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["add", "sync", "embed", "index"]
+          },
+          "status": {
+            "type": "string",
+            "enum": ["completed", "failed"]
+          },
+          "completedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/mcp-job-status.schema.json

@@ -0,0 +1,224 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-job-status@1.0",
+  "title": "GNO MCP Job Status",
+  "description": "Result payload for gno_job_status",
+  "type": "object",
+  "required": ["jobId", "type", "status", "startedAt", "serverInstanceId"],
+  "$defs": {
+    "collectionSyncResult": {
+      "type": "object",
+      "required": [
+        "collection",
+        "filesProcessed",
+        "filesAdded",
+        "filesUpdated",
+        "filesUnchanged",
+        "filesErrored",
+        "filesSkipped",
+        "filesMarkedInactive",
+        "durationMs",
+        "errors"
+      ],
+      "properties": {
+        "collection": {
+          "type": "string",
+          "description": "Collection name"
+        },
+        "filesProcessed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "filesAdded": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "filesUpdated": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "filesUnchanged": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "filesErrored": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "filesSkipped": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "filesMarkedInactive": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "durationMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "errors": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["relPath", "code", "message"],
+            "properties": {
+              "relPath": {
+                "type": "string"
+              },
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "syncResult": {
+      "type": "object",
+      "required": [
+        "collections",
+        "totalDurationMs",
+        "totalFilesProcessed",
+        "totalFilesAdded",
+        "totalFilesUpdated",
+        "totalFilesErrored",
+        "totalFilesSkipped"
+      ],
+      "properties": {
+        "collections": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/collectionSyncResult"
+          }
+        },
+        "totalDurationMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "totalFilesProcessed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "totalFilesAdded": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "totalFilesUpdated": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "totalFilesErrored": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "totalFilesSkipped": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "embedResult": {
+      "type": "object",
+      "required": ["embedded", "errors"],
+      "properties": {
+        "embedded": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of chunks embedded"
+        },
+        "errors": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of chunks that failed"
+        }
+      }
+    },
+    "indexResult": {
+      "type": "object",
+      "required": ["sync", "embed"],
+      "properties": {
+        "sync": {
+          "$ref": "#/$defs/syncResult"
+        },
+        "embed": {
+          "$ref": "#/$defs/embedResult"
+        }
+      }
+    },
+    "typedResult": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["kind", "value"],
+          "properties": {
+            "kind": { "const": "sync" },
+            "value": { "$ref": "#/$defs/syncResult" }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["kind", "value"],
+          "properties": {
+            "kind": { "const": "embed" },
+            "value": { "$ref": "#/$defs/embedResult" }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["kind", "value"],
+          "properties": {
+            "kind": { "const": "index" },
+            "value": { "$ref": "#/$defs/indexResult" }
+          }
+        }
+      ]
+    }
+  },
+  "properties": {
+    "jobId": {
+      "type": "string",
+      "description": "Job identifier"
+    },
+    "type": {
+      "type": "string",
+      "description": "Job type",
+      "enum": ["add", "sync", "embed", "index"]
+    },
+    "status": {
+      "type": "string",
+      "description": "Job status",
+      "enum": ["running", "completed", "failed"]
+    },
+    "startedAt": {
+      "type": "string",
+      "description": "Start time",
+      "format": "date-time"
+    },
+    "completedAt": {
+      "type": "string",
+      "description": "Completion time",
+      "format": "date-time"
+    },
+    "result": {
+      "description": "Legacy sync result (deprecated, use typedResult)",
+      "$ref": "#/$defs/syncResult"
+    },
+    "typedResult": {
+      "description": "Typed job result (discriminated union)",
+      "$ref": "#/$defs/typedResult"
+    },
+    "error": {
+      "type": "string",
+      "description": "Error message if failed"
+    },
+    "serverInstanceId": {
+      "type": "string",
+      "description": "Server instance UUID",
+      "format": "uuid"
+    }
+  }
+}

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

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-remove-result@1.0",
+  "title": "GNO MCP Remove Collection Result",
+  "description": "Result payload for gno_remove_collection",
+  "type": "object",
+  "required": [
+    "removed",
+    "collection",
+    "configUpdated",
+    "indexedDataRetained",
+    "note"
+  ],
+  "properties": {
+    "removed": {
+      "type": "boolean",
+      "description": "Whether the collection was removed",
+      "const": true
+    },
+    "collection": {
+      "type": "string",
+      "description": "Normalized collection name"
+    },
+    "configUpdated": {
+      "type": "boolean",
+      "description": "Config update status",
+      "const": true
+    },
+    "indexedDataRetained": {
+      "type": "boolean",
+      "description": "Indexed data retention flag",
+      "const": true
+    },
+    "note": {
+      "type": "string",
+      "description": "Explanation of retained data"
+    }
+  }
+}

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

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-sync-result@1.0",
+  "title": "GNO MCP Sync Result",
+  "description": "Result payload for gno_sync",
+  "type": "object",
+  "required": ["jobId", "collections", "status", "options"],
+  "properties": {
+    "jobId": {
+      "type": "string",
+      "description": "Job identifier"
+    },
+    "collections": {
+      "type": "array",
+      "description": "Collections included in the sync",
+      "items": {
+        "type": "string"
+      }
+    },
+    "status": {
+      "type": "string",
+      "description": "Job status",
+      "enum": ["started"]
+    },
+    "options": {
+      "type": "object",
+      "description": "Effective sync options",
+      "required": ["gitPull", "runUpdateCmd"],
+      "properties": {
+        "gitPull": {
+          "type": "boolean",
+          "description": "Run git pull before sync"
+        },
+        "runUpdateCmd": {
+          "type": "boolean",
+          "description": "Run update command before sync"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/mcp-tag-result@1.0",
+  "title": "GNO MCP Tag Result",
+  "description": "Result from gno_tag tool (add/remove tag)",
+  "type": "object",
+  "required": ["docid", "uri", "tag", "action"],
+  "properties": {
+    "docid": {
+      "type": "string",
+      "description": "Document ID",
+      "pattern": "^#[a-f0-9]{6,8}$"
+    },
+    "uri": {
+      "type": "string",
+      "description": "Document URI",
+      "pattern": "^gno://[^/]+/.+"
+    },
+    "tag": {
+      "type": "string",
+      "description": "Tag that was added or removed"
+    },
+    "action": {
+      "type": "string",
+      "enum": ["add", "remove"],
+      "description": "Action performed"
+    },
+    "wroteToFile": {
+      "type": "boolean",
+      "description": "Whether frontmatter was updated in source file"
+    }
+  }
+}

package/spec/output-schemas/models-list.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/models-list@1.0",
+  "title": "GNO Models List",
+  "description": "List of configured and cached models with preset information",
+  "type": "object",
+  "required": [
+    "activePreset",
+    "presets",
+    "embed",
+    "rerank",
+    "gen",
+    "cacheDir",
+    "totalSize"
+  ],
+  "properties": {
+    "activePreset": {
+      "type": "string",
+      "description": "ID of the currently active model preset"
+    },
+    "presets": {
+      "type": "array",
+      "description": "Available model presets",
+      "items": {
+        "$ref": "#/$defs/presetInfo"
+      }
+    },
+    "embed": {
+      "$ref": "#/$defs/modelStatus",
+      "description": "Embedding model status"
+    },
+    "rerank": {
+      "$ref": "#/$defs/modelStatus",
+      "description": "Reranker model status"
+    },
+    "gen": {
+      "$ref": "#/$defs/modelStatus",
+      "description": "Generation model status"
+    },
+    "cacheDir": {
+      "type": "string",
+      "description": "Path to model cache directory"
+    },
+    "totalSize": {
+      "type": "integer",
+      "description": "Total size of cached models in bytes",
+      "minimum": 0
+    }
+  },
+  "$defs": {
+    "presetInfo": {
+      "type": "object",
+      "required": ["id", "name", "active"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Preset identifier (e.g., slim, balanced, quality)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable preset name"
+        },
+        "active": {
+          "type": "boolean",
+          "description": "Whether this preset is currently active"
+        }
+      }
+    },
+    "modelStatus": {
+      "type": "object",
+      "required": ["uri", "cached", "path"],
+      "properties": {
+        "uri": {
+          "type": "string",
+          "description": "Model URI (hf: or file:)"
+        },
+        "cached": {
+          "type": "boolean",
+          "description": "Whether the model is cached locally"
+        },
+        "path": {
+          "type": ["string", "null"],
+          "description": "Local file path if cached"
+        },
+        "size": {
+          "type": "integer",
+          "description": "File size in bytes",
+          "minimum": 0
+        }
+      }
+    }
+  }
+}