oomi-ai 0.2.18 → 0.2.19

package/README.md

@@ -4,8 +4,9 @@ OpenClaw channel plugin and bridge tooling for Oomi managed chat and voice.
 
 ## Current Focus
 
-`0.2.18` adds the first live persona automation lane:
+`0.2.19` adds the first live persona automation lane:
 - WebSpatial-based persona scaffolding for generated Oomi apps
+- a high-level `oomi personas create-managed` command for agent-driven persona creation
 - device-authenticated persona runtime registration and job callbacks
 - automatic bridge-side polling for queued `persona_job` control messages
 - end-to-end local persona startup from a structured orchestration payload
@@ -153,6 +154,7 @@ oomi personas scaffold market-analyst --name "Market Analyst" --description "Pri
 
 Use:
 - `oomi personas create <id>` for repo-local manifest work
+- `oomi personas create-managed --name "Cooking Persona" --description "Private cooking workspace"` for the end-to-end Oomi-managed persona flow
 - `oomi personas scaffold <slug>` for a WebSpatial-based Oomi app shell with runtime metadata and health documents
 - `oomi persona-jobs execute --message-file <job.json>` when OpenClaw receives a structured persona orchestration job from Oomi
 
@@ -166,7 +168,13 @@ oomi persona-jobs succeed pj_123 --workspace-path ~/.openclaw/personas/market-an
 oomi persona-jobs fail pj_123 --code JOB_FAILED --message "Scaffold generation failed."
 ```
 
-When the managed bridge is running, `oomi-ai` now also polls the backend control lane for queued `persona_job` messages and executes them automatically. That poll path is filtered to `metadata.type = persona_job`, so it does not consume normal queued chat traffic.
+Recommended agent flow:
+
+```bash
+oomi personas create-managed --name "Cooking Persona" --description "Private cooking workspace for recipes, meal planning, and kitchen notes."
+```
+
+That command creates the managed persona record in Oomi using the linked device identity. The backend then enqueues the `persona_job`, and the running bridge consumes that job automatically. The poll path is filtered to `metadata.type = persona_job`, so it does not consume normal queued chat traffic.
 
 ## Bridge Health States
 

package/agent_instructions.md

@@ -194,6 +194,13 @@ Aliases allowed if needed:
 
 ## Persona App Generation
 
+When a user asks you in chat to create a new persona for Oomi:
+
+1. Prefer `oomi personas create-managed --name "<name>" --description "<description>"`.
+2. That is the primary end-to-end command for agent-driven persona creation.
+3. It creates the managed persona record in Oomi and relies on the running bridge to consume the queued `persona_job` automatically.
+4. Do not manually scaffold first unless you are recovering a failed persona job or working outside the queued Oomi flow.
+
 When generating a managed persona app for Oomi:
 
 1. Do not build the app shell from scratch.

package/bin/oomi-ai.js

@@ -190,6 +190,8 @@ Commands:
 
   personas create <id>
     Create a new persona manifest and optionally sync it to the backend.
+  personas create-managed [slug]
+    Create a managed persona in Oomi and enqueue its build job for the linked device.
   personas scaffold <slug>
     Create an Oomi-managed persona app scaffold for agent customization.
   personas runtime-register <slug>
@@ -225,9 +227,10 @@ Common flags:
   --json                 Print pairing result as JSON (for automation)
   --backend-url URL      Override Oomi backend URL
   --root PATH            Override repo root path for persona discovery
-  --name NAME            Persona display name (for create)
-  --description TEXT     Persona description (for scaffold)
-  --summary TEXT         Persona summary (for create)
+  --name NAME            Persona display name (for create)
+  --description TEXT     Persona description (for scaffold)
+  --slug SLUG            Explicit slug override (for create-managed)
+  --summary TEXT         Persona summary (for create)
   --status STATUS        Persona status (for create)
   --type TYPE            Persona type (for create)
   --tags a,b,c           Persona tags (for create)
@@ -595,6 +598,32 @@ function printPersonaScaffoldResult(result, asJson = false) {
   }
 }
 
+function printManagedPersonaCreateResult(result, asJson = false) {
+  if (asJson) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+
+  const persona = result?.persona && typeof result.persona === 'object' ? result.persona : {};
+  const personaJob = result?.personaJob && typeof result.personaJob === 'object' ? result.personaJob : {};
+  console.log(`Managed persona created: ${String(persona.name || persona.slug || 'unknown')}`);
+  if (persona.slug) {
+    console.log(`Slug: ${persona.slug}`);
+  }
+  if (persona.lifecycle) {
+    console.log(`Lifecycle: ${persona.lifecycle}`);
+  }
+  if (personaJob.jobId) {
+    console.log(`Persona job: ${personaJob.jobId}`);
+  }
+  if (personaJob.status) {
+    console.log(`Job status: ${personaJob.status}`);
+  }
+  if (personaJob.deviceId) {
+    console.log(`Assigned device: ${personaJob.deviceId}`);
+  }
+}
+
 function parseOptionalPositiveInteger(value) {
   if (value === undefined || value === null || value === '') return null;
   const parsed = Number(value);
@@ -932,6 +961,26 @@ async function handlePersonaJobExecuteCommand(flags = {}) {
 
   printStructuredResult(result, isTruthyFlag(flags.json));
 }
+
+async function handlePersonaCreateManagedCommand(flags = {}, positionalSlug = '') {
+  const name = String(flags.name || '').trim();
+  if (!name) {
+    throw new Error('Persona name is required. Usage: oomi personas create-managed [slug] --name "<name>" --description "<description>"');
+  }
+
+  const description = String(flags.description || '').trim() || name;
+  const explicitSlug = String(flags.slug || positionalSlug || '').trim();
+  const client = createCliPersonaApiClient(flags);
+  const result = await client.createManagedPersona({
+    slug: explicitSlug,
+    name,
+    description,
+    templateType: String(flags['template-type'] || 'persona-app').trim() || 'persona-app',
+    promptTemplateVersion: String(flags['template-version'] || 'v1').trim() || 'v1',
+  });
+
+  printManagedPersonaCreateResult(result, isTruthyFlag(flags.json));
+}
 
 function resolveOpenclawConfigPath() {
   const candidates = [
@@ -3964,15 +4013,20 @@ async function main() {
     return;
   }
 
-  if (command === 'personas' && subcommand === 'create') {
+  if (command === 'personas' && subcommand === 'create') {
     const id = args.positionals[0];
     if (!id) {
       throw new Error('Persona id is required. Usage: oomi personas create <id>');
     }
     await createPersona({ id, root: args.flags.root, flags: args.flags });
     return;
-  }
-
+  }
+
+  if (command === 'personas' && subcommand === 'create-managed') {
+    await handlePersonaCreateManagedCommand(args.flags, args.positionals[0]);
+    return;
+  }
+
   if (command === 'personas' && subcommand === 'scaffold') {
     const slug = args.positionals[0];
     if (!slug) {

package/lib/personaApiClient.js

@@ -66,6 +66,38 @@ export function createPersonaApiClient({
   }
 
   return {
+    createManagedPersona({
+      slug,
+      name,
+      description,
+      templateType = 'persona-app',
+      promptTemplateVersion = 'v1',
+    }) {
+      const safeName = trimString(name);
+      if (!safeName) {
+        throw new Error('Persona name is required.');
+      }
+
+      const body = withDevice({
+        name: safeName,
+        description: trimString(description) || safeName,
+        templateType: trimString(templateType) || 'persona-app',
+        promptTemplateVersion: trimString(promptTemplateVersion) || 'v1',
+      });
+      const safeSlug = trimString(slug);
+      if (safeSlug) {
+        body.slug = safeSlug;
+      }
+
+      return postJson({
+        fetchImpl,
+        backendUrl: resolvedBackendUrl,
+        deviceToken: resolvedDeviceToken,
+        path: '/v1/personas/managed_create',
+        body,
+      });
+    },
+
     registerRuntime({
       slug,
       endpoint,

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "oomi-ai",
   "name": "Oomi Channel Plugin",
   "description": "Managed Oomi channel integration for OpenClaw.",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "author": "Oomi",
   "license": "MIT",
   "openclawVersion": ">=0.5.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oomi-ai",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "description": "Oomi OpenClaw channel plugin and bridge tooling",
   "bin": {
     "oomi": "bin/oomi-ai.js"