@pellux/goodvibes-contracts 1.9.0 → 1.10.0

package/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "1.9.0"
+    "version": "1.10.0"
   },
   "auth": {
     "modes": [
@@ -32421,6 +32421,148 @@
         },
         "invokable": true
       },
+      {
+        "id": "ops.memory.get",
+        "title": "Get Memory Governance State",
+        "description": "The MemoryGovernor snapshot: the current memory-pressure tier and budget, resident set size and heap, per-cache footprints the governor can shrink, which deferrable background jobs are paused, and the leak-tripwire state. Read-only observability so operators can see the daemon shedding memory before it approaches OOM.",
+        "category": "health",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "read:health"
+        ],
+        "http": {
+          "method": "GET",
+          "path": "/api/ops/memory"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "tier": {
+              "type": "string",
+              "enum": [
+                "normal",
+                "elevated",
+                "high",
+                "critical"
+              ]
+            },
+            "budgetMb": {
+              "type": "number"
+            },
+            "rssMb": {
+              "type": "number"
+            },
+            "heapUsedMb": {
+              "type": "number"
+            },
+            "heapTotalMb": {
+              "type": "number"
+            },
+            "usedPct": {
+              "type": "number"
+            },
+            "refusingExpensiveWork": {
+              "type": "boolean"
+            },
+            "caches": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "entries": {
+                    "type": "number"
+                  },
+                  "estimatedBytes": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name",
+                  "entries"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "pausedJobs": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "tripwire": {
+              "type": "object",
+              "properties": {
+                "armed": {
+                  "type": "boolean"
+                },
+                "sustainedSec": {
+                  "type": "number"
+                },
+                "rateMbPerSec": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "armed",
+                "sustainedSec",
+                "rateMbPerSec"
+              ],
+              "additionalProperties": false
+            },
+            "thresholds": {
+              "type": "object",
+              "properties": {
+                "elevatedPct": {
+                  "type": "number"
+                },
+                "highPct": {
+                  "type": "number"
+                },
+                "criticalPct": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "elevatedPct",
+                "highPct",
+                "criticalPct"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "tier",
+            "budgetMb",
+            "rssMb",
+            "heapUsedMb",
+            "usedPct",
+            "refusingExpensiveWork",
+            "caches",
+            "pausedJobs",
+            "tripwire",
+            "thresholds"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
       {
         "id": "power.keepAwake.set",
         "title": "Set the Owner Keep-Awake Toggle",
@@ -32757,6 +32899,389 @@
         },
         "invokable": true
       },
+      {
+        "id": "voice.local.install",
+        "title": "Install the Managed Local-Voice Runtime",
+        "description": "One-act setup: download + checksum-verify the piper TTS engine, a default voice, and (where a pinned goodvibes-built bundle exists) the whisper.cpp STT engine with its default model into the goodvibes-managed directory, then point the voice.local.* config keys at the managed install — never overwriting a key you already set to a custom value (skipped keys are reported). After this, local TTS works with zero further configuration. Downloads only when you ask; a failed or checksum-mismatched download keeps nothing.",
+        "category": "health",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "write:config"
+        ],
+        "http": {
+          "method": "POST",
+          "path": "/api/voice/local/install"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "provisioned": {
+              "type": "boolean"
+            },
+            "platform": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "tts": {
+              "type": "object",
+              "properties": {
+                "engine": {
+                  "type": "string"
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "provisioned",
+                    "unsupported-platform",
+                    "download-failed",
+                    "checksum-mismatch"
+                  ]
+                },
+                "binaryPath": {
+                  "type": "string"
+                },
+                "modelPath": {
+                  "type": "string"
+                },
+                "reason": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "engine",
+                "state"
+              ],
+              "additionalProperties": false
+            },
+            "stt": {
+              "type": "object",
+              "properties": {
+                "engine": {
+                  "type": "string"
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "provisioned",
+                    "unsupported-platform",
+                    "download-failed",
+                    "checksum-mismatch",
+                    "bundle-unavailable",
+                    "sideload-mismatch"
+                  ]
+                },
+                "binaryPath": {
+                  "type": "string"
+                },
+                "modelPath": {
+                  "type": "string"
+                },
+                "reason": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "engine",
+                "state"
+              ],
+              "additionalProperties": false
+            },
+            "components": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "state": {
+                    "type": "string",
+                    "enum": [
+                      "installed",
+                      "skipped",
+                      "failed"
+                    ]
+                  },
+                  "bytes": {
+                    "type": "number"
+                  },
+                  "error": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "state"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "configured": {
+              "type": "object",
+              "properties": {
+                "set": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "key": {
+                        "type": "string"
+                      },
+                      "value": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "key",
+                      "value"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "skipped": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "key": {
+                        "type": "string"
+                      },
+                      "reason": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "key",
+                      "reason"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "set",
+                "skipped"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "provisioned",
+            "platform",
+            "tts",
+            "stt",
+            "components",
+            "configured"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
+      {
+        "id": "voice.local.status",
+        "title": "Get Managed Local-Voice Runtime State",
+        "description": "Whether the managed local voice runtime (piper TTS + a default voice) is installed: not-provisioned (with a size-labeled offer), partial, provisioned, or unsupported-platform. STT (whisper.cpp) reports its own managed state: goodvibes builds and pins the whisper.cpp bundle per platform (no official prebuilt exists; provisioning never compiles on your machine), so where a pinned bundle exists STT provisions like TTS, and elsewhere it reports unsupported honestly. While a voice.local.install run is active, the response also carries installInProgress — the live per-component progress (phase, byte sizes where known) of that run — so surfaces poll this read during the install to render real progress; the section is absent when no install is running. Read-only.",
+        "category": "health",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "read:health"
+        ],
+        "http": {
+          "method": "GET",
+          "path": "/api/voice/local/status"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "platform": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "state": {
+              "type": "string",
+              "enum": [
+                "not-provisioned",
+                "partial",
+                "provisioned",
+                "unsupported-platform"
+              ]
+            },
+            "tts": {
+              "type": "object",
+              "properties": {
+                "engine": {
+                  "type": "string"
+                },
+                "binaryPresent": {
+                  "type": "boolean"
+                },
+                "voicePresent": {
+                  "type": "boolean"
+                },
+                "binaryPath": {
+                  "type": "string"
+                },
+                "modelPath": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "engine",
+                "binaryPresent",
+                "voicePresent",
+                "binaryPath",
+                "modelPath"
+              ],
+              "additionalProperties": false
+            },
+            "stt": {
+              "type": "object",
+              "properties": {
+                "engine": {
+                  "type": "string"
+                },
+                "supported": {
+                  "type": "boolean"
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "not-provisioned",
+                    "partial",
+                    "provisioned",
+                    "unsupported-platform"
+                  ]
+                },
+                "binaryPresent": {
+                  "type": "boolean"
+                },
+                "modelPresent": {
+                  "type": "boolean"
+                },
+                "binaryPath": {
+                  "type": "string"
+                },
+                "modelPath": {
+                  "type": "string"
+                },
+                "reason": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "engine",
+                "supported",
+                "state",
+                "binaryPresent",
+                "modelPresent",
+                "binaryPath",
+                "modelPath"
+              ],
+              "additionalProperties": false
+            },
+            "offerBytes": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "installInProgress": {
+              "type": "object",
+              "properties": {
+                "startedAt": {
+                  "type": "number"
+                },
+                "components": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "component": {
+                        "type": "string"
+                      },
+                      "phase": {
+                        "type": "string",
+                        "enum": [
+                          "skip",
+                          "download",
+                          "verify",
+                          "extract",
+                          "done",
+                          "error"
+                        ]
+                      },
+                      "message": {
+                        "type": "string"
+                      },
+                      "bytesTotal": {
+                        "type": "number"
+                      },
+                      "bytesDone": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "component",
+                      "phase"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "startedAt",
+                "components"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "platform",
+            "state",
+            "tts",
+            "stt",
+            "offerBytes"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
       {
         "id": "intelligence.snapshot",
         "title": "Intelligence Snapshot",
@@ -91544,10 +92069,10 @@
       }
     ],
     "schemaCoverage": {
-      "methods": 412,
-      "typedInputs": 412,
+      "methods": 415,
+      "typedInputs": 415,
       "genericInputs": 0,
-      "typedOutputs": 412,
+      "typedOutputs": 415,
       "genericOutputs": 0
     },
     "eventCoverage": {
@@ -91556,8 +92081,8 @@
       "withWireEvents": 32
     },
     "validationCoverage": {
-      "methods": 412,
-      "validated": 405,
+      "methods": 415,
+      "validated": 408,
       "skippedGeneric": 0,
       "skippedUntyped": 7
     }