npm - @rubytech/taskmaster - Versions diffs - 1.0.102 → 1.0.104 - Mend

@rubytech/taskmaster 1.0.102 → 1.0.104

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/build-info.json +3 -3
package/dist/control-ui/assets/{index-xpeRZhsZ.js → index-BVS_Pain.js} +80 -57
package/dist/control-ui/assets/index-BVS_Pain.js.map +1 -0
package/dist/control-ui/index.html +1 -1
package/dist/gateway/server-methods/wifi.js +207 -10
package/package.json +1 -1
package/taskmaster-docs/USER-GUIDE.md +31 -9
package/templates/maxy/memory/public/FAQ.md +42 -0
package/dist/control-ui/assets/index-xpeRZhsZ.js.map +0 -1

package/dist/control-ui/index.html CHANGED Viewed

@@ -6,7 +6,7 @@
     <title>Taskmaster Control</title>
     <meta name="color-scheme" content="dark light" />
     <link rel="icon" type="image/png" href="./favicon.png" />
-    <script type="module" crossorigin src="./assets/index-xpeRZhsZ.js"></script>
+    <script type="module" crossorigin src="./assets/index-BVS_Pain.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-DjhCZlZd.css">
   </head>
   <body>

package/dist/gateway/server-methods/wifi.js CHANGED Viewed

@@ -2,6 +2,15 @@
  * RPC handlers for WiFi network management on Linux (Raspberry Pi).
  * Uses nmcli (NetworkManager CLI) which ships with Raspberry Pi OS Bookworm.
  * All methods require operator.admin scope (enforced by the catch-all in server-methods.ts).
+ *
+ * Connection lifecycle:
+ * - wifi.connect  → creates/updates NM profile, enables autoconnect, disables power save
+ * - wifi.disconnect → disables autoconnect, brings connection down (intentional)
+ * - wifi.reconnect  → re-enables autoconnect, brings saved profile up (no password needed)
+ * - wifi.forget     → deletes the NM connection profile entirely
+ *
+ * NetworkManager handles auto-reconnect natively when autoconnect=yes.
+ * We additionally disable WiFi power save to prevent the wlan0 adapter from sleeping.
  */
 import os from "node:os";
 import { runExec } from "../../process/exec.js";
@@ -86,12 +95,102 @@ async function getWifiIp() {
     }
     return null;
 }
+/**
+ * Query wlan0 device state directly via `nmcli dev show wlan0`.
+ * This is more reliable than checking IN-USE in scan results, which can be stale.
+ */
+async function getWlan0State() {
+    try {
+        const { stdout } = await runExec("nmcli", ["-t", "-f", "GENERAL.STATE,GENERAL.CONNECTION", "dev", "show", "wlan0"], { timeoutMs: 5_000 });
+        // Output: GENERAL.STATE:100 (connected)\nGENERAL.CONNECTION:MyWiFi
+        let connected = false;
+        let ssid = null;
+        for (const line of stdout.split("\n")) {
+            if (line.startsWith("GENERAL.STATE:")) {
+                // State 100 = connected, anything else = disconnected
+                connected = line.includes("100");
+            }
+            if (line.startsWith("GENERAL.CONNECTION:")) {
+                const val = line.slice("GENERAL.CONNECTION:".length).trim();
+                if (val && val !== "--")
+                    ssid = val;
+            }
+        }
+        return { connected, ssid };
+    }
+    catch {
+        return { connected: false, ssid: null };
+    }
+}
+/**
+ * Find a saved WiFi connection profile managed by NetworkManager.
+ * Returns { name, ssid, autoconnect } or null if none exists.
+ */
+async function getSavedWifiConnection() {
+    try {
+        // List all connection profiles: NAME:TYPE:AUTOCONNECT
+        const { stdout } = await runExec("nmcli", ["-t", "-f", "NAME,TYPE,AUTOCONNECT", "con", "show"], { timeoutMs: 5_000 });
+        for (const line of stdout.split("\n")) {
+            if (!line.trim())
+                continue;
+            const placeholder = "\x00";
+            const safe = line.replace(/\\:/g, placeholder);
+            const parts = safe.split(":");
+            if (parts.length < 3)
+                continue;
+            const name = parts[0].replace(new RegExp(placeholder, "g"), ":").trim();
+            const type = parts[1].trim();
+            const autoconnect = parts[2].trim().toLowerCase() === "yes";
+            // 802-11-wireless is the nmcli type for WiFi connections
+            if (type === "802-11-wireless") {
+                return { name, ssid: name, autoconnect };
+            }
+        }
+    }
+    catch {
+        // Non-critical
+    }
+    return null;
+}
+/**
+ * Disable WiFi power save on wlan0 to prevent the adapter from sleeping.
+ * This is a common cause of WiFi drops on Raspberry Pi.
+ */
+async function disableWifiPowerSave(log) {
+    try {
+        await runExec("iw", ["dev", "wlan0", "set", "power_save", "off"], { timeoutMs: 5_000 });
+        log.info?.("WiFi power save disabled on wlan0");
+    }
+    catch (err) {
+        // iw might not be installed or wlan0 might not exist — non-critical
+        log.warn(`Could not disable WiFi power save: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Ensure a connection profile has autoconnect enabled and high priority.
+ */
+async function ensureAutoconnect(connectionName) {
+    try {
+        await runExec("nmcli", [
+            "con",
+            "modify",
+            connectionName,
+            "connection.autoconnect",
+            "yes",
+            "connection.autoconnect-priority",
+            "100",
+        ], { timeoutMs: 5_000 });
+    }
+    catch {
+        // Non-critical — profile might not exist yet
+    }
+}
 // ---------------------------------------------------------------------------
 // Handlers
 // ---------------------------------------------------------------------------
 export const wifiHandlers = {
     /**
-     * Return current WiFi connection status.
+     * Return current WiFi connection status, including saved profile info.
      */
     "wifi.status": async ({ respond, context }) => {
         if (!requireLinux(respond))
@@ -104,20 +203,38 @@ export const wifiHandlers = {
                     ssid: null,
                     signal: null,
                     ip: null,
+                    savedSsid: null,
+                    autoconnect: false,
                 });
                 return;
             }
-            // Check active WiFi connection
-            const { stdout } = await runExec("nmcli", ["-t", "-f", "IN-USE,SSID,SIGNAL,SECURITY", "dev", "wifi", "list"], { timeoutMs: 10_000 });
-            const networks = parseWifiList(stdout);
-            const active = networks.find((n) => n.active);
-            const ip = active ? await getWifiIp() : null;
+            // Query wlan0 device state directly — more reliable than scan results
+            // which can be stale right after connecting.
+            const deviceState = await getWlan0State();
+            const ip = deviceState.connected ? await getWifiIp() : null;
+            // Get signal strength from scan results (non-blocking, may be stale)
+            let signal = null;
+            if (deviceState.connected && deviceState.ssid) {
+                try {
+                    const { stdout } = await runExec("nmcli", ["-t", "-f", "IN-USE,SSID,SIGNAL,SECURITY", "dev", "wifi", "list"], { timeoutMs: 5_000 });
+                    const networks = parseWifiList(stdout);
+                    const active = networks.find((n) => n.active);
+                    signal = active?.signal ?? null;
+                }
+                catch {
+                    // Non-critical — signal strength is cosmetic
+                }
+            }
+            // Check for saved connection profile
+            const saved = await getSavedWifiConnection();
             respond(true, {
                 available: true,
-                connected: !!active,
-                ssid: active?.ssid ?? null,
-                signal: active?.signal ?? null,
+                connected: deviceState.connected,
+                ssid: deviceState.ssid,
+                signal,
                 ip,
+                savedSsid: saved?.ssid ?? null,
+                autoconnect: saved?.autoconnect ?? false,
             });
         }
         catch (err) {
@@ -147,6 +264,7 @@ export const wifiHandlers = {
     },
     /**
      * Connect to a WiFi network.
+     * Creates a persistent NM profile with autoconnect enabled and disables power save.
      * Params: { ssid: string, password?: string }
      */
     "wifi.connect": async ({ params, respond, context }) => {
@@ -172,12 +290,19 @@ export const wifiHandlers = {
             const combined = `${stdout}\n${stderr}`;
             const success = combined.includes("successfully activated") || combined.includes("successfully added");
             if (success) {
+                // Ensure autoconnect is enabled and high priority for reliable reconnection
+                await ensureAutoconnect(ssid);
+                // Disable WiFi power save to prevent adapter sleep
+                await disableWifiPowerSave(context.logGateway);
                 const ip = await getWifiIp();
                 respond(true, { connected: true, ssid, ip });
             }
             else {
                 // nmcli returned 0 but no success message — treat as unexpected
                 context.logGateway.warn(`wifi.connect: unexpected output: ${combined.slice(0, 300)}`);
+                // Still try to configure autoconnect and power save
+                await ensureAutoconnect(ssid);
+                await disableWifiPowerSave(context.logGateway);
                 respond(true, { connected: true, ssid, ip: null });
             }
         }
@@ -200,7 +325,9 @@ export const wifiHandlers = {
         }
     },
     /**
-     * Disconnect from the current WiFi network.
+     * Disconnect from the current WiFi network (intentional).
+     * Disables autoconnect so NetworkManager won't automatically reconnect.
+     * The saved profile is preserved — use wifi.forget to delete it.
      */
     "wifi.disconnect": async ({ respond, context }) => {
         if (!requireLinux(respond))
@@ -225,6 +352,13 @@ export const wifiHandlers = {
                 respond(true, { disconnected: true }); // Already disconnected
                 return;
             }
+            // Disable autoconnect so NM won't immediately reconnect
+            try {
+                await runExec("nmcli", ["con", "modify", connectionName, "connection.autoconnect", "no"], { timeoutMs: 5_000 });
+            }
+            catch {
+                // Non-critical — proceed with disconnect anyway
+            }
             await runExec("nmcli", ["con", "down", connectionName], { timeoutMs: 10_000 });
             respond(true, { disconnected: true });
         }
@@ -233,4 +367,67 @@ export const wifiHandlers = {
             respond(false, undefined, errorShape(ErrorCodes.UNAVAILABLE, "Failed to disconnect from WiFi"));
         }
     },
+    /**
+     * Reconnect to a saved WiFi profile (no password needed).
+     * Re-enables autoconnect and brings the saved connection up.
+     */
+    "wifi.reconnect": async ({ respond, context }) => {
+        if (!requireLinux(respond))
+            return;
+        try {
+            if (!(await nmcliAvailable())) {
+                respond(false, undefined, errorShape(ErrorCodes.UNAVAILABLE, "NetworkManager (nmcli) is not installed"));
+                return;
+            }
+            const saved = await getSavedWifiConnection();
+            if (!saved) {
+                respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, "No saved WiFi connection to reconnect"));
+                return;
+            }
+            // Re-enable autoconnect
+            await ensureAutoconnect(saved.name);
+            // Bring the connection up
+            await runExec("nmcli", ["con", "up", saved.name], { timeoutMs: 30_000 });
+            // Disable power save after reconnecting
+            await disableWifiPowerSave(context.logGateway);
+            const ip = await getWifiIp();
+            respond(true, { connected: true, ssid: saved.ssid, ip });
+        }
+        catch (err) {
+            const errObj = err;
+            const detail = errObj.stderr?.trim() || errObj.message || "Reconnect failed";
+            context.logGateway.warn(`wifi.reconnect failed: ${detail}`);
+            let message = "Failed to reconnect to WiFi";
+            if (detail.includes("No network with SSID") || detail.includes("not available")) {
+                message = "Network not in range — try moving closer to the router";
+            }
+            respond(false, undefined, errorShape(ErrorCodes.UNAVAILABLE, message));
+        }
+    },
+    /**
+     * Forget a saved WiFi network — deletes the NM connection profile entirely.
+     * After this, the user must re-enter the password to connect again.
+     */
+    "wifi.forget": async ({ respond, context }) => {
+        if (!requireLinux(respond))
+            return;
+        try {
+            if (!(await nmcliAvailable())) {
+                respond(false, undefined, errorShape(ErrorCodes.UNAVAILABLE, "NetworkManager (nmcli) is not installed"));
+                return;
+            }
+            const saved = await getSavedWifiConnection();
+            if (!saved) {
+                respond(true, { forgotten: true }); // Nothing to forget
+                return;
+            }
+            // Delete the connection profile — this also disconnects if active
+            await runExec("nmcli", ["con", "delete", saved.name], { timeoutMs: 10_000 });
+            respond(true, { forgotten: true, ssid: saved.ssid });
+        }
+        catch (err) {
+            context.logGateway.warn(`wifi.forget failed: ${err instanceof Error ? err.message : String(err)}`);
+            respond(false, undefined, errorShape(ErrorCodes.UNAVAILABLE, "Failed to forget WiFi network"));
+        }
+    },
 };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/taskmaster",
-  "version": "1.0.102",
+  "version": "1.0.104",
   "description": "AI-powered business assistant for small businesses",
   "publishConfig": {
     "access": "public"

package/taskmaster-docs/USER-GUIDE.md CHANGED Viewed

@@ -539,16 +539,34 @@ The free tier works for low-volume use (a handful of voice notes or images per d
 ## Your Files
-The **Files** page shows your assistant's knowledge — everything it knows about your business. Files are organised into folders:
+The **Files** page shows your full workspace — everything your assistant knows and how it's configured. The top-level folders are:
+| Folder | What it contains |
+|--------|-----------------|
+| **agents/** | Your assistant's identity and personality files (admin and public agents) |
+| **memory/** | Knowledge files organised by audience (see below) |
+| **skills/** | Skill packs that teach your assistant new capabilities |
+Inside **memory/**, files are organised by who can see them:
 | Folder | Who can see it | What it's for |
 |--------|---------------|---------------|
-| **public/** | Both assistants | Information your customers can ask about — services, pricing, opening hours |
-| **shared/** | Both assistants | Internal guidance — how to handle enquiries, tone of voice, escalation rules |
-| **admin/** | Admin assistant only | Private notes, business plans, personal reminders — customers never see this |
-| **users/** | One customer at a time | A folder for each customer (by phone number) with their profile, preferences, and history |
+| **memory/public/** | Both assistants | Information your customers can ask about — services, pricing, opening hours |
+| **memory/shared/** | Both assistants | Internal guidance — how to handle enquiries, tone of voice, escalation rules |
+| **memory/admin/** | Admin assistant only | Private notes, business plans, personal reminders — customers never see this |
+| **memory/users/** | One customer at a time | A folder for each customer (by phone number) with their profile, preferences, and history |
+All files are markdown (`.md`) — plain text with simple formatting.
+### Uploading and Managing Files
+Click any **folder** in the tree to set it as your working directory. The folder highlights with a left border to show it's selected. The **Upload** and **New Folder** buttons show where files will go — for example, "Upload to memory/public".
-All files are markdown (`.md`) — plain text with simple formatting. You can upload new files by dragging them onto the Files page.
+- **Upload** — Click the Upload button or drag `.md` files onto a folder in the tree
+- **New Folder** — Creates a new folder inside the current directory (useful for adding skill packs or organising memory)
+- **Delete** — Select a file and click Delete. The button changes to "Confirm delete?" — click again within 3 seconds to confirm. Empty folders show a small × on hover to remove them
+- **Move** — Drag any file onto a different folder to move it there
+- **Multi-select** — Hold Ctrl (or Cmd on Mac) and click multiple files, then use Download to save them all
 When you add or change a file, your assistant picks it up automatically — no restart needed. The status light on the Files page turns red when files have changed since the last index, so you can see at a glance whether a re-index is needed.
@@ -666,11 +684,15 @@ If your Pi is connected by Ethernet cable, you can switch to WiFi directly from
 **Signal bars** next to each network name show the signal strength — more lit bars means a stronger signal.
-**Disconnecting:** Tap **Disconnect** to drop the current WiFi connection. This is useful if you want to switch back to Ethernet or connect to a different network.
+**Auto-reconnect:** Once connected, your Pi remembers the WiFi network and password. If the connection drops (e.g. router reboot, temporary signal loss), the Pi automatically reconnects without any action needed. The WiFi row shows "Saved: (network name)" when a saved network exists but the connection is temporarily down.
-**Closing the list:** Tap **Close** to dismiss the network list without making changes. You can also tap the network you're already connected to (marked with a green tick) to dismiss the list.
+**Reconnecting:** If WiFi was manually disconnected and you want to reconnect to the saved network, tap **Reconnect** — no need to re-enter the password.
+**Disconnecting:** Tap **Disconnect** to intentionally drop the current WiFi connection. This prevents auto-reconnect until you tap **Reconnect** or connect to a new network.
-**Rescanning:** While the network list is open, tap **Scan** again at the top to refresh the list with the latest networks.
+**Forgetting a network:** Tap **Forget** to remove the saved WiFi password entirely. After forgetting, you'll need to scan and enter the password again to reconnect.
+**Closing the list:** Tap **Close** to dismiss the network list without making changes. You can also tap the network you're already connected to (marked with a green tick) to dismiss the list.
 > **Tip:** Connect an Ethernet cable first, open the Control Panel, then use the WiFi row to connect. Once WiFi is working, you can remove the Ethernet cable.

package/templates/maxy/memory/public/FAQ.md CHANGED Viewed

@@ -80,6 +80,9 @@ Optional add-ons that teach Maxy new domains. £5 each or all for £20. One-time
 - **Elderly Care** — medication management, safety check-ins, carer communication, emergency info
 - **Social** — birthdays, gift planning, event organisation, friend/family context, group coordination
+**Premium skills:**
+- **Beagle** — AI booking agent for local services. Find, quote, and book tradespeople and other professionals. Pay-per-booking (10% fee, capped at £50). See beagle.bot
 ### Can I buy skill packs later?
 Yes. Start with what you need and add more any time. They're permanent — no ongoing cost.
@@ -90,6 +93,45 @@ Any time. No minimum term. Your data stays on your device — Maxy never had acc
 ---
+## Beagle — Premium Skill
+### What is Beagle?
+Beagle is Maxy's AI booking agent for local services. Instead of calling around for quotes, tell Maxy what you need — a plumber, cleaner, electrician, painter — and Beagle handles the rest. It contacts local professionals, compares quotes, and books the best one in. The whole process takes under 4 hours and happens through conversation.
+Website: beagle.bot
+### How does Beagle work with Maxy?
+Beagle extends Maxy's Home skill pack. Where the Home pack remembers your tradespeople and reminds you about maintenance, Beagle actively finds and books new professionals when you need them. Ask Maxy to fix something, and it handles the sourcing, quoting, and booking.
+### What does Beagle cost?
+Beagle uses a pay-per-booking model, not a flat skill pack price:
+- 10% booking fee on the job total (minimum £2, maximum £50)
+- Nothing upfront — the fee is collected after the job is done
+- The provider deducts the fee from what you owe — your total stays the same
+Example: A £130 plumbing job → £13 Beagle fee. The plumber charges you £117. You pay £130 total, same as booking direct.
+### What if Beagle can't find someone?
+You pay nothing. If Beagle can't source a suitable quote, the request is closed and there's no charge.
+### What services can Beagle book?
+Starting with tradespeople — plumbers, electricians, painters, decorators, handymen, gardeners, cleaners. Expanding to any bookable service: hairdressers, personal trainers, accountants, removals, restaurant tables, wedding photographers.
+### What areas does Beagle cover?
+UK-wide.
+### Is Beagle different from Bark or Checkatrade?
+Yes. Those platforms sell your details to multiple tradespeople who compete to contact you — you get bombarded with calls. Beagle does the opposite: it contacts providers on your behalf, compares quotes behind the scenes, and gives you one confirmed booking. No spam, no runaround.
+---
 ## Setup
 ### How long does setup take?