@linxin666/dsh-pet 0.2.2 → 0.2.4

package/contracts/pet-manifest-v2.schema.json

@@ -0,0 +1,281 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.linxin666.org/dsh-pet/pet-manifest-v2.schema.json",
+  "title": "DSH Pet Manifest v2",
+  "description": "Pet-center manifest v2 (issue #623). Pure-asset pet directory contract: renderer type declaration, license metadata, and renderer-specific blocks. Top level and renderer blocks are fail-closed; v1 manifests (no petManifestVersion) are compat-read as sprite2d by the registry.",
+  "type": "object",
+  "required": [
+    "petManifestVersion",
+    "id",
+    "displayName",
+    "license"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "petManifestVersion": {
+      "const": 2
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "maxLength": 64,
+      "description": "Globally unique lowercase kebab-case pet id."
+    },
+    "displayName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 500
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "author": {
+      "type": "string",
+      "maxLength": 128
+    },
+    "license": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Asset license identifier (SPDX id or free text). Required so community pets always carry provenance."
+    },
+    "homepage": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "Optional provenance URL for the pet assets."
+    },
+    "renderer": {
+      "enum": [
+        "sprite2d",
+        "live2d"
+      ],
+      "default": "sprite2d",
+      "description": "Renderer kind; omitted means sprite2d (v1 compatibility). Unknown values are rejected."
+    },
+    "sprite2d": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "spritesheetPath"
+      ],
+      "description": "Spritesheet renderer block; required when renderer=sprite2d.",
+      "properties": {
+        "spritesheetPath": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Atlas path relative to the manifest directory (safe segments only)."
+        },
+        "cell": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Atlas cell size in px; defaults to the Codex contract 192x208.",
+          "properties": {
+            "width": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 2048
+            },
+            "height": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 2048
+            }
+          }
+        },
+        "columns": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "default": 8
+        },
+        "atlasRows": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 32,
+          "description": "Total atlas rows; 9 for the classic contract, 11 for v2 look-row atlases."
+        },
+        "frames": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 32
+          },
+          "description": "Per-row used frame counts; omitted rows fall back to the hatch-pet contract table."
+        },
+        "tracks": {
+          "type": "object",
+          "description": "Per-track rhythm overrides (durations/loop/fallback), v1 structure unchanged."
+        }
+      }
+    },
+    "live2d": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "model",
+        "motions"
+      ],
+      "description": "Live2D renderer block; required when renderer=live2d. The Cubism Core runtime is always user-supplied; the plugin never bundles or downloads it.",
+      "properties": {
+        "model": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\.model3\\.json$",
+          "description": "Path of the .model3.json relative to the manifest directory."
+        },
+        "scale": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 10,
+          "default": 1
+        },
+        "translate": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "x": {
+              "type": "number"
+            },
+            "y": {
+              "type": "number"
+            }
+          }
+        },
+        "motions": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "idle"
+          ],
+          "description": "ActivityPhase -> model motion group name. Unmapped phases fall back to the idle group; missing groups degrade to the first frame with a diagnostic.",
+          "properties": {
+            "idle": {
+              "type": "string",
+              "minLength": 1
+            },
+            "waiting": {
+              "type": "string",
+              "minLength": 1
+            },
+            "thinking": {
+              "type": "string",
+              "minLength": 1
+            },
+            "tool": {
+              "type": "string",
+              "minLength": 1
+            },
+            "review": {
+              "type": "string",
+              "minLength": 1
+            },
+            "done": {
+              "type": "string",
+              "minLength": 1
+            },
+            "failed": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "expressions": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Optional ActivityPhase -> expression name (layered over the motion).",
+          "properties": {
+            "idle": {
+              "type": "string",
+              "minLength": 1
+            },
+            "waiting": {
+              "type": "string",
+              "minLength": 1
+            },
+            "thinking": {
+              "type": "string",
+              "minLength": 1
+            },
+            "tool": {
+              "type": "string",
+              "minLength": 1
+            },
+            "review": {
+              "type": "string",
+              "minLength": 1
+            },
+            "done": {
+              "type": "string",
+              "minLength": 1
+            },
+            "failed": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "hitAreas": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Hit area names that trigger pet.interact; defaults to every HitArea the model declares."
+        },
+        "lipSync": {
+          "type": "boolean",
+          "default": false,
+          "description": "Optional whisper-paced lip sync (post-M3)."
+        }
+      }
+    },
+    "sequences": {
+      "type": "object",
+      "description": "Renderer-agnostic ActivityPhase sequence table (v1 structure; every declared sequence has at least 5 items)."
+    },
+    "remarks": {
+      "type": "object",
+      "description": "Per-slot witty-remark pools (v1 structure; a slot replaces the built-in pool for that slot only)."
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "renderer": {
+            "const": "sprite2d"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "sprite2d"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "renderer": {
+            "const": "live2d"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "live2d"
+        ]
+      }
+    }
+  ]
+}

package/contracts/status-decoration-v1.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.linxin666.org/dsh-pet/status-decoration-v1.schema.json",
+  "title": "DSH Pet Status Decoration v1",
+  "description": "Status-decoration descriptor (issue #623 M5, protocol #567). A pure-content entry ornamenting the pet center's status bubble chrome with a PNG/WebP sprite strip driven by the ActivityPhase stream. Structure is fail-closed; phase-binding content issues drop that binding only. Entry assets are PNG/WebP strips only (no SVG/CSS) per the adopted disciplines.",
+  "type": "object",
+  "required": [
+    "decorationManifestVersion",
+    "id",
+    "license",
+    "entry",
+    "cell",
+    "columns"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "decorationManifestVersion": {
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "maxLength": 64
+    },
+    "displayName": {
+      "type": "string",
+      "maxLength": 64
+    },
+    "license": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Asset license identifier (SPDX id or free text). Required so community decorations always carry provenance."
+    },
+    "entry": {
+      "type": "string",
+      "maxLength": 256,
+      "description": "PNG/WebP single-row sprite strip, relative to the descriptor directory."
+    },
+    "cell": {
+      "type": "object",
+      "required": [
+        "width",
+        "height"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "width": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 256
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 256
+        }
+      }
+    },
+    "columns": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 16
+    },
+    "frameMs": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 2000,
+      "description": "Constant per-frame duration; 'durations' overrides per frame."
+    },
+    "durations": {
+      "type": "array",
+      "items": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 2000
+      },
+      "description": "Per-frame durations; length must equal 'columns'."
+    },
+    "loop": {
+      "type": "boolean",
+      "default": true
+    },
+    "phases": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "ActivityPhase -> frame segment; 'hide' (default) shows no ornament.",
+      "properties": {
+        "idle": {
+          "$ref": "#/definitions/phaseBinding"
+        },
+        "waiting": {
+          "$ref": "#/definitions/phaseBinding"
+        },
+        "thinking": {
+          "$ref": "#/definitions/phaseBinding"
+        },
+        "tool": {
+          "$ref": "#/definitions/phaseBinding"
+        },
+        "review": {
+          "$ref": "#/definitions/phaseBinding"
+        },
+        "done": {
+          "$ref": "#/definitions/phaseBinding"
+        },
+        "failed": {
+          "$ref": "#/definitions/phaseBinding"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "phaseBinding": {
+      "oneOf": [
+        {
+          "const": "hide"
+        },
+        {
+          "type": "object",
+          "required": [
+            "from",
+            "to"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "from": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "to": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "description": "Inclusive frame segment into the strip; must satisfy from <= to < columns."
+        }
+      ]
+    }
+  }
+}

package/contracts/voice-pack-v1.schema.json

@@ -0,0 +1,234 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.linxin666.org/dsh-pet/voice-pack-v1.schema.json",
+  "title": "DSH Pet Voice Pack v1",
+  "description": "Pet-center voice pack (issue #677). Optional voice.json inside a pet directory, or the global $DSH_HOME/pets/.voice.json override — pure JSON content layering status / tool / whisper copy over the built-in pools, plus hover-panel chrome. Structure is fail-closed per file (a non-object root drops the pack); content is warn-and-drop per slot.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "voicePackVersion": {
+      "const": 1,
+      "description": "Optional; absent reads as v1."
+    },
+    "status": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Status copy pools keyed by the eleven StatusScene ids; each key replaces that scene's built-in pool.",
+      "properties": {
+        "prepare": {
+          "$ref": "#/definitions/pool"
+        },
+        "waiting": {
+          "$ref": "#/definitions/pool"
+        },
+        "thinking": {
+          "$ref": "#/definitions/pool"
+        },
+        "review": {
+          "$ref": "#/definitions/pool"
+        },
+        "toolResult": {
+          "$ref": "#/definitions/pool"
+        },
+        "done": {
+          "$ref": "#/definitions/pool"
+        },
+        "failed": {
+          "$ref": "#/definitions/pool"
+        },
+        "toolFailed": {
+          "$ref": "#/definitions/pool"
+        },
+        "maxTokens": {
+          "$ref": "#/definitions/pool"
+        },
+        "interrupted": {
+          "$ref": "#/definitions/pool"
+        },
+        "blocked": {
+          "$ref": "#/definitions/pool"
+        }
+      }
+    },
+    "tools": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Tool copy pools keyed by the seventeen ToolCategory ids; {tool} and {hint} interpolate.",
+      "properties": {
+        "read": {
+          "$ref": "#/definitions/pool"
+        },
+        "write": {
+          "$ref": "#/definitions/pool"
+        },
+        "edit": {
+          "$ref": "#/definitions/pool"
+        },
+        "shell": {
+          "$ref": "#/definitions/pool"
+        },
+        "grep": {
+          "$ref": "#/definitions/pool"
+        },
+        "find": {
+          "$ref": "#/definitions/pool"
+        },
+        "ls": {
+          "$ref": "#/definitions/pool"
+        },
+        "webSearch": {
+          "$ref": "#/definitions/pool"
+        },
+        "webFetch": {
+          "$ref": "#/definitions/pool"
+        },
+        "mcp": {
+          "$ref": "#/definitions/pool"
+        },
+        "memory": {
+          "$ref": "#/definitions/pool"
+        },
+        "subagent": {
+          "$ref": "#/definitions/pool"
+        },
+        "todo": {
+          "$ref": "#/definitions/pool"
+        },
+        "browser": {
+          "$ref": "#/definitions/pool"
+        },
+        "git": {
+          "$ref": "#/definitions/pool"
+        },
+        "ask": {
+          "$ref": "#/definitions/pool"
+        },
+        "generic": {
+          "$ref": "#/definitions/pool"
+        }
+      }
+    },
+    "toolRemaining": {
+      "$ref": "#/definitions/pool",
+      "description": "The parallel-tools count line pool; {n} interpolates the count."
+    },
+    "whispers": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Murmur pools; each section replaces the built-in one as a whole. An explicit empty array mutes that channel.",
+      "properties": {
+        "generic": {
+          "$ref": "#/definitions/pool"
+        },
+        "rules": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "keywords",
+              "pool"
+            ],
+            "properties": {
+              "keywords": {
+                "type": "array",
+                "maxItems": 16,
+                "items": {
+                  "type": "string",
+                  "maxLength": 40,
+                  "minLength": 1
+                },
+                "description": "Lowercase substrings matched against the model's output."
+              },
+              "pool": {
+                "$ref": "#/definitions/pool"
+              }
+            }
+          }
+        }
+      }
+    },
+    "panel": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Hover-panel chrome; unset slots keep the client's i18n dictionary copy.",
+      "properties": {
+        "labels": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "feed": {
+              "type": "string",
+              "maxLength": 40
+            },
+            "rename": {
+              "type": "string",
+              "maxLength": 40
+            },
+            "hide": {
+              "type": "string",
+              "maxLength": 40
+            },
+            "confirm": {
+              "type": "string",
+              "maxLength": 40
+            }
+          }
+        },
+        "stats": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "{rank} / {n} / {points} interpolate the live values.",
+          "properties": {
+            "rank": {
+              "type": "string",
+              "maxLength": 80
+            },
+            "treats": {
+              "type": "string",
+              "maxLength": 80
+            },
+            "points": {
+              "type": "string",
+              "maxLength": 80
+            }
+          }
+        },
+        "actions": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "feed",
+              "rename",
+              "hide"
+            ]
+          },
+          "description": "Subset of actions to render in canonical order; absent = all three, [] = none."
+        }
+      }
+    }
+  },
+  "definitions": {
+    "pool": {
+      "oneOf": [
+        {
+          "type": "string",
+          "maxLength": 160
+        },
+        {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "string",
+            "maxLength": 160
+          }
+        }
+      ]
+    }
+  }
+}