@gmickel/gno 2.5.1 → 2.7.0

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

@@ -0,0 +1,113 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/request-status@1.0",
+  "title": "GNO Request Status",
+  "description": "Content-free lookup of a write request ID (CLI `gno request-status --json`, MCP gno_request_status, REST GET /api/requests/:requestId, SDK client.requestStatus()). Lookups are confined to the caller's namespace; another namespace's request reads as not_found.",
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestId",
+        "status",
+        "operation",
+        "createdAt",
+        "updatedAt",
+        "result"
+      ],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": { "const": "committed" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the request committed."
+        },
+        "result": { "$ref": "#/$defs/result" }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestId",
+        "status",
+        "operation",
+        "createdAt",
+        "updatedAt"
+      ],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": {
+          "enum": ["pending", "expired"],
+          "description": "pending: accepted but not finished; retry the same call with the same ID. expired: already ran; its outcome was compacted; it will not run again."
+        },
+        "operation": { "$ref": "#/$defs/operation" },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requestId", "status"],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": {
+          "const": "not_found",
+          "description": "Nothing was accepted under this ID in the caller's namespace (or it was rejected before any write)."
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "requestReceipt": {
+      "type": "object",
+      "description": "The `request` field a write result carries when the caller sent a requestId (capture, remember, document update). replayed is true when an identical retry returned the recorded outcome without executing again. Shared by capture-receipt, mcp-capture-result, and memory-remember.",
+      "additionalProperties": false,
+      "required": ["requestId", "status", "replayed", "committedAt"],
+      "properties": {
+        "requestId": { "$ref": "#/$defs/requestId" },
+        "status": { "const": "committed" },
+        "replayed": { "type": "boolean" },
+        "committedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "requestId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
+    },
+    "operation": {
+      "enum": ["capture", "remember", "document.update"]
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "result": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Pointer to what the committed request produced. Never note or fact content.",
+      "properties": {
+        "uri": {
+          "type": "string",
+          "pattern": "^gno://[^/]+/.+"
+        },
+        "docid": { "type": "string" },
+        "contentHash": {
+          "$ref": "#/$defs/sha256",
+          "description": "Capture and remember: content hash of the note or fact."
+        },
+        "sourceHash": {
+          "$ref": "#/$defs/sha256",
+          "description": "Document update: source hash after the save."
+        }
+      }
+    }
+  }
+}

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

@@ -128,6 +128,28 @@
         "content": { "type": "integer", "minimum": 0 },
         "index": { "type": "integer", "minimum": 0 }
       }
+    },
+    "backgroundIssues": {
+      "description": "Present only while a background job is in trouble: failing passes, retries parked, a pass overrunning, or (client-side) a resident that did not answer its status request",
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/definitions/backgroundIssue" }
+    }
+  },
+  "definitions": {
+    "backgroundIssue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["job", "state", "consecutiveFailures", "runningSeconds"],
+      "properties": {
+        "job": { "type": "string", "enum": ["embed", "resident"] },
+        "state": {
+          "type": "string",
+          "enum": ["failing", "parked", "overrunning", "unresponsive"]
+        },
+        "consecutiveFailures": { "type": "integer", "minimum": 0 },
+        "runningSeconds": { "type": ["integer", "null"], "minimum": 0 }
+      }
     }
   },
   "allOf": [

package/spec/output-schemas/search-result.schema.json

@@ -78,7 +78,7 @@
       "properties": {
         "absPath": {
           "type": "string",
-          "description": "Absolute path (included with --source or in MCP)"
+          "description": "Absolute source path. Host path: local callers only (CLI, stdio MCP, same-host Web UI/REST); omitted for remote REST and HTTP MCP callers, which identify the document by uri + relPath."
         },
         "relPath": {
           "type": "string",

package/spec/output-schemas/search-results.schema.json

@@ -237,7 +237,7 @@
           "properties": {
             "absPath": {
               "type": "string",
-              "description": "Absolute filesystem path when resolvable from collection root + relPath. Default field on gno search --json (no --source flag). Omitted when unresolvable; consumers fall back to the URI tail for display and disable file-open."
+              "description": "Absolute filesystem path when resolvable from collection root + relPath. Default field on gno search --json (no --source flag). Omitted when unresolvable, and always omitted for remote REST and HTTP MCP callers (host paths reach only CLI, stdio MCP and same-host Web UI/REST callers); consumers fall back to uri + relPath for display and disable file-open."
             },
             "relPath": {
               "type": "string",

package/spec/output-schemas/sessions-automation-run.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-automation-run@1.0",
+  "title": "GNO Session Automation Run Result",
+  "description": "Result of running one automation profile (CLI `gno sessions automation run --json`, MCP gno_sessions_automation_run, REST POST /api/sessions/automation/run, SDK client.runSessionsAutomation()). Derived from SessionAutomationRunResult in src/sessions/types.ts. Contains no host paths or session content.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "profileId",
+    "ran",
+    "outcome",
+    "reason",
+    "pending",
+    "receipts"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "1"
+    },
+    "profileId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "ran": {
+      "type": "boolean",
+      "description": "False when nothing could start (busy, backoff, nothing pending, trigger disabled)."
+    },
+    "outcome": {
+      "enum": ["complete", "up_to_date", "partial", "failed", "not_started"]
+    },
+    "reason": {
+      "type": ["string", "null"]
+    },
+    "pending": {
+      "type": "boolean",
+      "description": "Admitted work is still waiting (deferred units, failure, busy)."
+    },
+    "receipts": {
+      "type": "array",
+      "items": {
+        "$ref": "gno://schemas/sessions-import-receipt@1.0"
+      }
+    }
+  }
+}

package/spec/output-schemas/sessions-discovery.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-discovery@1.0",
+  "title": "GNO Session Source Discovery",
+  "description": "Preview of supported local session sources (CLI `gno sessions discover --json`, REST GET /api/sessions/discover for same-host browsers only, SDK client.discoverSessions()). Discovery never imports. It carries host paths and is therefore never exposed over MCP or to non-local HTTP clients.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "candidates", "warnings"],
+  "properties": {
+    "schemaVersion": { "const": "1" },
+    "candidates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "harness",
+          "path",
+          "units",
+          "bytes",
+          "truncated",
+          "formatVersions",
+          "registeredAs"
+        ],
+        "properties": {
+          "harness": { "enum": ["codex", "claude-code", "openclaw", "hermes"] },
+          "path": { "type": "string", "minLength": 1 },
+          "units": { "type": "integer", "minimum": 0 },
+          "bytes": { "type": "integer", "minimum": 0 },
+          "truncated": { "type": "boolean" },
+          "formatVersions": { "type": "array", "items": { "type": "string" } },
+          "registeredAs": { "type": ["string", "null"] }
+        }
+      }
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/spec/output-schemas/sessions-import-receipt.schema.json

@@ -0,0 +1,156 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/sessions-import-receipt@1.0",
+  "title": "GNO Session Import Receipt",
+  "description": "Shared receipt of a manual session import on every surface (CLI `gno sessions import --json`, MCP gno_sessions_import, REST POST /api/sessions/import, SDK client.importSessions()). Derived from SessionImportReceipt in src/sessions/types.ts. Receipts never contain host paths or session content.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "dryRun",
+    "index",
+    "sourceIds",
+    "status",
+    "counts",
+    "turns",
+    "units",
+    "unitsTruncated",
+    "deferredUnits",
+    "lexical",
+    "embedding",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1" },
+    "dryRun": {
+      "type": "boolean",
+      "description": "True when nothing was written to the archive, checkpoint state or index."
+    },
+    "index": { "type": "string", "minLength": 1 },
+    "sourceIds": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "status": {
+      "enum": ["complete", "partial", "failed", "nothing_to_do"],
+      "description": "partial whenever any unit is incomplete, failed, unsupported or deferred, or lexical sync failed; failed when nothing was archived or unchanged and nothing is incomplete; a partial import is never reported complete."
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "imported",
+        "updated",
+        "unchanged",
+        "skippedPolicy",
+        "unsupported",
+        "incomplete",
+        "failed"
+      ],
+      "properties": {
+        "imported": { "type": "integer", "minimum": 0 },
+        "updated": { "type": "integer", "minimum": 0 },
+        "unchanged": { "type": "integer", "minimum": 0 },
+        "skippedPolicy": { "type": "integer", "minimum": 0 },
+        "unsupported": { "type": "integer", "minimum": 0 },
+        "incomplete": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "turns": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "human",
+        "assistant",
+        "redactions",
+        "injectedSkipped",
+        "copiedHistorySkipped",
+        "overLimit"
+      ],
+      "properties": {
+        "human": { "type": "integer", "minimum": 0 },
+        "assistant": { "type": "integer", "minimum": 0 },
+        "redactions": { "type": "integer", "minimum": 0 },
+        "injectedSkipped": { "type": "integer", "minimum": 0 },
+        "copiedHistorySkipped": { "type": "integer", "minimum": 0 },
+        "overLimit": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "units": {
+      "type": "array",
+      "maxItems": 200,
+      "items": { "$ref": "#/$defs/unit" }
+    },
+    "unitsTruncated": { "type": "boolean" },
+    "deferredUnits": { "type": "integer", "minimum": 0 },
+    "lexical": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "collections"],
+      "properties": {
+        "status": { "enum": ["ready", "failed", "skipped"] },
+        "collections": { "type": "array", "items": { "type": "string" } },
+        "error": { "type": "string" }
+      }
+    },
+    "embedding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["backlog"],
+      "properties": {
+        "backlog": {
+          "type": ["integer", "null"],
+          "minimum": 0,
+          "description": "Chunks awaiting embeddings in the archive index; null on dry runs."
+        }
+      }
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  },
+  "$defs": {
+    "unit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sourceId",
+        "harness",
+        "locator",
+        "outcome",
+        "threads",
+        "turns",
+        "collections"
+      ],
+      "properties": {
+        "sourceId": { "type": "string" },
+        "harness": {
+          "enum": ["codex", "claude-code", "openclaw", "hermes", null]
+        },
+        "locator": {
+          "type": "string",
+          "description": "Safe locator inside the source root (file name or database path), never a host path."
+        },
+        "outcome": {
+          "enum": [
+            "imported",
+            "updated",
+            "unchanged",
+            "skipped_policy",
+            "unsupported",
+            "incomplete",
+            "failed"
+          ]
+        },
+        "reason": { "type": "string" },
+        "threads": { "type": "integer", "minimum": 0 },
+        "turns": { "type": "integer", "minimum": 0 },
+        "collections": { "type": "array", "items": { "type": "string" } },
+        "unknownKinds": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 1 }
+        },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}