kroki 1.0.1 → 1.0.3

package/README.md

@@ -1,7 +1,7 @@
 # Kroki CLI
 
-> **Browser Automation & AI Agent Bridge for Google Chrome & Dolphin{anty}**  
-> Control live browser tabs, run deterministic workflows, and extract web data from your terminal or any AI Coding Agent (Antigravity, Cursor, Claude Code, Windsurf).
+> **Browser Automation & AI Agent Bridge for Google Chrome**  
+> Control live browser tabs, run deterministic workflows, and extract web data from your terminal or AI Coding Agents (Antigravity, Cursor, Claude Code, Windsurf).
 
 [![npm version](https://img.shields.io/npm/v/kroki.svg)](https://www.npmjs.com/package/kroki)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -11,82 +11,40 @@
 
 ## ⚡ Quick Start
 
-No installation required. You can run it directly with `npx`:
+No installation required — run directly with `npx`:
 
 ### 1. Pair with your browser profile
-> **Note:** Requires an active **Ultra** plan.
-
-1. Log in at [https://kroki.ai/#/devices](https://kroki.ai/#/devices).
-2. Find your active Chrome or Dolphin{anty} profile.
-3. Click **"Скопировать код для AI"**.
-4. Run:
-
+1. Open [https://kroki.ai/#/devices](https://kroki.ai/#/devices) *(Ultra plan required)*.
+2. Click **"Скопировать код для AI"** next to your active browser profile.
+3. Pair:
 ```bash
 npx kroki pair <YOUR_PAIRING_CODE>
 ```
 
-```text
-Connecting to profile [Dolphin WB-Bot]...
-✔ Successfully paired with "Dolphin WB-Bot".
-```
-
-### 2. Send an AI task to the live browser
-
+### 2. Control browser or run workflows
 ```bash
-npx kroki "open wildberries.ru, search for 'iPhone 16 cases' and list the top 5 prices"
-```
-
-Kroki's built-in Planner & Navigator subagent will navigate to the page, interact with elements, extract the requested information, and stream the result back to your terminal.
+# Autonomous browser task (Planner + Navigator)
+npx kroki "open github.com/trending and list the top 3 repositories"
 
-### 3. Run a saved workflow
-
-```bash
+# Run a saved deterministic workflow
 npx kroki run "Export Leads" '{"query": "CTO", "limit": 20}'
-```
-
----
-
-## 📦 Global Installation (Optional)
-
-If you prefer using `kroki` without typing `npx` every time:
 
-```bash
-npm install -g kroki
-```
-
-Now you can just run:
-
-```bash
-kroki pair <CODE>
-kroki "scrape the current page"
-kroki run "My Workflow"
+# Check status or disconnect
+npx kroki status
+npx kroki clear
 ```
 
 ---
 
 ## 🤖 Using with AI Agents (Antigravity, Claude Code, Cursor)
 
-Kroki CLI works out-of-the-box with AI pair-programming agents.
-
-### In Antigravity CLI
-
-Whenever you mention **kroki** in the chat, the agent automatically knows how to use this CLI:
-
-> **You:** `kroki pair kroki_eyJh...`  
-> **Agent:** Pairs with the specified profile and confirms readiness.  
->  
-> **You:** `kroki найди на Avito Mac mini M4 и выпиши самые дешевые цены`  
-> **Agent:** Executes `kroki "<task>"`, waits for Kroki in the browser to finish, and summarizes the findings.
-
-### In Cursor / Claude Code
-
-Add the following to your agent prompt or rule file (`.cursorrules` or `CLAUDE.md`):
+Add the following to your project's agent instructions (`.cursorrules`, `CLAUDE.md`, or system prompt):
 
 ```markdown
-When the user requests live browser interaction or running Kroki workflows:
-1. Ensure the profile is paired: run `npx kroki status`. If not paired, ask the user for their pairing code from https://kroki.ai/#/devices (Ultra plan required).
-2. Pair via `npx kroki pair <CODE>`.
-3. Dispatch tasks via `npx kroki "<task>"` or workflows via `npx kroki run "<workflow>" '[vars]'`.
+When asked to automate the browser or run Kroki workflows:
+1. Check pairing: `npx kroki status`. If not paired, ask user for pairing code from https://kroki.ai/#/devices.
+2. Pair: `npx kroki pair <CODE>`.
+3. Execute: `npx kroki "<task>"` or `npx kroki run "<workflow>" '[vars]'`.
 ```
 
 ---
@@ -95,18 +53,11 @@ When the user requests live browser interaction or running Kroki workflows:
 
 | Command | Description |
 | :--- | :--- |
-| `npx kroki pair <code_from_devices>` | Connect to a specific browser profile (requires Ultra plan) |
-| `npx kroki "<browser_task>"` | Send an autonomous agent task to the active browser profile |
-| `npx kroki run "<workflow_name>" [json]` | Execute a saved Kroki deterministic workflow |
-
----
-
-## 🔒 Security Architecture
-
-- **Zero Global Credentials**: Pairing codes are session-bound and scoped strictly to your selected browser window (`targetDeviceId`).
-- **Confirmation Gate**: The extension prompts you for confirmation on your computer when a connection attempt is made.
-- **Ultra Plan Scoped**: Cloud control channels require an active Ultra entitlement.
-- **Pure Native Node.js**: Zero third-party npm dependencies. Clean, audited, and lightweight.
+| `npx kroki pair <CODE>` | Pair with active browser profile |
+| `npx kroki "<task>"` | Execute browser task via autonomous Planner & Navigator |
+| `npx kroki run "<name>" [json]` | Execute a saved Kroki deterministic workflow |
+| `npx kroki status` | View active paired profile and device info |
+| `npx kroki clear` | Clear active pairing session |
 
 ---
 

package/bin/kroki.js

@@ -70,7 +70,9 @@ class RealtimeConnection {
     this.deviceId = config.deviceId;
     this.topic = `realtime:control:${this.googleId}`;
     this.ref = 0;
+    this.joinRef = null;
     this.ws = null;
+    this.heartbeatTimer = null;
   }
 
   nextRef() {
@@ -90,7 +92,16 @@ class RealtimeConnection {
       this.ws.onopen = () => {
         clearTimeout(timer);
         this.joinChannel()
-          .then(() => resolve(this))
+          .then(() => {
+            this.heartbeatTimer = setInterval(() => {
+              if (this.ws && this.ws.readyState === globalThis.WebSocket.OPEN) {
+                this.ws.send(
+                  JSON.stringify({ topic: 'phoenix', event: 'heartbeat', payload: {}, ref: this.nextRef() }),
+                );
+              }
+            }, 25000);
+            resolve(this);
+          })
           .catch(reject);
       };
 
@@ -103,21 +114,21 @@ class RealtimeConnection {
 
   joinChannel() {
     return new Promise((resolve, reject) => {
-      const joinRef = this.nextRef();
+      this.joinRef = this.nextRef();
       const payload = {
         topic: this.topic,
         event: 'phx_join',
         payload: {
-          config: { broadcast: { self: false } },
+          config: { private: true, broadcast: { self: false } },
           access_token: this.token,
         },
-        ref: joinRef,
+        ref: this.joinRef,
       };
 
       const handler = event => {
         try {
           const msg = JSON.parse(event.data);
-          if (msg.ref === joinRef) {
+          if (msg.ref === this.joinRef) {
             this.ws.removeEventListener('message', handler);
             if (msg.payload?.status === 'ok') {
               resolve();
@@ -173,6 +184,7 @@ class RealtimeConnection {
           payload: command,
         },
         ref: msgRef,
+        join_ref: this.joinRef,
       };
 
       this.ws.send(JSON.stringify(packet));
@@ -180,6 +192,10 @@ class RealtimeConnection {
   }
 
   close() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
     if (this.ws) {
       try {
         this.ws.close();
@@ -196,7 +212,7 @@ async function pairCommand(code) {
 Requires an active \x1b[33mUltra\x1b[0m plan.
 
 1. Log in at \x1b[36mhttps://kroki.ai/#/devices\x1b[0m
-2. Find your active browser profile (Chrome or Dolphin{anty})
+2. Find your active browser profile
 3. Click \x1b[32m"Скопировать код для AI"\x1b[0m
 4. Run:
    \x1b[33mnpx kroki pair <YOUR_CODE>\x1b[0m
@@ -315,16 +331,32 @@ async function workflowCommand(nameOrId, varsJson) {
   }
 }
 
+function statusCommand() {
+  const session = getActiveSession();
+  if (!session) {
+    console.log('No active paired profile.');
+    console.log('To pair, get a code from https://kroki.ai/#/devices and run:');
+    console.log('  npx kroki pair <CODE>');
+    return;
+  }
+  console.log(
+    `\x1b[32m✔ Paired\x1b[0m with "${session.deviceName || session.deviceId}" (${session.platform || 'browser'})`,
+  );
+  console.log(`  Device ID: ${session.deviceId}`);
+}
+
 function helpCommand() {
   console.log(`
-\x1b[1mKroki CLI\x1b[0m — Browser Automation & AI Agent Bridge for Chrome & Dolphin{anty}
+\x1b[1mKroki CLI\x1b[0m — Browser Automation & AI Agent Bridge for Google Chrome
 
 \x1b[1mUsage:\x1b[0m
-  npx kroki pair <code_from_devices>       Pair with a browser profile (requires Ultra plan)
-  npx kroki "<browser_task>"              Send an AI task to the live browser
-  npx kroki run "<workflow_name>" [json]  Execute a saved workflow
+  npx kroki pair <CODE>                   Pair with a browser profile (from https://kroki.ai/#/devices)
+  npx kroki "<task>"                      Send an AI task to the live browser
+  npx kroki run "<workflow>" [json]       Execute a saved workflow
+  npx kroki status                        View paired profile and status
+  npx kroki clear                         Disconnect active pairing session
 
-\x1b[1mGet pairing code:\x1b[0m
+\x1b[1mDashboard:\x1b[0m
   https://kroki.ai/#/devices
 `);
 }
@@ -343,6 +375,10 @@ switch (first) {
     });
     break;
 
+  case 'status':
+    statusCommand();
+    break;
+
   case 'run':
   case 'workflow':
     workflowCommand(rawArgs[1], rawArgs[2]).catch(e => {

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "kroki",
-  "version": "1.0.1",
-  "description": "Kroki Browser Automation CLI — Control Chrome & Dolphin{anty} from terminal and AI agents",
+  "version": "1.0.3",
+  "description": "Kroki Browser Automation CLI — Control Chrome from terminal and AI agents",
   "keywords": [
     "kroki",
     "browser-automation",
     "ai-agent",
     "antigravity",
-    "dolphin-anty",
     "chrome",
     "mcp",
     "cli"