oomi-ai 0.2.2 → 0.2.3

package/README.md

@@ -49,12 +49,15 @@ oomi openclaw pair --app-url https://your-oomi-app.vercel.app --device-id my-ope
 `--app-url` must be reachable from the OpenClaw host. If OpenClaw runs on a different machine/network, do not use `localhost` unless tunneled.
 
 This prints:
-- `Connect code: <device-id>`
-- `Connect URL: https://.../?connect=managed://<device-id>&sessionKey=...`
+- `Auth invite URL: https://.../connect/<single-use-token>`
 - A copy-ready block for the user:
   - `Oomi Connect Ready`
-  - `Code: ...`
-  - `Link: ...`
+  - `Auth Link: ...`
+
+If you need a fresh auth link later (without re-pairing), run:
+```
+oomi openclaw invite --app-url https://your-oomi-app.vercel.app
+```
 
 Agent-intent mapping (recommended):
 - If user says `Connect yourself to Oomi. Use app URL https://www.oomi.ai.`
@@ -68,7 +71,7 @@ Agent-intent mapping (recommended):
 
 Important distinction:
 - `pairCode` is one-time and used internally by the pair/bootstrap flow.
-- `connect code` is the stable device id used by browser connect (`managed://<device-id>`).
+- Invite auth links are the required user flow.
 
 Sync personas from the repo into the backend registry:
 ```

package/agent_instructions.md

@@ -31,7 +31,12 @@ If the user asks to connect OpenClaw to Oomi voice/web:
    - Example: `oomi openclaw pair --app-url <URL> --no-start`
 8. Return this exact result format to the user:
    - `Oomi Connect Ready`
-   - `Code: ...`
-   - `Link: ...`
+   - `Auth Link: ...`
+   - No extra narrative text before or after those lines.
+
+Primary UX requirement:
+- Never ask the user to enter raw pairing identifiers.
+- The user should open the auth link, complete sign-in, and land directly in connected chat.
+- Return `/connect/<invite-token>` auth links only.
 
 Do not ask users to paste gateway IP/token/password when managed connect is available.

package/bin/oomi-ai.js

@@ -142,6 +142,9 @@ Commands:
   openclaw pair
     Pair this OpenClaw host with Oomi and start bridge (single command).
 
+  openclaw invite
+    Create a single-use auth invite link for the paired OpenClaw device.
+
   openclaw plugin
     Print OpenClaw extension install/config guidance for Oomi channel plugin.
 
@@ -158,7 +161,7 @@ Common flags:
   --broker-http URL      Managed broker HTTPS URL (for pair claim)
   --broker-ws URL        Managed broker device WS URL (wss://.../cable)
   --pair-code CODE       One-time pairing code from Oomi
-  --app-url URL          Oomi app URL used for pairing APIs (default: http://127.0.0.1:3000)
+  --app-url URL          Oomi app URL used for pairing APIs (default: http://127.0.0.1:3456)
   --label TEXT           Pairing label shown in broker logs
   --session-key KEY      Session key used in generated connect URL
   --detach               Start bridge in background and exit
@@ -595,6 +598,25 @@ async function requestManagedPairCode({ appUrl, label }) {
   return payload;
 }
 
+async function requestConnectInviteLink({ backendHttp, appUrl, sessionKey, deviceToken }) {
+  const response = await fetch(`${backendHttp.replace(/\/$/, '')}/v1/invite_links/start`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${deviceToken}`,
+    },
+    body: JSON.stringify({ appUrl, sessionKey }),
+  });
+  const payload = await response.json().catch(() => ({}));
+  if (!response.ok || !payload?.inviteUrl) {
+    const message =
+      (payload && typeof payload.error === 'string' && payload.error) ||
+      `Invite link start failed (${response.status})`;
+    throw new Error(message);
+  }
+  return payload;
+}
+
 async function fetchManagedGatewayConfig({ appUrl }) {
   const baseUrl = appUrl.replace(/\/$/, '');
   const response = await fetch(`${baseUrl}/api/gateway/managed/config`, {
@@ -924,7 +946,7 @@ async function startOpenclawBridge(flags) {
 
 async function pairAndStartOpenclawBridge(flags) {
   const bridgeState = readBridgeState();
-  const appUrl = String(flags['app-url'] || process.env.OOMI_APP_URL || 'http://127.0.0.1:3000').trim();
+  const appUrl = String(flags['app-url'] || process.env.OOMI_APP_URL || 'http://127.0.0.1:3456').trim();
   const deviceId = resolveDeviceId(flags, bridgeState);
   const label = String(flags.label || `${deviceId}-bridge`).trim();
   const sessionKey = String(
@@ -961,19 +983,24 @@ async function pairAndStartOpenclawBridge(flags) {
     brokerWs,
     deviceId,
     deviceToken,
+    sessionKey,
     claimedAt: new Date().toISOString(),
     expiresAt: claimed.expiresAt || null,
   });
 
-  const connectCode = deviceId;
-  const gatewayValue = `managed://${deviceId}`;
-  const connectUrl = `${appUrl.replace(/\/$/, '')}/?connect=${encodeURIComponent(gatewayValue)}&sessionKey=${encodeURIComponent(sessionKey)}`;
+  const invite = await requestConnectInviteLink({
+    backendHttp: managedConfig.brokerHttpUrl,
+    appUrl,
+    sessionKey,
+    deviceToken,
+  });
+  const inviteUrl = String(invite.inviteUrl || '').trim();
+  const inviteExpiresAt = String(invite.expiresAt || '').trim();
 
   const pairSummary = {
     deviceId,
-    connectCode,
-    gatewayValue,
-    connectUrl,
+    inviteUrl,
+    inviteExpiresAt,
     brokerHttpUrl: managedConfig.brokerHttpUrl,
     brokerDeviceWsUrl: brokerWs,
     bridgeMode: shouldStart ? (detach ? 'detached' : 'attached') : 'skipped',
@@ -984,15 +1011,15 @@ async function pairAndStartOpenclawBridge(flags) {
     console.log(JSON.stringify(pairSummary, null, 2));
   } else {
     console.log(`Paired device: ${deviceId}`);
-    console.log(`Connect code: ${connectCode}`);
-    console.log(`Gateway value: ${gatewayValue}`);
-    console.log(`Connect URL: ${connectUrl}`);
+    console.log(`Auth invite URL: ${inviteUrl}`);
+    if (inviteExpiresAt) {
+      console.log(`Invite expires at: ${inviteExpiresAt}`);
+    }
     console.log('');
-    console.log('Share this with the user:');
+    console.log('Share this exact response with the user (no extra text):');
     console.log('----------------------------------------');
     console.log('Oomi Connect Ready');
-    console.log(`Code: ${connectCode}`);
-    console.log(`Link: ${connectUrl}`);
+    console.log(`Auth Link: ${inviteUrl}`);
     console.log('----------------------------------------');
   }
 
@@ -1033,6 +1060,61 @@ async function pairAndStartOpenclawBridge(flags) {
   });
 }
 
+async function createOpenclawInviteLink(flags) {
+  const bridgeState = readBridgeState();
+  const backendHttp = String(
+    flags['backend-url'] ||
+      flags['broker-http'] ||
+      process.env.OOMI_BACKEND_URL ||
+      process.env.OOMI_CHAT_BROKER_HTTP_URL ||
+      bridgeState.brokerHttp ||
+      ''
+  ).trim();
+  const appUrl = String(flags['app-url'] || process.env.OOMI_APP_URL || 'http://127.0.0.1:3456').trim();
+  const sessionKey = String(
+    flags['session-key'] ||
+      process.env.OOMI_SESSION_KEY ||
+      bridgeState.sessionKey ||
+      'agent:main:webchat:channel:oomi'
+  ).trim();
+  const deviceToken = String(flags['device-token'] || bridgeState.deviceToken || '').trim();
+  const jsonOutput = isTruthyFlag(flags.json);
+
+  if (!backendHttp) {
+    throw new Error('Missing backend URL. Set --backend-url (or --broker-http) or pair first.');
+  }
+  if (!deviceToken) {
+    throw new Error('Missing device token in bridge state. Run: oomi openclaw pair --app-url https://www.oomi.ai --no-start');
+  }
+
+  const invite = await requestConnectInviteLink({
+    backendHttp,
+    appUrl,
+    sessionKey,
+    deviceToken,
+  });
+
+  const summary = {
+    appUrl,
+    backendHttp,
+    inviteUrl: invite.inviteUrl,
+    expiresAt: invite.expiresAt || null,
+    sessionKey,
+  };
+
+  if (jsonOutput) {
+    console.log(JSON.stringify(summary, null, 2));
+    return;
+  }
+
+  console.log('Oomi Auth Invite Ready');
+  console.log('----------------------');
+  console.log(`Auth Link: ${summary.inviteUrl}`);
+  if (summary.expiresAt) {
+    console.log(`Expires: ${summary.expiresAt}`);
+  }
+}
+
 function printOpenclawPluginSetup(flags) {
   const bridgeState = readBridgeState();
   const backendUrl = String(
@@ -1141,6 +1223,11 @@ async function main() {
     return;
   }
 
+  if (command === 'openclaw' && subcommand === 'invite') {
+    await createOpenclawInviteLink(args.flags);
+    return;
+  }
+
   if (command === 'openclaw' && subcommand === 'plugin') {
     printOpenclawPluginSetup(args.flags);
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oomi-ai",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Oomi CLI for OpenClaw setup",
   "bin": {
     "oomi": "bin/oomi-ai.js"

package/skills/oomi/agent_instructions.md

@@ -31,7 +31,12 @@ If the user asks to connect OpenClaw to Oomi voice/web:
    - Example: `oomi openclaw pair --app-url <URL> --no-start`
 8. Return this exact result format to the user:
    - `Oomi Connect Ready`
-   - `Code: ...`
-   - `Link: ...`
+   - `Auth Link: ...`
+   - No extra narrative text before or after those lines.
+
+Primary UX requirement:
+- Never ask the user to enter raw pairing identifiers.
+- The user should open the auth link, complete sign-in, and land directly in connected chat.
+- Return `/connect/<invite-token>` auth links only.
 
 Do not ask users to paste gateway IP/token/password when managed connect is available.