oomi-ai 0.2.50 → 0.3.0

package/openclaw.plugin.json

@@ -1,17 +1,17 @@
-{
-  "id": "oomi-ai",
-  "name": "Oomi Channel Plugin",
-  "description": "Managed Oomi channel integration for OpenClaw.",
-  "version": "0.2.50",
-  "author": "Oomi",
-  "license": "MIT",
-  "openclawVersion": ">=0.5.0",
-  "channels": [
-    "oomi"
-  ],
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {}
-  }
-}
+{
+  "id": "oomi-ai",
+  "name": "Oomi Channel Plugin",
+  "description": "Managed Oomi channel, bridge, voice, and persona app API integration for OpenClaw.",
+  "version": "0.3.0",
+  "author": "Oomi",
+  "license": "MIT",
+  "openclawVersion": ">=0.5.0",
+  "channels": [
+    "oomi"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "oomi-ai",
-  "version": "0.2.50",
-  "description": "Managed Oomi chat, voice bridge, and XR-first persona scaffolding for OpenClaw",
-  "bin": {
-    "oomi": "bin/oomi-ai.js"
-  },
-  "type": "module",
-  "engines": {
-    "node": ">=18"
-  },
-  "openclaw": {
-    "extensions": [
-      "./openclaw.extension.js"
-    ],
-    "channel": {
-      "id": "oomi",
-      "label": "Oomi",
-      "selectionLabel": "Oomi (Managed)",
-      "docsPath": "/channels/oomi",
-      "docsLabel": "oomi",
-      "blurb": "Managed channel transport for Oomi chat.",
-      "aliases": [
-        "oomi-ai"
-      ]
-    },
-    "install": {
-      "npmSpec": "oomi-ai",
-      "defaultChoice": "npm"
-    }
-  },
+{
+  "name": "oomi-ai",
+  "version": "0.3.0",
+  "description": "Managed Oomi channel, bridge, voice, and persona app API tooling for OpenClaw",
+  "bin": {
+    "oomi": "bin/oomi-ai.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "openclaw": {
+    "extensions": [
+      "./openclaw.extension.js"
+    ],
+    "channel": {
+      "id": "oomi",
+      "label": "Oomi",
+      "selectionLabel": "Oomi (Managed)",
+      "docsPath": "/channels/oomi",
+      "docsLabel": "oomi",
+      "blurb": "Managed channel transport for Oomi chat.",
+      "aliases": [
+        "oomi-ai"
+      ]
+    },
+    "install": {
+      "npmSpec": "oomi-ai",
+      "defaultChoice": "npm"
+    }
+  },
   "keywords": [
     "oomi",
     "openclaw",
@@ -37,38 +37,38 @@
     "voice",
     "agent",
     "persona",
-    "webspatial",
-    "xr",
-    "androidxr"
+    "api"
   ],
   "homepage": "https://www.oomi.ai",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/crispcode-io/oomi.git",
-    "directory": "packages/oomi-ai"
-  },
-  "bugs": {
-    "url": "https://github.com/crispcode-io/oomi/issues"
-  },
-  "scripts": {
-    "check": "node --check bin/oomi-ai.js",
-    "test": "node --test test/*.test.mjs"
-  },
-  "dependencies": {
-    "ws": "^8.19.0"
-  },
-  "license": "MIT",
-  "files": [
-    "bin/oomi-ai.js",
-    "bin/sessionBridgeState.js",
-    "lib",
-    "openclaw.plugin.json",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crispcode-io/oomi.git",
+    "directory": "packages/oomi-ai"
+  },
+  "bugs": {
+    "url": "https://github.com/crispcode-io/oomi/issues"
+  },
+  "scripts": {
+    "check": "node --check bin/oomi-ai.js",
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "ws": "^8.19.0"
+  },
+  "license": "MIT",
+  "files": [
+    "bin/oomi-ai.js",
+    "bin/sessionBridgeState.js",
+    "lib/openclawPaths.js",
+    "lib/openclawProfile.js",
+    "lib/personaApiClient.js",
+    "lib/spokenMetadata.js",
+    "openclaw.plugin.json",
     "openclaw.extension.js",
     "agent_instructions.md",
     "README.md",
-    "skills/oomi",
-    "templates/persona-app",
-    "templates/persona-app/vendor/webspatial/core-sdk/dist",
-    "templates/persona-app/vendor/webspatial/react-sdk/dist"
+    "persona-app",
+    "skills/oomi/SKILL.md",
+    "skills/oomi/agent_instructions.md"
   ]
 }

package/persona-app/README.md

@@ -0,0 +1,27 @@
+# Persona App Definitions
+
+Persona apps are composed from approved templates, components, data bindings, actions, and permissions.
+
+The agent should inspect and update account-linked persona app state through approved Oomi API actions. It should not generate arbitrary client code for any client target.
+
+Client renderers are target-specific:
+
+- iOS renders approved definitions with native SwiftUI components.
+- Android should render the same definitions with native components.
+- Web should render the same definitions with React components.
+- Spatial clients can render the same definitions directly or through a target-specific projection.
+
+The current files are the first shared contract for the vertical slice:
+
+- `schema/persona-app.v1.schema.json`
+- `registry/v1.json`
+
+OpenClaw agents should use the packaged CLI to inspect and update account-linked persona apps:
+
+```bash
+oomi persona-apps list --json
+oomi persona-apps show fitness-today --json
+oomi persona-apps apply-action fitness-today --action fitness.complete_workout --payload-json '{"goalId":"easy-run","minutes":20}' --json
+```
+
+If a persona app is missing, ask the user to add it from the Oomi client first so platform-specific permissions and hydration can run.

package/persona-app/registry/v1.json

@@ -0,0 +1,63 @@
+{
+  "schemaVersion": "persona-app.v1",
+  "registryVersion": "2026-04-23.1",
+  "sharedComponents": [
+    {
+      "type": "shared.personaHero",
+      "description": "Domain hero with title, subtitle, and a primary metric.",
+      "targets": ["ios", "android", "web", "webspatial"]
+    },
+    {
+      "type": "shared.oomiNote",
+      "description": "A primary-persona note with optional actions.",
+      "targets": ["ios", "android", "web", "webspatial"]
+    }
+  ],
+  "personaPacks": [
+    {
+      "personaType": "fitness",
+      "displayName": "Fitness",
+      "components": [
+        {
+          "type": "fitness.todaySummary",
+          "description": "Daily movement summary with progress, steps, and sleep context.",
+          "targets": ["ios", "android", "web"]
+        },
+        {
+          "type": "fitness.goalChecklist",
+          "description": "Checklist of suggested goals for today.",
+          "targets": ["ios", "android", "web"]
+        }
+      ],
+      "actions": [
+        {
+          "id": "fitness.complete_goal",
+          "description": "Marks one fitness goal complete.",
+          "payloadSchema": {
+            "type": "object",
+            "required": ["goalId"],
+            "properties": {
+              "goalId": { "type": "string" }
+            }
+          }
+        },
+        {
+          "id": "fitness.complete_workout",
+          "description": "Records a completed workout and updates today's movement state.",
+          "payloadSchema": {
+            "type": "object",
+            "properties": {
+              "goalId": { "type": "string" },
+              "minutes": { "type": "integer", "minimum": 1 }
+            }
+          }
+        }
+      ],
+      "permissions": [
+        "fitness.state.read",
+        "fitness.state.write"
+      ]
+    }
+  ]
+}
+

package/persona-app/schema/persona-app.v1.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://oomi.ai/schemas/persona-app.v1.schema.json",
+  "title": "Oomi Persona App Definition",
+  "type": "object",
+  "required": ["schemaVersion", "title", "summary", "tabs"],
+  "properties": {
+    "schemaVersion": {
+      "const": "persona-app.v1"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "summary": {
+      "type": "string"
+    },
+    "theme": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "tabs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "components"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_-]*$"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "components": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["id", "type"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9_-]*$"
+                },
+                "type": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "dataKey": {
+                  "type": "string"
+                },
+                "props": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "actions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "label"],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "requiresConfirmation": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}